Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
BIBIS LIBRARY PORTAL QUICK INSTALL & UPGRADE GUIDE
Opgesteld door Jean Paul Ueberbach Datum: 20 juli 2004 Versie: 0.1
Registered at Chamber of Commerce Roermond, registration number 13037353
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
Square Information Systems BV Bisschop Boermansstraat 27 6041 XL Roermond Postbus 56 6040 AB Roermond The Netherlands • T +(31) 0475 - 37 12 40 • F +(31) 0475 - 37 12 59 http://www.squareIS.com
[email protected]
Niets uit deze uitgave mag vermenigvuldigd en/of openbaar gemaakt worden door middel van druk, fotokopie, microfilm of op welke andere wijze dan ook, zonder voorafgaande schriftelijke toestemming van Square IS BV. Alle genoemde (geregistreerde) handelsmerken zijn eigendom van de respectievelijke fabrikanten. Copyright © 2004 Square Information Systems BV Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 2
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
Inhoudsopgave 1
Terminologie...................................................................................................4
2
BIBIS Library Portal Quick Install Guide ..................................................................5 2.1 Geadviseerde installatievolgorde...................................................................... 5
3
BIBIS Library Portal Quick Upgrade Guide ...............................................................8 3.1 BIBIS Library Management System Upgrade Guide .................................................. 8 3.2 BIBIS OPAC Quick Upgrade Guide ...................................................................... 8
4
Bijlage : activatie sleutels ..................................................................................9
5
Bijlage: voorbeeld uitvoer installatie script (bibis.vlaanderen.be) .............................. 10
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 3
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
1 Terminologie Dit document beschrijft in het kort de stappen die moeten worden ondernomen om de BIBIS installatie succesvol uit te voeren. In de volgende tekst wordt er gesproken over “omgevingen”, “directories” en “collecties”. Hieronder volgt een korte omschrijving van deze begrippen. Collecties:
Dit zijn de Verity-collecties en worden door de OPAC gebruikt voor het fulltext doorzoeken. U kunt deze collecties zien als een database gebaseerd op een bestandssysteem-structuur. Deze collecties worden door het BIBIS LMSprogramma opgebouwd met behulp van het Verity programma MKVDK.
BIBIS omgeving:
Een BIBIS omgeving is een combinatie van een virtuele directory welke is “gelinkt” naar een fysieke bestandsstructuur. Daarnaast hoort bij een BIBISomgeving ook nog een OPAC-omgeving.
OPAC omgeving: De definitie van een OPAC-omgeving is hetzelfde als de definitie van een BIBISomgeving, dus: een combinatie van een virtuele directory welke is “gelinkt” naar een fysieke bestandsstructuur. De OPAC 0001-omgeving en BIBIS 0001-omgeving bij elkaar genomen, worden gezien als een totaalomgeving voor bijvoorbeeld het departement COO. Directory:
De fysieke bestandslocaties op disk
Note: Wanneer een tekst tussen < > staat betekend het geven van een keyboard commando
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 4
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
2 BIBIS Library Portal Quick Install Guide 2.1
Geadviseerde installatievolgorde
1.
Plaats DVD in de server
!
2.
Kopieer de MVGINSTALL.TAR naar een tijdelijke directory
!
• 3.
Het filesysteem moet meer dan 3GB ruimte vrij hebben
Extract de MVGINSTALL.TAR in de tijdelijke directory middels •
!
tar xvf MVGINSTALL.TAR
4.
Start ./install.sh
!
5.
Selecteer de gewenste omgeving om te installeren
!
6.
Volg de aanwijzingen op het scherm!
!
•
7. 8. 9.
Zie ook de bijgevoegde “installatie-script”-uitvoer in bijlage 1 voor meer details en informatie. Indien u wordt gevraagd om de Providex serienummers in te vullen, belt u met Square IS, telefoonnummer +31475-371240 en geeft u het op het scherm gegenereerde System-id door aan de Square-medewerker. Deze zal vervolgens (terwijl u aan de lijn blijft) contact opnemen met de fa. EDIAS en de activatiesleutel opvragen en aan u doorgeven. De serienummers benodigd voor de overige programma’s, staan vermeld op de bijlage “activatie sleutels”, welke is bijgevoegd in dit document. Eventuele foutmeldingen in het installatie-script van Verity kunnen worden genegeerd. Gebruik als Verity install path: • export/org/https-bibis*.vlaanderen.be/square/verity
!
! !
10.
… Het installatie script is klaar…
!
11.
!
13.
Vervolgens opent u de “obj.conf” (in een tekst editor). U haalt in deze “obj.conf” de volgende regels weg en plaatst deze regels in de “magnus.conf” bij de overige inits: • Init fn=”load-modules” shlib=”/export/org/httpsbibis*.vlaanderen.be/square/verity/_solaris/bin/s97_ns3.so” funcs=”VerityTopicSearch” Het is van belang dat de webserver op poort 80 draait!!!
14.
In obj.conf verwijderd u, vanwege security-redenen, ook de volgende regels:
!
12.
• 15.
16.
17.
!
!
Nametrans fn=”pfx2dir” from=”/search97” dir=”[directory]”
Indien in obj.conf het volgende niet aanwezig, voeg dan toe: • Nametrans fn=”pfx2dir” from=”/search97cgi” dir=”/export/org/httpsbibis*.vlaanderen.be/square/verity/_solaris/bin” name=”cgi” Vervolgens voegt u voor iedere omgeving de volgende regels toe. Hierbij is de volgorde tevens van belang! • ;; BIBIS gerelateerd • Nametrans fn=”pfx2dir” from=”/lms0001” dir=”/export/org/httpsbibis*.vlaanderen.be/square/bibis/bibis0001/html” name=”cgi” • Nametrans fn=”pfx2dir” from=”/bibis0001” dir=”/export/org/httpsbibis*.vlaanderen.be/square/bibis/bibis0001” • ;; OPC gerelateerd • Nametrans fn=”pfx2dir” from=”/opc0001/cgi” dir=”/export/org/httpsbibis*.vlaanderen.be/square/opc/0001/search/cgi” • Nametrans fn=”pfx2dir” from=”/opc0001” dir=”/export/org/httpsbibis*.vlaanderen.be/square/opc/0001/search” Voor de samengestelde omgeving opc0000 voegt u de volgende regels toe aan de obj.conf.
!
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 5
!
!
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS •
18.
Nametrans fn=”pfx2dir” from=”/opc0000/cgi” dir=”/export/org/httpsbibis*.vlaanderen.be/square/opc/0000/search/cgi” • Nametrans fn=”pfx2dir” from=”/opc0000” dir=”/export/org/httpsbibis*.vlaanderen.be/square/opc/0000/search” Voor een correcte werking dient u het LD_LIBRARY_PATH te specificeren in het .profile van de webserver gebruiker. • Let op dat deze gebruiker ook volledige rechten heeft over de /export/org/httpsbibis.vlaanderen.be/square directory. • LD_LIBRARY_PATH=/export/org/https-bibis*.vlaanderen.be/verity/_solaris/bin
19.
U voegt nu aan de RC3.d het volgende proces toe: •
20.
21.
!
!
/export/org/https-bibis*.vlaanderen.be/scripts/crontab/bibis-start.sh
In de crontabs voor de webserver-gebruiker voegt u toe: •
/export/org/https-bibis*.vlaanderen.be/scripts/crontab/opc-ses-rm.sh
•
interval: dagelijks, iedere 20 minuten.
!
Het volgende script voegt u alleen toe aan de crontab van de INTRANET server:
!
• •
22.
23. 24. 25.
/export/org/https-bibis*.vlaanderen.be/scripts/crontab/bibis-int-cp.sh interval: 1 maal daags, bij voorkeur ’s nachts, 2 uur voordat de backup jobs plaatsvinden. U maakt een directory aan:
!
• /var/adm/log/bibis U linkt /usr/local/bin/perl naar /usr/local/ActivePerl-5.8/bin/perl middels het “ln –s”unixcommando. “Apply manual changes” in de webserver admin en reboot vervolgens de server Nu gaat u voor iedere BIBIS omgeving op de INTRANET machine de collecties opbouwen. U doet dit middels het intikken van: • cd /export/org/https-bibis.vlaanderen.be/square/bibis/bibis0001/unix <ENTER> •
./bib400 <ENTER>
•
UTL <ENTER>
•
23 <ENTER>
•
S <ENTER>
•
… wachten tot klaar …
•
8 <ENTER>
•
bye <ENTER>
! ! !
26.
U maakt de printerqueues aan zoals beschreven in de installatie handleiding
!
27.
Als laatste stap test u alle omgevingen.
!
NOTE: Indien er wordt uitgegaan van andere DNS-namen dan: • bibis-int.vlaanderen.be • bibis.vlaanderen.be • ldap.vlaanderen.be dient men voor iedere omgeving de volgende bestanden handmatig aan te passen: /export/org/https-bibis*.vlaanderen.be/square/opc/0001/settings/opc.hts /export/org/https-bibis*.vlaanderen.be/square/opc/0001/settings/opc.txt /export/org/https-bibis*.vlaanderen.be/square/bibis/bibis0001/config/perl.ini en het volgende alleen in omgeving 1: /export/org/https-bibis*.vlaanderen.be/square/bibis/bibis0001/config/bib2ver.ini
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 6
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS en alleen voor de intranet machine: /export/org/https-bibis*.vlaanderen.be/square/scripts/crontab/remssh/remssh.sh Meer details vindt u in de meer complete handleiding.
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 7
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
3 BIBIS Library Portal Quick Upgrade Guide 3.1
BIBIS Library Management System Upgrade Guide
Het is verstandig om bij elke upgrade van BIBIS een backup te maken van de gehele BIBIS directory. (/export/org/https-bibis*.vlaanderen.be/square/bibis/) Standaard wordt een BIBIS upgrade aangeleverd als een tar file. Deze tar file dient men te plaatsen in de directory: • /export/org/https-bibis*.vlaanderen.be/square en vervolgens uit te pakken. De software wordt dan correct overschreven. Indien de upgrade afwijkt van de hierboven beschreven procedure, wordt u middels een extra bijgeleverde tekst-(file) op de hoogte gebracht. 3.2
BIBIS OPAC Quick Upgrade Guide
Het is verstandig om bij elke upgrade van de OPAC een backup te maken van de gehele OPAC directory. (/export/org/https-bibis*.vlaanderen.be/square/opc) Standaard wordt ook bij een OPAC update, de nieuwe software aangeleverd als een tar bestand. Dit tar-bestand plaatst men in de directory: • /export/org/https-bibis*.vlaanderen.be/square en pakt men vervolgens uit. De software wordt dan tijdens het uitpakken correct overschreven. Na iedere update van de OPAC software dient u alle vhttp processen af te breken middels het killcommando Mochten er nog additionele stappen moeten worden uitgevoerd dan wordt dit beschreven in een bijgeleverde tekst file.
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 8
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
4 Bijlage : activatie sleutels Voor de bibis.vlaanderen.be: Omschrijving
Activatiesleutel
Providex versie 5 met serienummer 0680086, 20 users licentie
telefonisch opvragen
Providex mail package
RDED86F90A44BDF28
Verity 3.7.0, SN 10887
394790720-36770-18329
Dutch locale
4925-43-3205
Voor de bibis-int.vlaanderen.be: Omschrijving
Activatiesleutel
Providex versie 5, met serienummer 0680059, 10 users licentie
telefonisch opvragen
Providex mail package
R0CA2AE8B317C3FEA
Verity 3.7.0, SN 10887
394790720-36770-18329
Dutch locale
4925-43-3205
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 9
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS
5 Bijlage: voorbeeld uitvoer installatie script (bibis.vlaanderen.be) Square Information Systems Installer for: MVG – Brussel (Solaris8)
which server do you wish to install? 1 - https.bibis.vlaanderen.be (intranet) 2 - https.bibis-int.vlaanderen.be (internet) choice: 1 Enter username who will be owner of the files: bibis Has user bibis been created [y/n]? y Copying file(s)...... Done. NOTE: Next step may take up to 15 minutes, depending on the specs of your machine's hardware. Please do not interrupt this step. Extracting file(s)...... Done. Setting security to files (chmod 755)...... Done. Changing owner on files (chown bibis:bibis)...... Done. Next: Installation of packages and perl modules,... Welcome to the OPAC and BIBIS package/module installer, customized for MVG. Is perl present on this system... Yes. Configuration test... Perl seems to be fine. Is the Yes. Is the Yes. Is the Yes. Is the Is the
perl LWP::default extension installed and correctly configured... perl LWP::UserAgent extension installed and correctly configured... perl Convert::ASN1 extension installed and correctly configured... perl Net::LDAP extension installed and correctly configured... Yes. perl Babel extension installed and correctly configured... Yes.
Installing tools and other modules needed for BIBIS OPAC. Installation may take up to 5 minutes depending on the specs of your machine. Running the setup in the context of user: 'root'. Perl version found on the system: 5.8.1. Perl installation directory: /usr/local/ActivePerl-5.8. Temporary directory used for copy and extraction: /INST83635815 Is the GNU GCC Compiler already installed... No. Preparing and copying master file which is needed for installation... Done. Decompressing tools... No match Done. Installing tools packages.... Installing GNU GCC Compiler 3.0.3, may take a while... Done. Installing LIBGcc package 3.3... Done. Installing Zlib package 1.1.4... Done. Installing Prngd package 0.9.25... Skipped Installing OpenSSL package 0.9.7c... Skipped Decompressing perl modules... Done. Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 10
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS Removing temporary files in '/INST83635815'. Finished installing modules. Installation error messages (if any): No errors occured. Everything did install the way it should. :)) Next: Registration of providex Ready to register providex now... please use the following registration information. When asked for a serial number, please contact Edias in the Netherlands, phone number +31(0)71-341-5454. You will be asked for the system NUMBER... which is provided during activation. When asked for a registered username, enter: MVG. When asked for a serial number, enter: 0680086 (20 user licence). When asked for an expiry date, just press enter. When asked for the first serial key, contact EDIAS and enter the number provided. When asked for a package number, enter: 20001. When asked for the second serial key, enter RDED86F90A44BDF28. When asked for the next package number, just press enter. Press enter to continue.... ProvideX Activation utility --------------------------Enter name of registered user: MVG Enter serial number: 0680086 etc...... Welcome to Verity
Installation for Unix platforms ***
Enter your license key. If you don't have a key, press Ctrl-C to abort the process. Enter your license key. 394790720-36770-18329
Is this install script running on SPARC Solaris 2.6, 2.7 or later? [y/n] y Enter the full path of the destination directory to install the software: Default is //verity: >/export/org/https-bibis.vlaanderen.be/square/verity Specify the product(s) that you would like to install. You may enter one or more of the following (space-separated list). Product ------s97is370
Description ----------Verity Information Server V3.7
Verity
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 11
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS *** Installation for Verity Information Server v3.7 *** Platform -------solaris
Description ----------SPARC Solaris v2.6, v2.7
Are you Upgrading a previously Installed Search'97 IS? [y/n] >n Server Configuration
Specify the http server to use with your Verity Software. 1. Netscape Server 2. Apache Server v1.x 3. None of the above
(EN SunOne… )
>1 Netscape
Server
Configuration
Please enter the full path to your server. (ie. /usr/local/netscape/https-quest)
(“server” = https directory)
>/opt/SUNWam/servers/https-issun02.squareis.com Please pick the Netscape server you are using. 1. 2. 3. 4.
Netscape Netscape Netscape Netscape
Fasttrack Server v2.x. Enterprise Server v2.x. Enterprise Server v3.x. iPlanet Server v4.x. (of SunOne)
>4
Install will modify Netscape Server configuration files. Install needs to stop Netscape Server now to ensure its stability. Netscape Server will be restarted at the end of this configuration. Would you like to stop it now [y/n]? >y Stopping /opt/SUNWam/servers/https-issun02.squareis.com... Installing Verity Information Server v3.7 for solaris. Ini file /export/org/httpsbibis.vlaanderen.be/square/verity/_solaris/bin/inetsrch.ini already exists. Previous settings preserved... Verity Information Server v3.7 product installation complete Finished updating Verity Information Server v3.7 home page and sample forms... Installing Verity Agent Server v3.7 Moving your current Agent Server templates into a backup Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 12
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS template directory before installing new templates. The backup template directory already exists. The following directory will now be removed: /export/org/httpsbibis.vlaanderen.be/square/verity/s97is/locale/english/agents/template.old If you need the files in this directory, please relocate them now Press 'return' when you are ready to proceed
Old templates have been relocated to: /export/org/httpsbibis.vlaanderen.be/square/verity/s97is/locale/english/agents/template.old Backing up your current Agent Server repository before installing new one. The backup repository already exists. The following repository will now be removed: /export/org/https-bibis.vlaanderen.be/square/verity/s97as/v_store.old If you need the agents/deliveries in this repository, please relocate it now Press 'return' when you are ready to proceed Old repository has been relocated to: /export/org/https-bibis.vlaanderen.be/square/verity/s97as/v_store.old The dcm already has an existing data file on disk. Do you want to overwrite this data file and continue? [Y/n] >Y This install will start the DCM daemon. In the future, you should ensure that the DCM daemon is running before using the Verity Information Server's Agent features. To start the DCM, you should run '/export/org/httpsbibis.vlaanderen.be/square/verity/dcmstart' For future reference, DCM instructions can be found in: /export/org/https-bibis.vlaanderen.be/square/verity/DCMREADME.TXT Press return to continue. dcm: dcm - Verity, Inc. Version 2.6.1 (_solaris, Sep 6 2000) Starting daemon dcm: dcm - Verity, Inc. Version 2.6.1 (_solaris, Sep 6 2000) dcm Tue Jul 20 09:49:09 2004: Logging to '/export/org/httpsbibis.vlaanderen.be/square/verity/_solaris/bin/dcm.log' Dcm installed successfully. Couldn't retrieve AdminUser from ini file. Couldn't add the admin user to the user database
Verity Agent Server v3.7 product installation complete
Finished configuring your Netscape Server. The following files were modifed: /opt/SUNWam/servers/https-issun02.squareis.com/config/obj.conf /opt/SUNWam/servers/https-issun02.squareis.com/config/mime.types Your original copies are stored in: /opt/SUNWam/servers/https-issun02.squareis.com/config/orig/ The Netscape Server needs to be (re)started before Verity Information Server v3.7 can be used. Would you like to (re)start it now? [y/n]? Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 13
Bisschop Boermansstraat 27, 6041 XL, P.O. Box 56, 6040 AB Roermond, The Netherlands Telephone: +(31) 0475 – 37 12 40, telefax: +(31) 0475 – 37 12 59, http://www.squareIS.com
INFORMATION SYSTEMS >y iPlanet-WebServer-Enterprise/6.0SP2 B11/13/2001 00:49 warning: daemon is running as super-user Can not (re)start Netscape Server. Please (re)start the manually after installation In order to complete your Netscape Server configuration please follow instructions below. Caution - Your Netscape configuration files have been successfully updated. In order for these changes to take effect in the Netscape Administrative Server, do the following: 1) Start the Netscape Administration Server. 2) Select your server. 3) Netscape will display a message indicating changes have been made to your configuration files. Click OK. 4) Click the Apply button on the upper right side of the screen.
To start Verity Information Server, use your browser and connect to the following URLs: Home Page: http://issun02.squareis.com:/search97/ Admin Page: http://issun02.squareis.com:/search97secure/s97a.vta? Finished installing s97is370. Press 'return' to continue > In order to run command-line utilities from this installation, it may be necessary for you to add /export/org/httpsbibis.vlaanderen.be/square/verity/_solaris/bin to your system's LD_LIBRARY_PATH environment variable. Alternatively, you may opt to copy or link the required shared libraries into the appropriate system directory, usually /usr/lib or /usr/local/lib. The libraries to copy (if you choose) are: libvdk200.so Installation ends. The following steps you must do manually to finalize the setup. Next: Adjust your webserver configuration (obj.conf) as described in the manual Chapter: add opc/bibis environment or appendix D Next: Add periodical scripts to crontab for user bibis and the following scripts... .../square/scripts/crontab/opc-ses-rm.sh .../square/scripts/crontab/bibis-int-cp.sh Next: Add to your rc3.d configuration the following script... .../square/scripts/crontab/bibis-start.sh Done.
Registered at Chamber of Commerce Roermond, registration number 13037353
Pagina 14
