LFD

Dieses Dokument basiert auf den Freigabemitteilungen für SISIS-Sunrise V4.1pl2 sowie auf den Erfahrungen die während der folgenden Updates gemacht wurden.

Datum	Bibliothek
2012.11	Lippische Landesbibliothek Detmold
2012.12	Stadtbücherei Pulheim
2013.04	Kantonsbibliothek Uri
2013.05	Hochschule Ostwestfalen-Lippe

Dieses Dokument beschreibt den direkten Update von SISIS-Sunrise V3.7pl2 auf V4.1pl2 auf einem Webrechner.

Status der in diesem Dokument beschriebenen Beispielkomponenten
Komponente	Vorher	Danach
Rechnername	slx005	slx005
Betriebssystem	SLES 11 (i586)	SLES 11 (i586)
Datenbankserver	keiner	keiner
Bibliothekssystem	SISIS-SunRise V3.7pl2	SISIS-SunRise V4.1pl2

Diese Dokumentation passt in entsprechend angepasster Weise für alle Updates von einer Version höher als SISIS-Sunrise V3.6.

Es ist zu empfehlen, alle händisch angepassten Dateien ins Verzeichnis "/OCLC/backup/CUSTOMIZED/V4.1pl2" zu kopieren, um eine die Wiederherstellung der Konfiguration bei einem späteren Update zu vereinfachen!

Voraussetzungen

Lesen der relevanten Freigabemitteilungen

Siehe dazu SISIS-Sunrise - Update von Sybase ASE 12.5.4 und V3.7pl2 zu ASE 15.0.3 und V4.1pl2 (SLES).

URLs

• Aussenadresse des Webrechners zum Testen des Aufrufs
• URL für Divibib
• URL für Saferpay

Sichern wichtiger Parameter und Verzeichnisse

Alle im Zusammenhang mit SISIS-Sunrise laufenden Server müssen gestoppt werden! Falls diese also nicht bereits gestoppt sind, so müssen sie jetzt gestoppt werden (siehe oben).

# /etc/init.d/tomcat stop

Überprüfen der Grösse der zu sichernden Verzeichnisse.

# du -sh /etc            \
         /home/sisis     \
         /opt/lib/sisis  \
         /usr/local      \
         /var/spool/cron \
         /var/spool/sisis
48M	/etc
406M	/home/sisis
du: Zugriff auf „/opt/lib/sisis“ nicht möglich: Datei oder Verzeichnis nicht gefunden
987M	/usr/local
16K	/var/spool/cron
du: Zugriff auf „/var/spool/sisis“ nicht möglich: Datei oder Verzeichnis nicht gefunden

Überprüfen, ob es auf dem lokalen Rechner genug Platz für die zu sichernden Verzeichnisse gibt.

# df -k

Bestimmen des Verzeichnisses, wo die zu sichernden Verzeichnisse gespeichert werden sollen.

# BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2
# cd $BACKUPDIR

Sichern der SISIS-Sunrise-Konfigurationseinstellungen.

# mkdir PKGPARAM
# for i in sisis-fast \
           sisis-pap  \
           webOPAC;   \
    do $(which pkgparam) -v ${i} > PKGPARAM/${i}; done

Sichern der mit SISIS-Sunrise zusammenhängenden Verzeichnisse auf dem lokalen Rechner.

# for i in /etc              \
           /home/sisis       \
           /opt/lib/sisis    \
           /usr/local        \
           /var/spool/cron   \
           /var/spool/sisis; \
    do tar cf - ${i} | tar xf -; done
tar: Removing leading `/' from member names
tar: Removing leading `/' from member names
tar: Removing leading `/' from member names
tar: /opt/lib/sisis: Kann stat nicht ausführen.: Datei oder Verzeichnis nicht gefunden
tar: Fehler beim Beenden, verursacht durch vorhergehende Fehler.
tar: Removing leading `/' from member names
tar: Removing leading `/' from member names
tar: Removing leading `/' from member names
tar: /var/spool/sisis: Kann stat nicht ausführen.: Datei oder Verzeichnis nicht gefunden
tar: Fehler beim Beenden, verursacht durch vorhergehende Fehler.

