This wiki article covers the changes made in between our “Legacy” version of our Agent (Versions 3.24.0 and below) and the newer versions of our Agent (Argon and above). It will document the best practices for migrating from the legacy version to the newer version as well as the small changes we have made for operating the Agent.
Additionally beginning with the Argon version, the Replicator Agent Service is enhanced to support a 64-bit JDK for all supported platforms.
Enhanced integration with various security options provided by our supported OS platforms may result in the user receiving additional prompts for Administrator or SUDO permission.
Users must to perform the install steps “as an Administrator” (Windows) or with sudo on *nix platforms.
For linux systems you may have been familiar with just executing
bin/agent start
the Agent would start up and that was it. It is now named agent.sh and this is no longer the recommended way to run the Agent.
This (along with windows) has been changed so running the Agent like so will run it “interactively” in the console. This is largely for quick demonstrations / tests. For extended use the recommended approach is to install it as a Windows Service or Linux Daemon.
When running the agent interactively (through the agent.sh/agent.bat convenience scripts or runConsole.sh/runConsole.bat commands), users are advised to always terminate the Agent as documented below with control-c. This allows the interactive agent session to exit gracefully. Failure to do so may result in a lingering Java process which must be killed or terminated manually.
The steps to upgrade are:
This is essentially verifying we are removing the legacy Agent's service prior to the fresh installation of the newer Agent.
As mentioned previously we want the Agent to run all the time, ie, as a service. This is detailed in the previous installation links. The following are direct links for how to do this:
If you are familiar with installing the Agent as a service this process should be familiar to you. The changes made between these two versions are primarily which files are executed:
Operation | Legacy Version | Argon and Above |
---|---|---|
Install Agent Service | InstallAgent.bat | installService.bat |
Remove Agent Service | UninstallAgent.bat | uninstallService.bat |
Starting Agent Service | StartAgent.bat | startService.bat |
Stopping Agent Service | StopAgent.bat | stopService.bat |
You need to “Run as Administrator” for the installService.bat as well as uninstallService.bat for the Replicator Agent to properly function as a service. You are still able to operate the Agent through the Windows service panel as you were previously (without administrator privileges).
Operation | Legacy Version | Argon and Above |
---|---|---|
Install Agent Service | bin/agent install | bin/installDaemon.sh |
Remove Agent Service | bin/agent remove | bin/uninstallDaemon.sh |
Starting Agent Service | service ReplicatorAgent start | bin/startDaemon.sh |
Stopping Agent Service | service ReplicatorAgent stop | bin/stopDaemon.sh |