Home
Administering
This documentation provides information about the administration tools for HCL Domino.
Administering with Domino Administrator
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.
The Administration Process
The Administration Process is a program that automates many routine administrative tasks.
Customizing the Administration Process
You can customize the Administration Process.
Enhancing the Administration Process through the Extension Manager
You can extend the Administration Process to enhance its current core functionality -- that is, processing all administration requests created through the Notes® user interface or by a Domino® server. Using the Extension Manager to extend the Administration Process, you can use the core Administration Process functionality and develop additional tasks based on Administration Process actions.

Administering
This documentation provides information about the administration tools for HCL Domino.
- Administering with AdminCentral
  The AdminCentral application (admincentral.nsf) is automatically created by adminP on the Domino administration server. You can open AdminCentral directly from your Notes Standard or Nomad web client, without the need to start Domino Administrator. This application provides a simplified and easy-to-use way of managing fully functional Notes users and groups in a Domino deployment.
- Administering with Domino Administrator
  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.
    - The Domino® Administrator
      The Domino® Administrator is the administration client for Notes® and Domino. You can use the Domino Administrator to perform most administration tasks.
    - The Server Controller and the Domino® Console
      The Server Controller is a Java-based program that controls a Domino® server. Starting the Server Controller starts the Domino server it controls. When a server runs under a Server Controller, you can send operating system commands, Controller commands, and Domino server commands to the Server Controller.
    - The Administration Process
      The Administration Process is a program that automates many routine administrative tasks.
      - Specifying the administration server for the Domino® Directory
        Choosing the administration server for the Domino® Directory depends on your network setup, the available equipment, and the anticipated changes that will be made to the Domino Directory via the Administration Process.
      - Setting up the Administration Process
        You complete a set of tasks to set up the Administration Process.
      - Administration Process support of secondary Domino® Directories
        Domino® supports the use of secondary Domino Directories for maintaining user names and groups that you want to store in a directory other than your primary Domino Directory, NAMES.NSF. For example, you may want to maintain Notes® users with Notes IDs in NAMES.NSF, but maintain Web-only users in a secondary Domino Directory.
      - Processing administration requests across domains
        The Administration Process for the Domino® Directory must be set up on a server in each domain.
      - Setting up ACLs for the Administration Process
        Each administrator who uses the Administration Process to perform tasks must have the appropriate access rights and roles in the Domino® Directory (NAMES.NSF), secondary directories -- if applicable, Administration Requests database (ADMIN4.NSF), and the Certification Log database (CERTLOG.NSF).
      - Modifying the Action field in the Access Control List (ACL)
        The Access Control List (ACL) dialog box for Notes® (.NSF) applications contains an Administration Server field and an Action field on the Advanced panel. Use caution when modifying these fields.
      - The Administration Requests database
        Use the views in the Administration Requests database (ADMIN4.NSF) to sort and examine requests in many ways.
      - Managing Administration Process requests
        Managing administration process requests involves approving requests, forcing requests when they must be processed immediately, and checking the Administration Requests database for errors.
      - Customizing the Administration Process
        You can customize the Administration Process.
        Scheduling Administration Request processing
        Each setting in the Administration Process section of the Server document controls the timing of specific types of requests. Interval settings and replication schedules for each server determine how quickly the administrative settings replicate throughout the domain. As these requests are carried out, the speed with which they are replicated to the appropriate databases in the domain depends on the replication schedule for those servers. If necessary, you can schedule separate replication events for more immediate updates.
        Redefining time interval defaults for administration requests
        You can specify the time interval, other than the default time interval, in which a specific administration request will execute. The settings that you specify override the default settings.
        Changing the number of threads used by the Administration Process
        By default, the Administration Process uses three threads to process requests. To improve Administration Process performance, increase the number of threads.
        Defining special purpose threads for specific administration requests
        You can specify one or more special purpose threads for a class of administration requests or for a specific administration request. An administration request's "class" is the request's time frame: immediate or interval.
        Creating an Administration Process view
        By default, the Administration Process scans all documents in a database looking for matches in the Readers and Authors fields or Names fields, when an Administration Request for a particular value in that field is received.
        Enhancing the Administration Process through the Extension Manager
        You can extend the Administration Process to enhance its current core functionality -- that is, processing all administration requests created through the Notes® user interface or by a Domino® server. Using the Extension Manager to extend the Administration Process, you can use the core Administration Process functionality and develop additional tasks based on Administration Process actions.
        Using an extended administration server
        An extended administration server is an administration server that processes Domino® Directory administration requests.
      - Using AdminQ to process web user requests
        Use Administration Quick (AdminQ) to expedite the processing of Administration Process (AdminP) requests that affect the user IDs of web users, for example, HCL Verse users. The users must have IDs in an ID vault.
      - Statistics generated during administration request processing
        The Administration Process records statistics to help you monitor the request processing activity of the administration process tasks.
      - Administration request messages
        The response Log documents in the Administration Requests database contain error messages that describe any errors that occur during the processing of an administration request. Error messages also appear on the console of the administration server. Administrators who want to be notified when one of these events occurs on a server, can create an Event Handler document in EVENTS4.NSF to define how they want to be notified.
      - Administration Process requests
        An administration request is created by the administrator performing an action; it represents an administration task and is run by the server task AdminP (Administration Process). When an administration request is generated, it appears in the Administration Requests database.
    - Domino® server commands
      This section describes the Domino® server commands that are available, as well as methods of issuing those commands.
    - Domino® server tasks
      The information in this topic describes Domino® server tasks and their defaults in the NOTES.INI file.
    - IBM® i server commands
      You can use IBM® i server commands to manage Domino® with IBM i.
  - 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.
  - 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.

Enhancing the Administration Process through the Extension Manager

You can extend the Administration Process to enhance its current core functionality -- that is, processing all administration requests created through the Notes® user interface or by a Domino® server. Using the Extension Manager to extend the Administration Process, you can use the core Administration Process functionality and develop additional tasks based on Administration Process actions.

About this task

For more information on creating and using an Extension Manager program, see the Lotus® C API User Guide. For more information on creating an Extension Manager for the Administration Process, see the ProcessRequestEMCallback function entry in the Lotus® C API Reference.

Creating a third-party Administration Request

About this task

You can extend the Administration Process by creating an administration request directed to a third-party server add-in task that interprets the request and acts on it. When creating a third-party administration request, specify:

The Message Queue name in the ProxyProcess field of the request. The Administration Process uses this data to pass the request's and response's note IDs.
The Server name in the ProxyServer field of the request to identify the Domino® server on which the server add-in task is running.
A Text version of an identifier, greater than "5000," in the ProxyAction field.

The Administration Process acts on third-party requests by opening the message queue and placing a message with the IDs of the administration request and log notes in it. The add-in task monitors the message queue and then performs the required processing.

For information on creating a server add-in task that processes third-party administration requests, see the Lotus® C API User Guide.

To verify which task is processing a request

About this task

Use these steps to verify whether AdminP or another task is processing an administration request. The ProxyProcess field is set by the program that created the request.

Procedure

From the Domino® Administrator, choose Server > Analyses > Administration Requests.
Open the All Requests by Action view.
Select the request, right-click the mouse button and choose Document Properties.
Click the Field tab, and then locate the ProxyProcess field which contains the name of the task that is processing the administration request.