Bei Platzproblemen sollte nun hier aus den gesicherten Verzeichnissen alles unnötige gelöscht werden. Löschbare Verzeichnisse sind unter anderem wohl

# cd /OCLC/backup/SunRise-V3.7pl2/usr/local
# rm -rf bin games include lib man sbin share src

# cd /OCLC/backup/SunRise-V3.7pl2/usr/local/sisis-pap
# rm -rf bin docs include java1.5 lib licenses man misc php share squid

# cd /OCLC/backup/SunRise-V3.7pl2/usr/local/sisis-pap/apache
# rm -rf bin include lib logs man modules

# cd /OCLC/backup/SunRise-V3.7pl2/usr/local/sisis-pap/tomcat
# rm -rf liblogs temp

Arbeiten im Betriebssystem

Einrichtung des neuen Webrechners durch Admin Kuhn GmbH

• Einrichten MTA und Test
• Einrichten NTP (swisstime.ethz.ch)
• sshd_config: AllowTcpForwarding yes (ist das nötig oder sowieso Standard?)
• Anmeldebildschirm mit Rechnerinformationen
• Solaris: Nachinstallation von "md5" und "top"

Beschaffung der SISIS-SunRise V4.1pl2-Software

Die SISIS-Sunrise V4.1pl2-Software ist bereits auf dem Bibliotheksrechner vorhanden und muss nur noch auf den Webrechner kopiert werden.

SISIS-Sunrise-Wartungsskripte (maintenance scripts)

Falls den Anweisungen dieser Anleitung gefolgt werden soll, so müssen einige grundlegende Wartungsskripte installiert werden. Falls die Gruppe "sisis" und der Benutzer "sisis" nicht vorhanden sind, so werden sie angelegt. Es ist in jedem Fall die Version der Wartungsskripte vom 23. Juni 2011 oder später zu verwenden.

Vom neuen Bibliotheksrechner aus wird zuerst die folgende TAR-Datei auf den Webrechner kopiert.

# cd /OCLC/software/SunRise-V4.1pl2/Server
# scp SunriseMaintScripts-V4.1pl2.tar root@Webrechner:/tmp

Falls das Verzeichnis "OCLC" nicht auf der root-Partition angelegt werden sollen, so sollte dort zumindest ein Softlink auf das tatsächliche Verzeichnis angelegt werden.

Beispielsweise wird das Verzeichnis "OCLC" auf der zweiten Festplatte in Partition "/data" angelegt. Entsprechend wird das Verzeichnis "/data/OCLC" angelegt.

# mkdir /data/OCLC && chmod 777 /data/OCLC

Danach wird ein Softlink von "/OCLC" auf "/data/OCLC" angelegt. Achtung: Die Syntax des Linux-Befehls ln(1) ist nicht dieselbe wie diejenige des Befehls unter Solaris!

Linux:
# ln -s /data/OCLC /OCLC

Solaris:
# ln -s /OCLC /data/OCLC

Auf dem Webrechner.

# cd /tmp
# tar xf SunriseMaintScripts-V4.1pl2.tar
# ./InstallSunriseMaintScripts.sh

sisis:!:1001:
Group sisis exists in /etc/group
sisis:x:1000:1001:sisis:/home/sisis:/bin/bash
User sisis exists in /etc/passwd

Erstellen der Mailweiterleitung

Erstellung von ".forward"-Dateien für die Benutzer "root" und "sisis".

Anlegen der OCLC-Installationsverzeichnisse

Anlegen der OCLC-Installationsverzeichnisse.

# CreateUsersAndDirectories.sh

Create
 1  user "sisis"
 2  user "sybase"
 3  "/OCLC" and subdirectories for backups, software etc
 4  directories for Sybase ASE 12.5.4 and/or 15.0.2 installations
 5  directories for Oracle installations

If in doubt please open the script file and change it to your needs!

Enter your selection [1-5] 3
Migration from SISIS-SunRise version X to Y
Please give the correct version name of package "sisisbase"!
(e. g. V3.6, V3.6pl1, V3.7pl2b, V4.0 etc)

Current version is  V3.7pl2
To be migrated to   V4.1pl1

