Skip to main content

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
Information noteInstalling an instance will not start the instance.

[pass=server_password] data=data_directory iport=internal_port_number rport=rest_port_number arep.sh install instancename  

pass=28dj20G43839&*! data=/opt/mydata iport=5342 rport=5341arep.sh install myreplicateinstance

Command parameters
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

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!