Befehlszeilenschalter für den Datenbankserver

Mit Befehlszeilenschaltern können Sie Optionen für den Befehl dbadmin festlegen und den Datenbankserver von IBM® Engineering Requirements Management DOORS (DOORS) verwalten.
Anmerkung: Zur Verwendung des Befehls dbadmin ist der Schalter -data erforderlich. Wenn Sie diesen Schalter übergehen oder einen ungültigen Datenwert verwenden, kann der Befehl nicht ausgeführt werden und die folgende Nachricht wird angezeigt: -F- DBADMIN: Server not specified.

Eine Liste der Befehlszeilenschalter für den DOORS-Client finden Sie unter Befehlzeilenschalter für den DOORS-Client.

Tabelle 1. Befehlszeilenschalter für den Befehl dbadmin in DOORS.
Schalter (Kurzform) Parameter Beschreibung
+-data (-d) port@DOORS-server Dieser Schalter gibt den Datenbankserver an, wobei port für die vom Datenbankserver verwendete Portnummer und DOORS-server für den Namen des Computers steht, auf dem der Datenbankserver installiert ist. Dieser Schalter ist immer erforderlich.
-killprocess (-k) kanal-id Unterbricht die Benutzerverbindung, die vom Parameter kanal-id angegeben wird.

Der Parameter kanal-id wird mithilfe des Schalters -userlist angezeigt.

-killserver (-K)   Dieser Schalter stoppt den Server.
-locklist (-l)   Dieser Schalter listet alle derzeit gesperrten Dateien und die Kanal-ID für jede Datei auf.
-outfile (-o) dateiname Dieser Schalter sendet Ausgaben an eine Datei.

Verwenden Sie diesen Schalter zusammen mit den Schaltern -locklist und -userlist.

-password (-P) Kennwort Dieser Schalter ist das aktuelle Kennwort für den Server.
-newpassword (-p) neueskennwort Dieser Schalter ist das neue Kennwort für den Server.
-unlock (-U) kanal-id Dieser Schalter entsperrt die Datei, die mithilfe des Parameters kanal-id angegeben wird.

Der Parameter kanal-id wird mithilfe des Schalters -locklist angezeigt.

-userlist (-u)   Dieser Schalter listet alle Benutzerverbindungen auf.
-serverLogging protokollstufe Wenn der Server mit den Parametern loglevel und logfile gestartet wurde, können Sie mit diesem Schalter die Protokollebene ändern.

Sie müssen den Server nicht erneut starten, damit die neue Protokollebene wirksam wird.

Weitere Informationen zur Protokollierung sowie eine Beschreibung der Protokollstufen finden Sie in Protokolldateien.
-tdsUserFilterLimit string Dieser Schalter grenzt die Suche nach Benutzern auf Rational Directory Server ein.
-tdsGroupFilterLimit string Dieser Schalter grenzt die Suche nach Gruppen auf Rational Directory Server ein.
-useCardAuthentication   Dieser Schalter aktiviert die Chipkartenauthentifizierung.
-doNotUseCardAuthentication   Dieser Schalter inaktiviert die Chipkartenauthentifizierung.
-useOSUserAuthentication   Dieser Schalter aktiviert die Benutzerauthentifizierung des Betriebssystems.
-doNotUseOSUserAuthentication   Dieser Schalter inaktiviert die Benutzerauthentifizierung des Betriebssystems.
-certName string Dieser Schalter gibt die Bezeichnung des Zertifikats an, das zum Identifizieren des Servers während der sicheren Authentifizierung verwendet wird.

Die Standardbezeichnung ist IBMSV1.

Tabelle 2. Befehlszeilenschalter für den Befehl dbadmin in IBM Engineering Requirements Management DOORS - Web Access (DWA)
Schalter (Kurzform) Parameter Beschreibung
-dwaHost DWA-server Dieser Schalter gibt den DWA-Server an, wobei DWA-server der vollständig qualifizierte Hostname des Computers ist, auf dem der Web-Server ausgeführt wird. Beispiel: dwaserver.ibm.com.
-dwaPort port Dieser Schalter gibt die Nummer des Ports an, an dem der DWA-Server ausgeführt wird.

Standardwerte und URIs finden Sie in den folgenden wichtigen Hinweisen nach dieser Tabelle.

-dwaProtocol http oder https Dieser Schalter gibt das Protokoll an, das der DWA-Server verwendet.

Wenn die Kommunikation sicher ist, geben Sie https ein. Geben Sie andernfalls http ein. Geben Sie nicht beides ein.

Informationen zur Abhängigkeit zwischen Protokoll und Standardportwerten finden Sie in den folgenden Hinweisen.

-dcnEnable   Dieser Schalter aktiviert die Benachrichtigungen über Datenänderungen, die erforderlich sind zum Aktivieren der Kommunikation mit dem DWA-Server und -Broker.
-dcnBrokerUri tcp://broker:61616 Dieser Schalter gibt den DWA-Broker an, wobei broker der Computer ist, auf dem der Broker ausgeführt wird, und 61616 die Standardportnummer, die der Broker verwendet.
-dcnChannelName dcn Dieser Schalter richtet den Kanal für die Benachrichtigungen über Datenänderungen ein. Der Kanalname lautet immer "dcn".
-dcnInfo   Dieser Schalter überprüft den Status des Service für die Benachrichtigung über Datenänderungen.
-dcnEnable   Dieser Schalter aktiviert den Kanal für die Benachrichtigungen über Datenänderungen.
-dcnDisable   Dieser Schalter inaktiviert den Kanal für die Benachrichtigungen über Datenänderungen.
Wichtig: Wenn der Schalter -dwaPort leer ist, nimmt der Wert für den Port standardmäßig den Standardport für das ausgewählte Protokoll an:
Tabelle 3. Befehlszeilenschalter für den Befehl doorsd in DOORS.
Schalter (Kurzform) Parameter Beschreibung
-minstall -port portnummer -serverdata serverdatenpfad Dieser Schalter erstellt einen zusätzlichen DOORS-Datenbankserverservice auf Computern mit Windows-Betriebssystemen, wenn die Parameter mit folgenden Werten gesetzt werden:
  • portnummer entspricht dem Datenverbindungsport
  • serverdatenpfad entspricht dem Ordner für das Datenverzeichnis auf dem Server
