Troubleshooting virtualization configuration objects issues

Certain virtualization configuration objects running on a Red Hat Linux computer might encounter the following error: any action that you try to perform through the TrueSight Server Automation Console for the management of the Citrix XenServer server assets results in an error message, "Unable to start CO Server." 

This problem arises when resource usage by the configuration object exceeds the defined OS limitations for the allocation of shared memory segments or message queues.

To prevent this issue from occurring, TrueSight Server Automation provides a shell script (blsysctl.sh ) that you can use to update the IPC configuration parameters in the Red Hat kernel so that the TrueSight Server Automation configuration object can run. This script updates the /etc/sysctl.conf file, which controls system parameters.
You must execute the script on any machine running a Red Hat Linux agent that has the Citrix XenServer TrueSight Server Automation configuration object installed.

To run the blsysctl.sh script for modifying IPC parameters, complete the following steps:

1. Log on to the Red Hat Linux computer as root.
    If you are not permitted to log on as root, use the su or sudo command to gain sufficient permissions.
2. Use the cd command to navigate to the installationDirectory/NSH/sbin directory.
3. Stop the RSCD agent using the agentctl stop command.

4. Run the blsysctl.sh script using the blsysctl.sh -options command, where options can be any of the parameters described in the following table.The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.As the script runs (with the -w option), the /etc/system.conf file is updated with new values for IPC parameters, within a new BMC BladeLogic section. Old values are commented out, as shown in the following figure, an example of an updated system.conf file.

   ### The line below is commented out by BMC blsysctl.sh script
   ### kernel.shmmax = 4294
   # Controls the maximum number of shared memory segments, in pages
   ### The line below is commented out by BMC blsysctl.sh script
   ### kernel.shmall = 26842
   #------------------------------------#
   ### BMC Bladelogic Section - Start
   #------------------------------------#
   kernel.sem=250 32000 32 1024
   kernel.shmmni=4096
   kernel.shmmax=32768
   kernel.shmall=2097152
   kernel.msgmni=1024
   #------------------------------------#
   ### BMC Bladelogic Section - End
   #------------------------------------#
5. Start the RSCD agent using the agentctl start command.