4.3 Reporting and Monitoring Administration Console

Using an administrative browser, enter the following URL and sign in as a Retain administrative user.

Path: http://reporting-and-monitoring-server-IP-or-DNS/RetainStatsServer

NOTE:You can also access the R&M server from the Retain administration interface by clicking either the Reporting or Monitoring links in the left navigation panel.

From the R&M console, you can access the following:

4.3.1 Home Tab

The Reporting and Monitoring Home tab/page lists current archive activity on the associated Retain server. It also includes the following subpanels.

Table 4-2 Using the Reporting and Monitoring Server Home Page

Field, Option, or Button

Information and/or Action

Language Drop-down

  • Use this to select or change the UI display language.

Top Navigation Bar

Refresh button

  1. Click this to refresh the details displayed.

Jobs list

This lists all of the jobs in your Retain system along with their associated workers, profiles, schedules, and last-reported run times.

You can

  • Sort the list by clicking any of the column headings.

  • Click a finished Job run to display

    • A Job History report.

    • Details of the selected job

    • A Mailbox Summary Report.

  • In the Job History report you can also drill down into mailbox errors for a given job run.

Job History Panel

Path: Retain Reporting and Monitoring Server > Home > select a listed Job

Table 4-3 Using the Job History Panel

Field, Option, or Button

Information and/or Action

List of Job runs

  • Job Name: Name that you assigned to the job.

  • Job Run ID: Internal ID assigned to job run.

  • Status: Current job status.

  • Messages Processed: Number of messages processed by the job.

  • Archived Messages: Number of messages archived by the job.

  • Speed (Messages/sec): How many messages the job processed per second.

  • Errors: Number of errors encountered on each job run.

    The number links to en error summary panel with more information about each error, such as severity, how many mailboxes had the error, and how many times it occurred during the job run selected.

  • Warnings: Number of warnings generated during the job.

  • Start Time: Date and time that the job started.

  • End Time: Date and time that the job ended.

  • Duration (hh:mm:ss): How long the job run lasted.

Job Details Panel

Path: Retain Reporting and Monitoring Server > Home > select a listed Job > select a Job Run ID— the Job Details panel for the selected run displays directly below the Job History panel.

Table 4-4 Using the Job Details Panel

Field, Option, or Button

Information and/or Action

Job Detail Items

  • Job Name: Name that you assigned to the job.

  • Status: State of the job run.

  • Worker: Worker that is running or that ran the job.

  • Duration (hh:mm:ss): How long the job has been running or if completed, how long it ran.

  • Start Time: Date and time that the job started.

  • End Time: Date and time that the job ended.

  • Mailboxes Processed: Total number of mailboxes processed during the run.

  • Archived Messages: Total number of messages archived during the run.

  • Messages Processed: Total number of messages that the job processed during this run.

  • Message Data Stored: Size of the message data that the job stored during this run.

  • Last PO Scanned: Last Post Office scanned during the job run.

  • Last Mailbox Scanned: Last mailbox scanned during the job run.

  • Errors: Number of errors encountered during the job run.

  • Last Error: Last error message recorded during the job run.

Job Mailbox Summary Panel

Path: Retain Reporting and Monitoring Server > Home > select a listed Job > select a Job Run ID— the Job Mailbox Summary panel for the selected run displays directly below the Job Details panel.

Table 4-5 Using the Job Mailbox Summary Panel

Field, Option, or Button

Information and/or Action

Mailbox Summary Columns

  • Mailbox: Mailbox UserID and post office name.

  • Messages Processed: Number of messages processed from this mailbox during the job run.

  • Archived Messages: Number of messages archived from this mailbox during the run.

  • Errors: Number of errors encountered on the mailbox during the job run.

  • Warnings: Number of warnings encountered on the mailbox during the job run.

  • Advanced Date Flags: Date flags encountered for the mailbox during the job run.

  • Start Time: Date and time the mailbox processing started.

  • End Time: Date and time the mailbox processing ended.

  • Duration: How long it took to process the mailbox.

4.3.2 Reports, Scheduled Reports, and Manage Scheduled Reports Drop-down Lists

Path: Retain Reporting and Monitoring Server > Report or Schedule Report or Manage Scheduled Reports

For information and usage instructions for these drop-down reports and tasks, see the following sections:

4.3.3 System Monitor Tab

Path: Retain Reporting and Monitoring Server > System Monitor Tab

The System Monitor page shows the following:

  • Report Generation Count: The total number of reports that have been generated on the system, by type.

  • Archiving Progress: Two calculation methods are reflected in these numbers.

    • Messages Archived: These numbers for the previous day, week, and month, include only the primary or initial messages themselves. Attached and child messages that are associated with the primary message threads, are not counted.

    • Total Messages Stored: This number includes all messages. In other words, it reflects all initial messages and all of the attached and child messages associated with them.

  • Last Recorded CPU Usage: This is the latest measured System CPU load recorded.

  • Memory Map: This pie chart focuses on memory usage by various Java-associated processes that support Retain functionality.

  • Disk Usage: This reports the disk space consumed by Retain’s data index.

  • Single-Instance Storage Usage: This compares the disk space actually used by archived messages against what would have been used if messages sent to multiple mailboxes had been archived separately for each mailbox.

    Retain’s single-instance storage system archives message data only once and links the archived data to the mailboxes that received the messages.

NOTE:If there is a problem gathering system-level information, the CPU, RAM, and system memory usage are set to 0 until the issue is resolved.

4.3.4 Mailbox Error Monitoring Tab

Path: Retain Reporting and Monitoring Server > Mailbox Error Monitoring Tab

Table 4-6 Using the Mailbox Error Monitoring Page

Field, Option, or Button

Information and/or Action

Mailbox(es) with errors

  • Mailbox

Mailbox name

  • Errors

A number that links to error information for the mailbox.

  1. Access the errors for a given mailbox by clicking the error number.

    The Error Summary for Mailbox [mailboxName] list displays.

    Each line includes:

    • A description of the error and its error code

    • The path to the folder the message was found in

    • The message’s subject, sender, attachment that the error occurred on, and the delivered date.

  2. If the message is accessible from the user's client, save the message from the client. Then import the message into Retain using the PST Importer or GroupWise Personal Archive Migrator.

  3. To skip messages the next time the job runs,

    1. Select individual messages or use the title bar checkbox to select all.

    2. Then click the Skip Errors button.

      The message is not reported in future job runs.

NOTE:This page is also accessible through the Retain Admin Console> Overview > Mailbox Error Monitoring

4.3.5 Maintenance Tab

The R&M server refreshes itself automatically each morning at 2 a.m. by expiring and deleting statistical data that is older than 14 days.

Use this dialog if you need to manually purge older data.

Path: Retain Reporting and Monitoring Server > Maintenance Tab

  • Retain Server link: Click this to open the Retain administrative console.

    In the administrative console, you can adjust the data retention period setting by accessing the Reporting and Monitoring configuration page. Micro Focus recommends not retaining statistical data longer than 30 days.

  • Remove old statistical data now: Use this button to remove statistical data that is older than the number of days indicated, immediately rather than at 2 a.m.

  • Synchronize address book cache now: Use this button if you need to ensure that the R&M server’s address book is synchronized with the Retain server’s address book. (They are automatically synchronized every 24 hours, but they can get out of sync in the interim.)

  • Synchronize jobs cache now: Use this button if you need to ensure that the R&M server’s job cache is synchronized with the Retain server’s address book. (They are automatically synchronized every 24 hours, but they can get out of sync in the interim.)

  • Active job run maintenance: Use this button to clear the current job status, for example when a job has completed but the R&M server shows it as is still running.