File Access Diagnostics

The connection time between the client and file server might differ from the connection time between the iCDB Server and file server even if the client and iCDB Server are on the same machine. This is because the default thresholds that trigger a warning or error differ between the two diagnostics.

Please note the default thresholds for each diagnostic.

Table 1. File Access Diagnostics
Diagnostic	Description

File server off-line Message: The connection to the file server has been lost. Work on project <project_path> may not be possible.	Issue Type: Error Configuration File: None Keys: None Description: Reports when the client loses the connection to the File Server.
File server on-line Message: The connection to the file server 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 connection to the File Server is restored.
Connection speed to File Server Messages: Error: The connection to the file server for project <project_path> is extremely slow. It takes <access_time> to access it. You will experience degraded performance if you continue to work. You may also experience problems with connecting to iCDB Server. If the condition persists contact your IT department for advice. Warning: The connection to the file server for project <project_path> is slow. It takes <access_time> seconds to access it. You may experience performance issues. Note: Optimal access time to the file server for project <project_path> has been restored. It takes <access_time> to access it.	Issue Type: Error, Warning, or Note, depending on actual measured connection speed. Configuration File: ServerMonitor.cfg Keys: SlowAccessTime_USec (Default = 100000) CriticalAccessTime_USec (Default = 200000) SlowAccessFactor (Default = 10) CriticalAccessFactor (Default = 100) CheckInterval_MSec (Default = 1000) StableMargin_Percentage (Server.cfg: FilerAccessMonitor section: Default = 20) AbsoluteRating (Default = yes) Relative Rating (Default = no) Description: The client performs a “file stat” command to the File Server at intervals of CheckInterval_MSec. A standard deviation filter to discard extreme peaks and valleys operates similarly to the one described in Connection speed to iCDB Server diagnostic. Two benchmarks and threshold calculations are available. Absolute Rating and Relative Rating. Absolute Rating is on by default. (AbsoluteRating = yes) The average is based on measures of the absolute access time to the iCDB database folder. This means it can be affected by current system/network load. If the average is above SlowAccessTime_USec, the warning is given. If the average is above CriticalAccessTime_USec, the error is given. Relative Rating is off by default. (RelativeRating = no) The average is based on the ratio of (Access Time to iCDB Database Folder) to (Access Time to a Temporary Folder on Local Disk). This is more immune to current system load. If the average is above SlowAccessFactor, the warning is given. If the average is above CriticalAccessFactor, the error is given. If both AbsoluteRating and RelativeRating are set to “yes” then an error or warning is given if either measure is greater than the specified threshold.
iCDB server connection speed to project filer Messages: Error: The iCDB Server (<server_address>) for project <project_path> is experiencing degraded performance due slow file server access. It takes <access_time> to access the file server. You will experience degraded performance if you continue to work. You may also experience problems with connecting to iCDB Server. If the condition persists contact your IT department for advice. Warning: The iCDB Server (<server_address>) for project <project_path> is experiencing poor performance due to slow file server access. It takes <access_time> to access the file server. You may experience performance issues if you continue to work. Note: The iCDB Server (<server_address>) for project <project_path> has optimal access time to the file server. It takes <access_time> to access the file server.	Issue Type: Error, Warning, or Note, depending on actual measured connection speed. Configuration File: Server.cfg (On the machine running iCDBNetServer) Keys: SlowAccessTime_USec (Default = 10000) CriticalAccessTime_USec (Default = 30000) SlowAccessFactor (Default = 10) CriticalAccessFactor (Default = 100) CheckInterval_MSec (Default = 1000) StableMargin_Percentage (Server.cfg: FilerAccessMonitor section: Default = 20) AbsoluteRating (Default = yes) Relative Rating (Default = no) Description: The iCDB Server performs a “file stat” command to the File Server at intervals of CheckInterval_MSec. A standard deviation filter to discard extreme peaks and valleys operates similarly to the one described in Connection speed to iCDB Server diagnostic. Two benchmarks and threshold calculations are available. Absolute Rating and Relative Rating. Absolute Rating is on by default. (AbsoluteRating = yes) The average is based on measures of the absolute access time to the iCDB database folder. This means it can be affected by current system/network load. If the average is above SlowAccessTime_USec, the warning is given. If the average is above CriticalAccessTime_USec, the error is given. Relative Rating is off by default. (RelativeRating = no) The average is based on the ratio of (Access Time to iCDB Database Folder) to (Access Time to a Temporary Folder on Local Disk). This is more immune to current system load. If the average is above SlowAccessFactor, the warning is given. If the average is above CriticalAccessFactor, the error is given. If both AbsoluteRating and RelativeRating are set to “yes” then an error or warning is given if either measure is greater than the specified threshold.
Broken connection between iCDB and File Server Message: The iCDB Server (<server_address>) for project <project_path> has lost the connection to the file server. It may be impossible to continue working on this project.	Issue Type: Error Configuration File: None Keys: None Description: Reports when the server loses connection to the File Server.