PingDirectory

Running the status tool

The PingDirectory server provides a status tool that outputs the current state of the server as well as other information, such as server version, java runtime environment statistics, operation processing times, work queue, and administrative alerts.

About this task

The status tool is located in the bin directory for UNIX and Linux or the bat directory for Windows.

Steps

  1. Run the status command on the command line.

    The following code displays an example of the current server status and limits the number of viewable alerts in the last 48 hours. It provides the current state of each connection handler, data sources, JE environment statistics, processing times by operation type, and the current state of the work queue.

    Example:

    $ bin/status --bindDN “uid=admin,dc=example,dc=com” --bindPassword secret
    
              --- Server Status ---
    Server Run Status:    Started 28/Mar/2012:10:47:17.000 -0500
    Operational Status:   Available
    Open Connections:     13
    Max Connections:      13
    Total Connections:    50
    
              --- Server Details ---
    Host Name:            server1.example.com
    Administrative Users: cn=Directory Manager
    Installation Path:    PingDirectory
    Server Version:       PingDirectory Server
                      8.1.0.0
    Java Version:         jdk-7u9
    
              --- Connection Handlers ---
    Address:Port : Protocol : State
    -------------:----------:---------
    Step 0.0.0.0:1389 : LDAP     : Enabled
    Step 0.0.0.0:1689 : JMX      : Disabled
    Step 0.0.0.0:636  : LDAPS    : Disabled
    
               --- Data Sources ---
    Base DN:             dc=example,dc=com
    Backend ID:          userRoot
    Entries:             2003
    Replication:         Enable
    Replication Backlog: 0
    Age of Oldest Backlog Change: not available
    
               --- JE Environment ---
    ID             	   : Cache Full :  Cache   : On-Disk : Alert
    -------------------:------------:----------:----------:------
    replicationChanges : 6 %	    : 328.8 kb : 30.4 kb : None
    userRoot	       : 9 %        : 6.2mb    : 146.6mb : None
    
               --- Operation Processing Time ---
    Op Type	  : Total Ops : Avg Resp Time (ms)
    ----------:-----------:-------------------
    Add       : 0         : 0.0
    Bind      : 0         : 0.0
    Compare   : 0         : 0.0
    Delete    : 0         : 0.0
    Modify    : 2788567   : 0.921
    Modify    : 0         : 0
    DN        : 2267266   : 0.242
    Search    : 5055833   : 0.616
    All
    
                --- Work Queue ---
               : Recent : Average : Maximum
    -----------:--------:---------:--------
    Queue Size : 4	  : 0	   : 10
    % Busy	 : 26	 : 5	   : 100
    
                --- Administrative Alerts ---
    Severity : Time	                      : Message
    ---------:----------------------------:----------------------------------------------
    Info     : 28/Mar/2012 10:47:17 -0500 : The Directory Server has started successfully
    Info     : 28/Mar/2012 10:47:14 -0500 : The Directory Server is starting
    Info     : 28/Mar/2012 10:44:22 -0500 : The Directory Server has started successfully
    Info     : 28/Mar/2012 10:44:18 -0500 : The Directory Server is starting
    
    Shown are alerts of type [Info,Warning,Error,Fatal] from the past 48 hours Use the
    --maxAlerts and/or --severity options to filter this list

    By default, the status command displays the alerts generated in the last 48 hours. To change this default setting, see step 2.

  2. To limit the number of viewable alerts from the default 48 hours, use the --maxAlerts option.