1 Themenübersicht
Das Tool „Softwareaktualisierungen importieren und installieren“ (insrfr) installiert Softwareaktualisierungen und Sprachaktualisierungen auf einem System. Die Installation der Softwareaktualisierungen und Sprachaktualisierungen läuft automatisch ab. Vorab können Softwareaktualisierungen importiert werden. Wenn bei der Installation Konflikte entstehen, wird eine Konfliktaufgabe erzeugt.
2 Zielgruppe
System-Administratoren
3 Voraussetzungen
Kenntnisse über Softwareaktualisierungen in Comarch ERP Enterprise.
4 Beschreibung
Die Installation von Softwareaktualisierungen und Sprachaktualisierungen kann für einen späteren Zeitpunkt eingeplant oder sofort ausgeführt werden. Wenn der Zeitpunkt erreicht ist, dann beginnt die Installation. Das System kann bis zum Ende der Installation nicht verwendet werden.
4.1 Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| insrfr | [-system:<str>]
[-installType:<vs>] [-codeClass:<str-1> … -codeClass:<str-n>] [-downtimeStart:<timeStamp>] [-continue] [-languages] [-importFromOldRelease] [-addCommand:<str>] [-cancel] [-info] [-reschedule] |
4.2 Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
| Parameter | Erläuterung |
| [-system:<str>] | Erfassen Sie den Namen des Systems, auf dem Sie die Installation von Softwareaktualisierungen durchführen möchten. Wenn Sie diesen Parameter nicht angeben, dann wird das aktuelle System ausgewählt. |
| [-installType:<vs>] | Wählen Sie die Installationsreihenfolge von System- und Anwendungs-Code aus.
Erfassen Sie „2“ für die parallele Installation von System- und Anwendungs-Code. Bei der parallelen Installation werden möglichst viele Arbeitsschritte im normalen Betrieb des Systems ausgeführt. Damit bleibt das System möglichst lange Zeit für die Benutzer verfügbar. Die parallele Installation wird vorgeschlagen. Erfassen Sie „3“ für die sequenzielle Installation von System- und Anwendungs-Code. Bei der sequenziellen Installation wird erst der System-Code vollständig installiert und danach der Anwendungs-Code. Die sequenzielle Installation kann in Ausnahmefällen bei besonders kritischen Änderungen am System-Code notwendig sein. |
| [-codeClass:<str-1>…
-codeClass:<str-n>] |
System- und Anwendungs-Code können getrennt installiert werden. Mit diesem Parameter wird „APP“ für Softwareaktualisierungen aus dem Anwendungsbereich und „SYS“ für Softwareaktualisierungen aus dem Systembereich übergeben. |
| [-languages] | Mit diesem Parameter werden Sprachaktualisierungen installiert. Sie können nur solche installieren, für die Sie eine Lizenz haben. |
| [-downtimeStart:
<timeStamp>] |
Beginn der Installation. Eventuell vorhandene Softwareaktualisierungen werden zur Vorbereitung vorher importiert. |
| [-continue] | Fortsetzen der Installation, auch dann, wenn die Installation abgebrochen wurde. |
| [-importFromOldRelease] | Importiert und installiert Softwareaktualisierungen aus älteren, bekannten Releases. Während des Imports kann folgende Fehlermeldung erscheinen:
„You are importing a code refresh of an older release. Use option – importFromOldRelease to import although.” Wenn Sie mehrere Releases des gleichen Systems betreiben, kann dies aus Versehen passieren oder weil Sie aufgrund von Abhängigkeiten eine Softwareaktualisierung installieren müssen. In diesem Fall benutzen Sie den Parameter „importFromOldRelease“, um die Softwareaktualisierungen zu installieren. |
| [-addCommand:<str-1>…
– addCommand:<str-n>] |
Führt nach Abschluss der Installation die angegebenen Befehle aus. Zum Beispiel können Sie durch Angabe von „wrkdatupd –execute:4“ die Ausführung von Datenaktualisierungen einplanen. |
| [-cancel] | Falls Sie für einen späteren Zeitpunkt eine Installation geplant haben, dann können Sie mit diesem Parameter die geplante Installation stornieren. Voraussetzung ist, dass die Installation noch nicht begonnen hat. |
| [-reschedule] | Falls Sie für einen späteren Zeitpunkt eine Installation geplant haben, dann können Sie mit diesem Parameter den Zeitpunkt der Installation verschieben. Dies erfordert die Angabe des Parameters „-downtimeStart“.Voraussetzung ist, dass die Installation noch nicht begonnen hat. |
| [-info] | Dieser Parameter ermöglicht, bestimmte Informationen abzufragen: Ist eine Installation geplant und wenn ja, für wann? Kann die geplante Installation noch verschoben werden? Ist evtl. ein Fehler aufgetreten? |
4.3 Skript
Die Installation von Softwareaktualisierungen kann auch in Einzelschritten erfolgen (siehe bei Bedarf die Dokumentationen zu den Tools „imprfr“, „upgaps“). Das Tool „Softwareaktualisierungen importieren und installieren“ (insrfr) erzeugt ein Skript („install.scl“), das die für eine Installation erforderlichen Einzelschritte enthält. Dieses Skript wird zu Beginn der Installation im Dateisystem im Ordner des Message-Servers abgelegt und vom System ausgeführt, indem es die Schritte sequentiell abarbeitet. Vor jedem Schritt überprüft das System, ob der vorangegangene Schritt erfolgreich ausgeführt wurde. Falls ja, wird der nächste Schritt ausgeführt, falls nein bricht die Skript-Verarbeitung ab.
Bei der Erstellung des Skripts werden die ausgewählten Softwareaktualisierungen dahingehend untersucht, ob diese einen Neustart des Servers benötigen. Dieses Skript führt falls notwendig auch Neustarts des Servers aus und setzt dann am entsprechenden Punkt des Skripts wieder auf.
Sollte während der Installation ein Fehler auftreten, dann bricht das System die Skript-Verarbeitung ab. In diesem Fall ist eine Analyse und evtl. ein manuelles Eingreifen durch einen Administrator notwendig.
Hinweis:
Während der Installation sollte das System nicht anderweitig verwendet werden, da es auch ohne Vorwarnung bei Bedarf durchgestartet wird. Evtl. vorhandene andere „scl“-Skripte werden während der Installation ignoriert.
Kritische Softwareaktualisierungen
Zu einem Release-Wechsel können kritische Softwareaktualisierungen vorkommen. Kritische Softwareaktualisierungen müssen einzeln installiert werden. Bei Release-Wechseln können Sie alle Softwareaktualisierungen in den „refreshes/import“-Ordner ablegen und das Tool „Softwareaktualisierungen importieren und installieren“ (insrfr) einmal ausführen. Sollten kritische Softwareaktualisierungen dabei sein, wird dies erkannt und automatisch berücksichtigt. In so einem Fall wird ein Skript erzeugt, das effektiv mehrere Installationen nacheinander ausführt.