Description
...
As a result, the CAB update package will be generated and available in the defined folder: AdonisPortalInstall_v2021.10.0.102.cab
In replicator task setup it need specify update parameter INSTANCE_NAME with name of APP instance you want to update. It needs in case if more then one instance installed on server. If this parameter is not specified then it will update [DEFAULT] instance.
Once done, Replicator will proceed to the next steps:
- Deliver the update package to the selected sites.
- Install the update at the scheduled time.
Plugin and program installation procedures are different. Below you will find the description of each installation procedures.
Distribute and Install Update Package
...
Anchor | ||||
---|---|---|---|---|
|
After the 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 both APM and APP.
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. |
...
Name | Value |
---|---|
INSTANCE_NAME | Specify the APP instance name to be updated. |
Info |
---|
The INSTANCE_NAME parameter may be optionally specified. It is specifically required in case several instances are installed on the server. If the parameter is not specified, Replicator will update the [DEFAULT] instance. |
Info |
---|
Passwords for user AD_UPGRADE must match. Otherwise, the APP site will be upgraded but the database will remain unchanged. |
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:
- On the left-hand side pane, select the service which you got connected to and navigate to Updatable programs:
- Within the Updatable programs workspace, click the Publish update button. The Open dialog then appears on the screen:
- 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:
Select the sites which the update package is to be delivered to:
Info 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 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.
- 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:
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. |
...
You can remove a program or a plugin from the list of programs that may be updated. To do this, 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 workspace, select the program/plugin you want to remove and click the Delete program button. Clicking the command displays the Confirm dialog where you can confirm the deletion:
- Click Yes to confirm the deletion.
When successfully completed, the corresponding message then appears.
Info |
---|
If an affected program/plugin is running at the moment, it will be removed after all the tasks are finished. |
...