Indexierungs-Scripte in $exlg

Transkript

1 Vorbemerkung Stand: Bei der Migration zu Version 16 wird die Indexierung standardmäßig aus dem Menue des Migrationstools Upgrade Express gestartet. In folgendem Fall ist dies nicht möglich und es müssen stattdessen Indexierungs-Scripte außerhalb des Upgrade Express verwendet werden. Die Indexierungsroutinen in Upgrade Express sehen die Anreicherung des Headingindex in der Titel-Library aus den Normdateien über p_manage_102 vor. Bei diesem Prozess kann aber nicht auf entfernte Normdateien zugegriffen werden, somit nicht auf die zentralen Normdateien eines Verbundes. Aus diesem Grunde muß der alternative Weg der Anreicherung der Headings über ue_08 verwendet werden. Dazu stehen vorbereitete Scripte in dem Verzeichnis $exlg zur Verfügung, die aber nicht aus Upgrade Express aufgerufen werden können. Die Scripte werden benutzt zur Indexierung in der Titelbibliothek, in den lokalen Normdateien, in der ILL- und Cource Reading-Bibiothek sowie in den Holdings, soweit diese Bibliotheken vorhanden sind. Die Indexierung der ADM-Bibliothek(en) erfolgt weiterhin über Upgrade Express. Verwendung bei Testmigrationen: Sofern Sie die Scripte bei einer Testmigration einsetzen, klären Sie bitte mit der Verbundzentrale, ob vom Testrechner aus ein Abgleich mit den zentralen Normdaten durchgeführt werden kann. Falls dies nicht möglich ist, muß im Indexierungs-Script der Aufruf von ue_08 auskommentiert werden und kann erst bei die produktive Umsetzung aktiviert werden. Bitte beachten Sie dazu die Hinweise unter Installation der $exlg-umgebung 1.1 Verzeichnis exlg16 anlegen Das Paket mit den Indexierungs-Scripten steht auf unserem FTP-Server (User: ftpuser) Verzeichnis: Datei: products/aleph/upgrade_express/ exlg16_user.tar.gz Das Verzeichnis exlg16 wird angelegt im u-baum Ihrer Aleph-Umgebung, parallel zu den User-Libraries. Verbinden Sie sich bitte mit unserem FTP-Server (User: ftpuser) und übertragen Sie bitte das oben genannte tar-file nach./u16_n. Entpacken Sie bitte die Datei mit folgenden Schritten aus: cd $USER_MOUNT/u16_n gzip -d exlg16_user.tar.gz tar -xvf exlg16_user.tar 1

2 Es wird ein Verzeichnis exlg16 mit zugehörigen Unterverzeichnissen angelegt. 1.2 Korrigieren aleph_start.private Das Verzeichnis exlg16 wird in aleph_start.private der Umgebungsvariablen $exlg zugeordnet. cd $alephe_root vi aleph_start.private Fügen Sie bitte die folgenden Zeilen an das Ende von aleph_start.private ein: ExLibris (Germany) - tool directory if (-e ${USER_MOUNT}/u${ALEPH_VERSION}_$ALEPH_COPY/exlg$ALEPH_VERSION \ && -d ${USER_MOUNT}/u${ALEPH_VERSION}_$ALEPH_COPY/exlg$ALEPH_VERSION ) then setenv exlg ${USER_MOUNT}/u${ALEPH_VERSION}_$ALEPH_COPY/exlg$ALEPH_VERSION endif Zum Aktivieren dieser Änderung führen Sie bitte einen Logoff und neuen Login durch. 1.3 Anlegen Konfigurationsdatei in der Titelbibliothek Die Indexierungs-Scripte werden gesteuert über eine Konfigurationsdatei, die in der Titelbibliothek abgelegt wird. Sofern Sie in Ihrer Anwendung mehrere Titelbibliotheken benutzen, reicht es aus, die Konfigurationsdatei in einer der Titelbibliotheken anzulegen. Die Konfigurationsdatei wird angelegt im conv-verzeichnis der Titelbibliothek. Sofern es noch kein conv-verzeichnis in der Titelbibliothek gibt, bitte das Verzeichnis anlegen. dr mkdir conv (nur, wenn das Verzeichnis noch nicht existiert) Kopieren des Templates aus der Umgebung $exlg: cd conv cp $exlg/tab/template/cvg_load_index.conf. Anpassen dieses Templates an die eigene Umgebung: Die Konfigurationsdatei enthält eine Reihe von Parametern, die für die Indexierung nicht von Bedeutung sind. Lediglich die im folgenden Ausdruck des Templates fett gedruckten Zeilen sind relevant und müssen ggf. angepasst werden. Es sind folgende Anpassungsschritte durchzuführen: 2

