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 Rational 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 connaître la liste des commutateurs de ligne de commande pour le client RationalDOORS, voir Commutateurs de ligne de commande pour le client Rational DOORS.

Tableau 1. Commutateurs de ligne de commande pour la commande dbadmin dans RationalDOORS
Commutateur (abréviation) Paramètre Description
-data (-d) port@serveurDOORS Ce commutateur identifie le serveur de base de données Rational DOORS, sur lequel 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 obtenir une description des niveaux de journal, voir Fichiers journaux.
-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, notamment ACK, CONFIRM et QUERY
  • WARNING
  • ERROR
  • FATAL
-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.
-secure on, ON, off, OFF Ce commutateur indique si le serveur Rational 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 Rational DOORS, comprenant le nom de fichier.

Le chemin par défaut est DOORS\9.version\certdb\server_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 séparé pour le fichier de clés Rational DOORS SSL, 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 Rational 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 Rational 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.

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

Si la communication doit être sécurisée, le port par défaut est 8443. Autrement, le port par défaut est 8080.

-dwaProtocol http ou https Ce commutateur identifie le protocole utilisé par le serveur Rational DOORS Web Access.

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

-dcnEnable   Ce commutateur active le service Data Change Notifications requis pour activer la communication avec le serveur et le courtier Rational DOORS Web Access.
-dcnBrokerUri tcp://courtier:61616 Ce commutateur identifie le courtier Rational DOORS Web Access, où broker est l'ordinateur qui héberge le courtier et 61616 est le 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.
Tableau 3. Commutateurs de ligne de commande pour doorsd dans Rational 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 Rational DOORS supplémentaire suivant sur les machines exécutant les systèmes d'exploitation Windows, où portnumber est égal au port de connexion de données et server_data_path au dossier de répertoire de données sur le serveur.

Par exemple :

"doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data._ Un numéro d'instance, tel que 00001, est attribué au nouveau service.

-remove   Ce commutateur supprime le service par défaut créé lorsque le serveur de base de données Rational DOORS est installé pour la première fois.
-mremove -i service_instance_number Ce commutateur supprime une instance spécifique d'un service de serveur de base de données Rational DOORS sur lequel portnumber est égal au numéro d'instance attribué 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 Rational DOORS configurés et leur statut.
-logfile log_file Ce commutateur définit le fichier utilisé pour la consignation de transaction du serveur de base Rational DOORS. 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 journalisation de transaction du serveur de base de données Rational DOORS. 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 de serveur de base de données Rational DOORS.
-stop   Ce commutateur démarre le service de serveur de base de données Rational DOORS.

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 Rational DOORS.
"C:\Program Files\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start -debug
Remarque : Utilisez -debug lorsque vous démarrez le serveur de base de données Rational DOORS à partir de la ligne de commande.

Vos commentaires