Zum Hauptinhalt springen

Kommandozeilen-Parameter und Rückgabewerte der Installationsroutine

Kommandozeilen-Parameter und Rückgabewerte der Installationsroutine Auflistung und Erläuterung der möglichen Kommandozeilen-Parameter sowie der Rückgabewerte der Installationsroutine

Die Installation kann teilweise oder auch ganz ohne einen Eingriff des Benutzers erfolgen. Der Installationsroutine können dazu verschiedene Parameter in der Kommandozeile übergeben werden. Die Parameter werden dabei mit "/" eingeleitet. Die Groß-/Kleinschreibung der Parameter wird nicht berücksichtigt.

c16_setup_*.exe [/? | /h | /help] [/lang=de|en] [/silent | /verysilent] [/sysui] [/nodriver] [/noicons] [/overwrite] [/nouninstall] [/nomsgbox] [/norestart] [/cpn_action=<action>] [/cpn_srv=<srv>] [/cpn_doc=<doc>] [/cpn_cln=<cln>] [/cpn_com=<com>] [/cpn_red=<red>] [/chk_off=<chk>] [/dir=<directory>] [/resultfile=<file>]

Die Schalter /cpn_srv, /cpn_doc, /cpn_cln und /cpn_com definieren welche Komponenten (in Abhängigkeit von /cpn_action) berücksichtigt werden sollen. Die Komponenten werden als hexadezimal addierte Werte angegeben (siehe Beispiele). Mit /chk_off werden Checkboxen deselektiert und ausgegraut dargestellt. Die Werte für die einzelnen Checkboxen können addiert werden, um mehrere Checkboxen zu deaktivieren.

  • /?, /h oder /help Die Online-Hilfe wird entpackt und die Hilfe zu den Übergabeparametern der Installation werden angezeigt. Es können auch alle anderen Seiten der Oline-Hilfe angezeigt werden.

  • /lang=de|en Es wird eine Sprache angegeben, in der die Installationsroutine Informationen oder Abfragen anzeigt. Zur Zeit stehen folgende Sprachen zur Auswahl:

  • de: deutsch

  • en: englisch

  • /silent Es werden nur die Splash-Screens und die Fortschrittsbalken angezeigt.

  • /verysilent Es werden nur die Splash-Screens angezeigt.

  • /sysui Die Windows-System-Oberfläche wird zur Anzeige benutzt und nicht die Modern Theme-Darstellung.

  • /nodriver Die Installation des Dongle-Treibers wird übergangen.

  • /noicons Es werden keine Einträge in das Startmenü vorgenommen.

  • /overwrite Die Konfigurationsdateien aus dem Startverzeichnis werden verwendet, unabhängig davon, ob auf dem System bereits Konfigurationsdateien existieren.

  • /nomsgbox Zum Abschluss der Deinstallation wird ein Dialogbox angezeigt. Die Anzeige des Dialogs kann mit dieser Option unterdrückt werden.

  • /norestart Ist diese Option übergeben worden, wird nicht zu einem Neustart des Computers aufgefordert, falls ein Neustart erforderlich ist. Ein Neustart wird erforderlich, wenn der Laufwerkstreiber installiert, aktualisiert oder deinstalliert wird.

info

Ist die Option /verysilent angegeben, wird automatisch ein Neustart ausgeführt, wenn er erforderlich ist. Mit dieser Option wird auch dann der Neustart unterbunden.

  • /cpn_action=<action> Dieser Schalter legt die Art der durchzuführenden Installation fest:
    • install Es wird eine Neuinstallation durchgeführt. Dieser Wert ist nur erlaubt, wenn noch keine Installation vorhanden ist. Über die Schalter /cpn_srv, /cpn_doc, /cpn_cln und /cpn_com müssen die zu installierenden Komponenten angegeben werden. Das Installationsverzeichnis kann in /dir angegeben werden. Ist kein Installationsverzeichnis angegeben, erfolgt die Installation in das Verzeichnis "CONZEPT 16" im Programm-Verzeichnis.
    • change Führt eine Änderung der installierten Komponenten durch. Der Wert ist nur gültig, wenn bereits eine Installation vorhanden ist. Welche Komponenten geändert werden sollen, wird duch die Schalter /cpn_srv, /cpn_doc, /cpn_cln und /cpn_com angegeben. Wird keiner der Schalter übergeben, wird lediglich die Auswahl-Seite (Ändern, Aktualisieren, Entfernen) übersprungen.
