32.2 Using GWIA Log Files

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:

32.2.1 Locating 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 Administration Console and the GWIA configuration file (gwia.cfg).

32.2.2 Configuring GWIA Log Settings and Switches

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.

  1. In the GroupWise Administration Console, browse to and click the GWIA.

  2. Click the GroupWise tab, and then click Log Settings.

  3. 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 --liveLogging, ‑‑log, ‑‑loglevel, ‑‑logdays, and ‑‑logmax switches in the GWIA startup file to configure logging.

32.2.3 Configuring Log Settings in the GWIA Console

For information about Log Level and Log Maintenance settings, see Configuring Log Settings in the Administration Console. Details for Disk Logging options are provided below.

Disk Logging: Enables logging of GWIA events in the Log Directory.

To configure Disk Logging:

  1. Open the GWIA console, and navigate to Configuration > Log Settings.

  2. Select the desired option:

    • On: Turns on disk logging and sets the logging level for the GWIA to its default of Verbose.

    • Off: Turns off disk logging. Logging information is still displayed in the GWIA console.

    • Live: Turns on live logging.

      You can also use the startup switch to enable live logging. However, you will still need to access the GWIA Console to turn live logging off by changing the toggle option to On or Off.

      For startup switch information, see --liveLogging.

      WARNING:To minimize impact to disk storage and system performance, we recommend that you only use the Live logging option for temporary troubleshooting.

  3. Select log criteria to show from Extensive Logging Options and SOAP Logging Options lists.

  4. Click Submit.

32.2.4 Viewing and Searching Log Files

You can view the contents of the GWIA log file in the GWIA console.

  1. In the GWIA console, click Log Files.

  2. To view a log file, select the log file, and then click View Events.

  3. To search for a specific string, select the log files to search, specify the string in the Events Containing field, and then click View Events.

    HINT:To search all log files, select Select All.

  4. To create a new log file, click Cycle Log.