Installing an additional instance of Replicate as a service
The installation directory of an instance depends on the user running the script.
- If the script is run as root:
- The instance will be installed as a service
- The installation directory of the service will be /etc/init.d
- If the script is run by a non-root user, the installation directory of the instance will be the replicate bin directory
Syntax:
[pass=server_password] data=data_directory iport=internal_port_number rport=rest_port_number arep.sh install instancename
Example:
pass=28dj20G43839&*! data=/opt/mydata iport=5342 rport=5341arep.sh install myreplicateinstance
Parameter | Description |
---|---|
[pass=password] |
Sets the server password. Users will be prompted for this password when connecting to the Replicate server through the Replicate Web Console. You can either set this password when installing Replicate (recommended) or you can set it later as described in Changing the server password. |
data=replicate_data_directory |
Use this parameter to install the Replicate data directory to a non-default location. Example: data=/opt/mydata |
iport |
The internal port, which must be a decimal number greater than 1023 but less than 65535. |
rport |
The REST port, which must be a decimal number greater than 1023 but less than 65535. |
instancename | The name of the service to create. |
Running the script will:
-
Confirm not using instance name / port numbers / data directory that are already in use
Information noteReinstalling an instance after it was just stopped and uninstalled may require a few minutes wait until tcp releases the port(s) - Determine the data directory and port numbers, using the command line parameters or default values
- Create a configured copy of itself, named instance, installed in the instance installation directory
- Add an instancename record to a list of installed instances in services_list.txt
- Create a functionally empty instance specific file in the data directory named instancename_arep_login.sh for instance specific settings
- If run as root:
- Create start/stop links for run levels as specified in the script (chkconfig)
- Create a symbolic link to /etc/init.d/instancename in the Replicate bin directory (same name)
- If a server password is specified, the script will run repctl to set the admin UI server password