Note: The eTrace log and the eRoom performance log
are only collected if you have previously configured and enabled these
utilities using the Server Tuning dialog box.This section explains the following diagnostic and troubleshooting tools:
eRoom tracing (eTrace) enables you to retrieve several levels of detail on numerous aspects of eRoom 7 performance. For information on configuring eRoom tracing, refer to eRoom Server Tuning.
The Heartbeat utility is a client-side utility, which you can install on any client machine using the instructions provided below. The Diagnostic Service, Diagnostic Report, and Checker utilities are available within the eRoom MMC snap-in; to access these utilities, select the eRoom Server folder and right click to bring up a menu containing the utilities.
The eRoom Heartbeat utility is a Windows MMC snap-in that you can install on any computer and use to remotely monitor an eRoom server. The default Heartbeat test attempts to open every facility and every eRoom. If it is successful, the test passes; otherwise, it fails. Using VBScript and eRoom’s Server Access API (SAAPI), you can also create custom Heartbeat tests.
In order to use the Heartbeat utility to monitor a server, you must enable Heartbeat monitoring on the server.
To enable Heartbeat monitoring:
On the eRoom 7 server that you want to monitor, pick Start > Programs > eRoom Server > eRoom Server Administration.
The eRoom MMC snap-in (ERSAdmin) opens.
Open the eRoom Folder.
Double-click "Site Settings".
The General tab of eRoom Site Settings opens.
In the Options section, select the "Allow heartbeat monitoring" check box.
Click "Apply".
The eRoom Heartbeat utility is a separate download that is not installed with the eRoom server. Consequently, you must install the Heartbeat utility separately. Perform the following procedure on the eRoom 7 client machine you want to use for remotely monitoring an eRoom server.
Download the Heartbeat utility from the Documentum site and launch it.
Follow the prompts to install the utility.
Perform the following procedure on the eRoom client machine on which you have installed the Heartbeat utility.
From the Windows Start menu, choose Programs > eRoom 7 Heartbeat > eRoom Heartbeat Administration.
The eRoom Heartbeat Console opens.
Right-click the eRoom Heartbeat folder.
From the pop-up menu, choose New > Job.
The New Heartbeat Job dialog box opens.
For the default test, specify a Job Name, Interval, Protocol, and Server Name.
If necessary, specify a non-default Port Number, Test Name, or Query String Parameters.
This step is unnecessary for a default test. It is only necessary if you are using a non-default port or a customized test, or if you need to specify query string parameters.
To test the configuration, click Test URL.
A message box indicates whether the test passed or failed.
Click "OK".
Once you have installed and configured the Heartbeat utility on a remote client machine, you can easily use it to check a server’s status.
On the Windows Start menu, choose Programs > eRoom 7 Heartbeat > eRoom Heartbeat Administration.
The eRoom Heartbeat Console opens.
In the row for the test job you want to monitor, look at the Last Run Status column to see the last recorded results.
Alternatively, to run the test immediately, right-click the test job.
From the pop-up menu, choose All Tasks > Test Now.
The test results appear in the Last Run Status column.
You can record Heartbeat test results to a log file. A new file for the next day's results is created at daily, at midnight.
From the Windows Start menu, choose Programs > eRoom 7 Heartbeat > eRoom Heartbeat Administration.
The eRoom Heartbeat Console opens.
Right-click the eRoom Heartbeat node.
From the pop-up menu, choose Properties.
The eRoom Heartbeat Properties dialog box opens.
Select the "Log Enabled" check box.
For File Directory, specify a writable directory for the log file.
File Prefix, specify a prefix for the log file.
The filename of the generated log will consist of the prefix you specified, the current date, and a .log extension. (For example, hb050802.log). The file is placed in the directory you specified.
The Heartbeat utility can generate performance counter information, which can be used by such monitoring tools as the Windows Performance Monitor. The Heartbeat utility uses a performance object called eRoom Heartbeat. There are four performance counters you can use:
Number of requests -- the total number of Heartbeat requests made by a Heartbeat job.
Last Status -- the status code that was returned by the last Heartbeat request. (See table below.)
Number of errors -- the total number of failed Heartbeat requests.
Last Request Elapsed Time -- the time (in milliseconds) required to receive a response from the last Heartbeat request.
There is one instance of each performance counter for each defined Heartbeat job; the names of the instances are the same as the names of the jobs. There is also an instance called "_Total", which is an aggregated count for all of the jobs.
The status codes that the Last Status performance counter can return are as follows:
|
Code |
Value |
|
0 |
Success |
|
1 |
Timeout |
|
2 |
Authentication failure |
|
3 |
Test failed |
|
4 |
Test disabled |
|
5 |
Invalid URL |
|
6 |
Name not resolved |
|
7 |
Incorrect username |
|
8 |
Incorrect password |
|
9 |
Login failure |
|
10 |
Cannot connect to server |
|
11 |
Client certificate needed |
|
12 |
Invalid CA |
|
13 |
Client authentication not set up |
|
14 |
Asynchronous thread failed |
|
15 |
TCP/IP not installed |
|
16 |
Internet disconnected |
|
17 |
Server unreachable |
|
18 |
Proxy server unreachable |
|
19 |
Bad auto proxy script |
|
20 |
Invalid certificate |
|
21 |
Certificate revoked |
|
22 |
Connection timeout |
|
23 |
Invalid server response |
|
24 |
Denied |
|
25 |
Server error |
|
26 |
Not found |
|
27 |
Not supported |
|
28 |
Bad request |
|
29 |
Forbidden |
|
30 |
Bad method |
|
31 |
None acceptable |
|
32 |
Proxy Authentication request |
|
33 |
Request timeout |
|
34 |
Conflict |
|
35 |
Gone |
|
36 |
Length required |
|
37 |
Request too large |
|
38 |
Pre-condition failed |
|
39 |
Version not supplied |
|
40 |
Gateway timeout |
|
41 |
Unknown error |
The eRoom Diagnostic Report collects several types of diagnostic information and places it in a .zip file that you can specify. Pick any number of the following types of diagnostic information for including in the .zip file:
System configuration report
IIS Log
NT event log
User dump
eRoom server configuration report
eTrace log
eRoom performance log
eRoom heartbeat log
eRoom server install log
Note: The eTrace log and the eRoom performance log
are only collected if you have previously configured and enabled these
utilities using the Server Tuning dialog box.
In the event of a server failure, you can run the eRoom Diagnostic Report to collect all the information eRoom Support might request surrounding the incident. Note that the collection of all diagnostics (especially Userdumps) may take several minutes (0-40 minutes). However, all information is necessary in the event of a server outage.
From the Windows Start
menu, choose Programs > eRoom Server
> eRoom Server Administration.
The eRoom MMC snap-in opens.
Open the eRoom folder.
Right-click the eRoom server machine.
From the pop-up menu,
pick Diagnostic Report.
The eRoom Diagnostic Report dialog box opens, and the date and
time are filled in automatically.
Describe the incident with as much detail as possible.
Select the types of data files you want included.
For outages, leave all check boxes selected.
Click "OK".
Specify a filename and directory for the output .zip file.
If the web server is
not responding, you will need to reboot after running the report.
The diagnostic service will restart when the server is rebooted.
Each time the report runs in a given day, it will capture all Performance Monitor logs for that day. After running the report, you should delete the eTrace and Performance Monitor logs (after confirming they were zipped and captured). This way, each time the report runs, it will capture only the eTrace and Performance Monitor logs that were captured since the last time the service restarted.
The eRoom Checker tool is installed with eRoom and checks the following:
Server software configuration
General site consistency and file permissions
Site database
Facility databases
Use the following procedure to configure and run eRoom Checker.
From the Windows Start menu, choose Programs > eRoom Server > eRoom Server Administration.
The ERSAdmin window opens.
Open the eRoom folder and right click on the eRoom server you would like to check.
Choose “eRoom Checker”.
The eRoom MMC snap-in opens.
Specify what you want to check and a policy for handling any errors the checker might find.
Click Start.
The Checker process runs. When it completes, Errors and a Full Report appear in the dialog box.
The Checker executable resides in the …\Program Files\eRoom\eRoom Server directory. In most cases, it is unnecessary to run the eRoom Checker from a command line. However, if you have SQL Anywhere, running the erchecker/r all command from an operating system window in the eRoom Server directory can repair SQL Anywhere log files for facilities and databases. To see a listing of all available command line arguments, use the erchecker/? command.
eRoom 7 contains a site database backup and recovery feature. This feature is not intended to replace normal backup procedures, but it can provide a means of easily restoring a lost eRoom 7 site. The backup and recovery feature makes regular, automated backups of the site database. This feature is enabled by default.
To disable or enable site recovery:
On the Scheduler page of Site Settings, clear or select the "Enable site recovery" check box in the Nightly tasks table. (If there is more than one eRoom server, the site recovery check box appears only in the row for the primary eRoom server.)
Click "Apply".
When site recovery task is enabled, a nightly job creates (or replaces) a file called SiteBackup.bak containing the Members, Groups & Communities tables in the site database. This file is placed on the eRoom file server that stores facility templates and extensions. Failed backup attempts are listed in the Event Viewer.
To recover a site database from a site backup file:
From a command line,
run the Checker with the recover switch:
erchecker -recover
The Checker dialog appears
with a "Restore Site" button.
Click Restore
Site.
Using the file browser dialog, locate the SiteBackup.bak file.
Click OK.
Confirm the site restoration.
Automatically created by eRoom, the eRoomerrors.log file records any errors generated by the eRoom 7 server. When this file is created, it is placed in the eRoom Data directory location you specified when installing eRoom 7. This file can be sent to eRoom Support when you encounter problems that need troubleshooting.