You must run the Object Repository Synchronizer to download the latest objects any time you add or update an object in the database server's Object Repository. See "Step 5: Run the Object Repository Synchronizer" on page 15 for instructions on how to run the synchronization utility. Note:
Note |
---|
You should run the Object Repository Synchronizer after hours when no user is accessing the database. |
Also, you can create a batch file and a Windows Scheduled Task that will automatically run the utility on a specified schedule.
When you run AptifyObjRepSynchronizer.exe, a dialog opens that walks you through the process for downloading objects. However, the Object Repository Synchronizer also supports a series command line arguments. Specifying a series of arguments on a command line suppresses the dialog and runs the tool in the background. The command line arguments are as follows (and shown in the figure below):
- /? or /Help: Displays the help screen shown in the figure .
- /Server=[Aptify Database Server]: Use this argument to specify the Aptify database server. Note that rather than use this command line argument, you can add the Aptify.Framework.LoginServices.AptifyLogin.Server key to the AptifyObjRepSyn-chronizer.exe.config file.
- /EntitiesDB=[Database used to store Aptify's Entities Entity]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
- /UsersDB=[Database used to store user metadata]: Typically, this database is APTIFY, which is already set in AptifyObjRepSynchronizer by default. Therefore, you do not need to use this command unless you have installed Aptify to a database other than APTIFY.
- /User=[Untrusted User Name]: If connecting as an untrusted user, such as sa, use this argument to specify that user. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyObjRepSynchronizer.exe.config file to use a trusted login.
- /pwd=[password]: If you specified an untrusted user using the /user argument, specify the password for that untrusted user. Note that the password will appear in plain text. There is no command line argument to specify a trusted user account. Instead, set the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to true in the AptifyOb-jRepSynchronizer.exe.config file to use a trusted login.
- /CacheFolder=["Aptify Folder Location"]: The path for the Aptify 5.0 files. Typically, this is C:\Program Files\Aptify 5.0. When using this argument, enclose the path in quotation marks.
- /RepositoryUserID=[ID of User]: Use this argument to specify the ID of the user for whom the synchronization utility runs. (This is the equivalent to the Repository User selection you would make in the tool's user interface.)
- /s: This argument suppresses the synchronizer's user interface.
- /c: This argument, introduced with Aptify 5.0 Service Pack 2, specifies the Sync Repository Objects record that contains the collection of objects to download (or not download). With this option, only the objects within the Sync Repository Objects record that are marked as Downloadable will be downloaded. See the Aptify 5.0 Service Pack 2 Release Notes for more information about this feature.
By using the command line arguments listed above and modifying the AptifyObjRepSynchro-nizer.exe.config file, you can create a batch file and a Windows Scheduled Task that automatically stops any applicable services, runs the synchronization utility, and restarts the services on a pre-determined schedule without requiring user intervention.
Note |
---|
...
When specifying multiple command line arguments separate each argument with a space. |
The procedure below describes how to create a scheduled task on the terminal server to automate the execution of the synchronizer using a trusted user account (the user specified in the Scheduled Task).
- Log in to the client computer using a Windows account that is an administrative user on the computer (i.e., the user is in the computer's Administrators group).
- Identify the location of the Object Repository Synchronization Utility on the computer. See "Step 5: Run the Object Repository Synchronizer" on page 15 for details.
- Open the AptifyObjRepSynchronizer.exe.config file with Notepad.
- Locate the Aptify.Framework.LoginServices.AptifyLogin.Trusted key and change the value from false to true.
- With this setting, the synchronizer will use the trusted user account for the Windows domain user specified in the Scheduled Task. This eliminates the need to use the /User and /pwd command line arguments.
- With this setting, the synchronizer will use the trusted user account for the Windows domain user specified in the Scheduled Task. This eliminates the need to use the /User and /pwd command line arguments.
- Add the following line above the Aptify.Framework.LoginServices.AptifyLogin.Trusted key to connect to your organization's Aptify database server only:
<add key="Aptify.Framework.LoginServices.AptifyLogin.Server" value="[Enter Your Database Name]"/>
- This eliminates the need to use the /Server command line argument.
...
.
- Save and close AptifyObjRepSynchronizer.exe.config.
- Create a batch file that performs these steps:
- Stop any applicable services using the NET STOP "[service name]" command as required by your network and terminal server configuration. However, do not stop the Aptify Object Repository Service, since the Synchronizer uses this service.
- Run the synchronization utility for a specified repository user in silent mode with this command:
...