E' possibile utilizzare le informazioni WebSphere ESB
non in linea (senza che sia necessario collegarsi ad Internet) utilizzando localmente un
information center basato su Eclipse con plug-in della documentazione
WebSphere ESB. Alternativamente, è possibile utilizzare Adobe Acrobat Reader con i documenti PDF di WebSphere ESB.
Informazioni preliminari
I documenti PDF ed i plug-in della documentazione WebSphere ESB
sono forniti sul Web. Pertanto, per poter effettuare il download di questi file,
è necessario accedere temporaneamente ad Internet. Dopo il download dei
file desiderati, si può utilizzare la documentazione senza
essere collegati ad Internet.
Perché e quando eseguire questa attività
Se si desidera utilizzare le informazioni
WebSphere ESB non in linea
(senza che sia necessario accedere al Web), effettuare il download dei plug-in della documentazione
WebSphere ESB
per un utilizzo in un information center locale oppure effettuare il download dei documenti PDF di
WebSphere ESB per un utilizzo con una copia locale di Adobe Acrobat Reader.
Questo argomento
descrive come utilizzare l'IBM Eclipse Help System fornito con WebSphere ESB.
Altrimenti, è possibile utilizzare i plug-in della documentazione WebSphere ESB
in un altro information center basato su Eclipse, ad esempio per integrare le informazioni
presenti nel proprio information center esistente.
Se si desidera utilizzare
i documenti PDF di WebSphere ESB,
consultare Documenti PDF relativi a WebSphere ESB.
Passi per questa attività
- Installare l'IBM Eclipse Help System.
Per ulteriori informazioni
sull'installazione dell'IBM Eclipse Help System, consultare il file readme fornito
con il pacchetto di installazione nella directory IEHS sul
CD2.
Per installare l'IBM Eclipse Help System, completare le seguenti
operazioni secondarie:
- Inserire il CD2 nell'unità.
- Estrarre il contenuto del pacchetto di installazione sul proprio sistema,
mantenendo la struttura della directory. Ad esempio; su Windows, utilizzare
il seguente comando per estrarre il sistema della guida nella directory C:\ibm_help:
unzip IBM-Help-Win32.zip -d C:\
La directory iehs_install\ibm_help
contiene l'IBM Eclipse Help System e il relativo JRE incorporato, dove iehs_install fa riferimento
alla directory su cui è stato estratto il contenuto del pacchetto di installazione del sistema
della guida.
- Effettuare il download dei plug-in della documentazione del prodotto.
I plug-in della documentazione WebSphere ESB sono disponibili
come un file ZIP dalla pagina web http://www.ibm.com/software/integration/wsesb/library/infocenter/.
- Effettuare il download del file ZIP della documentazione su un'ubicazione appropriata. In base alla velocità della connessione, il download del file può richiedere
più di 20 minuti.
- Estrarre il contenuto del file ZIP nella directory iehs_install\ibm_help\eclipse\plugins,
mantenendo la struttura della directory.
Nella directory iehs_install\ibm_help\eclipse\plugins,
dovrebbero essere visualizzate alcune directory di plug-in per la documentazione del prodotto,
che includono quanto segue:- com.ibm.websphere.wesb.doc_6.0.1
- Plug-in principale della documentazione
WebSphere ESB. Questo plug-in dovrebbe determinare la comparsa
della voce WebSphere ESB
nella navigazione del sistema della guida.
- com.ibm.websphere.nd.doc_6.0.2
- Il plug-in della documentazione per WebSphere Application Server Network Deployment,
che viene sviluppato su WebSphere ESB.
- com.ibm.websphere.wscc.doc
- Il plug-in della documentazione per IBM Web Services Client for C++.
- com.ibm.websphere.xms.doc
- IBM Message Service Client for C/C++ e Message Service Client for .NET
Se non si visualizzano queste directory, verificare di aver
estratto il contenuto del file ZIP in maniera corretta.
- Avviare l'IBM Eclipse Help System
E' possibile avviare
l'IBM Eclipse Help System eseguendo i file di script nella directory iehs_install\ibm_help.
I file
di script forniti con il sistema della guida utilizzano il JRE incorporato per lanciare
il sistema della guida. Se non si desidera utilizzare il JRE incorporato, è necessario installare un
JRE versione 1.4.2 o superiore, quindi, modificare ed arrestare gli script per utilizzare
tale JRE.
E' possibile avviare l'IBM Eclipse Help System con una delle seguenti
modalità:
- Modalità autonoma
- Quando si utilizza la modalità autonoma, l'IBM Eclipse Help System avvia automaticamente
un browser web per visualizzare il contenuto della guida. Quando è in esecuzione in modalità autonoma,
il contenuto della guida è disponibile solo per gli utenti su quel sistema. I menu ed il contenuto
della guida vengono visualizzati nelle impostazioni internazionali del sistema.
- Modalità information center
- Quando viene utilizzata la modalità information center, l'IBM Eclipse Help System avvia
un'applicazione web sulla porta definita dall'utente (la porta predefinita è 8888) e
rende il contenuto della guida disponibile a qualsiasi browser web con connettività di rete
su quel sistema. I menu e le pagine della guida vengono visualizzati nelle impostazioni internazionali del browser web dell'utente.
Script di esempio vengono forniti per avviare ed arrestare il sistema della guida
in ogni modalità. Dopo essere stato avviato, l'IBM Eclipse Help System continua a rimanere in esecuzione
anche dopo la chiusura di tutti i browser web attivi. E' necessario arrestare esplicitamente
l'IBM Eclipse Help System con lo script di arresto appropriato.
E' possibile
personalizzare i file di script con opzioni relative ad esigenze specifiche. Per ulteriori
informazioni sulle opzioni disponibili, consultare il file readme del sistema della guida.
Opzione |
Descrizione |
Modalità autonoma |
Da iehs_install\ibm_help,
eseguire il file IC_start.bat o IC_start.sh. Viene visualizzata la finestra della riga
comandi per il sistema della guida. Per visualizzare il contenuto della guida, aprire un browser web, quindi
immettere l'URL http://servername:port/help,
dove servername è il nome host o l'indirizzo IP del sistema
su cui è installato IBM Eclipse Help System.
|
Modalità information center |
- Da iehs_install\ibm_help,
eseguire il file help_start.bat o help_start.sh. Viene visualizzata la finestra della riga
comandi per il sistema della guida.
- Se il browser predefinito è stato impostato nel sistema operativo, il sistema della guida
apre automaticamente un browser web con il contenuto della guida.
|
- Verificare che la documentazione del prodotto visualizzata corrisponda a quanto previsto.
Se il file ZIP della documentazione è stato estratto correttamente, ma il sistema della guida
non viene ancora visualizzato nella lingua nazionale prevista o non visualizza gli argomenti corretti
della guida, è possibile effettuare una serie di
verifiche. Ad esempio, aggiungere osgi.checkConfiguration=true al
file di configurazione iehs_install\ibm_help\configuration\config.ini. Questa impostazione determina l'individuazione
e la configurazione di nuovi pacchetti di lingua nazionale da parte del sistema.
Per ulteriori dettagli sulla
risoluzione dei problemi con l'IBM Eclipse Help System, consultare il file readme fornito con il pacchetto
di installazione.
Operazioni successive
E' possibile effettuare il download di plug-in aggiuntivi della documentazione da IBM o da altri fornitori
ed utilizzarli nello stesso sistema della guida per creare un nuovo information center più
completo.