Anwender-Dokumentation

Anwender-Dokumentation 

ATOSS 

LINUX 

Update von 2.4 auf 2.5

Anwender-Doku FORMEL 1 

ATOSS Update 2.5M 

Was ist neu in der 2.5? ____________________________________________ 2 

Allgemein _______________________________________________________ 4 

Voraussetzungen____________________________________________________________ 4 

Update des SES Servers ________________________________________________ 5 

Vorbereitungen _____________________________________________________________ 5 

Einspielen der ATOSS LINUX CD-ROM _________________________________________ 10 

Probleme während des Ablaufs des Releasewechsels______________________________ 12 

Abschließende Arbeiten __________________________________________ 12 

Update der Windows Clients_____________________________________________ 13 

Eintragen des Testtimers _________________________________________ 17 

Weitere ATOSS-Clients in den Filialen aktualisieren __________________________ 19 

Fehlermeldung: Client passt nicht zum Server _______________________________ 19 

05.08.2005 © CARDIS GmbH & Co. KG, Murnau, 2005 Seite 1 /19



Was ist neu in der 2.5? 

- Diverse Fehlerbehebungen, aktuelle Programmversion von 2005. 

- Größere Eingabemasken 

- Auch Schichtzyklen und Schichtmodelle haben Varianten, bisher hatten das in den 

Zeitmodellen nur die Arbeitsmuster 

- Die Warnung „Ungültige Kostenstelle“ erscheint nicht mehr zweimal, wenn eine 

falsche Auftragsnummer gestempelt wurde. 

- Laden von Tagesinformationen: Neue Lademethode OriginalAM = „Original 

Arbeitsmuster“, lädt alles, was mit Schichtzyklus zu tun hat 

- Neuer Button „Alles lesen“ in den Auswahllisten am Bildschirm: alle Daten werden in 

der Liste dargestellt, nicht erst, wenn man ganz nach unten scrollt 

- Inaktive Mitarbeiter: reduzieren nicht die Mitarbeiterlizenzgröße, können aber 

trotzdem noch ausgewertet werden 




- Neu gestaltete Online Hilfe 

- Eingabe der Tagescodes nicht mehr über Assistent sondern über diesen Dialog: 

- Erweiterungen in der Bezugsartenrechnung 

- Optional kann für die 2.5 das Feature Änderungsprotokoll hinzugekauft werden 

... 




Allgemein 

Diese Dokumentation beschreibt das Aktualisieren eines LINUX-ATOSS Servers auf die 

Version 2.5 

Material: 

- 1 CD für LINUX 

- 1 CD für Windows 

- Testtimer-Lizenznummer 

- Das Passwort für den Hauptbenutzer root 

Bitte lesen Sie die Anleitung vor Beginn der Installation sorgfältig durch und prüfen Sie, ob 

sämtliche Voraussetzungen für einen Releasewechsel (=RW) gegeben sind. 

Der Releasewechsel benötigt unter Umständen sehr viel Zeit! Das ist von der Größe der SES- 

Datenbank abhängig. 

Für eventuelle Rückfragen stehen wir Ihnen jederzeit gerne zur Verfügung. Wenden Sie sich dazu 

bitte an unsere Hotline. 

Voraussetzungen 

- Nach diesem Update läuft ATOSS unter LINUX nur noch mit einem zeitlich begrenztem 

Testtimer. Die Prozesse der Dongleabfrage hatten unter Umständen für Probleme gesorgt, 

da die WIBUKEY-Software zu SLES7 nicht voll kompatibel war. Aus diesem Grund wurde 

diese „Spezialversion“ gemacht, bei der die Dongleabfrage nicht mehr aktiv ist. 

- Man braucht also einen Testtimer in der passenden Größe. Bevor dieses Update 

durchgeführt wird, sollte man mit F2-Taste und Eingabe von CHGINST prüfen, ob die Anzahl 

der Mitarbeiter kleiner als der vorhandene Testtimer ist. 




Update des SES Servers 

Vorbereitungen 

perl 

Das Releasewechsel-Script ist in Perl geschrieben und benötigt einen installierten Perl- 

Interpreter unter /usr/local/bin/perl. Ob und wo ein Perl-Interpreter installiert ist, kann 