info

Nicht angegebene, jedoch bereits installierte Komponenten werden deinstalliert! Dies kann durch den optionalen Parameter /nouninstall unterbunden werden. Ist dieser angegeben, werden nicht angegebene Komponenten ignoriert.

- **`update`** Führt eine Aktualisierung der installierten Komponenten durch. Der Wert ist nur gültig, wenn bereits eine Installation vorhanden ist. Welche Komponenten aktualisiert werden sollen, wird durch die Schalter `/cpn_srv`, `/cpn_doc`, `/cpn_cln` und `/cpn_com` angegeben. Hierbei können natürlich **nur** Komponenten angegeben werden, die auch bereits installiert sind. Wird keiner der Schalter übergeben, wird die Auswahl-Seite (Ändern, Aktualisieren, Entfernen) übersprungen und alle installierten Komponenten werden aktualisiert.
- **`remove`** Führt eine Deinstallation der installierten Komponenten durch. Der Wert ist nur gültig, wenn bereits eine Installation vorhanden ist. Welche Komponenten deinstalliert werden sollen, wird durch die Schalter `/cpn_srv`, `/cpn_doc`, `/cpn_cln` und `/cpn_cln` angegeben. Wird keiner der Schalter übergeben, wird die Auswahl-Seite (Ändern, Aktualisieren, Entfernen) übersprungen und alle installierten Komponenten entfernt.
- **`extract`** Extrahiert die Komponenten in das durch `/dir=<dir>`angegebene Verzeichnis. Die Komponenten werden durch `/cpn_srv`, `/cpn_doc`, `/cpn_cln` und `/cpn_com` angegeben. Existiert das angegebene Verzeichnis nicht, wird es erstellt.
  • /cpn_srv=<srv>
info

Bei den übergebenen Zahlenwerten handelt es sich um Hexadezimalzahlen. Das wirkt sich besonders bei der Addition von mehreren Optionen aus. Soll zum Beispiel die Web-Schnittstelle und die PHP-Schnittstelle installiert werden, muss der Wert 0000000C angegeben werden.

  • 00000001: Windows Server

  • 00000002: Linux Server

  • 00000004: Control-Center

  • /cpn_doc=<doc>

  • 00000001: Online-Hilfe

  • /cpn_cln=<cln>

  • 00000001: Standard- und Advanced-Client

  • 00000002: API-Client

  • 00000004: Web-Schnittstelle

  • 00000008: PHP-Schnittstelle

  • 00000010: Druckertreiber

  • 00000020: Druckprozessor

  • 00000200: SOA-Service (Windows)

  • 00000400: ODBC-Treiber (32-bit)

  • 00000800: ODBC-Treiber (64-bit)

  • 00001000: SOA-Service (Linux)

  • 00010000: Laufwerkstreiber

  • /cpn_com=<com>

  • 00000001: Gemeinsame Komponenten des CtxDocEdit

  • 00000002: Extern vorliegendes Chromium-Package

  • /cpn_red=<red>

  • 00000001: Visual C++ Laufzeitkomponenten

info

Diese Option wird nur bei /cpn_action=extract ausgewertet.

  • /chk_off=<chk>

  • 00000001: Server als Dienst einrichten

  • 00000002: Server nach Abschluss der Installation starten

  • 00000004: Systemcache-Einstellung anpassen (siehe Installation des Servers unter Windows )

  • 00000100: Control-Center automatisch mit Windows starten

  • 00000200: Control-Center nach Abschluss der Installation starten

