Description

Replicator provides you with the possibility to distribute and automatically install the application updates on sites. There are two update types: program and plugin updates.

When updating a program, Replicator delivers the installer and other update files to sites and starts the installer at a defined time.

A plugin is an independent console application that is regularly started 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.  On installing a plugin, Replicator starts its executable file on schedule.

Distribute APM and APP Updates

To update a program on the sites, you need to:

1. Create an update package of an application.
2. Upload (publish) the update package into Replicator.
3. Specify the sites to which the update must be delivered and set the installation time.

Create APM Update Package

To create the APM update package, follow the steps below:

1. Run the APM setup wizard. In the Install mode dialog, select the Generate update package option:
   
   Click Next to continue.
2. In the Choose Adonis Personnel Manager Location dialog, define the directory for saving the update package:
   
   Click Generate to generate the package.
3. Wait until the package is generated:
   
   When completed generating, click Next to continue.
4. When done, the following dialog appears:
   
   Click Finish to close the wizard dialog.

Create APP Update Package

To create the APP update package, follow the steps below:

1. Open a command line application and enter the following commands:
   
   start /D <path_to_the_folder_with_the_installation_set> <path_to_APP_installer.exe> /CAB
   
   start /D H:\Adonis\Replicator\APP_distribute_via_Replicator AdonisPortalInstall_v2021.10.0.102.exe /CAB
2. Press Enter.

As a result, the CAB update package will be generated and available in the defined folder: AdonisPortalInstall_v2021.10.0.102.cab

Distribute and Install Update Package

To publish the update package in Replicator Manager, follow the steps below carefully:

1. On the left-hand side pane, select the service to which you got connected and navigate to Updatable programs:
   
   
2. Within the Updatable programs workspace, click the Publish update button. The Open dialog then appears on the screen:
   
3. Select the CAB file of the program you want to update. Click Open to load the file to Replicator Manager. Once clicked the package publishing is started. If the package is successfully published, you are notified respectively:
   

4. Select the sites to which the update package is to be delivered:
   

   Based on whether you want to deliver an update package to a single site or a multiple of them, you can select a single row or a multiple of them, accordingly.

   
   

5. Selecting the site(s) enables the Set Install Time button. Click the button to open the Set Update Install Time dialog:
   

6. Within the dialog, specify the update install time by setting one of the options:

   • Do not install the update automatically. Select the option to deliver the update package without auto-update.
   • Install update as soon as it is delivered to site. Select the option to allow updating once it is delivered to the sites.
   • Install at specified date and time. Select the option and specify the date and time values for the update to be installed on the sites.
7. Once done, click Ok to apply the changes.

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 Set Parameters For Sites.

Set Parameters For Sites

After the program is installed, it is necessary to specify parameters for the Site(s). 

To specify the parameters, follow the steps below:

1. On the left-hand side pane, select the service to which you got connected and navigate to Updatable programs.
2. In the Updatable programs node, select the plugin/program to be affected. Right under the selected program/plugin, select Update parameters/Plugin parameters, accordingly.
3. 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:
   
   
4. On entering, click OK to proceed.

Below, you will find the description of the parameters required for both APM and APP.

For APM, the following parameters are required:

For APP, only one parameter is required:

Replicator Plugin

A plugin is an independent console application that is regularly started 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.

To publish the update package in Replicator Manager, follow the steps below carefully:

1. On the left-hand side pane, select the service to which you got connected and navigate to Updatable programs:
   
   
2. Within the Updatable programs workspace, click the Publish update button. The Open dialog then appears on the screen:
   
3. Select the CAB file of the program you want to update. Click Open to load the file to Replicator Manager. Once clicked the package publishing is started. If the package is successfully published, you are notified respectively:
   

4. Select the sites to which the update package is to be delivered:
   
   

   Based on whether you want to deliver an update package to a single site or a multiple of them, you can select a single row or a multiple of them, accordingly.

   
   

5. Selecting the site(s) enables the Set Install Time button. Click the button to open the Set Update Install Time dialog:
   

6. Within the dialog, specify the update install time by setting one of the options:

   • Do not install update automatically. Select the option to deliver the update package without auto-update.
   • Install update as soon as it is delivered to site. Select the option to allow updating once it is delivered to the sites.
   • Install at specified date and time. Select the option and specify the date and time values for the update to be installed on the sites.
7. Once done, click Ok to apply the changes.

Once done, you can define the plugin parameters. For the RESCO Interface plugin, the following parameters are required: