Administrative troubleshooting

When you encounter issues administering IBM® Sterling Control Center Monitor, there are solutions that can help you fix them.

The following table provides solutions to common IBM Sterling Control Center Monitor system issues:

Issue Solution
Logging off UNIX kills the IBM Sterling Control Center Monitor process. Log on as root to the computer where the engine is installed, then start IBM Sterling Control Center Monitor.
Not enough space errors received during installation.
  • Delete unnecessary files to provide more room on your computer.
  • Close all open applications and rerun the installation.
Getting out-of-memory errors on the IBM Sterling Control Center Monitor engine server. By default, the maximum heap size of the IBM Sterling Control Center Monitor engine is set to 4 GB. You can increase this value when getting out-of-memory errors or when you increase Simultaneous Pollers in Systems Settings. The guidelines and steps apply both to 32-bit and 64-bit platforms.

To calculate your heap requirements, use the following formula:

Maximum heap size = 45 MB + (Number of simultaneous pollers * 30 MB) + (Number of servers * .5 MB) 
 				        + (Max file agent activity cache size * 1 KB * Number of CD file agents)

If more than 1.5 GB of heap is required, you must use a 64-bit system.

Changing Java heap settings in both Microsoft Windows and UNIX environments involves editing the InstallationInfo.properties file to add an entry. Next, you must run the configCC.bat/sh configuration script and restart the IBM Sterling Control Center Monitor engine.

To change Java heap settings:

  1. Make a backup of the file InstallationInfo.properties at ControlCenterInstallDirectory\conf.
  2. Open InstallationInfo.properties (at ControlCenterInstallDir\conf) with a text editor (such as Notepad on Microsoft Windows or vi on UNIX).
  3. Look for line that starts with MAX_HEAP_SIZE. (If it is there, change the value to the wanted number). If it is not there, add a line at the end of the file as shown in the following example:

    MAX_HEAP_SIZE=-Xmx???m

  4. Replace ??? with the wanted number.

    Example: MAX_HEAP_SIZE=-Xmx8192m

  5. Save the file.
  6. Run the configCC.sh (UNIX) or configCC.bat (Microsoft Windows) file at ControlCenterInstallDirectory/bin.
  7. Answer no to all the questions. Merely running the script makes the necessary updates to different runEngine scripts.
  8. Stop the engine by using stopEngine.sh (UNIX) or stopEngine.bat (Microsoft Windows).
  9. Start the engine by using runEngine.sh (UNIX) or runEngine.bat Microsoft Windows).
Rules produce no results.
  • If you specify multiple criteria, all criteria must be met for the rule to take effect. Try reducing the number of criteria.
  • Rule values are case-sensitive. Verify that you are using the proper case.
  • Earlier rule criteria was met. Verify that the rules are in proper order.
  • Verify that the rule is enabled. If the rule has a schedule associated with it, the schedule is enabled and active during the time in question.
Expected User and Server Data statistics are not being produced. Unlike other configuration data, the Metadata Type Mapping for User Data and Server Data are stored in the database, rather than in the local IBM Sterling Control Center Monitor configuration. If you switched to a new database or reinitialized the existing database during upgrading or for any other reason, the Metadata Type Mapping values were lost.
No WS_FTP statistics or events are being produced even though no errors occurred during installation of the WS_FTP agent. There are no obvious configuration errors in IBM Sterling Control Center Monitor. Verify that the name of the directory where you installed the IBM Sterling Control Center Monitor FTP agent does not contain any blanks. If it does, reinstall the agent and make sure that the name of the new directory does not contain any blanks.
The IBM Sterling Control Center Monitor engine shutdown unexpectedly. When an SQL exception occurs within the IBM Sterling Control Center Monitor engine that is not a truncation or duplication exception, IBM Sterling Control Center Monitor sends out a notification message CJDB026E. It then shuts down IBM Sterling Control Center Monitor.

If you want to send a notification that IBM Sterling Control Center Monitor shutdown, create a rule that identifies this error message and sends a notification.

A driver exception occurred. When a driver exception occurs, IBM Sterling Control Center Monitor sends out a CJDB013E or CLI025E message.
Cannot find the IBM Sterling Control Center Monitor Engine log file to identify an installation issue. The IBM Sterling Control Center Monitor Engine log file is in the log directory under the IBM Sterling Control Center Monitor engine installation directory. The engine log file name starts with CCEngine.
The IBM Sterling Control Center Monitor Engine shuts down while it is running, caused by the shutdown of the database server. Check the IBM Sterling Control Center Monitor engine log file for details.

If the database server was shut down, restart the database server and restart the IBM Sterling Control Center Monitor engine.

When using the Microsoft SQL Server, IBM Sterling Control Center Monitor creates too many connections on the SQL Server.

This can be caused by IBM Sterling Control Center Monitor using the JDBC connection pooling mechanism, which maintains a fixed number of connections with the SQL server or by using statement pooling which reuses the same JDBC connection with many different SQL Statements.

For more details refer the following link: PRB: Unexpected Connections to SQL Server with JDBC.

If you want to reduce the Connection Pool Size:
  • Stop the IBM Sterling Control Center Monitor engine.
  • From the IBM Sterling Control Center Monitor engine installation location, edit the following lines in the installation directory/conf/services/system/JDBCService.xml file and change the values to the number that you want:

<maxpool>50</maxpool>

<maxconn>100</maxconn>

<initsize>16</initsize>

Important: Setting the value of any of these fields to less than 16 severely impacts the performance of the IBM Sterling Control Center Monitor engine.
  • Save the modified file.
  • Restart the IBM Sterling Control Center Monitor engine.
Cannot log on when trying to manage a Sterling Connect:Direct® for i5/OS server where the correct user ID and password are provided. The following error is displayed in the log file:
ERROR CDTask - javax.security.auth.login.
FailedLoginException: 
com.sterlingcommerce.component. 
persistence.PersistenceException: 
java.sql.SQLException: [SQL0204] 
INITPARMS in <Library name> type 
*FILE not found. 
Fix the invalid library name specified for server connection properties.
Cannot start the engine due to a system server group naming conflict. The following error is displayed in the console and the log file:
CGRP034E Server group IDs found with matching 
system server Group IDs. Edit 
conf\servergroups\systemGroups.properties 
and change these names: {0}.
Edit the systemGroups.properties in Web console. Click Menu button () > System Settings > Properties > systemGroups.properties.
A node receives a log in failed message, and the node is shunned until the node service is recycled. Recycle the node by pausing and resuming the node or by changing information in the node properties.
When you have IBM Sterling Control Center Monitor to monitor a Sterling Connect:Direct for UNIX server, it might be displayed in the Secure+ Node list but cause retrievability errors in IBM Sterling Control Center Monitor. Check the Sterling Connect:Direct for UNIX server and make sure that the Secure Plus (Secure+) component is installed.
The test connection for a Sterling Connect:Direct server does not match the server list page status in the IBM Sterling Control Center Monitor web console, and the Sterling Connect:Direct server is secured with certificate authentication. Check to ensure that the certificates for all of your event processors are set properly.
When you generate reports, you might receive messages similar to the following one, which indicates that the report query times out:
INFO  RecoverableDAO - Retrying for another time to execute query
You might also find the following log in the Engine.log file:
SQL Exception msg : The query has timed out.

In the JDBCService.xml file under the CC_installation_directory/conf/services/system directory, modify the value of the dbTimeout parameter. 600 is default value, which means the query times out in every 10 minutes.

Increase the following value until you no longer see the timeout message:
<dbTimeout>600</dbTimeout>