(Linux) Install and start the CCMS Output Generator service

The seventh task when you install a new IXIA CCMS Output Generator is to install and start the IXIA CCMS Output Generator service on a Linux server.

Before you begin

Note: Some of these steps require root permissions.

About this task

To install and start the CCMS Output Generator service in Linux:

Procedure

To customize the CCMS Output Generator application name and description, take the following actions:
1. Open the CCMS Output Generator outputgenerator.sh executable file, located in the %OutputGenDir%/bin directory in a text editor.
```
/opt/ixiasoft/OutputGenerators/prod_[version]/bin/outputgenerator.sh
```
  Where:
  
  [version] is replaced by the current release version number
  Note: 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, after removing the .empty suffix.
2. Set the APP_NAME field to your application name.
```
APP_NAME="OutputGenerator"
```
  Important: Embedded space characters are not allowed.
3. Set the APP_LONG_NAME field to the detailed name of the application:
```
APP_LONG_NAME="Ixiasoft Output Generator" 
```
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 username.
```
RUN_AS_USER=OutgenUser
```
Tip: Make sure that the user has the required privileges to write to the logs, pid, and temp folders.
Save and close outputgenerator.sh.
To make all required files executable, run the fix-execution-bit.sh file located in the %OutputGenDir%/bin directory of the CCMS Output Generator.
```
sh /opt/ixiasoft/OutputGenerators/prod_[version]/bin/fix-execution-bit.sh
```
Where:

[version] is replaced by the current release version number.
As root, install the system service.
```
/opt/ixiasoft/OutputGenerators/prod_[version]/bin/outputgenerator.sh install
```
Where:

[version] is replaced by the current release version number.
As root, reload the system configuration:
```
systemctl daemon-reload
```
As root, start the CCMS Output Generator service.
```
systemctl start [APP_NAME]
```
Where:

[APP_NAME] is the name you set for the CCMS Output Generator service.
To confirm that the CCMS Output Generator started correctly, open the %OutputGenDir%/logs/wrapper.log file.
```
/opt/ixiasoft/OutputGenerators/prod_[version]/logs/wrapper.log
```
You should see the following message:
```
CCMS Output Generator is ready to process requests
```
Note: If this message does not display, examine the log information to determine why the CCMS Output Generator cannot start.