The Android Replicator Monitoring Service allows monitoring the Replicator performance in real-time from your android device. The Android application ensures to:
show status of last replications on clients’ sites
send out alerts when the last replication on a site contains errors or when no new replication status has been received from the site for a long time
receive the status of replication on main sites in real-time
Functionality
The Adonis Monitoring Service sends out notifications to the application in the following cases:
If no data have been received for a long time from a site (the time that had elapsed since the last time when some data was received from the site exceeds the replication schedule interval).
If the last replication on a site contains errors.
Let us see the example of the client’s site list with the time and status of the last replication:
The possible values of a replication status:
Success (no errors, no warnings)
Warnings (ignored errors)
Errors
Now, tap the site to see the replication details, i.e. the replication start time and status:
In the list, tap any of the replication statuses to see the stages with their duration, status and error or ignored error details:
Housekeeping
This section will walk you through the installation and configuration procedures.
Install Service
To install the service, follow the steps described below:
Step 1
To start the installation, go to your FTP area and download the latest version of the service:
…/files/upgrade/Replicator/ADONISReplMon
Once the download is complete, go to the downloaded path and double-click the installation file to launch a setup wizard. This makes the Welcome dialogue appears on the screen:
Click Next to continue.
Step 2
Select the directory where the monitoring database will be located. By default, the directory is set to Program_Data. To indicate a different destination folder, click Browse… and set the path:
The database file is constantly updated. For this reason, it is not recommended to define either the Program Files or Program Files (x86) folder as the database location.
To proceed, click Next.
Step 3
Specify the monitoring service ports for communicating with the Android applications and the Replicator services, as well as for administrating the monitoring service via a web browser:
On completing, click Next.
Step 4
Define the administrator password to be used for accessing and setting up the monitoring service in a web browser:
Click Next.
Step 5
Choose the folder where you want to install the service. To do this, click Browse… and indicate the path to the destination folder.
Click Install to initiate the installation process.
Now, you can see the installation in progress:
When completed, click Next.
Step 6
The installation is completed:
Click Finish to close the setup wizard.
Set-Up Service
On installing the Android Replicator Monitoring Service, you can now perform a one-time setup of the service.
Run Service from Browser
To run the service, open your web browser and enter the following URL:
HTTP://<webserver hostname>:<port number>/
For example:
Use the port number that you have specified as the port for web administrating on the Monitoring Service Ports page of the setup wizard:
The default preconfigured port number is 5002.
The login page then appears on the screen.
On the page, proceed as described below:
Enter your credentials: 'admin' as your username and the password you have defined on Step 4 of the service installation procedure (see Replication Surveillance#Install Service).
Select Remember me if you want the browser to remember your login credentials.
Click Login to log into the service.
Set Clients
After logging in, you can set clients which replication activity you want to monitor:
A client is a set of sites replicating data between each other.
To set a client, follow the steps below:
On the left-hand side Repl Monitor pane, make sure to be on the Clients tab.
Click the New Client button at the top of the working area. This opens the New Client dialogue:
Fill in the following fields:
Client Name is a client name used by Android applications to identify the group of replication sites. The defined name is available in the client list and the notifications.
Short Name (maximum of 6 characters) is a client short name used as a column header in the list of logins in the Android users section (see Replication Surveillance#Set Android Users).
Repl Login is a login used by the replicator service to connect to the client's monitoring service. All the replicator services of a certain client must use the same credentials.
Repl Password is a password used by the replicator service to connect to the client's monitoring service.
Confirm Password enables re-entering the repl password.
A unique login must be provided for each client.
Click Add Client to create a new client.
As a result, a new client appears in the list of clients:
Use Basic Commands
On adding a new client, the following actions become available: edit records, change a password and remove records.
To access them, first, select the client and click the More button located in the last column:
Change password
To change a defined password, select Change password in the menu. The following dialogue then appears:
Please enter a new password and confirm it in the respective fields. When done, click Save.
Edit name
To change a defined client name, select Edit... in the menu. This opens the Edit Client Name dialogue:
Please make the appropriate changes to the client name and/or its short name and click Save.
Remove record
To permanently remove a client record from the system, select Remove in the menu. Selecting the option opens the Client Delete Confirmation dialogue:
Within the dialogue, click Remove to confirm the deletion.
Set Android Users
You can define Android users who will monitor the replication activity. For this, on the left-hand side panel Repl Monitor, switch to the Android Users tab:
Now, click the New User button at the top of the working area. Clicking the button makes the New Android Login dialogue appears:
In the dialogue, fill in the fields:
Login. Specify the login to be used to connect to the monitoring server from your mobile device.
Password. Specify the password to be used to connect to the monitoring server from your mobile device.
Confirm Password. Please re-enter the password to confirm it.
Access to everyone. Select the checkbox to grant a user access to future clients.
A unique user login must be provided for each device.
As a result, a new user then appears in the list of Android users:
Use Basic Commands
On adding a new Android user, the following actions become available to you: change a password and remove a record.
To access them, first, select the user and click the More button located in the last column:
Change password
To change a defined password, select Change Android Login/Password in the menu. The following dialogue then appears:
Please enter a new password and confirm it in the respective fields. When done, click Save.
Remove record
To permanently remove a client record from the system, select Remove in the menu. Selecting the option opens the Android Login Delete confirmation dialogue:
Within the dialogue, click Delete to confirm the deletion.
Set Up Replicator Service
You can set up the Replicator service by following the steps below:
Run Adonis Replicator Manager and switch to Settings in the tree-view left-hand side pane.
At the top of the Repl Settings workspace, click Run Settings Wizard.
When the Replicator Settings Wizard appears, navigate to the page where you can define the way of delivering replication events to the Monitoring Service:
The following options are available:
Connect to the monitoring server and send events. Select the option to establish a direct TCP connection between the replicator and the monitoring service for sending events.
Send heartbeat files to the main site. Select the option to primarily send events to the main site (preferable for satellites). After that, the Replicator of the main site re-sends the received heartbeat files to the monitoring server through its direct connection.
Do not send events. Select the option to forbid sending events.
Replicators belonging to one client must use the same login to connect to the monitoring service.
Selecting the Connect to the monitoring server and send events option enables you to configure the following monitoring server settings:
Server name or IP Address. Specify the server name or IP address of your monitoring server.
Port. Enter the port number that you have defined as the Replicator port when installing the monitoring service.
User Name. Enter the Repl Login that you defined for the current client when setting up the monitoring service.
Password. Enter the password that you have defined for the current client when setting up the monitoring service.
When completed, click Test Connection to make sure the connection has been successfully established.
Set Up Android Application
Now it is time to download and install the Android application on your device. To do this, go to Google Play Store and Locate the Adonis Replication Monitor or follow the link or QR code below.
https://play.google.com/store/apps/details?id=com.adonis.replmonitor&hl=en_US&gl=US
When running the application for the first time, it will ask you to enter:
The IP address of the server where the Adonis Monitoring Service
Port number that you specified for Android client connections when installing the monitoring service.
When done, tap OK to proceed.
After that, enter the login and password you have specified in the Set Android Users section in the web interface of the Adonis Monitoring Service. Tap OK to proceed.
When successfully connected, the list of available clients will be shown:
For each of these clients, you will be able to see its sites, the list of the recent replications and receive notifications.