3 1. Eintragen der aktuellen Library-Namen anstelle von z.b. ppp01. Die Namen der zentralen Normdateien auf dem Verbundrechner werden hier nicht eingetragen. 2. Eintragen der korrekten Anzahl von Parallelprozessen für die Indexierung. Bitte bei allen Parametern (NO-CPU-TIT1, NO-CPU-TIT2, NO-CPU-AUT1 und NO-CPU- AUT2) den gleichen Wert eintragen. 3. Der Parameter PM-02-RUN-2 ist standardmäßig auf N gesetzt. Nur wenn Sie eine eigene Systematik-Normdatei verwenden, ist ein 2. -Lauf in der Titeldatei zur Anreicherung der Headings über ein Expandprogramm notwendig. In diesem Fall muß der Parameter auf Y gesetzt werden. Template cvg_load_index.conf configuration file for load / index data with exlg-scripts COL 1. Code COL 2. Parameter or COL 1. lib... / znn z... COL 2. List of Code=Parameter Change ppp by library and PP by 001-prefix in this template LIB-TYPE MAB LIBS-ALL ppp01 ppp10 ppp11 ppp12 ppp50 ppp60 LIBS-TIT ppp01 LIBS-AUT ppp10 ppp11 ppp12 LIBS-ADM ppp50 LIBS-HOL ppp60 ==== load parameter ==== ---- default values ---- FIX-TYPE MAB DOC-CONV MAB_TO_UTF DN-OLD-NEW NEW ZNN-CONV 8859_1_TO_UTF CAT-LEVEL PREFIX PP ---- specific non-default values lib ppp01 DOC-CONV=8859_1_TO_UTF FIX-TYPE=NO-FIX CAT-LEVEL=NO-CAT DN- OLD-NE W=NEW znn z30 ZNN-CONV=NO-CONV ==== index parameter ==== NO-CPU-TIT-1 2 NO-CPU-TIT-2 2 NO-CPU-AUT-1 2 NO-CPU-AUT-2 2 PM-02-RUN-2 N ==== 3

4 1.4 Testindexierung ohne Anreicherung über entfernte Normdateien Klären Sie bitte für die Testmigration(en) und später auch für die Produktionsmigration mit der Verbundzentrale, dass die Verbindung zum zentralen Normdatenserver für den aktuellen Rechner freigeschaltet ist. Sie sollten auch abklären, ob der Normdatenserver für den Zeitraum der Indexierung erreichbar ist und nicht z.b. für Wartungsarbeiten abgeschaltet wird. Sofern die Verbundzentrale den Zugriff auf die Normdaten bei einer Testindexierung nicht freischalten möchte, muß in den Indexierungs-Scripten der Aufruf des Schrittes ue_08 auskommentiert werden. Bitte prüfen Sie in diesem Fall anhand der Beschreibung unter 2.4ff, welche(s) Script(e) mit Anreicherung der Headings über ue_08 für Ihre indexierung verwendet werden soll(en). In diesen Scripten ist der entsprechende Indexierungschritt wie folgt zu deaktivieren: In den Scripten aaa_index_tit.all und aaa_index_tit.all.no_links echo "time: start aaa_index_tit_ue_08 " `date` >> $log_file csh -f $exlg/proc/aaa_index_tit_ue_08 $lib Im Script aaa_index_tit.all.lib1_lib2 echo "time: start aaa_index_tit_ue_08 for $lib1" `date` >> $log_file csh -f $exlg/proc/aaa_index_tit_ue_08 $lib1 echo "time: stop aaa_index_tit_ue_08 for $lib1" `date` >> $log_file echo "time: start aaa_index_tit_ue_08 for $lib2" `date` >> $log_file csh -f $exlg/proc/aaa_index_tit_ue_08 $lib2 echo "time: stop aaa_index_tit_ue_08 for $lib2" `date` >> $log_file Bitte achten Sie darauf, dass die Auskommentierung vor der Produktionsmigration wieder herausgenommen und der Indexierungsschritt wieder aktiviert wird. 4

