NAME

ldap_addcell - Registers DCE cell information in a server that supports LDAP. 

SYNOPSIS

ldap_addcell -h ldap_server -a authentication_DN -p password
[-o object_class, object_class...]] | [-d]

OPTIONS

-h ldap_serverThe name of the LDAP server targeted to hold the binding. 

-a authentication_DN
The distinguished name (DN), specified in LDAP name syntax, that is to be authenticated for successive operations to use.

-p passwordThe password that is used to authenticate the distinguished name (DN). 

-o object_class, object_class...
Value or values of the attribute object_class for the entry being created or modified. If you are listing more than one object_class value, you must separate them with commas. If no object_class value is specified, it is assumed that the object exists and an attempt is made to modify its attributes, CDS_CELL and CDS_REPLICAS.  If this attempt fails, another attempt is made with the addition of the object_class value of dceCellInfoO. "dceCellInfoO" is the recommended auxilliary object class for the CDS_CELL and CDS_REPLICAS attributes

-dDeletes the DCE cell information attributes from the entry in the directory. It does not remove the directory entry. 

DESCRIPTION

The ldap_addcell command registers DCE cell information in a server that supports LDAP. It returns a zero (0) on success and a one (1) on error. 

Privileges Required

You must log in as superuser (root) to run the ldap_addcell command. 

EXAMPLES

The following ldap_addcell examples assume the following:

       •The ldap server machine name is mymachine.mycity.mycompany.com. 

       •gdatest is a user that has write access to the ldap server. 

       •gdatest is also the password of the user gdatest. 

       •An organizational unit is allowed to contain the auxiliary object dceCellInfo. 

       •The ldap server does schema checking. 

Example 1 shows the normal creation of the cell bindings in the ldap server. 

ldap addcell -h mymachine.mycity.mycompany.com -a \
"cn=gdatest, ou=mycity, o=mycompany, c=mycountry" \
-p "gdatest" -o organizationalUnit, dceCellInfo

Example 2 shows the deletion of the CDSCELL and CDSREPLICAS attributes. 

ldap addcell -h mycountry.mycity.mycompany.com -a \
"cn=gdatest, ou=mycity, o=mycompany, c=mycountry" \
-p "gdatest" | -d

Example 3 shows the changing of the CDSCELL and CDSREPLICAS attributes in an object that exists. 

ldap addcell -h mycountry.mycity.mycompany.com -a \
"cn=gdatest, ou=mycity, o=mycompany, c=mycountry" \
-p "gdatest"

ENVIRONMENT VARIABLES USED

Each parameter of the ldap_addcell command has a corresponding environment variable, which is used when the corresponding parameter is not present on the ldap_addcell command invocation. The ldap_addcell parameters and the corresponding environment variables are as follows:

-hLDAP_SERVER

-aLDAP_AUTH_DN

-pLDAP_AUTH_DN_PW

-oLDAP_OPJECT_CLASS

If the cell entry is already registered, the CDSCELL and CDSREPLICAS attributes are replaced with new values for this cell. 

RELATED INFORMATION

None