Installing and Using a service to start a Single Server (Linux)

Instead of manually starting a server, you can install a service that automatically starts the server on a Linux OS. Read the steps below to learn how to:

  • Install the service (as root)
  • Verify that the installation was successful
  • Start the service (as the domain user specified during installation)
  • Verify that the service has started

The Single Server must be installed and working properly before taking the steps described below.

Steps

As root:

  1. Open a terminal from within <install>/utils/service/Linux.
  2. Type and enter the following command.
    sh ebi_service_install.sh <user> <install_path> <node_name>
    • <user>: This user must have proper permissions to run the server. (i.e. the user entered during the Server installation process).

    • <install_path> : The full path from root to the Single Server installation. This means you should have a leading / but do not include a trailing /. (For example: /opt/Cleo/Clarify5_Server)

    • <node_name>: The node name for a Single Server installation must be named "standard".

      Example of full command: sh clarify_service_install.sh <user> /opt/Cleo/Clarify_5_Server standard

    As a result, the command:
    • Creates the service with the name: clarifyservice_standard
    • Copies the service script to the /etc/rc.d/init.d directory with the node name appended to the script name.
    • Populates the supplied values into the script.
    • Installs the service.
    Note: Do not attempt to start the service as root.
  3. To verify the service has successfully installed, type in the command chkconfig --list You should see clarifyservice_standard.service in the list..
  4. Logout of root and use the command: sudo service <service name> stop This ensures that you are starting the server from a clean stop status.
  5. To start the service, you have two options:
    • Reboot the system.
    • Use service <service name> start to manually start the service.
  6. To verify the clarifyservice_standard.service has successfully started, type in the command systemctl –t service. You should see the service as loaded, active, and running.