Server Connection Diagnostics

Problems with server connections are reported in iCDB server messages.

Table 1. Server Connection Diagnostics
Diagnostic	Description

Lost connection to iCDB Server Message: The connection to the iCDB Server (<server_address>) for project <project_path> has been lost. You may not be able to continue working until the connection is restored. You will be notified when the connection is restored.	Issue Type: Error Configuration File: None Keys: None Description: Reports when the client loses the connection to the server. Action: When the connection to the project is restored, you must repair and verify the database with Project Backup. See Repairing a Project and Verifying a Backup.
Restored connection to iCDB Server Message: The connection to the iCDB Server (<server_address>) for project <project_path> has been restored after <offline_elapsed_time>. You may safely continue your work.	Issue Type: Note Configuration File: None Keys: None Description: Reports when the client’s connection to the server is restored.
Reloaded Project Message: The project <project_path> has been reloaded. You may continue your work.	Issue Type: Note Configuration File: None Keys: None Description: Reports when the project is reloaded.
Connection speed to iCDB Server Messages: Error: The connection to the iCDB Server (<server_address>) for project <project_path> is extremely slow. It takes <ping_time> for the server to respond. Performance may be degraded whilst working. If the condition persists contact your IT department for advice. Warning: The connection to the iCDB Server (<server_address>) for project <project_path> is slow. It takes <ping_time> for the server to respond. Slow connections to the iCDB Server may cause some operations to take longer than expected. For better performance lower access time is required. Note: Optimal access time to the iCDB Server has been restored. The server responds in <ping_time>.	Issue Type: Error, Warning, or Note, depending on actual measured connection speed. Configuration File: ServerMonitor.cfg Keys: SlowPingTime_USec (Default = 100000) CriticalPingTime_USec (Default = 200000) PingInterval_MSec (Default = 1000) StableMargin_Percentage (Server.cfg: SystemMemoryMonitor section: Default = 10) Description: The client pings the iCDB Server at intervals of PingInterval_MSec. The average delay is calculated over the past 20 pings. If the average is greater than SlowPingTime_USec, then the warning is given. If the average is greater than CriticalPingTime_USec, then the error is given. The standard deviation is also calculated. If the standard deviation is less than or equal to the percentage (relative to the average) specified in StableMargin_Percentage, then the average remains unchanged and the connection is considered stable. If the standard deviation is greater than the StableMargin_Percentage relative to the average, all samples that fall outside one sigma are thrown out and the average is recalculated. However, if more than half the samples fall outside one sigma, the average is not computed because the connection is too unstable. An average is calculated again when the sample is stable.