Configuring after grid installation

The administrator must perform these tasks before using the product (or part of the product) to accomplish user goals.

• • Adjust Default group permissions
  • Configure memory settings

In the instructions on this page, AO_HOME represents the installation directory for a TrueSight Orchestration Configuration Distribution Peer (CDP).

Adjust Default group permissions

After installing the primary CDP, you were instructed to remove permissions from the Default group. If you have not already done so, remove permissions before continuing. See Adjust default group permissions for details.

Configure memory settings

For the production (and potentially lower) environments, the number of concurrent jobs and memory consumption of those individual jobs might require a memory increase (increase of the Java heap size) for the TrueSight Orchestration Java virtual machines (JVMs).

You can check the grid's available and used memory in the Grid Manager console by entering the following URL in a browser window:

https://<fullyQualifiedAOgridHostName>:<port>/baocdp/console

You can adjust the server memory by editing the server's Tomcat properties.

The following BMC Communities video (5:28) demonstrates how to increase a TrueSight Orchestration peer's memory on Windows or Linux.

 https://youtu.be/v6GWfDOOP4Q

To adjust a CDP server's memory on Windows

1. Stop the TrueSight Orchestration Configuration Distribution Peer service. See Starting-and-stopping-product-components-and-services.
2. From the command prompt, go to AO_HOME\tomcat\bin and run the tomcat8w.exe //ES//<CDPService> command.
3. On the CDP Peer Properties dialog box, click the Java tab.
4. You can edit the values of the following parameters to determine the heap size:
   • Initial memory pool

   • Maximum memory pool

     Note

     Here, the default value of the parameters is Initial memory pool=1024 and Maximum memory pool=1280. BMC recommends that you do not increase the Maximum memory pool value (default 1280) to more than half of the computer's total memory. In addition, do not increase this value beyond 8192 (8 GB) without consulting BMC Customer Support.

5. Click Apply and then click OK.
6. Start the CDP service. See Starting-and-stopping-product-components-and-services.

To adjust a CDP server's memory on UNIX

1. Stop the TrueSight Orchestration Configuration Distribution Peer service. See Starting-and-stopping-product-components-and-services.
2. Go to the AO_HOME/bin directory.
3. Back up the the server.sh file.
4. Open the server.sh file for editing.
5. Edit the values of the following parameters to determine the heap size:
   • -Xms

   • -Xmx
      Here, the default value of the parameters is: -Xms1024m and -Xmx1280m. Do not increase the set maxMemSize value (defaut 1280) to more than half of the computer's total memory. Also, do not increase this value beyond 8192 (8 GB) without consulting BMC Support.

     There's a slight difference between the default values of the -Xms and -Xmx parameters, however, for optimal performance, BMC recommends that you specify same values for -Xms and -Xmx parameters.

     The default value of the maximum memory size (-Xmx) and minimum memory size (-Xms) parameters is set to minimal required to start the application. However, on QA or production environments, BMC recommends that you specify the minimum required values. For more information, see System-requirements.

6. Save the file.
7. Start the CDP service. See Starting-and-stopping-product-components-and-services.