ADDDIRINST

La commande Ajouter une instance de serveur d'annuaire (ADDDIRINST) permet de créer une instance de serveur d'annuaire. La bibliothèque de base de données utilisateur et la bibliothèque de configuration de l'instance sont créées, ainsi que les fichiers de configuration et de schéma de l'instance. L'instance de serveur peut s'exécuter en tant que serveur d'annuaire autonome. Elle peut être supprimée à l'aide de la commande Supprimer une instance de serveur d'annuaire (RMVDIRINST). The Add Directory Server Instance (ADDDIRINST) command is used to create a Directory Server instance. The user database library and instance configuration library are created, and the configuration and schema files for the instance are also created. The server instance can run as a standalone Directory Server. The server instance can be removed by running the Remove Directory Server Instance (RMVDIRINST) command.

Restrictions:

• Vous devez posséder les droits spéciaux sur tous les objets (*ALLOBJ) et de configuration du système d'entrée-sortie (*IOSYSCFG) pour utiliser cette commande. You must have all object (*ALLOBJ) and input/output system configuration (*IOSYSCFG) special authorities to use this command.

Paramètres

Instance (INSTANCE)

Indique le nom de l'instance de serveur d'annuaire à créer. Specifies the name of the Directory Server instance to be created.

Ce paramètre est obligatoire. This is a required parameter.

QUSRDIR

Il s'agit de l'instance de serveur d'annuaire par défaut du système. This is the system default Directory Server instance.

nom

Indiquez le nom d'une instance de serveur d'annuaire. Le nom comporte de un à huit caractères. Specify a Directory Server instance name. The name has a minimum of one character and a maximum of eight characters.

Administrateur (ADMIN)Administrator (ADMIN)

Indique le nom et le mot de passe de l'administrateur de l'instance de serveur d'annuaire à créer. Specifies the name and password for the administrator of the Directory Server instance to be created.

Élément 1: Distinguished name

*DFT

Utilise le nom distinctif par défaut de l'administrateur, cn=administrator. Use the default distinguished name for administrator, cn=administrator.

valeur-caractère

Indiquez le nom distinctif de l'administrateur de l'instance de serveur d'annuaire à créer. Specify the distinguished name of the administrator for the Directory Server instance to be created.

Élément 2: Password

*GEN

Une valeur de mot de passe aléatoire sera générée pour vous. A random password value will be generated for you.

valeur-caractère

Indiquez le mot de passe de l'administrateur de l'instance de serveur d'annuaire à créer. Le mot de passe est sensible à la casse. La longueur maximale est de 50 caractères. Specify the password for the administrator for the Directory Server instance to be created. The password is case sensitive. The maximum length is 50 characters.

Port (PORT)

Indique le port sur lequel l'instance de serveur d'annuaire est en écoute pour les communications LDAP non chiffrées. Specifies the port to be listened by the Directory Server instance for unencrypted LDAP communication.

389

Numéro de port par défaut des communications LDAP non chiffrées. The default port number for unencrypted LDAP communication.

1-65535

Indiquez le numéro de port des communications LDAP non chiffrées. Specify the port number for unencrypted LDAP communication.

Port SSL (SSLPORT)SSL port (SSLPORT)

Indique le port sur lequel l'instance de serveur d'annuaire est en écoute pour les communications LDAP chiffrées. Specifies the port to be listened by the Directory Server instance for encrypted LDAP communication.

636

Numéro de port par défaut des communications LDAP chiffrées. The default port number for encrypted LDAP communication.

1-65535

Indiquez le numéro de port des communications LDAP chiffrées. Specify the port number for encrypted LDAP communication.

Texte 'description' (TEXT)Text 'description' (TEXT)

Indique la description de l'instance à créer. Specifies the description for the instance to be created.

*NONE

Aucun texte descriptif n'est associé à l'instance. No descriptive text is associated with the instance.

valeur-caractère

