Home
Administering
This documentation provides information about the administration tools for managing and monitoring servers and databases.
Monitoring servers
This section describes how to use the tools and features that help you monitor a Domino® system.
Monitoring the Domino® system
You can monitor system activity and platform use using the Domino® Administrator or the server console.
Customizing the Domino® server and administrator console
By creating a Server Console configuration document for the server you are monitoring, you can specify the text, background, and color attributes that the Domino® server console uses to display monitoring information. By default, the Domino Administrator server console uses the same attributes, but you can override the defaults and customize the appearance of the Domino Administrator server console.
Using the Domino® Administrator server console to monitor events
When you use the Domino® Administrator server console to monitor events, you can set a stop trigger for an event. The stop trigger causes the console to pause and display only the event and the next 10 lines of console text when the event occurs.

Administering
This documentation provides information about the administration tools for managing and monitoring servers and databases.
- Administration tools
  Topics in this section describe the tools you can use to administer a Domino® server.
- Managing users
  The Administration Process helps you manage users by automating many of the associated administrative tasks. For example, if you rename a user, the Administration Process automates changing the name throughout databases in the Notes® domain by generating and carrying out a series of requests, which are posted in the Administration Requests database.
- Monitoring servers
  This section describes how to use the tools and features that help you monitor a Domino® system.
  - Monitoring the Domino® system
    You can monitor system activity and platform use using the Domino® Administrator or the server console.
    - Monitoring Configuration application (EVENTS4.NSF)
      The Monitoring Configuration application includes a configuration user interface for use with Domino® Domain Monitoring (DDM). Use this interface to set up DDM probes and a collection hierarchy of servers that collect information from other servers.
    - Monitoring server shutdown
      Domino's Shutdown Monitor task ensures that Domino® terminates when requested to do so, that is, the server does not hang while attempting to shut down.
    - Monitoring processes running in the Domino® server environment
      Domino's "Process Monitor" task applies to Domino® on Microsoft™ Windows™ platforms only. This task monitors the processes that should be running as part of the Domino server environment.
    - Monitoring events on the Domino® system
      Events signal both that the system is working smoothly, processing data, and performing tasks; or that the system is malfunctioning, perhaps by not processing data or performing required tasks.
    - Event generators
      Event generators gather information by monitoring a task or a statistic or by probing a server for access or connectivity. Each event generator has a specified threshold or condition, which, when met, causes an event to be created The event is passed to the Event Monitor task, which checks whether an associated event handler has been defined. If an event handler has not been defined, the Event Monitor task does nothing. If an event handler has been defined, the Event Monitor carries out the instructions in the event handler. The Event Monitor task, formerly know as the Event task, starts automatically when you start the server and must run on all servers that you want to monitor.
    - Monitoring iNotes® activity
      You can determine the number of active HCL iNotes® users on a system and log iNotes request information. To monitor this activity, set up activity logging to include iNotes.
    - Event handlers
      An event handler defines the action that Domino® takes when a specific event occurs.
    - Viewing an event report
      The Monitoring Results database (STATREP.NSF) stores statistic and event information, depending on how you configured the Statistic Collector server task and event handler documents. For each event, a report records the server that originated the event; the time, severity, type and error code of the event; and a brief description of the event.
    - Viewing event messages, causes, and solutions
      Each event that occurs on the Domino® system has an associated event message that is stored in the Monitoring Configuration database (EVENTS4.NSF). The message text often provides information about possible causes and solutions.
    - Customizing the Domino® server and administrator console
      By creating a Server Console configuration document for the server you are monitoring, you can specify the text, background, and color attributes that the Domino® server console uses to display monitoring information. By default, the Domino Administrator server console uses the same attributes, but you can override the defaults and customize the appearance of the Domino Administrator server console.
      - Using the Domino® Administrator server console to monitor events
        When you use the Domino® Administrator server console to monitor events, you can set a stop trigger for an event. The stop trigger causes the console to pause and display only the event and the next 10 lines of console text when the event occurs.
    - Monitoring system statistics
      Domino® continuously generates and updates server statistics, which you can collect and monitor in a number of ways. From the server, you can use the Show Statistic or Show Platform Statistic commands. From the Domino Administrator, you can create statistics profiles and charts.
    - Platform statistics
      In addition to tracking server statistics, Domino® tracks operating-system performance statistics. You can view these statistics from the Domino Administrator, along with your Domino statistics, which helps you with Domino server monitoring and tuning. You can include platform statistics in any statistic monitoring task you perform with the Domino statistics, including using them in monitoring and statistic profiles, and charting them.
    - Using the Domino® Administrator to monitor statistics
      Using the Domino® Administrator, you can create a statistic profile that you use to monitor the same set of statistics periodically or to compare performance on different servers.
    - Using mail-in statistics
      If you can access Notes® mail on a server, you can collect statistics from the server and mail them to yourself. Use mail-in statistics when the Domino® Administrator is not available or you do not have administrator access to a server.
    - Charting statistics
      You can graphically display the statistics generated by Domino®, by creating statistics charts. To chart sets of statistics on a regular basis, you can define statistics profiles. Using statistics charts you can track and visualize statistics in real time or historically. Real-time charts reflect the current server activity. Historical charts pull information from the local Monitoring Results database (STATREP.NSF). You can also create statistic profiles so that you can chart a specified set of statistics routinely.
    - Publishing Domino statistics to external services
      You can set up Domino to publish Domino statistics to an external monitoring service, for example, Hosted Graphite. The service must be able to accept time series data via HTTP POST requests.
  - Server Health Monitor
    You can monitor and troubleshoot performance issues using a number of different tools.
  - Entitlement tracking
    As of Domino 12.0, a new internal mechanism is provided for collecting the highest entitlement that individual users have across a Domino domain. When a user appears in the ACL of a database with Reader access or above and that person has the right to access the server, the user is said to be an entitled user.
  - Domino® domain monitoring (DDM)
    Domino® domain monitoring (DDM) provides one location in the Domino Administrator client that you can use to view the overall status of multiple servers across one or more domains, and then use the information provided by DDM to quickly resolve problems.
  - The Domino® SNMP Agent
    The Domino® SNMP Agent enhances the monitoring and control features of Domino by enabling third-party management stations, which use industry standard SNMP, to manage aspects of the Domino server.
  - Overview of server maintenance
    As a Domino® administrator, a major part of your job is maintaining each server that you administer.
  - Tools for mail monitoring
    Domino® provides three tools that you can use to monitor mail. Message tracking allows you to track specific mail messages to determine if the intended recipients received them. Mail usage reports provide the information you need to resolve mail problems and improve the efficiency of your mail network. Mail probes test and gather statistics on mail routes.
  - Monitoring directory assistance
    You can monitor directory assistance by using Show Xdir command to display information about all the directories a server uses for directory services. You can also view directory assistance statistics.
  - Monitoring databases
    You can monitor database activity, replication, and document deletions.
  - Monitoring a cluster
    Domino® provides several ways to find out what is happening in a cluster and make adjustments to keep the cluster running smoothly and efficiently, so that no server is overloaded. You can monitor failover, workload balancing, and cluster replication to see how efficiently the cluster is running.
  - Monitoring slow or unresponsive servers with the Domino® Diagnostic Probe
    Use the Domino® Diagnostic Probe (DDP), a Java™ utility provided by Support, to monitor servers that have been intermittently slow or unresponsive. The probe is a Java process (dbopen.jar) that runs in the background. The utility probes a specific Domino server over time by invoking database open transactions. If the probe detects a slow response, it will invoke Notes® System Diagnostic (NSD) to gather diagnostic data. This data is used by Support to troubleshoot and determine the cause or causes of the performance degradation.
  - Monitoring quality of service
    Quality of Service, or QoS, is designed to react to the general operation of a Domino® server in order to keep that server functioning reliably and always available. If QoS detects that a server is not responding or hung, QoS probing can be configured to email an administrator about the problem and/or automatically terminate the server and restart it. QoS log information can also be useful for analysis by Support.
  - Understanding Quality of Service (QoS) behavior and logging
    This topic covers details of QoS including server and server controller behavior during kill events, failover trigger, and log file content.
