Server Processes Diagnostics

Problem with server processes are reported in server messages.
Table 1. Server Processes Diagnostics

Diagnostic

Description

Server Startup

Message: <app_name> with PID (<app_pid>) reported a problem starting the iCDB Server for project <project_path>. Please check the iCDB client log files in the client WDIR directory for detailed information.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the server cannot start.

Server Shutdown

Message: The last iCDB Server session <icdb_session_info> for project <project_path> shutdown unexpectedly. Please check the log files in <server_log_dir_path> and in the iCDB server WDIR directory on <server_address> machine for more information or contact Mentor Graphics Customer Support.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the Server shuts down unexpectedly.

Server Unreachable

Message: The iCDB Server (<server_address>) for project <project_path> could not be reached. Please ensure the iCDB Server at location <server_address> is running and you have access to it.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the client cannot connect to the server.

Database Integrity

Message: Error encountered reading the iCDB database for project <project_path>. Please check the log files in <server_log_dir_path> for detailed information and contact Mentor Graphics Customer Support.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the database is possibly corrupt.

Server Plug in Error

Message: The iCDB Server for project <project_path> was not started because the plugin <plugin_name> could not be loaded. Please check the log files in <server_log_dir_path> for more information and contact your system administrator for advice.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the iCDB Server cannot start because a plugin cannot be loaded. This can happen if environment variables are broken (wrong SDD_HOME, or SDD_PLATFORM) or if it cannot find libraries.

Auto Backup Error

Message: The iCDB Server (<server_address>) for project <project_path> could not create a database backup in <backup_path>. Please check the log files in <server_log_dir_path> for more information and contact your systems administrator for advice.

Issue Type: Error

Configuration File: None

Keys: None

Description: Reports when the iCDB Server cannot create an auto backup. This can happen if the client has access to the autobackup directory but the iCDB Server does not.

Detect Defunct Client

Message: The iCDB Server (<server_address>) for project <project_path> has <dead_clients_count> defunct clients connected: <dead_clients>. The iCDB Server will shut down after <server_shut_down_elapsed_time>. You may use Server Manager to shut it down manually.

Issue Type: Warning

Configuration File: None

Keys: None

Description: Reports when the iCDB Server detects dead clients. A dead client is a client that gets disconnected from the iCDB Server (for example because of network problems).

All dead clients are kept on a list of dead/defunct clients for defined time: by default 10 minutes (600 seconds). Change this time with the ClientOffline_Sec key in the Server.cfg configuration file. If the connection is available before it times out, the iCDB Server sets this client to online-mode. If the only client connected to an iCDB Server is a dead client, the server does not stop.

Server Memory

Messages:

  • Warning: The iCDB Server (<server_address>) for project <project_path> is using <memory_usage_bytes> bytes of memory. Performance may be affected by this high memory usage. If you see this message frequently you may need to add additional system memory on the machine running the iCDB Server.

  • Note: The iCDB Server (<server_address>) for project <project_path> is using <memory_usage_bytes> bytes of memory. Normal operation has been restored.

Issue Type: Warning or Note.

Configuration File: Server.cfg (On the machine running iCDBNetServer)

Keys:

WarningFactor (Default = 85)

CheckInterval_MSec (Default = 1000)

StableMargin_Percentage (Default = 10)

Description: iCDB Server issues this warning if its memory used is greater than the percentage specified by WarningFactor. A standard deviation filter to discard extreme peaks and valleys operates similarly to the one described in Connection speed to iCDB Server diagnostic.

Server log file size

Message: There are more than <log_files_size> MB of log files in project <project_path>. Please consider archiving the log files for better performance.

Issue Type: Warning

Configuration File: Server.cfg (On the machine running iCDBNetServer)

Keys: LogFilesWarningSize_MB (Default = 20)

Description: Reports when the server log files are greater than LogFilesWarningSize_MB.

Database rollback size

Message: There are <backup_snapshots_number> Designer rollback points in project <project_path>. Please consider removing some of them for better performance.

Issue Type: Warning

Configuration File: Server.cfg

Keys: DBSavepointWarningNumber (Default=200)

Description: Reports when the number of savepoints (backups of sheets/ICTs with Designer: File > Backup) exceeds the threshold specified in the configuration file.