mit dem Befehl which geprüft werden: 

# which perl 

/usr/bin/perl 

# ls -l /usr/local/bin/perl 

ls: /usr/local/bin/perl: Datei oder Verzeichnis nicht gefunden 

Falls der Perl-Interpreter in einem anderen Verzeichnis als /usr/local/bin abgelegt ist, 

muss mit root-Kennung ein entsprechender Link erstellt werden, z.B.: 

# ln -s /usr/bin/perl /usr/local/bin/perl 

# ls -l /usr/local/bin/perl 

/usr/local/bin/perl -> /usr/bin/perl 

(s. auch „Perl für AIX“ in der Installationsanleitung zur SES unter LINUX) 

Hinter jedem Punkt steht die Benutzerkennung, mit der die beschriebenen Schritte 

ausgeführt werden müssen. 

� Beenden der Formel I Schnittstelle (bbx) 

Melden Sie Sich an Formel I an und beenden Sie die ATOSS-Schnittstelle unter 

15.3.1. 

� Beenden von ATOSS (tarisadm) 

Alle ATOSS Prozesse müssen beendet werden (z.B. mit 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! 

o su – tarisadm 

o (tarisadm als Kennwort eingeben) 

- Vor dem Update müssen alle SES-Prozesse beendet werden (z.B. mit stoptaris). 

Kontrollieren Sie mit 

lui oder 

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 




� Backup der SES Datenbank (tarisadm/root) 

Hierzu kann die übliche Methode zum Backup der Datenbank verwendet werden. 

c00020: su - tarisadm 

Password: (tarisadm als Kennwort eingeben) 

tarisadm@c00020:~ > cd taris 

tarisadm@c00020:~/taris > cd bin 

tarisadm@c00020:~/taris/bincust > cd /home/tarisadm/taris/bin 

tarisadm@c00020:~/taris/bin > perl unloaddb.pl 

TARIS Datenbank wird in Textdateien ausgelesen ... 

Alte tarisexport-Dateien in /home/tarisadm/taris/database 

werden überschrieben! 

Weiter mit ENTER oder Abbruch mit Ctrl-C... 

reading acclog ... 

Laenge eines acclog Records ist: 40 

0 Saetze aus acclog gelesen - Mandant: * 

... 

... 

Laenge eines dszstat Records ist: 60 

0 Saetze aus dszstat gelesen - Mandant: * 

reading fmsglog ... 

Laenge eines fmsglog Records ist: 110 

0 Saetze aus fmsglog gelesen - Mandant: * 

reading fmsglog2 ... 

Laenge eines fmsglog2 Records ist: 170 

0 Saetze aus fmsglog2 gelesen - Mandant: * 

tarisadm@c00020:~/taris/bin > 

� Umkopieren des Backups ins Formel I Verzeichnis 




tarisadm@c00020:~/taris/bin > cd .. 

tarisadm@c00020:~/taris > cd database 

tarisadm@c00020:~/taris/database > cp *.tarisexport 

/home/bbx/atoss/backup 

tarisadm@c00020:~/taris/database > 

� Backup der SES-Installation (tarisadm/root) 

Das Update überschreibt die alte SES-Installation. Vor dem Update sollte deshalb 

das gesamte Unterverzeichnis taris des Benutzers tarisadm gesichert werden (z.B. 

mit tar). 

tarisadm@c00020:~/taris/database > cd 

somit wechselt man aufs Verzeichnis /home/tarisadm 

tarisadm@c00020:~ > tar -cvf taris240_juli2005.tar taris 

taris/ 

taris/bin/ 

taris/bin/lui 

taris/bin/export_basic_tables 

taris/bin/analyze_ora.sh 

taris/bin/dbbackup.ini 

taris/bin/term_time_sync 

taris/bin/zerror_snmp.atoss 

taris/bin/clrbooklog_atoss.sh 

taris/bin/save_taris_db.atoss 

taris/bin/ora_frontend 

... 

... 

� Backup der SES-Installation komprimieren 

tarisadm@c00020:~ > compress taris240_juli2005.tar 

� WICHTIG: in der Datei /home/tarisadm/.tarisrc mit einem Editor (z.B. vi) 

die Zeile 

export TARIS_DEBUG_SHMSNO=disable 

ergänzen: 

c00020: su - tarisadm 

Password: (tarisadm als Kennwort eingeben) 

tarisadm@atoss:~ > cd 

tarisadm@atoss:~ > cp .tarisrc .tarisrc24 

tarisadm@atoss:~ > vi .tarisrc 

Mit den Cursortasten ans Ende des Dokuments gehen, die „I“ Taste für Insert 

drücken und dann die fett dargestellte Zeile ergänzen: 




DB2PROFILE="" 

if [ ! -z "$DB2PROFILE" ]; then 

fi 

if [ -f $DB2PROFILE ]; then 

fi 

. $DB2PROFILE 

#export DB2DBDFT=TARIS 

export TARIS_DEBUG_SHMSNO=disable 

# Ende der Datei .tarisrc 

Nachdem die Zeile eingegeben ist, den Editor mit Speichern verlassen mit Eingabe 

von 

ESC-Taste 

:wq 

Return-Taste 

Es erscheint 

".tarisrc" 109L, 3503C written 

Danach tarisadm mit exit abmelden und wieder neu anmelden, damit die veränderte 

Datei .tarisrc neu geladen wird. 

� WICHTIG: in /home/bbx liegt seit Installation ATOSS eine Kopie von 

.tarisrc, auch in der muß der Schalter stehen, damit auch für die Formel i 

Schnittstelle (läuft unter user bbx) der Schalter gesetzt ist: 

cp /home/tarisadm/.tarisrc /home/bbx 

Falls folgende Meldung erscheint: 

cp: cannot create regular file `/home/bbx/.tarisrc': Keine 

Berechtigung 

gibt es ein Berechtigungsproblem mit der /home/bbx/.tarisrc Datei, 

tarisadm@c00020:~ > cd /home/bbx 

tarisadm@c00020:/home/bbx > ls -l .tarisrc 

-rwxr--r-- 1 bbx users 3433 Dez 16 2003 .tarisrc 

das folgendermaßen behoben wird: 




tarisadm@c00020:/home/bbx > su - 

Password: � hier root-Paßwort eingeben 

c00020:~ # cd /home/bbx 

c00020:/home/bbx # chmod 777 .tarisrc 

c00020:/home/bbx # exit 

tarisadm@c00020:/home/bbx > cp /home/tarisadm/.tarisrc /home/bbx 

� Berechtigung Oracle Verzeichnis /home/oracle/ora_db/dbs erweitern 

Das ATOSS-Installationsprogramm läuft eine Fehlermeldung, wenn der Benutzer 

tarisadm nicht in das Verzeichnis /home/oracle/ora_db/dbs zugreifen kann. 

Deshalb ist vorher ggf. die Berechtigung zu erweitern: 

tarisadm@c01148:/cdrom > cd /home/oracle/ora_db 

tarisadm@c01148:/home/oracle/ora_db > ls -l 

insgesamt 1 

drwx------ 2 oracle oinstall 611 Dez 8 2003 dbs 

drwx------ 2 oracle oinstall 379 Dez 8 2003 ora_redo2 

tarisadm@c01148:/home/oracle/ora_db > cd dbs 

bash: cd: dbs: Permission denied 

Das wird folgendermaßen behoben: 

tarisadm@c01148:/home/oracle/ora_db > su 

Password: � hier root-Paßwort eingeben 

root@c01148:/home/oracle/ora_db > chmod 777 dbs 

root@c01148: exit 

� Bereitstellung ausreichender Plattenkapazität (root) 

Während des Releasewechsels müssen einige Tabellen temporär gesichert werden, 

um sie anschließend wieder in die geänderte Tabellenstruktur laden zu können. 

Hierzu kann, je nach Größe der Datenbank, sehr viel Speicherplatz benötigt werden. 

Davon betroffen ist zum einen das Dateisystem der ATOSS Installation 

(/home/tarisadm/), und zum anderen das Dateisystem der Datenbank-Dateien 

(/home/oracle). Achten Sie bitte vorab darauf, dass in den beiden Dateisystemen 

mindesten 20 % noch verfügbar sind. Das Releasewechsel-Script ermittelt 

automatisch zu Beginn die aktuelle Größe der ATOSS-Datenbank und prüft, ob 

genügend Platz für temporäre Daten vorhanden ist. 




Einspielen der ATOSS LINUX CD-ROM 

Bitte melden Sie zunächst die LINUX CD-ROM an Ihrem System an. Hierzu müssen 

Sie sich evtl. als Benutzer root anmelden. 

tarisadm@c00020:~ > mount /cdrom 

tarisadm@c00020:~ > cd /cdrom 

In der folgenden Anleitung wird davon ausgegangen, daß die CD-ROM im 

Verzeichnis /cdrom angemeldet wurde. 

Hinweise: 

- Alle Schritte müssen als Benutzer tarisadm ausgeführt werden: 

o su – tarisadm 

Die Releasewechsel-Prozedur wird durch das PerlScript update_release.pl realisiert. 

Zusätzlich zu den Ausgaben in der Konsole wird eine ausführliche Protokolldatei 

geschrieben. Diese Datei ($TARIS/log/update_release_25.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_release_25.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_release.pl [CD-Verzeichnis] [Optionen] 

Das angegebene CD-Verzeichnis muss das Haupt-Archiv taris.tar enthalten. Ohne 

Angabe eines CD-Verzeichnisses wird das aktuelle Verzeichnis angenommen. Mögliche 

Optionen sind (Auszug): 

-h kurze Beschreibung der Optionen 

--help Beschreibung weiterer Optionen 

--tmpdir=Pfad Verzeichnis für temporäre Daten (Default: /tmp). 

Zum Start der RW-Prozedur gibt es zwei Möglichkeiten: direkt von CD-ROM oder ferner 

auch durch Entpacken des Archivs tarisupd.tar von CD. 

Die Update-Prozedur kann direkt von CD gestartet werden. Verwenden Sie hierzu folgende 

Befehle: 

tarisadm@c00020:~ > cd /cdrom 

tarisadm@c00020:/cdrom > ls 

TARIS_VERSION doc install_taris.pl taris.tar update_release.pl 

boot install pversion.exe tarisupd.tar update_version.pl 

tarisadm@c00020:/cdrom > ./update_release.pl 

Es kommt die Abfrage. 

„Soll das Releasewechsel-Script gestartet werden (j/n)?“ 

Dies beantworten sie bitte mit „j“ 




Fri Jul 22 10:27:48 2005 - Start des Releasewechsels (Version 2.5) 

(Das Protokoll wird in '/home/tarisadm/taris/log/update_release_25.log' 

geschrie 

ben.) 

Installation von 

System LINUX Version 2.4.7 

System libc Version 2.2.2 

Distribution LINUX 

Benutzerkennung tarisadm 

Umgebungseinstellungen werden untersucht ... 

Folgende Einstellungen wurden erkannt: 

-------------------------------------- 

SES Installationsverzeichnis (TARIS) = 

… 

Wird bei Ihnen das Installationsverzeichnis richtig 

angezeigt. Beantworten Sie die Abfrage 

„Sind diese Einstellungen korrekt? (j/n)“ 

ebenfalls mit „j“ 

Die folgende Meldung kann mit Drücken von RETURN übergangen werden: 

Der Archive Log Modus der Datenbank steht auf aktiviert 

(log_archive_start = TRUE) - das ist schlecht für die Performance 

des 

Releasewechsels, da sehr viele Änderungen archiviert werden müssten. 

Deaktivieren Sie den Archive Log Modus in einer zweiten Sitzung und 

kehren Sie anschließend an diese Stelle zurück. 

Siehe Abschnitt "Vorbereitung" in der Releasewechsel-Dokumentation. 

Weiter mit ENTER (empfohlen nach o.g. Aktion) oder Abbruch mit Ctrl- 

C... 

Falls das RW-Script nicht direkt von CD aus gestartet werden kann (oder soll), muss 

zunächst das Archiv tarisupd.tar von CD entpackt werden. Darin sind alle Dateien für den 

Ablauf des RW-Scripts enthalten: 

cd $TARIS 

tar xvf /cdrom/tarisupd.tar 

./update_release.pl /cdrom 




Falls während des Releasewechsels folgende Fehlermeldung erscheint, wurde statt als 

tarisadm der Releasewechsel als root gestartet: 

Anzahl Mandanten in der Datenbank wird mit den konfigurierten Mandanten 

in der CONVTAB verglichen ... 

/home/tarisadm/taris/command/readclts: error while loading shared 

libraries: lib 

clntsh.so.8.0: cannot load shared object file: No such file or directory 

Probleme während des Ablaufs des Releasewechsels 

Bei Problemen während des Ablaufs, reagiert das Script auf verschiedene Arten: 

� Ausgabe einer Warnung (das Script läuft i.d.R weiter) 

� Ausgabe einer Fehlermeldung und Warten auf eine Reaktion des Benutzers 

� Ausgabe einer Fehlermeldung und Abbruch 

� Zur genaueren Analyse von Problemen, können die ausführlichern Ausgaben in der 

Protokolldatei sehr hilfreich sein. Bei Anfragen an die Hotline sollten die beiden 

Dateien $TARIS/log/update_release_25.log und $TARIS/log/ 

update_release_25.state deshalb zur Verfügung gestellt werden können (z.B. per 

eMail). Da die Datei recht groß werden kann, sollte sie vor dem Versand komprimiert 

werden, 

z.B (AIX): 

gzip $TARIS/log/update_release_25.log 

Abschließende Arbeiten 

� Abmelden der CD-ROM (root) 

Die CD-ROM wird für den Server-Teil der Installation nicht weiter benötigt. 

� Archivierung alter Verzeichnisse (tarisadm) 

Die Unter-Verzeichnisse migrate, command, lib, print_jobs und log der 

$TARIS- Verzeichnisses wurden während des RW archiviert und anschließend 

geleert. Die komprimierten Archive sind im $TARIS-Verzeichnis abgelegt, z.B. 

$TARIS/command.240.tar.Z. 

Abschließend können Sie die CD-ROM abmelden und die SES-Prozesse mit starttaris 

wieder starten. 

tarisadm@c00020:/ > umount /cdrom 

tarisadm@c00020:/ > starttaris 

Starte Taris-Prozesse... 

bookloop wird gestartet 

tarisadm@c00020:/ > nohup: appending output to `nohup.out' 

Bitte starten Sie auch die Formel I Schnittstelle unter 15.3.1 wieder. 




Update der Windows Clients 

Führen Sie bitte das Update der Windows-Clients aus. Der Windows-Client befindet sich auf 

der zweiten CD ("NT 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 Verzeichnis \\c00020\atoss\tarisclt aktualsieren, man braucht zuerst eine 

Netzlaufwerkverbindung: 

Installer von Windows CD starten, Win-Client auswählen 

„Installation starten“ 

Installationsprogramm startet: 




- Zielverzeichnis abändern auf das bisher verwendete Client-Verzeichnis: 




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 




Fertig! 

Im Programm selbst wird unter „Info über ATOSS STARTUP EDITION“ oben die Version des Clients 

angegeben und unten die des Servers. 

ganz oben steht die Serverversion, unten die Clientversion. 

Falls bei Ihnen wie abgebildet in der dritten Zeile „ASES Version 2.4“ steht, ist das nicht die Version, 

sondern der Firmenname ist ASESVersion 2.4. 

Eintragen des Testtimers 

Vorgehensweise: 

- F2 Taste drücken 

- CHGINST eintragen 

- Unten auf „Timer“ drücken 

- Alte Einstellungen notieren, herauskopieren oder Screenshot 

- Testtimer eintragen 

- Es können einige Zeilen leer bleiben 

- OK 

- „Timer falsch“ darf nicht mehr erscheinen 

- Lizenz prüfen: 




nach Änderung des Firmennamens (!) in der ersten Zeile von CHGINST stimmt auch die dritte Zeile im 

Dialog „Info über ATOSS STARTUP EDITION“: 




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 aktualiseren 

Fehlermeldung: Client passt nicht zum Server 

Falls eine alte Client-Software nach dem Update des Server verwendet wird, erscheint sonst häufig 

die Meldung. 

Andreas.Scherer@dcsautomotive.de 

Einzelne Textpassagen wurden entnommen aus ATOSS LINUX CD, Dokument \DOC\*.HTML

Anwender-Dokumentation

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?