Configuring the Presentation Server

Use the instructions in the following sections to configure the TrueSight Presentation Server.

Configuring a disaster recovery system for the Presentation Server

You need not do any configuration on the primary TrueSight Presentation Server. Every installation of the Presentation Server is disaster-recovery ready. 

After a disaster, you can configure any other instance of Presentation Server as a recovery server. 

Perform the following steps to configure the recovery TrueSight Presentation Server:

Step 1: Stop the recovery TrueSight Presentation Server

To stop the recovery TrueSight Presentation Server, run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh server stop

Step 2: Copy the configuration files

Using any third-party file synchronization and backup software, copy the following folders from the primary TrueSight Presentation Server to the respective directory of the recovery TrueSight Presentation Server:

On Windows:

• TRUESIGHTPSERVER_HOME\data

• TRUESIGHTPSERVER_HOME\modules\elasticsearch\data
• TRUESIGHTPSERVER_HOME\conf

On Linux:

• TRUESIGHTPSERVER_HOME/data
• TRUESIGHTPSERVER_HOME/modules/elasticsearch/data
• TRUESIGHTPSERVER_HOME/conf

Step 3: Start the database on the recovery TrueSight Presentation Server

Run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh process start database

Step 4: Verify that the database is running

Run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh server status

If the database server fails to start, do the following:

1. Run following command on the recovery TrueSight Presentation Server:

   cd %TRUESIGHTPSERVER_HOME%\truesightpserver\modules\pgsql\bin
   pg_resetxlog.exe "%TRUESIGHTPSERVER_HOME%\truesightpserver\data\pgsql"

2. (Optional) You might see the following message:

   The database server was not shut down cleanly. Resetting the transaction log might cause data to be lost. 
   If you want to proceed anyway, use -f to force reset.

   If you see this message, run the following command:

   pg_resetxlog.exe -f "% TRUESIGHTPSERVER_HOME %\truesightpserver\data\pgsql"

3. Start the database process by running the following command:

   tssh process start database

Step 5: Modify the host name on the recovery TrueSight Presentation Server

Run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh dr configure <Secondary DNS HostName>

Step 6: Stop the database on the recovery TrueSight Presentation Server

Run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh process stop database

Step 7: Start the recovery TrueSight Presentation Server

Run the following command from the <Presentation Server installation directory>\truesightpserver\bin folder:

tssh server start

Describes how to configure a Presentation Server installation for disaster recovery

To customize the configuration files

After installing the TrueSight Presentation Server, you can override some default settings by customizing the following TrueSight Presentation Server configuration files according to your environment:

• csr.conf
• dbsrv.conf
• idxsrv.conf

For customization, the files are available in the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory. While customizing any of the files, ensure that you uncomment the properties that you want to customize. For example, the following property is commented out:

#vm.args.system.34=-XX:InitiatingHeapOccupancyPercent=70

Uncomment the property and then customize it. For example:

vm.args.system.34=-XX:InitiatingHeapOccupancyPercent=80

When you add a new configuration parameter, ensure that its configuration key starts with 501:

vm.args.system.501=<value>

To enable the msp-deployment parameter in a multi-tenant Presentation Server environment

On a multi-tenant Presentation Server environment, you must enable the msp-deployment parameter. To enable, do the following:

1. Navigate to the folder based on the operating system on which you installed the TrueSight Presentation Server:

   - (Windows) <Install_Directory>\truesightpserver\modules\tomcat\webapps\ROOT\WEB-INF\classes
   - (Linux) <Install_Directory>/truesightpserver/modules/tomcat/webapps/ROOT/WEB-INF/classes

2. Open the rsso-agent.properties file.
3. Uncomment the msp-deployment=true parameter and save.

4. Navigate to the folder.

   - (Windows) < install_Directory>\truesightpserver\bin
   - (Linux) < install_Directory>/truesightpserver/bin

5. Run the following commands to restart the Presentation Server:
tssh server stop
tssh server start