Also give the version of your operating system
(e. g. SLES-10, SLES-10SP1, SLES-10SP3 etc)

Operating system is SLES-11

Kopieren der SISIS-SunRise V4.1pl2-Software ins Installationsverzeichnis

Vom neuen Bibliotheksrechner aus wird nun die benötigte SISIS-Sunrise-Software auf den Webrechner kopiert.

# cd /OCLC/software/SunRise-V4.1pl2/Server
# scp package-V3.7-linux-pkg-tar.gz \
        sisis-pap-V4.1pl2-linux-pkg-tar.gz \
        SunriseMaintScripts-V4.1pl2.tar \
        webOPAC-V4.1pl2-002-tar.gz \
        webOPAC-V4.1pl2-linux-pkg-tar.gz \
        root@Webrechner:/OCLC/software/SunRise-V4.1pl2/Server

# cd /OCLC/software

Ebenfalls muss das Verzeichnis "AdminKuhn" auf den Webrechner kopiert werden.

• Genauere Angaben, welche Bestandteile davon notwendig sind...

# scp -r AdminKuhn root@Webrechner:/OCLC/software

Auf dem Webrechner wird nun ins Installationsverzeichnis gewechselt.

# INSTDIR=/OCLC/software/SunRise-V4.1pl2/Server
# cd $INSTDIR

Überprüfen der MD5-Summen sämtlicher Pakete.

# md5sum *gz

Dekomprimieren und Entpacken der Installationspakete. Dafür wird etwa 700 MB Festplattenplatz benötigt.

• Im Falle von Solaris lautet der Befehl anders...

# for i in $(ls -1 *gz); do tar xzf $i; done

Deaktivieren der Crontab-Einträge

Die Cronjobs werden vorzugsweise mit zwei Octothorpes ("##") auskommentiert, damit klar ist, welche während der Migration auskommentiert wurden und welche schon vorher ("#") auskommentiert waren.

# crontab -e

login: sisis
$ crontab -e

Stoppen der Anwendungsserver

Laufende Server müssen gestoppt werden (Apache Tomcat, webOPACClient).

$ /usr/local/sisis-pap/tomcat/bin/shutdown.sh -force

Bei der Lippischen Landesbibliothek Detmold wird nicht der von OCLC ausgelieferte Apache HTTP Server, sondern ein anderer verwendet.

Deinstallation installierter SISIS-Sunrise-Pakete

Unter Linux muss keine Deinstallation alter SISIS-Sunrise-Pakete durchgeführt werden.

Installation der SISIS-Sunrise V4.1pl2-Pakete (Teil 1)

Aufgrund bestimmter Abhängigkeitn müssen die SISIS-Sunrise-Pakete in der folgenden Reihenfolge installiert werden.

Setzen einiger Variablen

# export BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2     \
         INSTDIR=/OCLC/software/SunRise-V4.1pl2/Server \
         LANG=de

Installation des Pakets "package"

Installieren von Paket "package".

# cd $INSTDIR/package && ./install

Installation des Pakets "sisis-pap"

Installieren von Paket "sisis-pap". Dieses Paket enthält auch Java (für webOPAC und InfoGuide).

# cd $INSTDIR/sisis-pap && ./install
 Checking group sisis ...
 Checking user sisis ...
 Anlegen der Directories ...
 Kopieren der Files ...
 Anlegen der symbolischen Links ...
Installing new CUPS version in /usr/local/sisis-pap/cups
Fixing permission in CUPS
pkgparam: ERROR: unable to locate parameter information for "sisisbase"
done.

Installation beendet.
Hinweise zum weiteren Vorgehen entnehmen Sie bitte 
der Freigabemitteilung FGM-sisis-pap-V4.1pl2.htm

Installation erfolgreich beendet

Der Apache Tomcat Server ist nicht mehr enthalten und muss händisch installiert werden.

# rm -rf /usr/local/sisis-pap/tomcat
# cd /OCLC/software/AdminKuhn/ApacheTomcatServer
# gzip -cd apache-tomcat-6.0.35.tar.gz | tar xvf -
# mv apache-tomcat-6.0.35 /usr/local/sisis-pap/tomcat
# chown -R sisis:sisis /usr/local/sisis-pap/tomcat

