Anwender-Dokumentation Update ATOSS LINUX Versionswechsel innerhalb der V2.5
Allgemein Diese Dokumentation beschreibt das Aktualisieren eines LINUX-ATOSS-Servers auf die Version 2.5 vom 01.07.2011. Material: - 1 CD für das Update des LINUX-ATOSS-Servers ( 01.07.2011 ) - 1 Zusatz-CD für das Update der Windows-Clients Bitte lesen Sie die Anleitung vor Beginn der Installation sorgfältig durch und prüfen Sie, ob sämtliche Voraussetzungen für das Update gegeben sind. Das Update benötigt Kenntnisse in der Linux Systemumgebung! Die Zeit ist von der Größe der SES-Datenbank abhängig. Für eventuelle Rückfragen zur Vorbereitung des Updates stehen wir Ihnen jederzeit gerne zur Verfügung. Wenden Sie sich dazu bitte an unsere Hotline. Vergessen Sie bitte nicht, wie ab Seite 8 ( Update der Windows Clients ) beschrieben, alle Clients upzudaten und vergessen Sie auch nicht unterschiedliche Installationen in den Filialen oder angeschlossenen anderen Betriebsstätten. Vorbereitungen Bitte prüfen Sie, ob Sie genügend Plattenkapazität auf dem Server für dieses Update zur Verfügung haben. Melden Sie sich an einer Server-Konsole als Benutzer root an. c00020 login: root Password: cardis Überprüfen Sie mit dem Befehl df h, ob unter home mind.500 MB freier Plattenplatz zur Verfügung stehen. Sollte dies nicht der Fall sein, bitte an die CARDIS-Hotline wenden. Wir werden Ihnen dann die Plattenkapazität entsprechend erweitern. 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 2 /12
Update des SES Servers Beenden der FORMEL 1-Schnittstelle (bbx) Melden Sie Sich an FORMEL 1 an und beenden Sie die ATOSS-Schnittstelle unter 15.3.1. Beenden von ATOSS (tarisadm) Alle ATOSS Prozesse müssen beendet werden (mit dem Befehl stoptaris). Mit dem Befehl lui kann kontrolliert werden, dass keine Prozesse mehr laufen. Es dürfen auch keine Prozesse für die Terminalkommunikation oder Druckausgabe mehr laufen (z.b. prtmonth, zdemuldfv,...). ACHTUNG: Es brauchen nur die SES Programme beendet werden, die Datenbank muss dagegen gestartet bleiben! Melden Sie sich an einer Server-Konsole als Benutzer tarisadm an. o su tarisadm o (tarisadm als Kennwort eingeben) Stoppen Sie taris. tarisadm@c00020:/ > stoptaris Kontrollieren Sie mit dem Befehl lui oder mit dem Befehl ps ef grep taris ob alle Prozesse beendet sind. tarisadm@c00020:~ > ps -ef grep taris root 10239 10238 0 16:42 pts/0 00:00:00 login -- tarisadm tarisadm 10240 10239 0 16:42 pts/0 00:00:00 -bash tarisadm 10251 10240 0 16:44 pts/0 00:00:00 ps ef tarisadm 10252 10240 0 16:44 pts/0 00:00:00 grep taris Sicherung der SES-Umgebung mit dem Datensicherungstool Starten Sie das Datensicherungstool ( DASI-Tool ) entweder in FORMEL 1 im Menü 9.14.4 oder auf einer Server-Konsole als Benutzer dasi mit dem Paßwort cardis c00020 login: dasi Password: cardis und führen Sie als Sofortsicherung eine Sicherung des Paketes ATOSS auf einem separaten Datensicherungsband aus. 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 3 /12
Achten Sie auf eine fehlerfreie Durchführung ( History-Funktion im DASI-Tool ) Damit haben Sie eine Kopie der benötigten Dateien auf Band gesichert, die im Fehlerfall für die Rücksicherung auf den bisherigen Stand dient. 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 4 /12
Einspielen der ATOSS LINUX CD-ROM Bitte melden Sie zunächst die LINUX CD-ROM an Ihrem System an. Hierzu müssen Sie sich als Benutzer root anmelden. root@c00020: ~ > mount /cdrom root@c00020:~ > cd /cdrom In der folgenden Anleitung wird davon ausgegangen, dass die CD-ROM im Verzeichnis /cdrom angemeldet wurde. Hinweise: - Alle folgenden Schritte müssen als Benutzer tarisadm ausgeführt werden: o su tarisadm Lassen Sie sich zur Kontrolle mit dem Befehl ls -l den Inhalt der CD anzeigen Die Update-Prozedur wird durch das PerlScript update_version.pl realisiert. Zusätzlich zu den Ausgaben in der Konsole wird eine ausführliche Protokolldatei geschrieben. Diese Datei ($TARIS/log/ update_version.log) enthält u.a. alle SQL Statements, die auf der Datenbank ausgeführt werden und deren Ergebnisse. Alle erfolgreich ausgeführten Einzelschritte merkt sich dass Script zusätzlich in der Datei $TARIS/log/ update_version.log.state. Falls ein abgebrochener Script-Lauf neu gestartet werden muss, kann mit Hilfe dieser Datei bestimmt werden, welche Schritte nicht mehr ausgeführt werden sollen. Allgemeine Aufruf-Syntax: update_version.pl [CD-Verzeichnis] [Optionen] Starten Sie das Update bitte mit dem Befehl perl update_version.pl 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 5 /12
Falls Sie die unten aufgeführte Warnungen erhalten, kontaktieren Sie bitte die CARDIS- Hotline unter 08841/600-1005. WARNUNG: Auf dem Zielsystem sind weniger als 50 MB freier Speicherplatz! Weiter mit ENTER oder Abbruch (Empfohlen) mit Ctrl-C... WARNUNG: Verzeichnis </tmp> kann nicht beschrieben werden oder enthält weniger als 1024 KB freien Speicherplatz. Weiter mit ENTER oder Abbruch mit Ctrl-C... Folgende Abfrage betreffs korrekter Einstellungen kann mit J bestätigt werden. Thu Jul 4 09:56:48 2011 - Start des Updates (Version 250) Installation von </media/cdrom> System LINUX Version 2.6.5 System libc Version 2.3.3 Distribution LINUX Benutzerkennung tarisadm Umgebungseinstellungen werden untersucht... Folgende Einstellungen wurden erkannt: -------------------------------------- TARIS Installationsverzeichnis (TARIS) = </home/tarisadm/taris> TARIS Spracheinstellung (TARIS_LANG) = <ge> TARIS Primärsprache (TARIS_PRIMARY_LANG) = <ge> System Spracheinstellung (LANG) = <de_de> Datenbank: Oracle Oracle Installationsverzeichnis (ORACLE_HOME) = </opt/ora92> Sprache der Oracle Instanz (NLS_LANG) = <German_Germany.WE8ISO8859P1> Sortiereinstellung der Sprache (NLS_SORT) = <BINARY> TARIS Datenbank Benutzer (TARIS_ORACLE_USER) = <tarisadm> Passwort des Benutzers (TARIS_ORACLE_PASSW) = <tarisadm> Service der TARIS DB (TARIS_ORACLE_DATABASE) = <SES> Sind diese Einstellungen korrekt? (j/n) j Prüfen der ORACLE Datenbank... Oracle RDBMS Version = 9.2.0.4.0 Oracle sqlplus Version = 902000400 Entpacken des Archivs vom Installationsmedium '/media/cdrom'...... 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 6 /12
Nach einem erfolreichen Update-Lauf erhalten Sie folgende Meldung Thu Jul 4 10:16:48 2011 Update beendet. (Das Protokoll des Updates wurde in '/home/tarisadm/taris/log/update_version.log' ges) Abschließende Arbeiten Abschließend können Sie die CD-ROM als Benutzer root abmelden und die SES-Prozesse als Benutzer tarisadm mit dem Befehl starttaris wieder starten. root@c00020: ~ > umount /cdrom Melden Sie sich als tarisadm wieder an und starten taris. root@c00020: ~ > su tarisadm Password: tarisadm tarisadm@c00020:/ > starttaris Starte Taris-Prozesse... bookloop wird gestartet tarisadm@c00020:/ > nohup: appending output to `nohup.out' Bitte starten Sie danach auch wieder die Formel 1- Schnittstelle im Menü 15.3.1 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 7 /12
Update der Windows Clients Führen Sie bitte das Update der Windows-Clients aus. Der Windows-Client befindet sich auf der zweiten CD ("Zusatz-CD"). Sie können das Update wahlweise durch das Script setup.bat im Hauptverzeichnis der CD oder herkömmlich über die Datei setup.exe im Verzeichnis taris\client32 starten. Wo die Client-Software liegt, sehen Sie über Rechtsklick / Eigenschaften auf das ATOSS-Icon auf Ihrem PC. In diesem Beispiel liegt die Client-Software in \\C00020\atoss\tarisclt. Das ist das LINUX-Verzeichnis /home/bbx/atoss/tarisclt, welches in der Netzwerkumgebung so aussieht: Die Client-Software befindet sich unter \\C00020\atoss\tarisclt damit man diesen Update nur einmal machen muß und alle PCs, die eine Verknüpfung (s.o.) auf diese Clientsoftware aus diesem Verzeichnis haben, dann sofort die aktuelle Version haben. Wichtig: Bei Filialbetrieben liegt die Client-Software meist in der Filiale auch nochmal vor, damit das Programm schneller startet. Dann auch in den Filialen die folgenden Schritte durchführen. Vorgehensweise: - Diesen Ordner tarisclt duplizieren: Da der Installer der Client-Software nur über Laufwerksbuchstaben geht, kann man nicht direkt das 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 8 /12
Verzeichnis \\c00020\atoss\tarisclt aktualsieren, man braucht zuerst eine Netzlaufwerkverbindung: Installer von Windows CD starten, Win-Client auswählen Installation starten Installationsprogramm startet: 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 9 /12
- Zielverzeichnis abändern auf das bisher verwendete Client-Verzeichnis: 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 10 /12
Netzlaufwerk mit Client-Software wurde ausgewählt, Weiter Werden Sie nach Verbindungsinformationen (Rechnername, Portnummer) gefragt, so haben Sie ein neues Verzeichnis gewählt. Gehen Sie in diesem Fall bis zur Auswahl der Verzeichnisses zurück und wählen Sie das richtige Verzeichnis aus. Anschließend beendet sich das Installationsprogramm. Das orange Fenster darunter wird sichtbar. Abbrechen anklicken 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 11 /12
Fertig! Im Programm selbst wird unter Info über ATOSS STARTUP EDITION oben die Version des Clients und unten die des Servers angegeben. Weitere ATOSS-Clients in den Filialen aktualisieren Bei Filialen muß ebenfalls die Client-Software aktualisiert werden, da die häufig nicht über die Standleitung aus \\c00020\atoiss\tarisclt geladen wird, sondern lokal auf den Rechner(n) liegt. Bitte auch dort die Windows-CD einlegen und den Client aktualisieren Fehlermeldung: Client passt nicht zum Server Falls eine alte Client-Software nach dem Update des Server verwendet wird, erscheint sonst häufig diese Meldung. 31.07.2011 CARDIS Reynolds GmbH, Murnau 2011 Seite 12 /12