- Managing servers
  Manage Domino® servers by performing any of these tasks.
- Managing databases
  Topics in this section describe how to set up and manage Domino® databases.

Using the Domino® Administrator server console to monitor events

When you use the Domino® Administrator server console to monitor events, you can set a stop trigger for an event. The stop trigger causes the console to pause and display only the event and the next 10 lines of console text when the event occurs.

About this task

In addition, you can retrieve additional information about error messages, including possible causes and solutions, and create event handlers.

To set or remove a stop trigger

About this task

After you troubleshoot the problem for which you set the stop trigger, be sure to remove it.

Procedure

From the Domino® Administrator, click the Server > Status tab.
Open the Server Console view.
Click Pause or Stop to stop the logging of information to the console.
Do one:
- To remove a stop trigger, select Live Console > Local > Remove Stop Trigger.
- To set a stop trigger, select the event for which to set a stop trigger. Then from the menu, select Live Console > Set Watch.
Do one to restart the Domino® Administrator server console:
- If you clicked Pause, click Resume.
- If you clicked Stop, click Live.

To get error information

Procedure

From the Domino® Administrator, click the Server > Status tab.
Open the Server Console view.
Click Pause or Stop to stop the logging of information to the console.
Select the event error message for which you want more information.
Select Live Console > Lookup Error.
Do one to restart the Domino® Administrator server console:
- If you clicked Pause, click Resume.
- If you clicked Stop, click Live.

To create an event handler

Procedure

From the Domino® Administrator, click the Server > Status tab.
Open the Server Console view.
Click Pause or Stop to stop the logging of information to the console.
Select the event for which you want to create an event handler.
Select Live Console > Create Local Event Handler.
If an event handler for the specified event already exists, you are prompted to edit the Event Handler document or create a new one.
Do one to restart the Domino® Administrator server console:
- If you clicked Pause, click Resume.
- If you clicked Stop, click Live.

To start or stop the Domino® Administrator server console

Procedure

From the Domino® Administrator, click the Server > Status tab.
Open the Server Console view.
Click Live to start the console, or click Stop to stop it.