Commutateurs de ligne de commande pour le serveur de base de données

Vous pouvez utiliser les commutateurs de ligne de commande pour définir des options pour la commande dbadmin et pour gérer le serveur de base de données IBM® Engineering Requirements Management DOORS (DOORS).
Remarque : Pour utiliser la commande dbadmin, le commutateur -data est requis. Si vous omettez ce commutateur ou utilisez une valeur de données non valide, la commande ne peut pas s'exécuter et ce message s'affiche : -F- DBADMIN: Server not specified.

Pour obtenir la liste des commutateurs de ligne de commande pour le client DOORS, voir Commutateurs de ligne de commande pour le client DOORS.

Tableau 1. Commutateurs de ligne de commande pour la commande dbadmin dans DOORS
Commutateur (abréviation) Paramètre Description
-data (-d) port@serveurDOORS Ce commutateur identifie le serveur de base de données, où port est le numéro de port que le serveur de base de données utilise et DOORSserver est le nom de l'ordinateur sur lequel le serveur de base de données est installé. Ce commutateur est toujours obligatoire.
-killprocess (-k) identificateur_canal Ce commutateur déconnecte la connexion utilisateur spécifiée par le paramètre channel_identifier.

Le paramètre channel_identifier est affiché par le commutateur -userlist.

-killserver (-K)   Ce commutateur arrête le serveur.
-locklist (-l)   Ce commutateur répertorie tous les fichiers qui sont actuellement verrouillés et l'identificateur de canal pour chaque fichier.
-outfile (-o) nom_fichier Ce commutateur envoie la sortie à un fichier.

Utilisez ce commutateur avec les commutateurs -locklist et -userlist.

-password (-P) mot_de_passe Ce commutateur est le mot de passe actuel pour le serveur.
-newpassword (-p) nouveau_mot_de_passe Ce commutateur est le nouveau mot de passe pour le serveur.
-unlock (-U) identificateur_canal Ce commutateur déverrouille le fichier qui est spécifié par le paramètre channel_identifier.

Le paramètre channel_identifier est affiché par le commutateur -locklist.

-userlist (-u)   Ce commutateur répertorie toutes les connexions utilisateur.
-serverLogging log_level Si le serveur a été démarré avec les paramètres loglevel et logfile, vous pouvez utiliser ce commutateur pour modifier le niveau de journalisation.

Il n'est pas nécessaire de redémarrer le serveur pour que le nouveau niveau de consignation prenne effet.

Pour plus d'informations sur la consignation et notamment une description des niveaux de consignation, voir Fichiers journaux.
-tdsUserFilterLimit chaîne Ce commutateur définit les limites des recherches d'utilisateur Rational Directory Server.
-tdsGroupFilterLimit chaîne Ce commutateur définit des limites pour les recherches de groupe Rational Directory Server.
-useCardAuthentication   Ce commutateur active l'authentification par carte à puce.
-doNotUseCardAuthentication   Ce commutateur désactive l'authentification par carte à puce.
-useOSUserAuthentication   Ce commutateur active l'authentification d'utilisateur sur le système d'exploitation.
-doNotUseOSUserAuthentication   Ce authentification d'utilisateur désactive l'authentification d'utilisateur du système d'exploitation.
-certName chaîne Ce commutateur identifie le libellé du certificat qui identifie le serveur au cours de l'authentification sécurisée.

Le libellé par défaut est IBMSV1.

Tableau 2. Commutateurs de ligne de commande pour la commande dbadmin dans IBM Engineering Requirements Management DOORS - Web Access (DWA)
Commutateur (abréviation) Paramètre Description
-dwaHost serveurDWA Ce commutateur identifie le serveur DWA, où DWAserver est le nom d'hôte qualifié complet de l'ordinateur sur lequel le serveur Web s'exécute ; par exemple, dwaserver.ibm.com.
-dwaPort port Ce commutateur identifie le numéro de port sur lequel le serveur DWA s'exécute.

Voir les remarques importantes à la suite de ce tableau sur les valeurs et URI par défaut.

-dwaProtocol http ou https Ce commutateur spécifie le protocole utilisé par le serveur DWA.

Si la communication est sécurisée, entrez https. Autrement, entrez http. Ne spécifiez pas les deux.

Voir les remarques importantes à la suite de ce tableau sur la relation du protocole et les valeurs de port par défaut.

