Installazione del sistema della guida come centro informazioni

E' possibile consentire agli utenti l'accesso al sistema della Guida su Internet o Intranet mediante l'installazione del sistema della Guida automomo e dei plug-in di documentazione su un server Web. L'applicazione ha accesso alla documentazione richiamando un URL, quindi il sistema della Guida viene visualizzato nel browser Web. Il sistema della Guida come centro informazioni può essere utilizzato sia per le applicazioni client, sia per le applicazioni Web, per entrambe le quali è possibile avere un accesso remoto della Guida. Sono supportate tutte le funzioni, eccetto infopop e Guida attiva.

Installazione/compressione

Questa procedura è destinata all'esperto di integrazione del sistema della Guida e agli amministratori Web e non prevede di ricoprire tutti i possibili scenari. Si presuppone che tutta la documentazione venga recapitata come plug-in di Eclipse e che, generalmente, si abbia familiarità con il sistema della Guida di Eclipse. Si presuppone inoltre che gli utenti finali abbiano installato IE5.x o 6.x oppure Mozilla.
  1. Accertarsi che sul computer sia installata un'applicazione server.  E' stato eseguito il test con Tomcat 3 e Tomcat 4.
  2. Scaricare il driver binario di run-time della piattaforma relativa al livello della Versione 2.0 di Eclipse da www.eclipse.org.
  3. Installare (decomprimere) il driver in una directory d:\eclipse.
  4. Registrare l'applicazione della Guida di Eclipse presente in d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0 col server Web. Non copiare questa directory da altre parti; è necessario che rimanga nella struttura di installazione di Eclipse.

    In Tomcat è possibile effettuare questa registrazione aggiungendo le righe riportate di seguito al file tomcat\conf\server.xml:

    <Context path="/help"  docBase="d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0">
    </Context>

    Se si utilizza Tomcat 3 aggiungere tali righe in prossimità della fine del file, come ultimo elemento all'interno della sezione ContextManager.  Se si utilizza Tomcat 4, aggiungere questa sezione come ultimo elemento all'interno della sezione Host.

  5. Installare le correzioni riportate di seguito, a seconda del server che si sta utilizzando:

Utilizzo del centro informazioni

Avviare il server Web. Scegliere un browser Web per il percorso dell'applicazione Web.  Sul computer in cui è installato Tomcat dovrebbe essere http://localhost:8080/help/.

Installazione della documentazione personalizzata

La piattaforma Eclipse dispone della relativa documentazione, contenuta nel plug-in org.eclipse.platform.doc.user.  Questa sarà disponibile nel centro informazioni per impostazione predefinita. Per poter visualizzare la propria documentazione, comprimere la documentazione come i plug-in di documentazione di Eclipse.  Installarli su d:\eclipse\plugins\. 

Copyright IBM Corp.
e altri 2000, 2002.