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.
- Accertarsi che sul computer sia installata un'applicazione
server. E' stato eseguito il test con Tomcat 3 e Tomcat 4.
- Scaricare il driver binario di run-time della piattaforma
relativa al livello della Versione 2.0 di Eclipse da www.eclipse.org.
- Installare (decomprimere) il driver in una directory d:\eclipse.
- 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.
- Installare le correzioni riportate di seguito, a seconda del server
che si sta utilizzando:
- Tomcat 3: Tomcat 3 non dispone di libreria parser XML
per un'applicazione Web. Per risolvere questo problema, copiare
xercesImpl.jar e xmlParserAPIs.jar da
d:\eclipse\plugins\org.apache.xerces_4.0.3\ in d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF\lib\
- Tomcat 4:
- Sia Eclipse sia Tomcat contengono il codice per impostare
un URLStreamHandler, tuttavia è possibile impostarlo una sola volta.
Per consentire il funzionamento corretto di Tomcat ed Eclipse, è necessario
aggiungere una libreria
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar
al percorso classi all'avvio di Tomcat. In Tomcat 4.0.3 modificare
il file tomcat/bin/setclasspath.bat quindi, dopo la riga:
imposta
CLASSPATH=%JAVA_HOME%\lib\tools.jar
inserire la riga:
imposta
CLASSPATH=%CLASSPATH%;d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar.
-
A causa dei cambiamenti nella libreria xml, rimuovere
tomcat\common\lib\xerces.jar, quindi modificare setclasspath.bat
sostituendo la riga
imposta
JAVA_OPTS=
con
imposta
JAVA_OPTS=-Xbootclasspath/a:d:\eclipse\plugins\org.apache.xerces_4.0.3\xercesImpl.jar;d:\eclipse\plugins\org.apaches.xerces_4.0.3\xmlParserAPIs.jar.
- Disabilitare i JSP precompilati:. A meno che non si
stia utilizzando Tomcat 4.0.x o si pensi di effettuare il trasferimento
dei file jasper jar, è necessario copiare anche
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\web.xml in
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF.
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\.