Indiquez la description de l'instance de serveur. Vous pouvez indiquer 256 caractères au maximum. Specify the description for the server instance. A maximum of 256 characters can be specified.

Bibliothèque de base de données utilisateur (USERDBLIB)User database library (USERDBLIB)

Indique la bibliothèque utilisée pour stocker les données utilisateur (entrées d'annuaire) de l'instance de serveur d'annuaire à créer, et si elle doit être créée au cas où elle n'existerait pas sur le système. Specifies the library used to store the user data (Directory Entries) for the Directory Server instance to be created, and whether to create it or not if it does not exist on the system.

Élément 1: User database library

*INSTANCE

Le nom par défaut de la bibliothèque de base de données utilisateur est formé de la chaîne "DB" ajoutée au nom de l'instance. The default name for the user database library is formed with the string "DB" appended to the instance name.

nom

Indiquez le nom de la bibliothèque de base de données utilisateur. Le nom comporte de un à dix caractères. Specify the name for the user database library. The name has a minimum of one character and a maximum of ten characters.

Élément 2: If library does not exist

*CRT

Crée la bibliothèque si elle n'existe pas. Create the library if it does not exist.

*NOCRT

Ne crée pas la bibliothèque. Assurez-vous que la bibliothèque existe sur le système. Do not create the library. Please make sure the library exists on the system.

Activer le journal des modifications (ENBCHGLOG)Enable change log (ENBCHGLOG)

Indique si le journal des modifications est activé ou non pour l'instance à créer. Specifies whether the change log is enabled or not for the instance to be created.

*NO

Désactive le journal des modifications pour l'instance. Disable the change log for the instance.

*YES

Active le journal des modifications pour l'instance. Enable the change log for the instance.

Bibliothèque du journal des modifications (CHGLOGLIB)Change log library (CHGLOGLIB)

Indique la bibliothèque utilisée pour stocker le journal des modifications de l'instance de serveur d'annuaire à créer, et si elle doit être créée au cas où elle n'existerait pas sur le système. Specifies the library used to store the change log for the Directory Server instance to be created, and whether to create it or not if it does not exist on the system.

Élément 1: Change log library

*INSTANCE

Le nom par défaut de la bibliothèque du journal des modifications est formé de la chaîne "CL" ajoutée au nom de l'instance. The default name for the change log library is formed with the string "CL" appended to the instance name.

nom

Indiquez le nom de la bibliothèque du journal des modifications. Le nom comporte de un à dix caractères. Specify the name for the change log library. The name has a minimum of one character and a maximum of ten characters.

Élément 2: If library does not exist

*CRT

Crée la bibliothèque si elle n'existe pas. Create the library if it does not exist.

*NOCRT

Ne crée pas la bibliothèque. Assurez-vous que la bibliothèque existe sur le système. Do not create the library. Please make sure the library exists on the system.

Numéro d'ASP (ASP)ASP number (ASP)

Indique le numéro du pool de mémoire secondaire (ASP) système ou utilisateur de base dans lequel le stockage de la bibliothèque est alloué. Pour les bibliothèques créées dans un ASP, tous les objets de la bibliothèque doivent se trouver dans le même ASP que la bibliothèque. Lorsqu'une valeur autre que *ASP est indiquée pour le paramètre Unité d'ASP (ASPDEV), *ASPDEV est la seule valeur valide pouvant être indiquée pour le paramètre Numéro d'ASP (ASP), s'il est indiqué. De même, lorsqu'une valeur autre que *ASP est indiquée pour le paramètre ASPDEV, le paramètre ASP peut être omis et sa valeur par défaut sera ignorée. Specifies the number of the system or basic user auxiliary storage pool (ASP) where storage for the library is allocated. For libraries created in an ASP, all objects in the library must be in the same ASP as the library. When a value other than *ASP is specified for the ASP device (ASPDEV) parameter, *ASPDEV is the only valid value that can be specified for the ASP number (ASP) parameter, if specified. Also when a value other than *ASP is specified for the ASPDEV parameter, the ASP parameter can be omitted and its defaulted value will be ignored.

1

L'espace de stockage de la bibliothèque est alloué à partir du pool de mémoire secondaire système, ASP 1. The storage space for the library is allocated from the system auxiliary storage pool ASP 1.

*ASPDEV

Le stockage de la bibliothèque est alloué à partir de l'ASP principal ou secondaire indiqué pour le paramètre ASPDEV. The storage for the library is allocated from the primary or secondary ASP specified for the ASPDEV parameter.

1-32

Indiquez le numéro de l'ASP système ou utilisateur de base. Specify the number of the system or basic user ASP.

Unité d'ASP (ASPDEV)ASP device (ASPDEV)

Indique le nom de l'unité de pool de mémoire secondaire (ASP) dans laquelle le stockage de la bibliothèque est alloué. Lorsqu'une valeur autre que *ASPDEV est indiquée pour le paramètre Numéro d'ASP (ASP), ASPDEV(*ASP) est la seule valeur valide pouvant être indiquée pour le paramètre Unité d'ASP (ASPDEV), s'il est indiqué. Autres valeurs pour le paramètre ASPDEV sont valides si le paramètre ASP est omis. Dans ce cas, la valeur par défaut du paramètre ASP est ignorée. Specifies the auxiliary storage pool (ASP) device name where storage is allocated for the library. When a value other than *ASPDEV is specified for the ASP number (ASP) parameter, ASPDEV(*ASP) is the only valid value for the ASP device (ASPDEV) parameter, if specified. Autres valeurs for the ASPDEV parameter are valid if the ASP parameter is omitted. In this case, the defaulted value for the ASP parameter is ignored.

*ASP

Le stockage de la bibliothèque est alloué à partir de l'ASP système ou utilisateur de base indiqué pour le paramètre ASP. The storage for the library is allocated from the system or basic user ASP specified for the ASP parameter.

*ASPGRPPRI

Le stockage de la bibliothèque est alloué à partir de l'ASP principal du groupe d'ASP de l'unité d'exécution. Si aucun groupe d'ASP n'est associé à l'unité d'exécution, un message d'erreur est envoyé. The storage for the library is allocated from the primary ASP of the thread's ASP group. If no ASP group is associated with the thread an error message is sent.

*SYSTEM

Le stockage de la bibliothèque est alloué à partir de l'ASP système (ASP 1). The storage for the library is allocated from the system ASP (ASP 1)

nom

• Indiquez le nom d'une unité d'ASP principal ou secondaire. Le stockage de la bibliothèque est alloué à partir de l'ASP principal ou secondaire. L'ASP principal ou secondaire doit avoir été activé (par mise en fonction de l'unité d'ASP) et avoir le statut 'Disponible'. Specify the name of a primary or secondary ASP device. The storage for the library is allocated from the primary or secondary ASP. The primary or secondary ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
• Remarque : pour indiquer le nom d'une unité de pool de mémoire secondaire (ASP) particulière, vous devez posséder le droit d'utilisation (*USE) sur chaque unité d'ASP du groupe d'ASP. Note: To specify a specific auxiliary storage pool (ASP) device name, you must have use (*USE) authority for each ASP device in the ASP group.

Adresse Internet (INTNETADR)Internet address (INTNETADR)

• Indique les adresses IP utilisées par l'instance. Cette zone peut contenir plusieurs valeurs. La longueur maximale de chaque valeur est de 45. Specifies the IP addresses to be used by the instance. This field can hold multiple values. The maximum length for each value is 45.
• Une adresse Internet IPv4 est indiquée sous la forme nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.
• Une adresse Internet IPv6 est indiquée sous la forme x:x:x:x:x:x:x:x, où x est un nombre hexadécimal compris entre 0 et X'FFFF'. La notation "::" peut être utilisée une seule fois dans l'adresse IPv6 pour indiquer un ou plusieurs groupes de 16 bits à zéro. La notation "::" permet de compresser les zéros de début, intermédiaires ou de fin de l'adresse. An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
• Une adresse IPv6 mappée IPv4 peut être indiquée. Une adresse IPv6 mappée IPv4 est indiquée sous la forme ::FFFF:nnn.nnn.nnn.nnn, où nnn est un nombre décimal compris entre 0 et 255. An IPv4-mapped IPv6 address may be specified. An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.

Valeurs uniques

*CURSYS

Utilise toutes les adresses IP configurées sur le système. Use all the IP addresses that are configured on the system.

Autres valeurs (jusqu'à 5 répétitions)

valeur-caractère

Indiquez les adresses IP à utiliser par l'instance. Specify the IP addresses to be used by the instance.

Démarrage automatique du serveur (AUTOSTART)Autostart server (AUTOSTART)

Indique si l'instance de serveur démarre automatiquement lorsque TCP/IP démarre. Specifies whether the server instance starts automatically when TCP/IP starts.

*YES

Indique que l'instance de serveur démarre automatiquement lorsque TCP/IP démarre. Specify that the server instance starts automatically when TCP/IP starts.

*NO

Indique que l'instance de serveur ne démarre pas lorsque TCP/IP démarre. Specify that the server instance does not start when TCP/IP starts.

Suffixe (SUFFIX)Suffix (SUFFIX)

Indique les suffixes utilisés par l'instance. Cette zone peut contenir plusieurs valeurs. La longueur maximale de chaque valeur est de 512. Les suffixes d'annuaire déterminent les objets d'un annuaire LDAP auxquels le serveur peut accéder. Pour que le serveur d'annuaire puisse accéder aux objets d'un annuaire, ces objets doivent avoir l'un des suffixes de l'annuaire à la fin de leur nom distinctif (DN). Specifies the suffixes to be used by the instance. This field can hold multiple values. The maximum length for each value is 512. Directory suffixes determine which objects in an LDAP directory that the server can access. For the Directory Server to be able to access objects in a directory, objects must have one of the directory's suffixes at the end of their distinguished names (DNs).

Par exemple, si "dc=company,dc=com" était indiqué comme seul suffixe d'un serveur d'annuaire, le serveur pourrait accéder à un objet de l'annuaire dont le DN est "dc=product,dc=company,dc=com". En revanche, le serveur ne pourrait pas accéder à "dc=products,dc=mycompany,dc=com" tant qu'un suffixe correspondant, tel que "dc=mycompany,dc=com", n'aurait pas été ajouté. Notez toutefois que l'objet "dc=products,dc=mycompany,dc=com" pourrait continuer d'exister dans l'annuaire, où un autre serveur disposant d'un suffixe correspondant pourrait y accéder. For example, if "dc=company,dc=com" were specified as the only suffix on a Directory Server, the server could access an object in the directory that had DN "dc=product,dc=company,dc=com". However, "dc=products,dc=mycompany,dc=com" could not be accessed by the server unless a corresponding suffix, such as "dc=mycompany,dc=com", were added. Note, however, that the object "dc=products,dc=mycompany,dc=com" could still exist in the directory, where it might be accessed by another server that did have a corresponding suffix.

Le suffixe ne peut pas être en double, ni parent ou enfant d'un suffixe déjà présent dans la liste. Le suffixe ne peut pas être un suffixe réservé du serveur d'annuaire. Les suffixes réservés sont les suivants : The suffix cannot be a duplicate, parent, or a child of a suffix already in the list. The suffix cannot be a reserved suffix for the Directory Server. The reserved suffixes are shown as below:

• cn=anybody
• cn=authenticated
• cn=debug
• cn=changelog
• cn=configuration
• cn=localhost
• cn=monitor
• cn=pwdpolicy
• cn=schema
• cn=this
• cn=ibmpolicies
• cn=deleted objects

Vous pouvez indiquer 10 valeurs pour ce paramètre. You can specify 10 values for this parameter.

*HOSTNAME

La valeur du suffixe est le nom d'hôte en notation de composants de domaine (DC). Par exemple, "company.com.xx" est formaté sous la forme "dc=company,dc=com,dc=xx". The value for the suffix is the hostname in domain component (DC) notation. For example, "company.com.xx" is formated as "dc=company,dc=com,dc=xx".

valeur-caractère

Indiquez les suffixes à utiliser par l'instance. Specify the suffixes to be used by the instance.

Exemples

Exemple 1 : Création d'une instance avec des ports indiqués Example 1: Create an Instance with Specified Ports

ADDDIRINST  INSTANCE(MYINST1)
            DN('CN=ADMINISTRATOR' 'mypassword')
            PORT(1389)
            SSLPORT(1636)
            TEXT('my first instance')

Cette commande crée une instance de serveur d'annuaire nommée 'MYINST1'. Le mot de passe du DN administrateur 'CN=ADMINISTRATOR' est 'mypassword'. Le numéro de port est 1389 et le numéro de port SSL est 1636. La description de cette instance est 'my first instance'. Une fois l'instance créée, une bibliothèque nommée MYINST1DB est créée pour contenir les entrées utilisateur, et un chemin d'accès de répertoire '/QIBM/UserData/OS400/DIRSRV/idsslapd-MYINST1' est créé pour contenir les fichiers de configuration et de schéma. This command creates a Directory Server instance with the name 'MYINST1'. The password for the administrator DN 'CN=ADMINISTRATOR' is 'mypassword'. The port number is 1389, and the SSL port number is 1636. The description for this instance is 'my first instance'. After the instance is created, a library named MYINST1DB is created to contain the user entries. And a directory path '/QIBM/UserData/OS400/DIRSRV/idsslapd-MYINST1' is created to contain the configuration and schema files.

Exemple 2 : Création d'une instance sur un ASP indépendant Example 2: Create an Instance on an Independent ASP

ADDDIRINST  INSTANCE(MYINST2)
            ASP(*ASPDEV) ASPDEV(IASP1)
            DN('CN=ADMINISTRATOR' 'mypassword')
            PORT(2389)
            SSLPORT(2636)
            TEXT('my second instance')

Cette commande crée une instance de serveur d'annuaire nommée 'MYINST2'. Le journal des modifications est activé et la bibliothèque du journal des modifications est MYINST2CL. Les entrées utilisateur et les journaux des modifications se trouvent sur un ASP indépendant nommé IASP1. This command creates a Directory Server instance with the name 'MYINST2'. The change log is enabled, and the library for the change log is MYINST2CL. The user entries and change logs are located on an IASP named IASP1.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

GLD0201

L'instance de serveur d'annuaire &1 existe déjà. Directory server instance &1 already exists.

GLD0218

Droits insuffisants, ou nom distinctif et mot de passe incorrects. Not enough authority or incorrect distinguished name and password specified.

GLD021C

L'appelant de l'API doit posséder les droits spéciaux &1 et &2 pour configurer le serveur. The caller of the API must have &1 and &2 special authority to configure the server.

GLD0229

La liste de validation &1 de la bibliothèque &2 est introuvable. Validation list &1 in library &2 not found.

GLD095A

Le nom distinctif n'est pas valide. Distinguished name is not valid.

GLD095D

La syntaxe du suffixe n'est pas valide. Suffix syntax is not valid.

GLD095E

La valeur du suffixe n'est pas valide. Suffix value is not valid.

CPFA314

Erreur d'allocation de mémoire. Memory allocation error.

CPF2172

Valeur ASPDEV incorrecte avec la valeur indiquée pour ASP.

CPF218A

La bibliothèque &1 ne peut pas être créée dans l'ASP &2.

CPF218B

La bibliothèque &1 ne peut pas être créée dans ASPDEV &2.

CPF2197

La bibliothèque &1 ne peut être crée dans l'ASP utilisateur &2.

CPF2209

Bibliothèque &1 introuvable.