3 Descrizione software CASA

ARIADNE
Solutions for the E-Society
Via del Torchio 1
27020 Torre d’Isola (PV) – Italy
tel. +39.0382.407.450/538
fax +39.0382.407.384
www.ariadne.it
[email protected]
Progetto CASA
System installation and operations
guide
Progetto CASA – System installation and operations guide
0 Storia
Ver.
1.0
Status dd/mm/yyyy Prepared
11/09/2000
Revised
Ariadne ref.
G.Bernuzzi
A.Spada
E.Tronconi
2 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
1 Indice
0
Storia ....................................................................................... 2
1
Indice....................................................................................... 3
2
Prerequisiti ................................................................................ 4
2.1 Lato server.............................................................................. 4
2.2 Lato client .............................................................................. 4
3
Descrizione software CASA .............................................................. 5
4
Installazione del software CASA ........................................................ 8
5
Configurazione JRun ..................................................................... 9
5.1 Installazione JRun ..................................................................... 9
5.2 JRun Administrator ................................................................... 17
6
Installazione base dati .................................................................. 24
7
Procedure di generazione dell’identificativo del server .......................... 25
8
Upload registro ISSN .................................................................... 26
The CASA Software is owned by CASA Consortium and is protected by copyright laws. Your use of the
CASA Software and associated documentation is subject to the applicable copyright laws. You may not
rent, lease, or otherwise transfer the CASA Software except as expressly authorized in these terms. You
may not modify or remove any proprietary notices or labels on the Software.
3 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
2 Prerequisiti
I prerequisiti sono distinti fra lato server e lato client:
2.1 Lato server

Sistema Operativo WinNT/95/98, Unix.

Almeno 128 MB di RAM.

Almeno 6 GByte di disco liberi.

Web Server in grado di supportare jsp versione 1.0. Il software CASA è testato
con Web Server JRun le cui procedure di installazione dettagliate sono contenute
in questo documento nel paragrafo 5. JRun è un Java Web Server free prodotto
dalla Allaire Corp. scaricabile da: ftp://ftp.allaire.com/pub/jrun/.

JDK rel.1.2 o superiore.

Database: Oracle server rel. 7.3 o superiore.
Ariadne ha testato il funzionamento ed è in grado di fornire assistenza per JRun.
2.2 Lato client

Almeno un PC connesso ad Internet con installato un comune browser (per ora
testato con Netscape ed Explorer).
4 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
3 Descrizione software CASA
Il pacchetto contenente il software CASA deve essere installato in una directory
<CASA_HOME> ed è strutturato nel seguente modo:
Figura 1
In dettaglio le directory contengono:

bga
Figura 2
Contiene i dati relativi al Background Actor, in particolare la directory data
contiene i files utilizzati dal Background Actor, la directory logs contiene i files di
logs del Background Actor ed infine Properties in cui sono contenute le proprietà
del Background Actor stesso.

bin
Contiene tutti i comandi che possono essere eseguiti da interfaccia batch. Ogni
comando presenta la versione .bat e .sh.
5 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 3
I comandi visualizzati in Figura 3 possono essere raggruppati in questo modo:
 Configurazione ambiente: casaenv.
 Configurazione nuovo server: setup_casa_server (vedi paragrafo 7)
 Upload dati ISSN: load_issn (vedi paragrafo 8).
 MarcConversion dati SBN-UNIMARC nei formati
Originale UNIMARC: read_original_arch_sbn, conv_original_arch_sbn.
Stampa (utilizzato da ICCU): read_print_arch_sbn, conv_print_arch_sbn.
 Migrazione di un archivio convertito: migr_archive.
Prima dell’esecuzione di ogni comando è necessario eseguire il comando per
settare l’ambiente.

classes
Figura 4
6 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Contiene tutti i files sorgenti *.java e i files *.class del software CASA.

jsp
Contiene i files *.jsp10 con le jsp versione 1.0 relative al software CASA.
Figura 5

properties
Figura 6
Contiene i files di properties properties.casa nel quale sono definite le proprietà del
server CASA ovvero i dati relativi alla connessione al Database e install.properties
necessario per la generazione dell’identificativo di un nuovo server.

spool
Figura 7
Rappresenta l’area di spool del software CASA.
Nella directory mirroring sono presenti i files scaricati durante il processo di
mirroring contenenti record ISSN e proposte. Nella directory prop_doc sono
contenuti i files rappresentanti la documentazione ancillare di una proposta. La
directory tmp ha caratteristiche temporanee ed è utilizzata per l’upload dei file.
7 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
4 Installazione del software CASA

