Readme

IBM WebSphere Commerce
Professional Edition
Business Edition
per software Solaris Operating Environment(TM)

Versione 5.4

Ultimo aggiornamento: 15 aprile 2002

Indice

• Contenuto del README
• Documentazione
• Installazione
• Gestore configurazione
• WebSphere Application Server
• Distribuzione del codice personalizzato
• Comandi
• Pubblicazione del negozio
• Catalog Manager e Loader

Contenuto del README

Questo documento contiene informazioni su alcuni problemi noti del prodotto. Eventuali aggiornamenti a questo file saranno pubblicati alla pagina WebSphere Commerce Business Edition Technical Library e alla pagina WebSphere Commerce Professional Edition Technical Library . Inoltre, è possibile consultare il database Technote alle pagine WebSphere Commerce Business Edition Support e WebSphere Commerce Professional Edition Support per altre informazioni generali o di supporto sul prodotto.

Documentazione

1. Le pagine WebSphere Commerce Business Edition Technical Library e WebSphere Commerce Professional Edition Technical Library contengono tutti gli aggiornamenti alla guida in linea e alla Guida all'installazione e alcune informazioni sul prodotto non incluse nel CD.
    
2. Se si utilizza la funzione di ricerca della guida in linea di WebSphere Commerce su una macchina configurata con le impostazioni regionali diverse da en_US, è possibile che si verifichino problemi, ad esempio i caratteri nazionali non vengono visualizzati correttamente oppure la ricerca non restituisce alcun risultato. L'aggiornamento di Java(TM) Runtime Environment può correggere questo problema. Per ottenere una versione più recente, andare al sito java.sun.com e ricercare Java 2 Runtime Environment. Dopo l'aggiornamento di Java Runtime Environment, è necessario chiudere tutte le finestre di Internet Explorer riavviando la guida in linea.
    

Installazione

1. Durante l'installazione, vengono visualizzati diversi messaggi di avviso. Per evitare ciò, prima di aggiungere il pacchetto docs di WebSphere Commerce, completare le seguenti operazioni:
   1. Fare clic sul menu Proprietà.
   2. Fare clic sul menu Gestione pacchetto
   3. L'opzione predefinita per File esistenti è "Chiedi". Cambiarla in "Sovrascrivi"
   4. Fare clic su OK
   5. Aggiungere il pacchetto docs.
      
      
2. Per le macchine che non allocano un sistema di file per /opt e /export/home, lo script wc54sunpreq.sh restituisce il seguente errore:
   
   SPAZIO DISPONIBILE SU DISCO RIGIDO IN BLOCCHI DA 1K:
   Nessuna directory /opt rilevata  FAIL
   Nessuna directory /export/home rilevata  FAIL
   
   Sono richiesti 5 GB di spazio libero tra /opt e /export/home.

Il messaggio di errore appare anche se si dispone di 5 GB di spazio libero. In questo caso, può essere tranquillamente ignorato.



3. Se si esegue lo script utilizzato per avviare Gestore configurazione, potrebbe essere restituito il messaggio di errore: "whoami not found". Assicurarsi che le seguenti due righe siano presenti nel file .profile sia root che wasuser:
   
   PATH=$PATH:/usr/ucb
   export PATH
   
   Eseguire nuovamente lo script per avviare Gestore configurazione.
   
   
4. Per avviare WAS (WebSphere Application Server) come utente non root, la directory /tmp deve avere autorizzazioni file impostate su 777 perché WAS scriverà in questa directory.
    
5. Durante l'esecuzione di wcpostinstall.sh, se si sceglie un ID utente esistente diverso da quello predefinito per eseguire WebSphere Application Server, la directory principale predefinita di quell'ID utente deve essere /export/home/IDutente. Se si sceglie di creare un nuovo ID, la directory principale per tale ID utente sarà creata dallo script.
    
