LFD: Unterschied zwischen den Versionen

Aus Admin Kuhn GmbH
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
== Konfiguration Datei "server.xml" ==
== Solaris ==


$ <b>cd /usr/local/sisis-pap/tomcat/conf</b>
Unter Solaris müssen Einzelskripte erstellt werden (Beispiel: [[Bundesarbeitsgericht]])
$ <b>cp server.xml server.xml-ORIG4.1pl2-AK</b>
* CUPS
$ <b>vi server.xml</b>
* Apache HTTP Server
* Oracle
* AVServer
* CATServer
* OPServer
* S99z39oserver
* S98z39targetd
* SLNPDispatcher
* FAST
* Apache Tomcat Server
* AlertAgent.sh
* Gibt es speziell angepasste Skripte?


Bei Bibliotheken mit bloss einer Datenbank namens "sisis" sieht die Datei wie folgt aus.
Kontrolle der Verzeichnisse /etc/rc2.d, /etc/rc3.d - wurde dort unsinnigerweise automatisch was hinkopiert?


      <nowiki><!-- ANFANG - Anpassung gemaess FGM
== SUSE Linux Enterprise Server ==
                  - M. Kuhn, Admin Kuhn GmbH (mik@adminkuhn.ch) -->
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACServer/" path="/webOPACServer" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACClient/" path="/webOPACClient" reloadable="true"/>


      <!-- ENDE - Anpassung gemaess FGM
Kontrolle der folgenden Verzeichnisse - wurde dort unsinnigerweise automatisch was hinkopiert? <b>Nicht mehr unter SISIS-Sunrise V4.1pl2</b>
                - M. Kuhn, Admin Kuhn GmbH (mik@adminkuhn.ch) --></nowiki>
* /etc/init.d/rc2.d
* /etc/init.d/rc3.d
* /etc/init.d/rc5.d


Im Fall der [[Kantonsbibliothek Uri]] mit den drei Datenbanken "kkb", "sisis" und "urisik" sah das beispielsweise so aus:
Ausser dem Sybase-Startskript "sybase15.0.3" gibt es drei weitere Skripte auf dem Rechner zum Gebrauch mit SISIS-SunRise V4.1pl2:
* <code>sybase15.0.3</code> startet und stoppt Sybase ASE 15.0.3
* <code>DbServer_sisis</code> startet und stoppt eine Reihe von SISIS-Sunrise-Servern (AVServer, CATServer, OPServer, usw.) zum Gebrauch mit der Datenbank "sisis"
* <code>tomcat</code> startet und stoppt den Apache Tomcat Server sowie den SISIS-Sunrise webOPAC (den letzteren via Tomcat admin)
* <code>SunRiseServer</code> startet und stoppt nacheinander die Skripte "sybase15.0.3", "DbServer_sisis" und "tomcat"


      <nowiki><!-- ANFANG - Anpassung gemaess FGM - M. Kuhn (Admin Kuhn GmbH) -->
Installieren der Server-Startskripte ins Verzeichnis "/etc/init.d".
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACServer.kkb/" path="/webOPACServer.kkb" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACClient.kkb/" path="/webOPACClient.kkb" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACServer.sisis/" path="/webOPACServer.sisis" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACClient.sisis/" path="/webOPACClient.sisis" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACServer.urisik/" path="/webOPACServer.urisik" reloadable="true"/>
      <Context allowLinking="true" docBase="/opt/lib/sisis/webOPAC/webapps/webOPACClient.urisik/" path="/webOPACClient.urisik" reloadable="true"/>
      <!-- ENDE - Anpassung gemaess FGM - M. Kuhn (Admin Kuhn GmbH) --></nowiki>


== Konfiguration Datei "server.properties" ==
# <b>for i in SunRiseServer tomcat DbServer_sisis; \
    do cp /OCLC/software/SunRise-V4.1pl2/$i /etc/init.d; \
    chown root:root /etc/init.d/$i; chmod 744 /etc/init.d/$i; done</b>