-dcnEnable   Ce commutateur active le service Data Change Notifications requis pour autoriser la communication avec le serveur et le courtier DWA.
-dcnBrokerUri tcp://broker:61616 Ce commutateur identifie le courtier DWA, où broker correspond à l'ordinateur hébergeant le courtier et 61616 au numéro de port par défaut utilisé par le courtier.
-dcnChannelName dcn ce commutateur définit le canal du service Data Change Notifications. Le nom du canal est toujours "dcn".
-dcnInfo   Ce commutateur vérifie le statut du service Data Change Notifications.
-dcnEnable   Ce changement active le service Data Change Notifications.
-dcnDisable   Ce commutateur désactive le service Data Change Notifications.
Important : Si le commutateur -dwaPort est vide, par défaut la valeur du port est celle du port standard pour le protocole sélectionné :
Tableau 3. Commutateurs de ligne de commande pour la commande doorsd dans DOORS
Commutateur (abréviation) Paramètre Description
-minstall -port port_number -serverdata server_data_path Ce commutateur crée un service de serveur de base de données DOORS supplémentaire sur les ordinateurs équipés de systèmes d'exploitation Windows si les paramètres sont définis avec les valeurs suivantes :
  • portnumber est égal au port de connexion de données.
  • server_data_path est égal au dossier du répertoire de données sur le serveur.
Par exemple : "doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.7\new_data". Un numéro d'instance, tel que 00001, est affecté au nouveau service.
-remove   Ce commutateur supprime le service par défaut créé lorsque le serveur de base de données est installé pour la première fois.
-mremove -i service_instance_number Ce commutateur supprime une instance spécifique du service de serveur de base de données, où portnumber correspond au numéro d'instance affecté au nom du service de base de données.
-list   Ce commutateur émet une liste, au format table, de tous les services de serveur de base de données DOORS configurés ainsi que de leur statut.
-logfile log_file Ce commutateur définit le fichier utilisé pour la consignation des transactions du serveur de base de données. Pour obtenir une description des niveaux de journal, voir Fichiers journaux.
-loglevel log_level Ce commutateur définit le niveau de détail des informations enregistrées par la consignation des transactions du serveur de base de données. Utilisez la valeur 0 pour désactiver la journalisation. Utilisez la valeur 6 pour créer des détails plus prolixes.
-start   Ce commutateur démarre le service par défaut du serveur de base de données.
-stop   Ce commutateur arrête le service par défaut du service de base de données.
-logxconfig (-X) logging_file_name Le nom complet du fichier de configuration log4cxx ; par exemple, c:\Program Files\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxx est un canevas pour les messages de l'application de journalisation. Lorsque vous utilisez ce paramètre sur la ligne de commande ou dans le registre, les messages d'application sont émis dans un fichier de configuration spécifié. Six niveaux de messages sont consignés :
  • TRACE
  • DEBUG
  • INFO, dont ACK, CONFIRM et QUERY
  • WARNING
  • ERROR
  • FATAL
-secure on, ON, off, OFF Ce commutateur indique si le serveur DOORS est configuré pour démarrer en mode sécurisé.
-keyDB nom_fichier Ce commutateur est le chemin d'accès complet au fichier de clés qui contient les clés utilisées pour l'authentification et la validation SSL DOORS, notamment le nom de fichier.

Le chemin par défaut est DOORS\9.version\certdb\client_authentication.kdb.

Ce commutateur est prioritaire par rapport au commutateur -certdb. Pour spécifier un emplacement pour le dossier de base de données de clés Rational Directory Server, utilisez le commutateur -certdb. Pour spécifier un emplacement distinct pour le fichier de clés SSL DOORS, utilisez le commutateur -keyDB.

-certdb nom_dossier Ce commutateur identifie le dossier qui contient les fichiers de base de données de clés qui contiennent les clés pour Rational Directory Server et DOORS SSL.

Le chemin par défaut est DOORS\9.version\certdb\.

Pour placer les fichiers de base de données de clés pour DOORS SSL dans un dossier séparé, utilisez le commutateur -keyDB. Le commutateur -keyDB est prioritaire par rapport au commutateur -certdb.

-certName chaîne Ce commutateur identifie le libellé du certificat qui identifie le serveur au cours de l'authentification sécurisée.

Le libellé par défaut est IBMSV1.

-serverhostname chaîne Ce commutateur est le nom que le serveur utilise pour s'identifier au cours de la validation du certificat.

Le libellé par défaut est IBMEDSERV.

Exemple de commande de ligne de commande

Vous pouvez utiliser les commutateurs de ligne de commande dans la ligne de commande et dans des raccourcis.

Pour arrêter un serveur qui est en cours d'exécution sur le site 36677@IBMEDSERV, entrez cette commande :
dbadmin -data 36677@abc -killserver

Exemple de commande de raccourci

Pour démarrer un serveur, utilisez le raccourci suivant. Révisez la commande pour y insérer votre chemin d'installation de DOORS.
"C:\Program Files (x86)\IBM\Rational\DOORS\9.7\bin\doorsd.exe" -start

icône des vidéos Vidéo

Chaîne Jazz.net
Canal Software Education

icône d'apprentissage Cours

IoT Academy
Skills Gateway

icône de demande Communauté

Jazz.net
Forums Jazz.net
Bibliothèque Jazz.net

icône d'aide Support

Communauté de support IBM
Wiki sur le déploiement