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. |
|
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:
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:
|
Rules produce no results. |
|
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:
<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.
|
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:
|
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:
|
Edit the systemGroups.properties in Web console. Click . |
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 queryYou 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:
|