Setzen einiger Variablen.
Falls es weitere Datenbanken gibt, so müssen auch entsprechende Startskripte für diese erstellt werden. Im Beispiel für die Datenbank "kkb".


  $ <b>export BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2 \
  # <b>cd /etc/init.d && cp DbServer_sisis DbServer_kkb</b>
          DATABASE=sisis</b>


Anpassung der Datei "server.properties" für die Datenbank "sisis" (und allenfalls weitere Datenbanken).
{{Info|Es muss sichergestellt werden, dass alle Server-Startskripte gemäss den vorhandenen Anforderungen konfiguriert werden. Es darf auch nicht vergessen werden, bei Bedarf die vom Skript "DbServer_<i>Datenbankname</i>" aufgerufenen originalen SISIS-Sunrise-Server-Startskripte wieder anzupassen!}}


$ <b>cd /opt/lib/sisis/webOPAC/etc/profile.${DATABASE}</b>
Konfigurieren der Server-Startskripte.
$ <b>cp -i server.properties server.properties-ORIG4.1pl2-AK</b>
$ <b>diff server.properties ${BACKUPDIR}$(pwd)/server.properties | more</b>
$ <b>vi server.properties</b>


Oft sind die folgenden Parameter anzupassen.
# <b>BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2</b>
# <b>cd /etc/init.d</b>
# <b>diff SunRiseServer ${BACKUPDIR}$(pwd)/SunRiseServer | more</b>
# <b>diff DbServer_sisis ${BACKUPDIR}$(pwd)/DbServer_sisis | more</b>
# <b>diff tomcat ${BACKUPDIR}$(pwd)/init.d/tomcat | more</b>


server.sessiontimeout=
Zu den üblichen Anpassungen gehören die folgenden.
client.sessiontimeout=
client.webservice.general.threads=
client.webservice.config.threads=
client.webservice.search.threads=
client.webservice.circulation.threads=
client.webservice.systematik.threads=
client.webservice.availability.threads=
client.aws.secret.key=  <-- unklar, woher das genau kommt!
hitlistmanager.uncachetime=
hitlistmanager.expirytime=
client.memorize.output.fullformat.category=
 
Es kann hier auch Einträge für Munzinger geben (z. B. bei [[Stadtbücherei Pulheim]])
 
# ANFANG - Anpassung Munzinger-Daten - M. Kuhn (Admin Kuhn GmbH), 4.11.2012
singlehit.special.tag.handling=((?:http|https|ftp):\\/\\/www.munzinger.de\\/[^ ]+)
# ENDE - Anpassung Munzinger-Daten - M. Kuhn (Admin Kuhn GmbH), 4.11.2012
 