Copiare il contenuto del software CASA nella directory di installazione scelta
(<CASA_HOME>).

Modificare il file di properties (<CASA_HOME>/properties/properties.casa)
contenuto nella directory properties con le caratteristiche del Database.
drv
driver Database (oracle.jdbc.driver.OracleDriver).
url
url Database.
uid
nome dell’utente per l’accesso al Database CASA.
Upw
password dell’utente per l’accesso al Database CASA.
MaxNumberConnection
(consigliabile 9).
emira.version
numero massimo di connessioni alla base dati
parametro del Background Actor (sempre 1.2)
emira.listener_port
porta di ascolto del Background Actor (default 6900).

Modificare il file <CASA_HOME>/bin/casaenv.sh (o casaenv.bat) aggiungendo
alla variabile di sistema CLASSPATH di sistema il JDBC Driver, la directory
<CASA_HOME>/classes

Dopo aver eseguito il comando per il settaggio corretto dell’ambiente
<CASA_HOME>/bin/casaenv.sh (o casaenv.bat), posizionarsi sotto la directory
<CASA_HOME>/classes/ariadne/util
ed
eseguire
il
comando
javac
LinkNames.java (la ricompilazione è necessaria perché il file contiene caratteri
particolari ed il .class generato è dipendente dalla piattaforma usata).

Generare un identificativo per un nuovo server CASA (vedi paragrafo 7).

Configurare il Web Server (vedi paragrafo 5).

Caricare i dati ISSN (vedi paragrafo 8).
8 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
5 Configurazione JRun
La configurazione del Web Server, nel nostro caso del JRun deve avvenire nel
seguente modo:

Aggiungere al classPath del Server le classi del JDBCDriver e la directory
<CASA_HOME>/classes.

Mappare i files di estensione jsp10 affinché siano riconoscibili dal Web Server
come jsp versione 1.0.