6. WebSphere Commerce supporta i seguenti insiemi di codici:

   Lingua	Valore variabile LANG
   Tedesco	de_DE.ISO8859-1
   Inglese	en_US.ISO8859-1
   Spagnolo	es_ES.ISO8859-1
   Francese	fr_FR.ISO8859-1
   Italiano	it_IT.ISO8859-1
   Portoghese brasiliano	pt_BR.ISO8859-1
   Giapponese	ja_JP.eucJP
   Coreano	ko_KR.EUC
   Cinese semplificato	zh_CN.GBK
   Cinese tradizionale	zh_TW.BIG5

   Accertarsi che sulla macchina Solaris sia installato l'insieme di codici supportato per la propria locale. Per controllare gli insiemi di codici installati, immettere locale -a.
   Accertarsi che le variabili di ambiente per la locale (LANG, LC_ALL) siano impostate in modo da includere la locale WebSphere Commerce supportata. Per verificare, immettere locale, e controllare le variabili LANG e LC_ALL. Se la locale non è impostata sull'insieme di codici supportato, modificare le proprietà della locale immettendo i seguenti comandi come utente root:

   LANG=xx_XX.XXXX
   export LANG
   LC_ALL=xx_XX.XXXX
   export LC_ALL

   Ad esempio:
   LANG=en_US.ISO8859-1
   export LANG
   LC_ALL=en_US.ISO8559-1
   export LC_ALL

   È necessario assicurarsi che questi valori siano impostati correttamente come root prima di eseguire wcpostinstall.sh. Per la configurazione non-root, dopo aver eseguito wcpostinstall.sh, è necessario modificare il file /export/home/wasuser/.profile. Nel file .profile, il valore LANG deve essere impostato sull'insieme di codici supportato. Aggiungere l'estensione dell'insieme di codici. Ad esempio: da LANG=en_US a LANG=en_US.ISO8559-1.
    

7. Nel wizard di creazione istanze, il campo Directory home del responsabile database è obbligatorio. Se non è compilato, la creazione dell'istanza non riesce.
    
8. Lo script di verifica dei prerequisiti (wc54sunpreq.sh) non riesce a trovare la e-fix PQ57446 per WebSphere Application Server poiché è stata sostituita dalla e-fix PQ58443. Per verificare se questa e-fix è installata sul sistema, controllare product.xml per WebSphere Application Server. I programmi di installazione delle e-fix per WebSphere Application Server forniti dovrebbero installare correttamente le due e-fix sopra indicate; è possibile controllare il file di log wc54efixunix.log situato nella directory <WC>/logs o /tmp.

WebSphere Application Server 

1. Per la versione giapponese è richiesta la e-fix PQ57024 per WebSphere Application Server 4.0 FixPak2. Dopo aver applicato il FixPak, è necessario installare la e-fix PQ57024 fornita al fine di correggere i problemi con la traduzione giapponese. È possibile scaricare la e-fix dal seguente sito Web:
   
   Supporto di WebSphere Application Server
   
   Per dettagli circa il problema corretto dalla e-fix, controllare il file README fornito con la e-fix.
    
2. Se si sta installando WebSphere Application Server Advanced Single Server Edition su una macchina Sun Solaris, per evitare la visualizzazione di pagine corrotte, è necessario modificare la chiave GB2312 nel file converter.properties. Il file converter.properties risiede nella seguente directory: WebSphere/AppServer/properties. 

Distribuzione del codice personalizzato

Come parte della distribuzione sia di nuovi bean enterprise che di bean entità pubblici di WebSphere Commerce, è necessario creare un file XML che descriva ciascun bean di WebSphere Commerce Enterprise Application. Questo file viene creato mediante lo strumento XMLConfig con l'opzione "export".

Questo file XML non può contenere caratteri di ritorno a capo inclusi nella specifica del nome completo del server delle applicazioni per ciascun bean enterprise. Questo garantisce che i nomi completi dei server delle applicazioni nel file XML siano correttamente formattati (ovvero, non contengano ritorni a capo).

Questo metodo deve essere utilizzato dopo aver completato tutte le attività descritte nella guida per il programmatore di WebSphere Commerce di seguito elencate.

• "Esportazione delle informazioni di configurazione XML per l'applicazione di impresa" al Capitolo 9.
• "Esportazione delle informazioni di configurazione XML per l'applicazione di impresa" al Capitolo 10.
• "Esportazione delle informazioni di configurazione per i bean enterprise" nell'Appendice B.