5 2. Verwendung der Indexierungs-Scripte Die Scripte werden benutzt zur Indexierung in der Titelbibliothek, in den lokalen Normdateien, in der ILL- und Cource Reading-Bibiothek sowie in den Holdings, soweit diese Bibliotheken vorhanden sind. Zur Benutzung der Scripte gehen Sie bitte wie folgt vor: 2.1 Indexierung in Upgrade Express übergehen In Upgrade Express den Menuepunkt 7 / 2 / 1 Indexing -- Bibliographic/Authority Data übergehen. Die Indexierung in der ADM-Library über 7 / 2 / 2 Indexing -- Administrative Data wird weiterhin über Upgrade Express durchgeführt. 2.2 Starten Indexierung von Unix-Kommandoebene Die Indexierungsschritte für AUT, BIB, HOL, ILL und CR werden auf Unix-Ebene von der Kommandozeile aufgerufen. Die einzelnen Scripte müssen separat gestartet werden. Dabei bitte keine Programmläufe parallel laufen lassen, d.h. den jeweils folgenden Lauf erst starten, wenn der vorherige abgeschlossen ist. Bitte beachten Sie folgende allgemeine Hinweise: - In der folgenden Beschreibung ist die Angabe der jeweiligen Bibliothek mit xxx01, xxx20 usw. angegeben. Diese Kürzel sind in Ihrer Umgebung durch die korrekten Bibliotheksnamen zu ersetzen. - Beim Start aller Indexierungsschritte, d.h. auch bei denen für AUT, HOL, ILL und CR, muß active Library der Titelbibliothek zugeordnet sein, in der die Konfigurationsdatei abgelegt wurde (s. oben): - Der Library-Name, der beim Start eines Indexierungsschritts als Parameter übergeben wird, muss in Kleinbuchstaben angeben werden. Also z.b.: csh f $exlg/proc/aaa_index_tit.all.no_links fuh01 & - Die Logfiles werden in $data_scratch der zu indexierenden Library geschrieben. Im Logfile des Gesamtlaufs bzw. im Logfile des aktuellen p_manage_nn-laufs können Sie prüfen, wie weit die Indexierung zur Zeit ist. - Der Prozess ue_08 wird im Indexlauf der Titel aufgerufen und es wird im Script das Ende der Verarbeitung abgeprüft, um dann mit dem folgenden Index-Schritt fortzufahren. Während des Laufs von ue_08 können Sie in $data_scratch/aaa_check_ue_08_done den Stand der Verarbeitung ablesen. Der Programmlauf ist zu Ende, wenn die Anzahl der NEW-Einträge = 0 ist. - Nach den Einzelschritten der Indexierung wird eine Prüfung auf enthaltene Fehlermeldungen in den Logfiles durchgeführt. Das Ergebnis dieser Prüfung steht jeweils im scratch-verzeichnis der indexierten Bibliothek: 5