{{Alert|Falsche Belegung des Parameters "server.rssfeeds.path" bei Vorhandensein mehrerer Datenbanken - siehe [https://issues.oclcpica.org/browse/SRP-10830 SRP-10830 Falsche Belegung der Variable "server.rssfeeds.path"]
 
Allfällige weitere Verzeichnisse müssen händisch angelegt und mit den Rechten 777 versehen werden. Bei der [[Kantonsbibliothek Uri]] wurde das Verzeichnis "/opt/lib/sisis/webOPAC/webapps/webOPACServer.kkb/WEB-INF/rssfeeds" angelegt, zwei weitere mussten als Benutzer "root" händisch angelegt werden:
 
# <b>cd /opt/lib/sisis/webOPAC/webapps</b>
# <b>cp -pr webOPACServer.kkb webOPACServer.sisis</b>
# <b>cp -pr webOPACServer.kkb webOPACServer.urisik</b>
}}
 
== Konfiguration der GIF-Dateien für den Medientyp ==
 
Die GIF-Dateien für den Medientyp müssen aus der Sicherung wieder an den richtigen Ort zurückkopiert werden (das ist üblicherweise "/opt/lib/sisis/webOPAC/webapps/webOPACClient/images/mtyp"). Bereits vorhandene Dateien werden dabei nicht überschrieben.
 
$ <b>cd $BACKUPDIR/opt/lib/sisis/webOPAC/webapps/webOPACClient/images/mtyp</b>
$ <b>cp -ip * /opt/lib/sisis/webOPAC/webapps/webOPACClient/images/mtyp</b>
 
Im Verzeichnis "/opt/lib/sisis/webOPAC/webapps/webOPACClient/images" können sich ausserdem weitere angepasste Bilddateien befinden (z. B. ein Übersichtsplan oder ein Zählpixel) - insbesondere auch die GIF-Dateien zur Anzeige der Auflistung der Neuerwerbungslisten.
 
{{Alert|Wie können die Bilder hier eruiert werden?}}
 
$ <b>cd $BACKUPDIR/opt/lib/sisis/webOPAC/webapps/webOPACClient/images</b>
 
== Konfiguration Datei "application.properties" ==
 
$ <b>export BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2 \
          DATABASE=sisis</b>
 
$ <b>INFOGUIDE_WEBAPPS=/opt/lib/sisis/webOPAC/webapps</b>
$ <b>cd $INFOGUIDE_WEBAPPS/webOPACClient/WEB-INF/classes/resources</b>
$ <b>cp application.properties application.properties-ORIG4.1pl2-AK</b>
$ <b>diff application.properties \
    $BACKUPDIR$INFOGUIDE_WEBAPPS/webOPACClient/WEB-INF/classes/resources/application.properties | more</b>
$ <b>vi application.properties</b>
 
Häufige Anpassungen in dieser Datei sind die folgenden.


{| class=wiki
{| class=wiki
! Original-Datei !! Ersetzt durch !! vi-Befehl
! Startskript
|-
! Anpassungen
| zum Dokument || Vormerkung (Vormerken) || <code>:% s/=zum Dokument$/=Vormerkung/</code>
|-
| Aktuelles || Neuheiten || <code>:% s/=Aktuelles$/=Neuheiten/</code>
|-
| Aktuelles || Neuerwerbungslisten || <code>:% s/=Aktuelles$/=Neuerwerbungslisten/</code>
|-
| Aktuelles || Neu im Bestand || <code>:% s/=Aktuelles$/=Neu im Bestand/</code>
|-
| Auskunft || Kontakt || <code>:% s/=Auskunft$/=Kontakt/</code>
|-
|-
| Kennung || Benutzernummer || <code>:% s/Kennung/Benutzernummer/g</code>
| SunRiseServer
|  
* Setzen der Variable "DBS"
* Setzen der folgenden Variablen, je nach Bedarf:
CUPS_SERVER=Y
DATABASE_SERVER=Y
SISISSUNRISE_SERVER=Y
SLNPDISPATCHER=N
APACHETOMCAT_SERVER=Y
ALERTAGENT=Y
TOUCHPOINT=N
* Eintragen des Skripts "DbServer_sisis" bzw. allfälliger weiterer Startskripte
* evtl. auch Start und Stop von "apache_php" für PHP4SISIS
|-
|-
| Kennwort || Passwort || <code>:% s/Kennwort/Passwort/g</code>
| DbServer_sisis
|  
* Anpassung des Namens im Dateikopf
* Anpassung des Namens unter "Provides:"
* Setzen der Variable "DBS"
* Anpassen der Zeile "export DATABASE=sisis" mit dem gültigen Datenbanknamen
* Eintragen der gültigen Werte für die Variablen PORT usw. der einzelnen SISIS-Sunrise-Server
* Einkommentieren der zu startenden SISIS-Sunrise-Server in der Funktion "sunrise_server" am Dateiende
|-
|-
| Konto || Mein Konto || <code>:% s/=Konto$/=Mein Konto/</code>
| tomcat
|-
| Üblicherweise sind hier keine Anpassungen notwendig.
| || ||
|}
|}


Bei der [[Stadtbücherei Pulheim]] wurden folgende Anpassungen gemacht:
Nach durchgeführter Konfiguration können die Skripte in den erwünschten Runleveln (üblicherweise 3 und 5) verlinkt werden.


  singlehit.special.tag.text=Online verfügbar, bitte hier klicken!
  # <b>insserv /etc/init.d/SunRiseServer</b>


== Konfiguration JSP-Seiten ==
{{Alert|Bei der [[Kantonsbibliothek Uri]] erschien unter SUSE Linux Enterprise Server 11 SP2 (x86_64) mehrfach der folgende Fehler:


{{Info|Es muss sichergestellt werden, dass die Anpassungen an den JSP-Seiten wiederhergestellt werden.}}
insserv: script jexec is broken: incomplete LSB comment.
insserv: missing `Required-Stop:'  entry: please add even if empty.


Anzeige aller Dateien in den Unterverzeichnissen. Falls vor Anpassungen eine Dateisicherung erstellt wurde kann so erkannt werden, ob Anpassungen gemacht wurden...
Dies kann behoben werden indem in der Datei "jexec" eine Zeile "# Required-Stop:" eingefügt wird.


  $ <b>cd ${BACKUPDIR}/opt/lib/sisis/webOPAC/webapps/webOPACClient/jsp</b>
  # <b>cd /etc/init.d</b>
  $ <b>ls -al *</b>
# <b>cp jexec jexec-ORIG-AK</b>
# <b>vi jexec</b>
  ...
# Required-Start: $local_fs
<b><font color{{=}}red># Required-Stop:</font></b>
...


In folgenden Dateien befinden sich besonders oft Anpassungen.
Unter SUSE Linux Enterprise Server 11 SP2 (x86_64) bleibt trotzdem der folgende Scheissdreck übrig:


* common/header.jsp (hier ist meist das Bibliothekslogo eingebaut)
insserv: script apache2: service apache already provided!
insserv: script apache2: service apache2 already provided!
insserv: script apache2: service httpd already provided!
insserv: script jexec-ORIG-AK is broken: incomplete LSB comment.
insserv: missing `Required-Stop:'  entry: please add even if empty.
insserv: script jexec-ORIG-AK: service binfmt_misc already provided!
insserv: Service network is missed in the runlevels 4 to use service gf_agent
}}


$ <b>cd /opt/lib/sisis/webOPAC/webapps/webOPACClient/jsp/common</b>
Nun kann das Hauptskript gestartet werden.
$ <b>cp -i header.jsp header.jsp-ORIG4.1pl2-AK</b>
$ <b>vi header.jsp</b>


Beispiel der [[Hochschule Ostwestfalen-Lippe]].
# <b>/etc/init.d/SunRiseServer stop</b>
# <b>/etc/init.d/SunRiseServer start</b>


<pre>
{{Alert|Abschliessend muss der Apache HTTP Server (falls nötig) rekonfiguriert werden. <b>Das scheint aber hier NIE nötig zu sein...?</b>
<div style="height:100px;">


<span style="position:absolute; top:-5px; left:18px;"><a href='http://www.hs-owl.de/'><img src="/webOPACClient/images/hsowl.gif" alt="Logo HS OWL" width="240" height="79" /></a></span>
# <b>/usr/local/sisis-pap/bin/configure-sisis-pap.sh -s -c -br</b>
 
}}
<div style="text-align:center; padding:20px; margin:25px">
<h2>Bibliothekskatalog</h2>
</div>
 
<span style="position:absolute; top:55px; left:25px;"><a href='http://www.hs-owl.de/skim/'><img src="/webOPACClient/images/skim_logo.gif" width="130" height="42" /></a></span>
</div>
</pre>
 
* googlebookapi.jsp
 
$ <b>cp -i googlebookapi.jsp googlebookapi.jsp-ORIG4.1pl2-AK</b>
 
* result/teaser.jsp
** Auskommentieren des Zweigs bezüglich Kategorie 9902 (siehe [https://issues.oclcpica.org/browse/SRP-17095 SRP-17095])
 
{{SRP|18284|Überflüssiger Apostroph in Datei "teaser.jsp"|}}


$ <b>cp teaser.jsp teaser.jsp-ORIG4.1pl2-AK</b>
Der SISIS-Sunrise webOPAC kann nun über folgende URLs erreicht werden - Voraussetzung dafür ist allerdings eine korrekte Konfiguration in der SISIS-Sunrise Administration.


* result/singleHitTabNavi.jsp
<nowiki>http://</nowiki><i>host</i>/webOPACClient/start.do
<nowiki>http://</nowiki><i>host</i>:8080/webOPACClient/start.do


Anzeige der Amazon-Cover
Testen der Verbindungen über Rechner "adminkuhn.ch" mittels den durch das Skript "co" geöffneten Ports.
* [[SISIS-Sunrise Administration]] Menü "OPAC > Systemparameter > Allgemeine Systemparameter > Einstellungen zur Cover-Anzeige"
* evtl. Amazon-Covers in Einzeltrefferanzeige
* evtl. Amazon-Covers in Mehrfachtrefferanzeige


Beispielmatrix zu JSP-Dateien
{| class=wiki
{| class=wiki
| Rechner || colspan=2 | slx003 || colspan=2 | slx005
! Port !! Anwendung !! Bemerkungen
|-
| 80 || Apache HTTP Server || Meldung "It works!"
|-
|-
| Datenbank || lippe || sisis || lippe || sisis
| 631 || CUPS || Zugriff funktioniert erst nach erfolgter Konfiguration
|-
|-
| Datei || teaser.jsp || teaser.jsp || ||  
| 1443 || SISIS-Sunrise Administration || Weboberfläche erscheint
|-
| 8080 || Apache Tomcat Server || Weboberfläche des Tomcat Manager erscheint
|-
| 8080 || webOPACClient || Weboberfläche des OPAC erscheint
|}
|}


{{Alert|Fehlermeldung [https://issues.oclcpica.org/browse/SRP-17740 SRP-17740 Divibib- und Munzinger-Konverter: Datei extractLink.jsp wird standardmässig nicht mit ausgeliefert (Updateproblem)]: Die Datei "extractLink.jsp" muss aus der Sicherung wiederhergestellt werden, da sie zumindest in SISIS-Sunrise V4.1pl2 nicht mit ausgeliefert wird.
{{Alert|Ansonsten händisch:
 
$ <b>cd /OCLC/backup/SunRise-V3.7pl2/opt/lib/sisis/webOPAC/webapps/webOPACClient/jsp/result</b>
$ <b>cp -ipr extractLink.jsp /opt/lib/sisis/webOPAC/webapps/webOPACClient/jsp/result</b>
 
Die Anpassung in der Datei "simplehit.jsp" für die Munzinger-Daten sah wie folgt aus:
 
  <%-- ANFANG - Anpassung Munzinger-Daten - M. Kuhn, 4.11.2012 --%>
  <br/>
  <c:if test{{=}}'${fn:length(igf:availableValues(currenthit, "662,662.*")) > 0}'>
  <c:set var{{=}}"link" value{{=}}'${igf:availableValues(currenthit, "662,662.*")[0]}' scope{{=}}"request" />
      <jsp:include page{{=}}"extractLink.jsp" />
  </c:if>
  <%-- ENDE - Anpassung Munzinger-Daten - M.Kuhn, 4.11.2012 --%>


Die Anpassung in der Datei "teaser.jsp" für die Munzinger-Daten sah wie folgt aus:
# <b>ACCESSHOST{{=}}194.8.213.179</b>
# <b>TESTHOST{{=}}42.1.13.50</b>
# <b>ssh -t -C -g -L 1443:${TESTHOST}:1443 \
                -L 1631:${TESTHOST}:631 \
                -L 8080:${TESTHOST}:8080 \
                -L 8000:${TESTHOST}:80 root@${ACCESSHOST}</b>


  <%-- ANFANG - Anpassung Munzinger-Daten - M. Kuhn, 4.11.2012 --%>
* Apache HTTP Server: http://adminkuhn.ch:8000/
  <c:if test{{=}}'${fn:length(igf:availableValues(currenthit, "662,662.*")) > 0}'>
* Administration: https://adminkuhn.ch:1443/cgi-bin/sisisadmin/interpret.pl
    <c:set var{{=}}"link" value{{=}}'${igf:availableValues(currenthit, "662,662.*")[0]}' scope{{=}}"request" />
* CUPS: http://adminkuhn.ch:1631/
    <jsp:include page{{=}}"extractLink.jsp" />
* Apache Tomcat Server: http://adminkuhn.ch:8080/
  </c:if>
* webOPACClient: http://adminkuhn.ch:8080/webOPACClient/start.do
  <%-- ENDE - Anpassung Munzinger-Daten - M. Kuhn, 4.11.2012 --%>
 
Die Anpassung in der Datei "titleinfo.jsp" für die Munzinger-Daten sah wie folgt aus:
 
  <%-- ANFANG - Anpassung Munzinger-Daten - M. Kuhn, 4.11.2012
                Austausch des Standard-Renderers --%>
  <%--
                                  <ig:render type{{=}}"hit" source{{=}}"${currenthit}"/>
  --%>
                                  <ig:render type{{=}}"class:org.oclcpica.infoguide.taglib.SingleHitRendererSpecialTag" source{{=}}"${currenthit}"/>
  <%-- ENDE - Anpassung Munzinger-Daten - M. Kuhn, 4.11.2012
}}
}}


== Weitere Anpassungen ==
Testen, ob die Server-Startskripte wie gewünscht arbeiten - <b>damit wird der Rechner tatsächlich neu gestartet!</b>
 
Je nach zusätzlich lizensierter oder sonstwie erworbener Software kann es eine ganze Reihe weiterer Dateien mit Anpassungen geben.
 
Womöglich gibt es auch neu einzurichtende Funktionen.


== Konfiguration Datei "AlertAgent.sh" ==
# <b>shutdown -r now</b>


Konfigurieren des Startskripts für den AlertAgent.
Nach dem Neustart des Rechners sollten nun alle konfigurierten Server wieder laufen.


# <b>vi /opt/lib/sisis/webOPAC/AlertAgent.sh</b>
{{Info|Da die verwendete Datenbank bei einem Rechnerneubau von einem anderen Rechner stammt (beispielsweise hiess der originale Rechner bei der Fachhochschule Aachen "sunrise" mit seiner eigenen IP-Adresse, während der neue Rechner "sunrise2" hiess und eine andere IP-Adresse besass), ist es notwendig, einige Parameter in der SISIS-Sunrise Administration zu ändern (OPAC, Z39Target).}}
STARTPROFILES=" -k sisis"


== BSB Mobile OPAC ==
=== Weiteres ===


Siehe [[BSB Mobile OPAC]]
SLES: Sammelskripte
* /etc/init.d/SunRiseServer für Bootstart einrichten (Konfiguration)
* Startskripte Aachen
** S99upload
** starthbz
** S99sikom
** S99sikomSDI
* sip2slnp
* Gibt es speziell angepasste Skripte?
* Startskripte testen
* Startskripte mit "insserv" einbinden


== Weiteres ==
{{Alert|Starten der Server und überprüfen, ob der Prozess läuft (avs cats ops)


Nach Möglichkeit Zugang über Port 80 ermöglichen (früher per Skript "configure-sisis-pap.sh")
$ <b> ps -ef <nowiki>|</nowiki> grep AV</b>
* Anpassung in Datei "httpd.conf"
sisis   18168    1  0 Jul03 ?        00:00:00 /opt/lib/sisis/avserver/bin/AVServer -p 8076}}

Version vom 29. August 2013, 09:56 Uhr

Solaris

Unter Solaris müssen Einzelskripte erstellt werden (Beispiel: Bundesarbeitsgericht)

  • CUPS
  • Apache HTTP Server
  • Oracle
  • AVServer
  • CATServer
  • OPServer
  • S99z39oserver
  • S98z39targetd
  • SLNPDispatcher
  • FAST
  • Apache Tomcat Server
  • AlertAgent.sh
  • Gibt es speziell angepasste Skripte?

Kontrolle der Verzeichnisse /etc/rc2.d, /etc/rc3.d - wurde dort unsinnigerweise automatisch was hinkopiert?

SUSE Linux Enterprise Server

Kontrolle der folgenden Verzeichnisse - wurde dort unsinnigerweise automatisch was hinkopiert? Nicht mehr unter SISIS-Sunrise V4.1pl2

  • /etc/init.d/rc2.d
  • /etc/init.d/rc3.d
  • /etc/init.d/rc5.d

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

  • sybase15.0.3 startet und stoppt Sybase ASE 15.0.3
  • DbServer_sisis startet und stoppt eine Reihe von SISIS-Sunrise-Servern (AVServer, CATServer, OPServer, usw.) zum Gebrauch mit der Datenbank "sisis"
  • tomcat startet und stoppt den Apache Tomcat Server sowie den SISIS-Sunrise webOPAC (den letzteren via Tomcat admin)
  • SunRiseServer startet und stoppt nacheinander die Skripte "sybase15.0.3", "DbServer_sisis" und "tomcat"

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

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

Falls es weitere Datenbanken gibt, so müssen auch entsprechende Startskripte für diese erstellt werden. Im Beispiel für die Datenbank "kkb".

# cd /etc/init.d && cp DbServer_sisis DbServer_kkb
Es muss sichergestellt werden, dass alle Server-Startskripte gemäss den vorhandenen Anforderungen konfiguriert werden. Es darf auch nicht vergessen werden, bei Bedarf die vom Skript "DbServer_Datenbankname" aufgerufenen originalen SISIS-Sunrise-Server-Startskripte wieder anzupassen!

Konfigurieren der Server-Startskripte.

# BACKUPDIR=/OCLC/backup/SunRise-V3.7pl2
# cd /etc/init.d
# diff SunRiseServer ${BACKUPDIR}$(pwd)/SunRiseServer | more
# diff DbServer_sisis ${BACKUPDIR}$(pwd)/DbServer_sisis | more
# diff tomcat ${BACKUPDIR}$(pwd)/init.d/tomcat | more

Zu den üblichen Anpassungen gehören die folgenden.

Startskript Anpassungen
SunRiseServer
  • Setzen der Variable "DBS"
  • Setzen der folgenden Variablen, je nach Bedarf:
CUPS_SERVER=Y
DATABASE_SERVER=Y
SISISSUNRISE_SERVER=Y
SLNPDISPATCHER=N
APACHETOMCAT_SERVER=Y
ALERTAGENT=Y
TOUCHPOINT=N
  • Eintragen des Skripts "DbServer_sisis" bzw. allfälliger weiterer Startskripte
  • evtl. auch Start und Stop von "apache_php" für PHP4SISIS
DbServer_sisis
  • Anpassung des Namens im Dateikopf
  • Anpassung des Namens unter "Provides:"
  • Setzen der Variable "DBS"
  • Anpassen der Zeile "export DATABASE=sisis" mit dem gültigen Datenbanknamen
  • Eintragen der gültigen Werte für die Variablen PORT usw. der einzelnen SISIS-Sunrise-Server
  • Einkommentieren der zu startenden SISIS-Sunrise-Server in der Funktion "sunrise_server" am Dateiende
tomcat Üblicherweise sind hier keine Anpassungen notwendig.

Nach durchgeführter Konfiguration können die Skripte in den erwünschten Runleveln (üblicherweise 3 und 5) verlinkt werden.

# insserv /etc/init.d/SunRiseServer
Bei der Kantonsbibliothek Uri erschien unter SUSE Linux Enterprise Server 11 SP2 (x86_64) mehrfach der folgende Fehler:
insserv: script jexec is broken: incomplete LSB comment.
insserv: missing `Required-Stop:'  entry: please add even if empty.

Dies kann behoben werden indem in der Datei "jexec" eine Zeile "# Required-Stop:" eingefügt wird.

# cd /etc/init.d
# cp jexec jexec-ORIG-AK
# vi jexec
...
# Required-Start: $local_fs
# Required-Stop:
...

Unter SUSE Linux Enterprise Server 11 SP2 (x86_64) bleibt trotzdem der folgende Scheissdreck übrig:

insserv: script apache2: service apache already provided!
insserv: script apache2: service apache2 already provided!
insserv: script apache2: service httpd already provided!
insserv: script jexec-ORIG-AK is broken: incomplete LSB comment.
insserv: missing `Required-Stop:'  entry: please add even if empty.
insserv: script jexec-ORIG-AK: service binfmt_misc already provided!
insserv: Service network is missed in the runlevels 4 to use service gf_agent

Nun kann das Hauptskript gestartet werden.

# /etc/init.d/SunRiseServer stop
# /etc/init.d/SunRiseServer start
Abschliessend muss der Apache HTTP Server (falls nötig) rekonfiguriert werden. Das scheint aber hier NIE nötig zu sein...?
# /usr/local/sisis-pap/bin/configure-sisis-pap.sh -s -c -br

Der SISIS-Sunrise webOPAC kann nun über folgende URLs erreicht werden - Voraussetzung dafür ist allerdings eine korrekte Konfiguration in der SISIS-Sunrise Administration.

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

Testen der Verbindungen über Rechner "adminkuhn.ch" mittels den durch das Skript "co" geöffneten Ports.

Port Anwendung Bemerkungen
80 Apache HTTP Server Meldung "It works!"
631 CUPS Zugriff funktioniert erst nach erfolgter Konfiguration
1443 SISIS-Sunrise Administration Weboberfläche erscheint
8080 Apache Tomcat Server Weboberfläche des Tomcat Manager erscheint
8080 webOPACClient Weboberfläche des OPAC erscheint
Ansonsten händisch:
# ACCESSHOST=194.8.213.179
# TESTHOST=42.1.13.50
# ssh -t -C -g -L 1443:${TESTHOST}:1443 \
               -L 1631:${TESTHOST}:631 \
               -L 8080:${TESTHOST}:8080 \
               -L 8000:${TESTHOST}:80 root@${ACCESSHOST}

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.

Da die verwendete Datenbank bei einem Rechnerneubau von einem anderen Rechner stammt (beispielsweise hiess der originale Rechner bei der Fachhochschule Aachen "sunrise" mit seiner eigenen IP-Adresse, während der neue Rechner "sunrise2" hiess und eine andere IP-Adresse besass), ist es notwendig, einige Parameter in der SISIS-Sunrise Administration zu ändern (OPAC, Z39Target).

Weiteres

SLES: Sammelskripte

  • /etc/init.d/SunRiseServer für Bootstart einrichten (Konfiguration)
  • Startskripte Aachen
    • S99upload
    • starthbz
    • S99sikom
    • S99sikomSDI
  • sip2slnp
  • Gibt es speziell angepasste Skripte?
  • Startskripte testen
  • Startskripte mit "insserv" einbinden
Starten der Server und überprüfen, ob der Prozess läuft (avs cats ops)
$  ps -ef | grep AV
sisis 18168 1 0 Jul03 ? 00:00:00 /opt/lib/sisis/avserver/bin/AVServer -p 8076