Konfiguration von Apache Tomcat Server bei Neuinstallation

Folgende Dateien müssen gemäss der Freigabemitteilung von "sisis-pap" angepasst werden. Diese wurden vorkonfiguriert und müssen in die korrekten Verzeichnisse gestellt werden.

# cd /OCLC/software/AdminKuhn/ApacheTomcatServer
# for i in catalina.sh \
           catalina.sh-ORIG6.0.35-AK \
           startup.sh \
           startup.sh-ORIG6.0.35-AK; \
    do chown sisis:sisis $i && cp -p $i /usr/local/sisis-pap/tomcat/bin; done

In der Datei "tomcat-users.xml" ist ein gültiges Passwort einzutragen.

# vi tomcat-users.xml
# for i in server.xml \
           server.xml-ORIG6.0.35-AK \
           tomcat-users.xml \
           tomcat-users.xml-ORIG6.0.35-AK; \
    do chown sisis:sisis $i && cp -p $i /usr/local/sisis-pap/tomcat/conf; done

Für den Einsatz auf einem Webrechner muss die webOPACServer-Zeile aus der Datei "server.xml" entfernt werden!

# vi /usr/local/sisis-pap/tomcat/conf/server.xml

Konfiguration von Apache HTTP Server für Zugriff über Port 80 bzw. 443

Der Webrechner sollte so eingerichtet werden, dass ein Zugriff vom Internet her nicht direkt auf den Apache Tomcat Server sondern nur über den Apache HTTP Server via HTTP (Port 80) bzw. HTTPS (Port 443) möglich ist.

• configure-sisis-pap.sh erzeugt nicht mehr alles
• Einträge in Datei "httpd.conf"
  • 4 x LoadModule
  • Direktive <Proxy *>
  • 4 x ProxyPass
  • 4 x ProxyPassReverse

Die genauere Beschreibung dazu ist anderswo zu finden...

Installation des Pakets "webOPAC"

Allenfalls Eintragen des Namens des Bibliotheksrechners (wo der webOPACServer läuft) in die Datei "/etc/hosts".

# vi /etc/hosts
10.43.95.201    urikbu

Installieren des Pakets "webOPAC".

# cd $INSTDIR/webOPAC && ./install
Sprache: DEUTSCH
Geben Sie den Pfad zum 'java' (JAVA_HOME) an (/usr/local/sisis-pap/java1.5): 
  Ihre Eingabe: 
Geben Sie das Tomcat-Home-Verzeichnis an: (/usr/local/sisis-pap/tomcat)
  Ihre Eingabe: 
Geben Sie die Portnummer des verwendeten Connectors des Tomcats an: (8080)
  Ihre Eingabe: 
pkgparam is hashed (/usr/local/bin/pkgparam)
  Geben Sie das Datenbanksystem an:
      1 Informix
      2 Sybase
      3 Oracle
  Ihre Eingabe: 2

Geben Sie den Standardpfad der Installation ein (SISISROOT z.B. /opt/lib/sisis)
  Ihre Eingabe: 
Geben Sie das Standardspoolverzeichnis für die Installation an (SISISSPOOL z.B. /var/spool/sisis):
  Ihre Eingabe: 
Was wollen Sie tun?
      1. Neuinstallation
      2. Updateinstallation
  Ihre Eingabe: 1

Geben sie die Datenbank an (sisis):
  Ihre Eingabe: 
Geben Sie die Art der Installation an: 
  1. Standardinstallation (Server und Client)
  2. Verteilte Installation - nur Server
  3. Verteilte Installation - nur Client
  Ihre Eingabe: 3
Geben Sie das Heimatverzeichnis des Benutzers sisis an (/home/sisis):
  Ihre Eingabe: 
Hostname des webOPAC-/InfoGuide-Servers (slx005:8080):
  Ihre Eingabe:slx003:8080
Hostname (Public Domain) für Client (slx005:8080):
  Ihre Eingabe:
Geben Sie den Namen der webOPAC-Server-Webanwendung ein (webOPACServer):
  Ihre Eingabe: webOPACServer_sisis
