Sun Directory Server Enterprise Edition 7.0 Administration Guide

Configuring Administrative Alerts for Directory Proxy Server

For information about how to configure administrative alerts, see the following procedures.

ProcedureTo Enable Administrative Alerts

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

  1. View the enabled alerts.


    % dpconf get-server-prop -h host -p port enabled-admin-alerts
  2. Enable one or more administrative alerts.


    % dpconf set-server-prop -h host -p port enabled-admin-alerts:alert1 \
      [enabled-admin-alerts:alert2 ...]

    For example, to enable all available alerts, run this command:


    % dpconf set-server-prop -h host -p port \
     enabled-admin-alerts:error-configuration-reload-failure-with-impact \
     enabled-admin-alerts:error-resource-limit-exceeded \
     enabled-admin-alerts:error-server-shutdown-abrupt \ 
     enabled-admin-alerts:info-configuration-reload \
     enabled-admin-alerts:info-data-source-available \
     enabled-admin-alerts:info-server-shutdown-clean \
     enabled-admin-alerts:info-server-startup \
     enabled-admin-alerts:warning-configuration-reload-failure-no-impact \
     enabled-admin-alerts:warning-data-source-unavailable \
     enabled-admin-alerts:warning-data-sources-inconsistent \
     enabled-admin-alerts:warning-listener-unavailable \
     enabled-admin-alerts:warning-resource-limit-exceeded

    To disable all email alerts, run this command:


    % dpconf set-server-prop -h host -p port email-alerts-enabled:false

    To add an alert to an existing list of enabled alerts, run this command:


    % dpconf set-server-prop -h host -p port enabled-admin-alerts+:alert-name
    

    To remove an alert from an existing list of enabled alerts, run this command:


    % dpconf set-server-prop -h host -p port enabled-admin-alerts-:alert-name
    

    By default, all alerts are enabled. For example, once all the email alerts are enabled (email-alerts-enabled:true), run the following command to receive all the email alerts :


    % dpconf set-server-prop -h host -p port enabled-admin-alerts:all 
See Also

For more information, see enabled-admin-alerts(5dpconf).

ProcedureTo Configure Administrative Alerts to Be Sent to Syslog

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

  1. Select the alerts that will be sent to the syslog daemon, as described in To Enable Administrative Alerts.

  2. Enable alerts to be sent to the syslog daemon.


    $ dpconf set-server-prop -h host -p port syslog-alerts-enabled:true

    All alerts are sent to the syslog with the facility of USER.

  3. Set the host name of the syslog daemon to which alerts are to be sent.


    $ dpconf set-server-prop -h host -p port syslog_hostname:hostname
    

ProcedureTo Configure Administrative Alerts to Be Sent to Email

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

  1. Select the alerts that will be sent to the syslog, as described in To Enable Administrative Alerts.

  2. Configure the address and characteristics of the email.


    $ dpconf set-server-prop -h host -p port email-alerts-smtp-host:host-name \
      email-alerts-smtp-port:port-number \
      email-alerts-message-from-address:sender-email-address \
      email-alerts-message-to-address:receiver-email-address \
      [email-alerts-message-to-address:receiver-email-address ...] \
      email-alerts-message-subject:email-subject
    
  3. Enable alerts to be sent to email.


    $ dpconf set-server-prop -h host -p port email-alerts-enabled:true
  4. (Optional) Set a flag to include the alert code in the email


    $ dpconf set-server-prop -h host -p port \
     email-alerts-message-subject-includes-alert-code:true

ProcedureTo Configure Administrative Alerts to Run a Script

You can use DSCC to perform this task. For information, see Directory Service Control Center Interface and the DSCC online help.

  1. Select the alerts that will be sent to the syslog, as described in To Enable Administrative Alerts.

  2. Enable alerts to run a script.


    $ dpconf set-server-prop -h host -p port scriptable-alerts-enabled:true
  3. Set the name of the script that will be run.


    $ dpconf set-server-prop -h host -p port scriptable-alerts-command:script-name