Agents help spread the load of data migration on remote or local database servers. Follow these instructions to install and configure a data agent on a remote server.

System Requirements

Supported Linux Distros Supported Java JDK
CentOS 6 & 7
Red Hat
Oracle Enterprise

Install Agent on remote server

The agent requires a number of steps to be completed prior to installation:

Task Description
Download Cirro Agent Installer The installer is available from the Cirro Web interface.
Login as Root We need root access to complete a number of tasks, including creating a Cirro Agent user on the remote system.
Update Hosts files Perform this step if your Cirro server and/or remote server use IP addresses.
Create agent user The agent user takes ownership of the opt/cirro directory where the Cirro Agent is installed.
Install Java JDK Ensure the Java SDK matches on both your Cirro server and remote server. Login to your Cirro server and enter “java -version”.
Install Cirro Agent Login as the Cirro Agent user, untar the agent installer and install into the Cirro directory.

Download Cirro Agent Installer

Start by downloading the Agent Installer from your Cirro server.

  • Click Data Management then Agents

  • Click Add Agent.

  • Click Download the Cirro Agent Installer

Login to remote server

  • Connect to the remote server as Root

sudo su

Update Hosts Files

These steps are only required if your Cirro Server and/or Remote Server use IP addresses.

  • Update hosts file on your Cirro server and remote server with IP address and hostnames.

more etc/hosts  cirroagentexample  cirroserverexample

  • Test the changes.

ping cirroagentexample

Create Remote Server User

We now need to create a Linux user for the Cirro Agent. Change the example value to an appropriate username

useradd cirroclientexample

Create Cirro folder and change ownership

The Cirro Agent installer needs an /opt/cirro directory on the remote server.

  • Create Cirro folder.

mkdir /opt/cirro

  • Change ownership of the folder.

chown cirroclientexample:cirroclientexample /opt/cirro

Install JAVA JDK

  • Login to your Cirro Server and run this command to verify the local JDK version:

java -version

  • On the remote server, open the usr/local directory.

cd /usr/local bin

  • Untar the installer, where

    • directory - the download directory

    • jdk-version-linux-x64.tar.gz - alter this to the downloaded installer filename (e.g., jdk-8u121-linux-x64.tar.gz)

tar -xvzf /directory/jdk-version-linux-x64.tar.gz

Install Cirro Agent on Server

  • Login to remote server as the agent user

su cirroclientexample

  • Untar Cirro Agent installer from the download folder.

tar -xvzf /download/cirro_install_svcs.tgz

  • Run the installation script

./ –-dir /opt/cirro –-install-rdbms-service

  • Alter cirro_env.local file and give it the path to the Java JDK. Substitute the filename for jdkVERSION in the script below.

cd /opt/cirro/var

vi cirro_env.local

export JAVA_HOME=/usr/local/bin/jdkVERSION

Logout and check status of agent

  • Logout of the shell then login again as your agent user



su  - cirroclientexample

  • Verify Agent is running

cirro_rdbmsd status

--sample output

Process 1234 is running

Add Data Agent to Cirro

  • Click data management then Add Agent.

  • Enter the Agent Name.

Field Description Values
Host Hostname or IP address Use Localhost for agents on Cirro server.
Service Name    
RMI Port Java Remote Machine Invocation port number By default, RMI registry uses port 1099. However, this may differ based on your Server configuration.  
Read Only   True/False
  • Click Create Agent.