Aggiungere la Servlet principale di CASA agli Aliases definiti sul Web Server
come segue:
Name = CASAInvoker
Class = ariadne.CASA.invoker.CASAInvoker
Init Argoment
dirInstall=<CASA_HOME>/
5.1 Installazione JRun
JRun Setup Wizard assiste l’utente nell’installazione del Web server.
La seguente finestra appare all’inizio dell’installazione (Figura 8):
Figura 8
9 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Fare click su Continue
10 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 9
Dopo aver fatto click su next, (Figura 9) riempire il campo di testo con la posizione in
cui installare JRun (Figura 10) ed il Java Developer Kit (Figura 11).
Figura 10
11 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 11
Selezionare nella finestra precedente il jdk1.2 e procedere facendo click su Next.
Nella successiva maschera deve essere specificata la directory jsm, per default è
C:\JRun (Figura 12).
12 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 12
Nella maschera seguente, in cui si richiede all’utente il codice numerico della licenza
del software, l’inserimento dei dati va tralasciato; fare click su Next (Figura 13).
13 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 13
Figura 14
L’opzione CF_Anywhere può essere selezionata in base alle esigenze di uso
Deve essere quindi selezionata quale versione delle JSP si desidera che il JRun
supporti.
14 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Selezionando 0.92 automaticamente il JRun associa ai file con estensione .jsp
l’interprete delle 0.92 e ai file con estensione .jsp10 l’interprete delle jsp10.
Selezionare JSP1.0.
Figura 15
Il JRun connector, abilita un server web esterno per connettersi al JRun. È
consigliabile configurare JRun come WebServer e quindi non specificare nessun
altro web server (Figura 16).
15 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 16
L’installazione è conclusa, devono essere specificate le opzioni e configurato
l’ambiente.
16 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
5.2 JRun Administrator
Selezionare JRun Administrator.
Figura 17
Dal JRun service Manager (Figura 17), selezionare jsm-default e successivamente
fare click sul tasto Configure. Comparirà la seguente maschera (Figura 18):
17 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 18
Selezionare JseWeb e fare click su General Config. Selezionare dal menu General e
Java dal sottomenu e compilare i campi relativi al Java Classpath. In questo campo
di testo devono essere aggiunti le directory del JDBC Driver e
<CASA_HOME>\classes (Figura 19).
18 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 19
Salvare la configurazione definita e passare alla maschera di Service Config (Figura
20) cliccando sul pannello Services.
19 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 20
Fare click su Add ed inserire il Servlet Name: CASAInvoker ed il className:
ariadne.CASA.Invoker.CASAInvoker. Fare doppio click su Init Arguments (Figura
21) e compilare, dopo aver selezionato Add, la maschera seguente con name:
dirInstall e valori degli argomenti:<CASA_HOME>\.
20 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 21
Salvare le modifiche; selezionare la maschera Services ed il Service Config in jws
(Figura 22).
21 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 22
Inserire il percorso delle jsp nel real path (Figura 23) nell’amministrazione del Web
server, <CASA_HOME>/jsp/ in corrispondenza al virtual path /.
22 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
Figura 23
Dare conferma delle modifiche effettuate. Chiudere il JRun Administrator.
23 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
6 Installazione base dati
Il software CASA soddisfa al requisito di indipendenza da RDBMS: è semplicemente
richiesto che la base dati sia relazionale compatibile SQL92 e supporti il livello
TRANSACTION_SERIALIZABLE.
Il software CASA è stato sviluppato con RDBMS Oracle. La base dati è stata
generata mediante un set di script DDL. Questi script sono inevitabilmente
personalizzati per RDBMS Oracle, per le parti di dimensionamenti ed indicizzazioni.
La personalizzazione si è resa necessaria a seguito delle considerevoli dimensioni
della base dati (ordine di 1.000.000 di record ISSN e proposte), che hanno imposto
ottimizzazioni dipendenti dal particolare RDBMS utilizzato.
Insieme al software sono distribuiti gli script DDL per la creazione della base dati
CASA su RDBMS Oracle. Questi possono essere utilizzati solo su RDBMS Oracle. Se
non si dispone di Oracle, ma di altro RDBMS, il DBA del sito potrà produrre gli script
DDL per il particolare RDBMS usufruendo del documento “Logical Database Design”.
24 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
7 Procedure di generazione
dell’identificativo del server
Per generare un nuovo identificativo, è necessario modificare il file di properties
<CASA_HOME>/properties/install.properties compilando tutti i dati indicati con i
parametri corretti.
userdb
nome di un utente del Database CASA con funzionalità di sistema.
pwddb
password di un utente del Database CASA con funzionalità di sistema.
descrServ
descrizione del Server CASA
levServ
Livello del Server:
0 = Test CASA Server.
2 = National CASA Server.
3 = Community CASA Server.
notes
note aggiuntive alla descrizione del server.
urlServ
indirizzo IP del server CASA.
emailServ
SMTP Server che verrà utilizzato dal software CASA per la spedizione
di e-mail.
emailRet
Indirizzo e-mail configurato come mittente dei messaggi di posta
elettronica originati dal server.
La generazione dell’identificativo del nuovo server CASA avviene con l’esecuzione
del comando setup_casa_server –d <CASA_HOME>. È importante ricordare che
l’esecuzione di setup_casa_server deve avvenire dopo aver eseguito il comando
per il settaggio corretto dell’ambiente.
Durante la procedura di generazione dell’identificativo, vengono richieste
all’utente le credenziali userId e password. Non essendo definito nessun utente, si
utilizza l’utente generico di amministrazione: con userId=system e
password=system.
25 – 26
ARIADNE
Solutions for the E-Society
Progetto CASA – System installation and operations guide
8 Upload registro ISSN
La funzione di Upload permette il caricamento di un file di dati ISSN, organizzati un
record per riga, nel database CASA.
L’operazione di Upload del registro ISSN avviene con l’esecuzione del comando
load_issn –f <FILE>, dove <FILE> corrisponde al nome dell’archivio contenente i
dati da caricare. È importante ricordare che l’esecuzione di load_issn deve
avvenire dopo aver eseguito il comando per il settaggio corretto dell’ambiente.
Inizialmente viene richiesto all’utente l’inserimento della directory <CASA_HOME>
per consentire al sistema il recupero del file properties.casa contenente i parametri
necessari alla connessione al database.
Durante l’esecuzione del comando load_issn, sono visualizzati gli identificativi
numerici all’interno del file dei record caricati. In questo modo, in caso di eventuali
errori, si può risalire al record che ha generato il problema. Il popolamento è
avvenuto correttamente fino al numero di riga indicato a video prima del messaggio
di errore. Per continuare con l’upload del medesimo file, è necessario copiare le
righe successive a quella del record caricato in un altro archivio e successivamente
ripetere il comando load_issn utilizzando il nome del file appena generato.
26 – 26
ARIADNE
Solutions for the E-Society