Error messages and other information about GWIA functioning are written to log files and can be displayed in the GWIA console. Log files can provide a wealth of information for resolving problems with GWIA functioning or message flow. This section covers the following subjects to help you get the most from GWIA log files:
The default location of the GWIA log files varies by platform:
|
Linux: |
/var/log/novell/groupwise/gwia.domain |
|
Windows: |
domain\wpgate\gwia\000.prc |
You can change the location where the GWIA creates its log files in the GroupWise Admin console and the GWIA configuration file (gwia.cfg).
When installing or troubleshooting the GWIA, a logging level of Verbose can be useful. However, when the GWIA is running smoothly, you can set the logging level down to Normal to conserve disk space occupied by log files.
In the GroupWise Admin console, browse to and click the GWIA.
Click the GroupWise tab, then click Log Settings.
Set the desired settings for logging.
Log File Path: Browse to and select the folder where you want this GWIA to store its log files.
Logging Level: Select the amount of data displayed on the GWIA agent console and written to the GWIA log file.
Off: Turns off disk logging and sets the logging level for the GWIA to its default. Logging information is still displayed on the GWIA agent console.
Normal: Displays only the essential information suitable for a smoothly running GWIA.
Verbose: Displays the essential information, plus additional information that can be helpful for troubleshooting.
Diagnostic: Turns on Extensive Logging Options and SOAP Logging Options on the GWIA console Log Settings page.
Maximum Log File Age: Specifies how many days to keep GWIA log files on disk. The default is 30 days.
Maximum Log Disk Space: Sets the maximum amount of disk space for all GWIA log files. When the specified disk space is consumed, the GWIA deletes existing log files, starting with the oldest. The default is 100 MB. The maximum allowable setting is 1000 MB (1 GB).
Corresponding Startup Switches: You can also use the ‑‑log, ‑‑loglevel, ‑‑logdays, and ‑‑logmax switches in the GWIA startup file to configure logging.
You can view the contents of the GWIA log file in the GWIA console.
In the GWIA console, click Log Files.
To view a log file, select the log file, then click View Events.
To search for a specific string, select the log files to search, specify the string in the Events Containing field, then click View Events.
HINT:To search all log files, select Select All.
To create a new log file, click Cycle Log.