6 2.3 Indexierung Normdatei(en) Es werden alle in der Anwendung vorhandenen Authority-Libraries indexiert. Sofern bei Ihnen keine lokalen Normdateien benutzt werden, entfällt dieser Schritt. csh f $exlg/proc/aaa_index_aut LIBS-AUT & p_manage_12 $data_scratch/aaa_index_aut.log 2.4 Indexierung Titeldatei Es werden alle in der Titelbibliothek benötigten Indexierungsschritte aufgerufen. Standardmäßig werden bei der Indexierung im Rahmen der Migration die Links (z103) nicht neu aufgebaut. Sofern Sie bei diesem Indexierungslauf auch die Links innerhalb der Titelbibliothek, sowie der Links von ADM und HOL zum Titel neu aufbauen möchten, benutzen Sie bitte den unten entsprechend gekennzeichneten Programmaufruf. (kein Neuaufbau der Links) csh f $exlg/proc/aaa_index_tit.all.no_links xxx01 & Indexierung mit Neuaufbau der Links: Hier ist zu unterscheiden, ob die ADM-Bibliothek exklusiv zu der zu indexierenden Titelbibliothek gehört, oder ob die ADM-Bibliothek auch Verknüpfungen zu einer zweiten Titel- bzw. zu einer Fernleihbibliothek enthält. Fall 1 - (Nur) eine Titelbibliothek ist mit der/den ADM(s) verknüpft Aufruf: 6

7 csh f $exlg/proc/aaa_index_tit.all xxx01 & (mit Neuaufbau der Links) Fall 2 - Es sind zwei Titelbibliotheken (xxx01/02) oder eine Titel- und eine Fernleihbibliothek (xxx20) mit der/den gleichen ADM(s) verknüpft In diesem Fall benutzen Sie bitte ein Script, mit dem beide Bibliothken indexiert werden. Es ist für diesen Fall ein bestimmter Wechsel zwischen den beiden Libraries für die Indexierungsschritte notwendig, der in diesem speziellen Script realisiert wird. Aufruf: csh -f aaa_index_tit.all.lib1_lib2 xxx01 xxx02 & bzw. csh -f aaa_index_tit.all.lib1_lib2 xxx01 xxx20 & (nur bei Neuaufbau der Links/z103) p_manage_12 für (alle) ADM (nur bei Neuaufbau der Links/z103) p_manage_12 für HOL (nur bei Neuaufbau der Links/z103) p_manage_12 innerhalb der BIB (nur bei Neuaufbau der Links/z103) ue_08 p_manage_32 $data_scratch/aaa_index_tit.all.no_links.log 2.5 Indexierung Fernleihbibliothek Es werden hier alle Indexierungsschritte einer Titelbibliothek aufgerufen. Sofern bei Ihnen keine Fernleihbibliothek benutzt wird, entfällt dieser Schritt. Achtung: Sofern bei der Indexierung auch die Links neu aufgebaut werden, entfällt die separate Indexierung der Fernleihbibliothek. Die Indexierung wird dann über ein besonderes Script 7

8 zusammen mit der Indexierung der Titelbibliothek (s. unter 2.4) durchgeführt. Dies ist notwendig, da die Links von der ADM-Bibliothek zur Titel- und zur Fernleihbibliothek zusammen aufgebaut werden müssen. In diesem Fall entfällt dieser Schritt. csh f $exlg/proc/aaa_index_tit.all.no_links xxx20 & ue_08 p_manage_32 $data_scratch/aaa_index_tit.all.no_links.log 2.6 Indexierung Course Reading Bibliothek Es werden hier alle Indexierungsschritte einer Titelbibliothek aufgerufen. Sofern bei Ihnen keine Course Reading Bibliothek benutzt wird, entfällt dieser Schritt. csh f $exlg/proc/aaa_index_tit.all.no_links xxx30 & ue_08 p_manage_32 8

9 $data_scratch/aaa_index_tit.all.no_links.log 2.7 Indexierung Holdingdatei Es werden die für eine Holdingbibliothek benötigten Indexierungsschritte aufgerufen. csh f $exlg/proc/aaa_index_hol xxx60 & $data_scratch/aaa_index_hol.log 9