Geben Sie den Namen der webOPAC-Client-Webanwendung ein (webOPACClient):
  Ihre Eingabe: webOPACClient_sisis
Wollen Sie die Anwendung für eine weitere Datenbank installieren? [yYjJnN]
  Ihre Eingabe: y

Geben sie die Datenbank an (sisis):
  Ihre Eingabe: lippe
Geben Sie die Art der Installation an: 
  1. Standardinstallation (Server und Client)
  2. Verteilte Installation - nur Server
  3. Verteilte Installation - nur Client
  Ihre Eingabe: 3
Hostname des webOPAC-/InfoGuide-Servers (slx005:8080):
  Ihre Eingabe:slx003:8080
Hostname (Public Domain) für Client (slx005:8080):
  Ihre Eingabe:
Geben Sie den Namen der webOPAC-Server-Webanwendung ein (webOPACServer):
  Ihre Eingabe: webOPACServer_lippe
Geben Sie den Namen der webOPAC-Client-Webanwendung ein (webOPACClient):
  Ihre Eingabe: webOPACClient_lippe

Ein Verzeichnis mit dem angegebenen Namen
 '/opt/lib/sisis/webOPAC/webapps/webOPACClient_lippe'
der Webanwendung existiert	bereits.
Soll es gesichert werden?[yYjJnN]   Ihre Eingabe:n

Wollen Sie die Anwendung für eine weitere Datenbank installieren? [yYjJnN]
  Ihre Eingabe: n

Überprüfen der Protokolldatei.

# more /tmp/webOPAC_install.log

Installation des aktuellen webOPAC-Hotfix

Entpacken und Installieren des Hotfix "webOPAC-V4.1pl2-002".

# cd $INSTDIR/webOPAC-V4.1pl2-002 && ./installer.sh
...
Do you want to update:
/opt/lib/sisis/webOPAC/webapps/webOPACClient_lippe
Input (y/n): y

done for SRP-16643

done for SRP-17810
update file:
/opt/lib/sisis/webOPAC/webapps/webOPACClient_lippe/patchlevel.txt
update done.
...
Do you want to update:
/opt/lib/sisis/webOPAC/webapps/webOPACClient_sisis
Input (y/n): y

done for SRP-16643

done for SRP-17810
update file:
/opt/lib/sisis/webOPAC/webapps/webOPACClient_sisis/patchlevel.txt
update done.

Konfiguration von SISIS-SunRise

$ su - root
# export BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2

Konfiguration webOPAC

Admin Kuhn GmbH/Dienstleistung/SISIS-SunRise-Update und -Migration/Projektablauf/Konfiguration Paket "webOPAC"

Medientyp-Bildchen

Vom Bibliotheksrechner

Die Medientyp-Icons (GIF-Dateien) müssen aus der Sicherung wieder an den richtigen Ort zurückkopiert werden (das ist üblicherweise "/opt/lib/sisis/webOPAC/webapps/webOPACClient/images/mtyp" bzw. "/opt/lib/sisis/webOPAC/webapps/webOPACClient/images").

Bei der Stadtbibliothek Freiburg gibt es ausserdem im Verzeichnis "/opt/lib/sisis/webOPAC/webapps/webOPACClient/images" eine Reihe von Bilddateien:

Je nach zusätzlich lizensierter oder sonstwie erworbener Software kann es eine ganze Reihe weiterer Dateien mit Anpassungen geben.

Eine dieser Dateien ist jedenfalls "application.properties".

$ INFOGUIDE_WEBAPPS=/opt/lib/sisis/webOPAC/webapps
$ cd $INFOGUIDE_WEBAPPS/InfoGuideClient/WEB-INF/classes/resources
$ diff application.properties \
    $BACKUPDIR$INFOGUIDE_WEBAPPS/InfoGuideClient/WEB-INF/classes/resources/application.properties

Es muss sichergestellt werden, dass die Anpassungen an den JSP-Seiten wiederhergestellt werden.

# cd /opt/lib/sisis/webOPAC/webapps/webOPACClient/jsp

Bei der Stadtbibliothek Freiburg gibt es Anpassungen in folgenden Dateien.

