ocf_heartbeat_eDir88 - Man Page
Manages a Novell eDirectory directory server
Synopsis
eDir88 [start | stop | monitor | meta-data | validate-all]
Description
Resource script for managing an eDirectory instance. Manages a single instance of eDirectory as an HA resource. The "multiple instances" feature or eDirectory has been added in version 8.8. This script will not work for any version of eDirectory prior to 8.8. This RA can be used to load multiple eDirectory instances on the same host.
It is very strongly recommended to put eDir configuration files (as per the eDir_config_file parameter) on local storage on each node. This is necessary for this RA to be able to handle situations where the shared storage has become unavailable. If the eDir configuration file is not available, this RA will fail, and heartbeat will be unable to manage the resource. Side effects include STONITH actions, unmanageable resources, etc...
Setting a high action timeout value is _very_ _strongly_ recommended. eDir with IDM can take in excess of 10 minutes to start. If heartbeat times out before eDir has had a chance to start properly, mayhem _WILL ENSUE_.
The LDAP module seems to be one of the very last to start. So this script will take even longer to start on installations with IDM and LDAP if the monitoring of IDM and/or LDAP is enabled, as the start command will wait for IDM and LDAP to be available.
Supported Parameters
- eDir_config_file
Path to configuration file for eDirectory instance.
(unique, optional, string, default "/etc/opt/novell/eDirectory/conf/nds.conf")
- eDir_monitor_ldap
Should we monitor if LDAP is running for the eDirectory instance?
(optional, boolean, default 0)
- eDir_monitor_idm
Should we monitor if IDM is running for the eDirectory instance?
(optional, boolean, default 0)
- eDir_jvm_initial_heap
Value for the DHOST_INITIAL_HEAP java environment variable. If unset, java defaults will be used.
(optional, integer, no default)
- eDir_jvm_max_heap
Value for the DHOST_MAX_HEAP java environment variable. If unset, java defaults will be used.
(optional, integer, no default)
- eDir_jvm_options
Value for the DHOST_OPTIONS java environment variable. If unset, original values will be used.
(optional, string, no default)
Supported Actions
This resource agent supports the following actions (operations):
- start
Starts the resource. Suggested minimum timeout: 600s.
- stop
Stops the resource. Suggested minimum timeout: 600s.
- monitor
Performs a detailed status check. Suggested minimum timeout: 60s. Suggested interval: 30s.
- meta-data
Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.
- validate-all
Performs a validation of the resource configuration. Suggested minimum timeout: 5s.
Example CRM Shell
The following is an example configuration for a eDir88 resource using the crm(8) shell:
primitive p_eDir88 ocf:heartbeat:eDir88 \ op monitor timeout="60s" interval="30s"
Example PCS
The following is an example configuration for a eDir88 resource using pcs(8)
pcs resource create p_eDir88 ocf:heartbeat:eDir88 \ op monitor timeout="60s" interval="30s"
See Also
Author
ClusterLabs contributors (see the resource agent source for information about individual authors)