Install and start the IXIASOFT Output Generator service (Linux)

This procedure describes how to install and start the IXIASOFT CCMS Output Generator service on a Linux server.

Note: Some of these steps require root permissions.
  1. To customize the CCMS Output Generator application name and description:
    1. Open the CCMS Output Generator outputgenerator.sh executable file (located in the %OutputGenDir%/bin directory in a text editor; for example, /opt/ixiasoft/OutputGenerators/prod_[version]/bin/outputgenerator.sh; where [version] is replaced by the current release version number).
      If this is the first time that you are installing the CCMS Output Generator, open the outputgenerator.sh.empty file and save it as outputgenerator.sh (remove the .empty suffix).
    2. Set the APP_NAME field to your application name:

      For example:

      APP_NAME="OutputGenerator"
      Note: Embedded space characters are not allowed.
    3. Set the APP_LONG_NAME field to the detailed name of the application:

      For example:

      APP_LONG_NAME="Ixiasoft Output Generator" 
  2. By default, the service is run as the default user. To run the service as another user, uncomment and set the RUN_AS_USER field to the user name.
    For example:
    RUN_AS_USER=OutgenUser
    Note: Make sure that the user has the required privileges to write to the logs, pid, and temp folders.
  3. Save and close outputgenerator.sh.
  4. To make all required files executable, run the fix-execution-bit.sh file located in the %OutputGenDir%/bin directory of the CCMS Output Generator. For example:
    sh /opt/ixiasoft/OutputGenerators/prod_[version]/bin/fix-execution-bit.sh

    Where [version] is replaced by the current release version number.

  5. As root, create a symbolic link to the daemon startup script outputgenerator.sh:

    For example:

    ln -s /opt/ixiasoft/OutputGenerators/prod_[version]/bin/outputgenerator.sh /etc/init.d/outgen.prod[version for path]

    Where [version] is replaced by the current release version number and [version for path] is the version number without punctuation.

  6. As root, install the CCMS Output Generator as a service:
    /sbin/chkconfig --add outgen.outgen.prod[version for path]
  7. As root, start the CCMS Output Generator service:
    [root@appserver-ux bin]# /sbin/service outgen.prod[version for path] start
    Starting Ixiasoft Output Generator...
    [root@appserver-ux bin]# 
  8. To confirm that the CCMS Output Generator started correctly, open the %OutputGenDir%/logs/wrapper.log file.
    For example:
    /opt/ixiasoft/OutputGenerators/prod_[version]/logs/wrapper.log
    You should see the following message:
    CCMS Output Generator is ready to process requests
    If this message is not displayed, the log should provide more information as to why the CCMS Output Generator cannot be started.