Beispiel: "doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.7\new_data". Dem neuen Service wird eine Instanznummer zugewiesen, zum Beispiel 00001.
-remove   Dieser Schalter entfernt den Standardservice, der erstellt wird, wenn der Datenbankserver zum ersten Mal installiert wird.
-mremove -i serviceinstanznummer Dieser Schalter entfernt eine bestimmte Instanz des Datenbankserverservice; hierbei steht portnummer für die Instanznummer, die dem Namen des Datenbankservice zugewiesen ist.
-list   Von diesem Schalter wird eine Liste aller konfigurierten DOORS-Datenbankserverservices mit ihrem Status im Tabellenformat ausgegeben.
-logfile protokolldatei Mit diesem Schalter wird die Datei festgelegt, die für die Transaktionsprotokollierung für den Datenbankserver verwendet wird. Eine Beschreibung der Protokollstufen finden Sie unter Protokolldateien.
-loglevel protokollstufe Mit diesem Schalter wird die Detaillierungsebene für Informationen festgelegt, die von der Transaktionsprotokollierung des Datenbankservers aufgezeichnet werden. Verwenden Sie den Wert 0, um die Protokollierung zu inaktivieren. Verwenden Sie den Wert 6, um die ausführlichsten Details zu erhalten.
-start   Dieser Schalter startet den Standardservice für den Datenbankserver.
-stop   Dieser Schalter stoppt den Standardservice für den Datenbankserver.
-logxconfig (-X) protokolldateiname Der vollständige Name der Konfigurationsdatei log4cxx; Beispiel: c:\Programme\IBM\Rational\DOORS\9.6\logging-config.xml. Log4cxxj ist ein Framework zum Protokollieren der Anwendungsnachrichten. Wenn Sie diesen Parameter in der Befehlszeile oder Registry verwenden, werden die Anwendungsnachrichten in der angegebenen Konfigurationsdatei ausgegeben. Es werden sechs Stufen von Nachrichten protokolliert:
  • TRACE
  • DEBUG
  • INFO, einschl. ACK, CONFIRM und QUERY
  • WARNING
  • ERROR
  • FATAL
-secure on, ON, off, OFF Dieser Schalter gibt an, ob der DOORS-Server für den Start im sicheren Modus konfiguriert ist.
-keyDB dateiname Dieser Schalter ist der vollständige Pfad zur Schlüsseldatenbankdatei, die die Schlüssel für die Verwendung für die DOORS-SSL-Authentifizierung und -Validierung enthält, einschließlich des Dateinamens.

Der Standardpfad lautet DOORS\9.version\certdb\client_authentication.kdb.

Dieser Schalter hat Vorrang vor dem Schalter -certdb. Verwenden Sie zum Angeben einer Position für den Schlüsseldatenbankordner von Rational Directory Server den Schalter -certdb. Verwenden Sie zum Angeben einer separaten Position für die SSL-Schlüsseldatenbankdatei von DOORS den Schalter -keyDB.

-certdb Ordnername Dieser Schalter gibt den Ordner an, der die Schlüsseldatenbankdateien enthält, die wiederum die Schlüssel für Rational Directory Server- und DOORS-SSL enthalten.

Der Standardpfad lautet DOORS\9.Version\certdb\.

Wenn Sie die Schlüsseldatenbankdateien für DOORS-SSL in einen separaten Ordner platzieren möchten, verwenden Sie den Schalter -keyDB. Der Schalter -keyDB hat Vorrang vor dem Schalter -certdb.

-certName string Dieser Schalter gibt die Bezeichnung des Zertifikats an, das zum Identifizieren des Servers während der sicheren Authentifizierung verwendet wird.

Die Standardbezeichnung ist IBMSV1.

-serverhostname string Dieser Schalter ist der Name, der vom Server zu seiner eigenen Identifizierung während der Zertifikatsüberprüfung verwendet wird.

Die Standardbezeichnung ist IBMEDSERV.

Beispiel: Befehl für Befehlszeile

Sie können Befehlszeilenschalter in der Befehlszeile und in Direktaufrufen verwenden.

Geben Sie zum Herunterfahren eines Servers, der unter 36677@IBMEDSERV ausgeführt wird, den folgenden Befehl ein:
dbadmin -data 36677@abc -killserver

Beispiel: Befehl für Direktaufruf

Verwenden Sie zum Starten eines Servers den folgenden Direktaufruf. Bearbeiten Sie den Befehl so, dass er den Pfad Ihrer Installation von DOORS enthält.
"C:\Program Files (x86)\IBM\Rational\DOORS\9.7\bin\doorsd.exe" -start

Videosymbol Video

Jazz.net-Kanal
Kanal 'Software Education'

Lernsymbol Kurse

IoT Academy
Skills Gateway

Fragesymbol Community

Jazz.net
Jazz.net-Foren
Jazz.net-Bibliothek

Unterstützungssymbol Unterstützung

IBM Support Community
Bereitstellungs-Wiki