Ciascuna delle attività sopra elencate utilizza il comando XMLConfig -export per creare un file XML che fornisca le informazioni di configurazione per i bean enterprise in un'applicazione di impresa. Questo file non è formattato correttamente. In particolare, il nome del server delle applicazioni è suddiviso su più righe. Se il file non viene riformattato in modo che il nome del server delle applicazioni appaia su un'unica riga, quando viene utilizzato come input del comando XMLConfig -import, viene restituito un errore indicante che non è possibile rilevare il server delle applicazioni.

Per formattare appropriatamente il file XML creato mediante il comando XMLConfig -export, procedere nel modo seguente:

1. Utilizzando un editor di testo, aprire il file FileOutput.xml, dove FileOutput è il nome del file creato mediante il comando XMLConfig -export.
2. Assicurarsi che nessun valore contenuto tra le tag <nome-completo-server-applicazioni> e </nome-completo-server-applicazioni> contenga ritorni a capo. Se un valore contiene un ritorno a capo, eliminarlo in modo che il nome del server delle applicazioni venga specificato su un'unica riga.
3. Salvare il file.
4. Continuare con le operazioni successive per distribuire il codice, come descritto nella Guida per il programmatore di WebSphere Commerce.

Comandi

Se l'oggetto proprietà di una risposta che reindirizza alla richiesta HTTP (per esempio, il reindirizzamento alla pagina JavaServer)  è più grande di 4KB, viene generato un errore. Per evitare questo errore, è necessario modificare l'oggetto proprietà di una risposta, prima di reindirizzarlo, affinché contenga meno di 4KB di dati. Un metodo per ridurre la dimensione dell'oggetto proprietà di una risposta potrebbe essere la rimozione di parametri non necessari nelle stringhe URL. Per ulteriori informazioni, fare riferimento a "Gestione di un URL di reindirizzamento a lunghezza limitata" nella Guida per il programmatore WebSphere Commerce.

Pubblicazione del negozio

La proprietà di sistema java di seguito riportata è richiesta per assicurare la corretta gestione degli errori quando la pubblicazione di un negozio non riesce.

Aggiungere questa proprietà alla console di gestione di WebSphere Application Server:

1. Aprire la Console di gestione di WebSphere Application Server.
2. Espandere Nodi.
3. Espandere proprio_nodo.
4. Espandere Server delle applicazioni
5. Fare clic su nome_istanza.
6. Fare clic su Impostazioni JVM e aggiungere la seguente riga:
   com.ibm.wcm.ErrorReporterDir = /opt/WebSphere/CommerceServer/temp/nome_istanza/tools/devtools
7. Fare clic su Applica, quindi riavviare l'istanza.

Catalog Manager e Loader

1. Non è possibile avviare la guida per Text Transformer e XSL Editor. Questi strumenti non avviano la guida e il messaggio di errore si riferisce ai file .hlp. La pagina Web relativa a Text Transformer è ubicata nel file opt/WebSphere/CommerceServer/web/doc/locale/f1_fs/fdpttt.htm. Per XSL Editor, fare riferimento al file fdpxtt.htm nella stessa directory.
    
2. È possibile che Loader non esegua il roll back dei record in un commit non riuscito. Se ciò si verifica, è possibile eliminare manualmente i record dal database. È anche possibile specificare l'opzione -method delete nel comando Load per eliminare i record dal database. Quando si utilizza questa opzione, il file di immissione per Loader deve contenere i record da eliminare. Per ulteriori informazioni, fare riferimento alla guida per l'utente di Catalog Manager.

Marchi

IBM      WebSphere   AIX

Java e tutti i marchi basati su Java sono marchi della Sun Microsystems, Inc. negli Stati Uniti e/o in altri paesi.

Windows e Windows NT sono marchi della Microsoft Corporation negli Stati Uniti e/o in altri paesi.

Altri nomi di prodotti, società o servizi potrebbero essere marchi o marchi di servizi di altre società.

**************************************************************************

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2002

** TUTTI I DIRITTI RISERVATI.

**************************************************************************

Fine del file README