Capitolo 4 Installazione della documentazione di SEAS 3.0

Questo capitolo contiene informazioni sulle collezioni di documenti fornite con Solaris Easy Access Server 3.0 e istruzioni per l'installazione del programma di visualizzazione della documentazione AnswerBook2^TM.

• "La documentazione di SEAS"

• "Installazione del server Answerbook2"

• "Installazione del server Answerbook2"

• "Installazione delle collezioni di SEAS"

• "Registrazione di un server di documenti Answerbook2"

• "Uso del server AnswerBook2"

Vedere "Conversione a Solstice DiskSuite 4.2" in Note su Solaris Easy Access Server 3.0 e "Conversione a Solstice DiskSuite 4.2" in Note su Solaris Easy Access Server 3.0 per le ultime informazioni legate alla documentazione SEAS.

La documentazione di SEAS

Tutta la documentazione di SEAS è contenuta nel CD della documentazione di SEAS, fatta eccezione per le Note sulla versione che sono disponibili in forma stampata. La maggior parte della documentazione è disponibile nel formato AnswerBook2, ma altre parti sono disponibili in formati diversi, tra cui HTML, guida in linea, file di testo, file PDF e PostScript\256. La documentazione può essere installata con Solaris Web Start o con il comando pkgadd.

La Tabella 4-1 elenca i manuali e le informazioni che compongono il set di documenti di SEAS.

Installazione del server Answerbook2

AnswerBook2 è il sistema di documentazione in linea di Sun Microsystems. Utilizza una interfaccia di tipo browser per visualizzare, stampare ed effettuare ricerche nella documentazione.

Per visualizzare la documentazione in linea di SEAS, è necessario avere accesso a un server di documenti Answerbook2. Il server di documenti AnswerBook2 permette la visualizzazione della documentazione Sun usando il proprio browser preferito. I documenti vengono convertiti in formato HTML 3.2 e inviati al browser per la visualizzazione; il server supporta anche il precedente formato di visualizzazione AnswerBook^TM. Il software del server AnswerBook2 è incluso nel CD della documentazione di SEAS e nel CD della documentazione di Solaris 7.

Per una visualizzazione occasionale delle collezioni di documenti di SEAS non è necessario installare il software del server di documenti AnswerBook2. È possibile infatti eseguire il server direttamente dal CD della documentazione di SEAS usando lo script ab2cd. Per informazioni più dettagliate su questa funzionalità, vedere il file README sul CD della documentazione di SEAS. Per eseguire questa procedura è necessario avere accesso come root al sistema a cui è collegato il CD.

Tuttavia, per fornire agli utenti l'accesso alla documentazione dei prodotti SEAS, è necessario installare il server di documenti AnswerBook2. Dopo aver installato il server SEAS, è necessario installare la documentazione su quel server. Per informazioni sull'installazione del software server e dei documenti inclusi nel CD della documentazione di SEAS, vedere il file README che si trova su quel CD. Per informazioni generali sull'utilizzo di AnswerBook2, vedere il modulo "Accesso alla documentazione in linea" nella Libreria di installazione di Solaris 7 (edizione per piattaforma SPARC) o nella Libreria di installazione di Solaris 7 (edizione per piattaforma Intel).

Se non si ha accesso a un server di documenti AnswerBook2 o non si desidera installarlo localmente, è possibile visualizzare tutta la documentazione pubblicata su Solaris al sito Web http://docs.sun.com.

Eseguire il server Answerbook2 dal CD Documentation di SEAS

L'esecuzione del server di documenti direttamente dal CD è lenta. Per questa ragione, si sconsiglia di usare questo metodo se si prevede che altri utenti debbano accedere alle collezioni di documenti SEAS.

1. Eseguire il login come root.

2. Spostarsi, dalla riga di comando o con la Gestione di file, nella directory che contiene lo script eseguibile ab2_cd.

3. Eseguire il comando ab2_cd.

4. Accedere al server di documenti usando il seguente URL: http://hostlocale:8888

   dove hostlocale è il nome del sistema a cui è collegato il CD.

5. Per arrestare l'esecuzione del server dal CD, eseguire il comando ab2_cd stop.

Installare il server di documenti AnswerBook2

1. Inserire il CD Documentation di SEAS nel lettore di CD-ROM.

