Skip to end of banner
Go to start of banner

Replicator Update

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 12 Current »

Updating a program on the sites or on the main office assumes the following stages:

  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 Replicator Update Package

Before getting started, make sure to install the Adonis Package Builder application that allows creating the Replicator update package effortlessly:

http://download.adonis.no/files/upgrade/Replicator/2023.10

On completing the installation, run the application and proceed with the following steps:

  1. In the Package Type dialog, select Program and click Next to continue.

    replicator_update_package_builder.png

  2. In the Files dialog, click Add and load ReplManager.exe, ReplService.exe and sqlite3.dll.

    replicator_update_package_builder_files_dialog.png

    Click Next to proceed.

Note that the ReplManager.exe, ReplService.exe and sqlite3.dll files are part of the Replicator installation set. To extract them, dearchive ADONISREpl_xxx.exe by right-clicking it and selecting 7-Zip > Extract Files. Then save the files locally.

  1. In the Settings dialog, set the values for the list of parameters:

    replicator_update_package_builder_settings_dialog.png

Parameter

Value

TYPE

Program

PROGRAMCODE

ARE (Adonis Replicator)

DISPLAYNAME

ReplicatorUpdate (free input value). This name will appear in Replicator Manager under Updatable programs.

IS_PARTIALLY_DISTRIBUTED

Yes

IS_VERSION_UPDATED_BY_REPL

Yes

VERSION

Enter the version number to which Replicator is to be updated.

STARTEXECUTABLE

ReplService.exe

STARTPARAMETERS

-update -silent -instance: “%INSTANCE_NAME%“

Click Next.

  1. In the Destination dialog, you can specify the destination folder where the generated update package will be stored:

    replicator_update_package_builder_destination_dialog.png

    Click Next.

  2. In the Build dialog, click Start to see the update file generation in progress:

    replicator_update_package_builder_build_dialog.png

    As a result, the update package is successfully generated:

    replicator_update_package_builder_build_dialog_success.png

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:

    replicator_update_programs.png

  2. Within the Updatable programs workspace, click the Publish update button. The Open dialog then appears on the screen:

    replicator_update_select_cab_file.png

  3. Select the CAB file of the program you want to update and 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:

    replicator_update_package_published.png

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

    replicator_update_status_of_replicator.png

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.

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

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 the site. Select the option to allow updating once it is delivered to the sites.

  • Install at a specified date and time. Select the option and specify the date and time values for the update installed on the sites.

Once done, click Ok to apply the changes.

Make sure to define parameters for the sites where the update is to be performed. For more information, see Set Parameters for Sites.

As a result, the update package will be delivered to the selected site(s), and the update will start at the specified time or as soon as the update package is delivered to the site(s). Please be aware that ReplService is primarily updated. After that, the Replicator Manager connection will be interrupted and you need to restore connection manually:

replicator_update_connection_interrupted.png

Click Connect.

Once connection is restored, you are then notified that a new version of Replicator Manager is available:

replicator_update_new_version_available.png

Click Yes to proceed.

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 program name to be affected. Right under the selected program, select Update parameters.

The Replicator name corresponds to the one set in the DISPLAYNAME parameter. For more information, see Create Replicator Update Package (Step 3).

  1. 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 parameter dialog where you can enter the parameters one by one:

  2. On entering, click OK to proceed.

Below, you will find the description of the parameters required for Replicator.

Name

Value

INSTANCE_NAME

Specify the Replicator instance name that you want to update on the site.

replicator_update_instance_name.png

  • No labels