Durch Setzen der jeweiligen Flags wird die entsprechende Checkbox deselektiert und ausgegraut.

  • /dir=<directory> In dieser Option wird das Verzeichnis angegeben, in das die Programmstände extrahiert werden sollen. Existiert das Verzeichnis nicht, wird es angelegt.

  • /resultfile=<file> Mit dieser Option kann der Pfad und der Name einer Resultat-Datei angeben werden. Wird keine Datei angegeben, werden nur die Fehlerwerte 0 bis 5 zurückgegeben. War die Installation erfolgreich, wird keine Resultatdatei generiert. Ansonsten wird die Datei <file> mit dem Inhalt ExitCode <Fehlerwert> erzeugt. Der Fehlerwert ist ein numerischer Wert im Bereich 244 bis 255:

  • 244: Upgrade nicht möglich, da installierte Version kleiner 5.6.01.

  • 245: Vollversion ist installiert und Setup der Evaluierungsversion wird ausgeführt.

  • 246: Evaluierungsversion ist installiert und Setup der Vollversion wird ausgeführt.

  • 248: Eine oder mehrere Datenbanken sind noch offen. Rückgabewert tritt nur auf, wenn /silent oder /verysilent übergeben wurde.

  • 249: Fehler beim Upgraden der Version 5.1 auf eine höhere Version.

  • 250: Fehler beim Verschieben der Anwendungsdateien.

  • 251: Fehler beim extrahieren der Dateien.

  • 252: Aufgrund der übergebenen Kommandozeilenargumente hat die Installationsroutine festgestellt, dass keine Änderungen zur vorhandenen Installation vorliegen und die Routine deshalb beendet wurde.

  • 253: Die bereits vorhandene CONZEPT 16-Installation ist neuer als die zu installierende Version.

  • 254: Betriebssystem wird nicht unterstützt.

  • 255: Fehler bei der Übergabe der Kommandozeilenargumente oder ungültige Kombination der Argumente.

Beispiele:

Installation des Windows- und des Linux-Servers, des Control-Centers und der Dokumentation:

c16_setup_*.exe /cpn_action=install /cpn_srv=7 /cpn_doc=1

Installation des Windows Servers, des Control-Centers, der Dokumentation und des Standard- und Advanced-Clients in dem Verzeichnis "C:\CONZEPT 16":

c16_setup_*.exe /verysilent /noicons /cpn_action=install /dir="c:\CONZEPT 16" /cpn_srv=5 /cpn_doc=1 /cpn_cln=1

Update des installierten Windows-Servers. Alle anderen Komponenten werden entfernt:

c16_setup_*.exe /cpn_action=change /cpn_srv=1

Update des installierten Windows-Servers. Alle anderen Komponenten bleiben unverändert:

c16_setup_*.exe /cpn_action=change /cpn_srv=1 /nouninstall

Update des Druckertreibers (20 hexadezimal), des Druckprozessors (40 hexadezimal) und des ODBC-Treibers (80 hexadezimal, Summe = e0):

c16_setup_*.exe /cpn_action=change /cpn_cln=e0 /nouninstall

Alle Clients deinstallieren:

c16_setup_*.exe /cpn_action=remove /cpn_cln=ffffffff

Extrahieren aller Server-Komponenten in das Verzeichnis "c:\temp":

c16_setup_*.exe /cpn_action=extract /cpn_srv=ffffffff /dir="C:\temp"

Deselektierten und Sperren der Checkboxen "Server als Dienst einrichten" (001), "Server nach Abschluss der Installation starten" (002) und "Control-Center automatisch mit Windows starten" (100, Summe = 103):

c16_setup_*.exe /chk_off=103

Rückgabewerte der Installationsroutine

Wenn keine Resultatdatei vorliegt, gibt der Errorlevel der Installationsroutine Aufschluss über Erfolg oder Nicht-Erfolg der Installation. Dieser kann bei der Verarbeitung von Batches herangezogen werden.

  • Errorlevel: Beschreibung
  • 0: Kein Fehler - Routine erfolgreich durchgeführt.
  • 1: Fehler bei der Initialisierung.
  • 2: Die Installation wurde durch den Benutzer abgebrochen (bevor die Installation startete bzw. bei der Willkommen-Seite).
  • 3, 4: Fataler Fehler aufgetreten.
  • 5: Die Installation wurde vom Benutzer abgebrochen.

Bei der Deinstallation wird von der Installationsroutine immer der Errorlevel 0 zurückgegeben.