2. Eseguire il login come root sul server di documenti e spostarsi nella directory che contiene i package di installazione.

3. Al prompt di sistema, avviare il Registro dei prodotti digitando:

   prodreg &

4. Fare clic su Installa nella parte inferiore della finestra Registro dei prodotti.

5. Individuare il programma di installazione di AnswerBook2 e fare clic su OK.

6. Seguire le indicazioni visualizzate.

Installare il server di documenti Answerbook2 con pkgadd

1. Inserire il CD Documentation di SEAS nel lettore di CD-ROM.

2. Eseguire il login come root nel server di documenti e spostarsi nella directory che contiene i package di installazione.

3. Digitare il comando:

   pkgadd nome_package

   Per installare i package del server in una directory diversa da quella predefinita, usare il comando pkgadd -d . -a none. In questo modo, l'utility pkgadd chiederà di inserire la directory in cui si desidera installare il software.

   SUNWab2r (0,02 Megabyte) viene installato nella partizione radice e contiene i file di configurazione e di avvio.

   SUNWab2s (0,21 Megabyte) contiene i file condivisi per l'elaborazione dei documenti.

   SUNWab2u (21,02 Megabyte) contiene i file eseguibili e i file di elaborazione back-end per il server e le funzioni di amministrazione.

4. Se necessario, avviare il server.

   L'installazione dei package dovrebbe far avviare il server sulla porta predefinita 8888. Se il server non si avvia, digitare il comando seguente:

   # /usr/lib/ab2/bin/ab2admin -o start

Installazione delle collezioni di SEAS

Per poter utilizzare il server di documenti AnswerBook2, è necessario installare le collezioni di documenti. Per ottenere un elenco delle collezioni di documenti di SEAS, vedere la Tabella 4-1.

Per installare le nuove collezioni di documenti sul server, usare l'utility pkgadd. Per aggiungere le collezioni di documenti di SEAS a un database AnswerBook esistente, usare la funzione Aggiungi collezione all'elenco o il comando ad2admin -o add_coll.

Se i package delle collezioni sono già installati sul server di documenti, è possibile usare la funzione Individua le collezioni installate localmente del server o il comando ab2admin -o scan per individuarli e aggiungerli automaticamente al database di documenti del server. Questa funzione può essere usata solo con i package installati localmente.

Per aggiungere al server le collezioni installate su altri server di documenti, usare la funzione Aggiungi collezione all'elenco o il comando ab2admin -o add_coll e specificare il percorso completo del file ab_cardcatalog o del file collinfo. Ad esempio, se il server di documenti è ab2docserver e si desidera che fornisca le collezioni di documenti di DiskSuite 4.2 al sistema bingo, è necessario utiizzare il seguente comando:

ab2admin -o add_coll -d /net/bingo/opt/answerbooks/english/DiskSuite_4.2/SUNWdsab

Registrazione di un server di documenti Answerbook2

Per offrire agli utenti la possibilità di individuare automaticamente il server di documenti mediante il servizio FNS (Federated Naming Services), è necessario registrare il server. Questa operazione includerà il sistema in un gruppo di server all'interno del sito e permetterà agli utenti di scegliere il server di documenti desiderato.

Registrare un server di documenti AnswerBook2

1. Digitare il comando seguente:

   # /usr/lib/ab2/bin/ab2regsvr url_server

   dove url_server è l'indirizzo pienamente qualificato del server.

   Ad esempio: ab2docserver.eng.sun.com:8888

Per maggiori informazioni sull'installazione del server AnswerBook2, vedere la Libreria di installazione di Solaris 7 (edizione per piattaforma SPARC).

Uso del server AnswerBook2

Se si utilizza l'ambiente operativo Solaris 2.6 o Solaris 7, è possibile avviare AnswerBook2 in uno dei seguenti modi.

• Dallo spazio di lavoro del CDE, facendo clic con il pulsante destro del mouse per aprire il menu dello spazio di lavoro e selezionando AnswerBook2 dal menu Programmi.

• Dal menu Programmi di Open Windows, con l'opzione AnswerBook2.

• Dalla riga di comando di UNIX, digitando answerbook2.

• Da un Web browser, inserendo il nome del server AnswerBook2 e il numero della porta, con la sintassi:

  http://server_documenti:porta.

  Ad esempio: http://ab2docserver:8888.