Konfiguration BSB Mobile OPAC

Siehe anderswo.

Konfiguration Divibib-Anmeldeschnittstelle

Siehe anderswo.

Server-Startskripte

Ausser dem Sybase-Startskript "sybase15.0.3" gibt es drei weitere Skripte auf dem Rechner zum Gebrauch mit SISIS-SunRise V4.1pl2:

• tomcat startet und stoppt den Apache Tomcat Server sowie den SISIS-Sunrise webOPAC (den letzteren via Tomcat admin)

Installieren der Server-Startskripte ins Verzeichnis "/etc/init.d".

# for i in tomcat; \
    do cp -i /OCLC/software/SunRise-V4.1pl2/$i /etc/init.d; \
    chown root:root /etc/init.d/$i; chmod 744 /etc/init.d/$i; done

Nach durchgeführter Konfiguration kann das Skript in den erwünschten Runleveln (üblicherweise 3 und 5) verlinkt und gestartet werden.

Offenbar muss zuvor der Kopf der Datei wie folgt angepasst werden.

Bei der Hochschule Ostwestfalen-Lippe musste nichts angepasst werden...

# insserv /etc/init.d/tomcat
insserv: Service xinetd has to be enabled for service tomcat
insserv: Service sunriseserver has to be enabled for service tomcat
insserv: exiting now!
# vi /etc/init.d/tomcat
# Required-Start: $network $named
# insserv /etc/init.d/tomcat
insserv: Warning, current runlevel(s) of script `tomcat' overwrites defaults.

# insserv /etc/init.d/tomcat
# /etc/init.d/tomcat stop
# /etc/init.d/tomcat start

Abschliessend muss der Apache HTTP Server (falls nötig) rekonfiguriert werden.

# /usr/local/sisis-pap/bin/configure-sisis-pap.sh -s -c -br

Der SISIS-Sunrise webOPAC kann nun über folgende URLs erreicht werden:

http://host/webOPACClient/start.do
http://host:8080/webOPACClient/start.do

Testen, ob die Server-Startskripte wie gewünscht arbeiten - damit wird der Rechner tatsächlich neu gestartet!

# shutdown -r now

Nach dem Neustart des Rechners sollten nun alle konfigurierten Server wieder laufen.

Cronjobs von Benutzer "sisis"

Wieder aktivieren, falls es welche gab.

Backup system configuration

Stopping all SISIS-SunRise related servers on host.

# /etc/init.d/SunRiseServer stop

Make sure there are no more open FIFO files:

# find /var/spool/sisis -type p -exec rm {} \;

Make sure there is enough space for the directories you want to backup.

# du -sh /etc            \
         /home/sisis     \
         /opt/lib/sisis  \
         /usr/local      \
         /var/spool/cron \
         /var/spool/sisis

Also, check if there is enough space on the host to backup these directories:

# df -k

Define a directory where to store your system backup.

# BACKUPDIR=/OCLC/backup/SYSTEMBACKUP
# cd $BACKUPDIR

Backup the SISIS-SunRise configuration settings.

# mkdir PKGPARAM
# for i in sisis-pap  \
           webOPAC; \
    do /usr/local/bin/pkgparam -v ${i} > PKGPARAM/${i}; done

Backup the important directories on the host as follows. Don't forget to backup directory "/opt/sybase/15.0.2".

# for i in /etc              \
           /home/sisis        \
           /opt/lib/sisis     \
           /usr/local         \
           /var/spool/cron    \
           /var/spool/sisis;  \
    do tar cf - ${i} | tar xf -; done

You may want to compress the backed up files and directories.

# cd /OCLC/backup
# tar czf SYSTEMBACKUP-$(date +%Y%m%d).tgz SYSTEMBACKUP

Make sure to copy the resulting file "SYSTEMBACKUP-date.tgz" onto a remote host for safety reasons!

Java Server Pages / JSP ist eine von Sun Microsystems entwickelte, auf JHTML basierende Web-Programmiersprache zur einfachen dynamischen Erzeugung von HTML- und XML-Ausgaben eines Webservers (z. B. Apache Tomcat Server).