...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Description
Replicator provides you with the possibility to distribute and to automatically install the application updates on sites. An update is distributed as a CAB archive (Microsoft Cabinet file) that contains update files. The archive is called an update package. Replicator supports two update types: program and plugin updates.
...
A plugin is an independent console application that can be started regularly to perform various actions, e.g. create some reports and send them by email to specified destinations. When updating a plugin, Replicator delivers the plugin executable file (and some other auxiliary files) to sites. The plugin installation is just simple file copying to a certain folder created for that plugin. An installer is not required. On installing a plugin, Replicator starts its executable file on schedule.
Distribute and Install Update Package
To update a program on the sites, you need to:
...
Plugin and program installation procedures are different. Below you will find the description of each installation procedures.
Update Program/Plugin
A program update package contains an executable file that performs installation, a configuration file (Update.ini) and other files needed to install the update. Replicator starts the installer at the scheduled time using the command line parameters specified in Update.ini. When the installation process is completed, Replicator gets the exit code and stores the installation log in a certain database table. In case the update installation is successful, Replicator saves the version number of the installed program to that database table (the version number is specified in Update.ini). Based on this information, you can observe the program update installation on each site.
...
- Create an update package of the program. For more information, see 2626159128 Create Update Package.
- Publish the update package in Replicator Manager and set the time for updating the program/plugin. For more information, see 2626159128 Publish Update Package.
- Specify parameters for the site(s). For more information, see 2626159128 Set Parameters for Sites.
Anchor Create Update Package Create Update Package
Create Update Package
| Create Update Package | |
| Create Update Package |
An update package is a CAB archive that includes:
...
| Info |
|---|
You can create an update package on your own or with the help of the PackageBuilder utility. |
Anchor Publish Update Package Publish Update Package
Publish Update Package
| Publish Update Package | |
| Publish Update Package |
To publish the update package in Replicator Manager, follow the steps below carefully:
...
As a result, the update package will be delivered to the selected site(s) and update will start at the specified time or as soon as the update package is delivered to the site(s). Besides, you must set the connection parameters to the affected site(s) have been correctly set. For more information, see 2626159128 Set Parameters for Sites.
| Anchor | ||||
|---|---|---|---|---|
|
After the plugin/program is installed, it is necessary to specify parameters for the Site(s).
To specify the parameters, follow the steps below:
- On the left-hand side pane, select the service which you got connected to and navigate to Updatable programs.
- In the Updatable programs node, select the plugin/program to be affected. Right under the selected program/plugin, select Update parameters/Plugin parameters, accordingly.
- In the Update parameters workspace, select the Site for which you want to add parameters and click the Add button. Clicking the command displays the Add new command dialog where you can enter the parameters one by one:
- On entering, click OK to proceed.
Below, you will find the description of parameters required for each program/plugin.
For the RESCO Interface plugin, the following parameters are required:
| Name | Value |
|---|---|
| DATABASE | Enter the database name to be used. |
| DAYSGAP | Define the number of days after the current day during which crew members will be available in RESCO. |
| SERVER_NAME | Specify the server name to which to connect. |
| SERVICE_PSW | Enter the password to the service. |
| SERVICE_URL | Enter the service URL. |
| SERVICE_USER | Enter the service user name. |
| XREF | Define the name of the Xref interface added in the APM. |
For APM, the following parameters are required:
| Name | Value |
|---|---|
| APM_FOLDER | Specify the application installation path. |
| SERVER_NAME | Enter the server name. |
| DATABASE_NAME | Enter the database name to be used. |
| USER_NAME | Enter the APM username. |
| Password | Define the database password. |
...
| Info |
|---|
Passwords for user AD_UPGRADE must match. Otherwise, the APP site will be upgraded but the database will remain unchanged. |
Remove Program/Plugin
You can remove a program or a plugin from the list of programs that may be updated. To do this, follow the steps below:
...