File Leggimi di Microsoft BizTalk Server 2004 SP1

28 gennaio 2005

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

© 2005 Microsoft Corporation. Tutti i diritti riservati.

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

Microsoft® BizTalk® Server 2004, Service Pack 1. In questo file sono riportate informazioni importanti su questa versione di BizTalk Server 2004.

Esaminare il presente documento prima di installare BizTalk Server 2004, Service Pack 1.

Per avere la garanzia di leggere le informazioni più aggiornate, scaricare la versione più recente del file Leggimi di BizTalk Server 2004 SP1, dall'indirizzo http://go.microsoft.com/fwlink/?linkid=39416. Per un elenco dei miglioramenti apportati in BizTalk Server 2004, Service Pack 1, visitare il sito Web all'indirizzo http://go.microsoft.com/fwlink/?linkid=39415.

Per informazioni sui problemi noti correnti relativi a BizTalk Server 2004, vedere l'articolo 834624 della Knowledge Base disponibile all'indirizzo http://go.microsoft.com/fwlink/?LinkId=22784 (in inglese). Per informazioni sulla versione più recente della documentazione di BizTalk Server 2004, visitare il sito Web all'indirizzo http://go.microsoft.com/fwlink/?linkid=20616.

Nota  Il Service Pack 1 non include gli aggiornamenti di BizTalk Server 2004 SDK. Per scaricare l'aggiornamento più recente, visitare il sito Web all'indirizzo http://go.microsoft.com/fwlink/?LinkId=24723. Anche la documentazione relativa al backup dei database (invio del registro) è stata aggiornata. Per la documentazione più aggiornata sull'invio del registro, visitare il sito Web all'indirizzo http://go.microsoft.com/fwlink/?LinkId=38236.

Per garantire un livello di prestazioni soddisfacente, verificare che i computer nei quali si installa BizTalk Server 2004 soddisfino i requisiti hardware consigliati e che tutte le applicazioni software necessarie siano state installate nell'ordine corretto. Per informazioni sui requisiti hardware e software di BizTalk Server 2004, vedere la "Guida all'installazione di BizTalk Server 2004" all'indirizzo http://go.microsoft.com/fwlink/?LinkId=22120.

Il presente documento contiene le seguenti sezioni:

Prima di installare il Service Pack 1

Tenere presenti i seguenti requisiti:

Non è necessario ridistribuire le applicazioni distribuite prima dell'installazione di BizTalk Server 2004 SP1.

Requisiti software

È necessario installare il seguente software prima dell'installazione del Service Pack 1:

Installazione del Service Pack 1

I file per il Service Pack 1 sono contenuti in un singolo file eseguibile, BizTalk 2004 Service Pack 1 <lingua>.exe, ad esempio BizTalk 2004 Service Pack 1 ITA.exe. Facendo doppio clic sul file, viene estratto il file leggimi e un file eseguibile, BTS2004-SP1-<lingua>.exe, nella directory indicata nella finestra di dialogo. Quando si apre questo secondo file eseguibile, i file vengono estratti nella cartella corrente e il file Setup.exe viene eseguito automaticamente.

Nota  Utilizzare solo il programma Setup.exe per installare il prodotto. Non utilizzare i singoli file di Windows Installer.

Per informazioni sull'installazione invisibile, vedere Installazione invisibile.

Se si verifica un problema durante l'installazione e non viene visualizzato alcun messaggio di errore, esaminare il file di registro, Setup.log. Il percorso predefinito del file è C:\Documents and Settings\All Users\Dati applicazioni\Microsoft\E-Business Servers Updates\BTS2004\SP1\. Un collegamento a questo file viene visualizzato anche nell'ultima pagina dell'installazione guidata.

In determinate condizioni, può essere richiesto di riavviare il computer dopo l'installazione del SP1. È una procedura normale.

Nota   L'installazione del SP1 rimuove gli elenchi di controllo di accesso (ACL, Access Control List) personalizzati applicati a un file o una cartella come aggiornamento.

Nota  Il SP1 sovrascrive il processo Backup BizTalk Server.

Nota  Il SP1 installa Microsoft® Windows® Installer 3.0, se necessario.

Per installare il Service Pack 1

  1. Se si utilizza l'adattatore EDI, è necessario arrestarlo e consentire l'elaborazione dei messaggi rimanenti.
  2. Utilizzare lo script fornito di seguito nel presente file leggimi per interrompere i servizi BizTalk Server e disattivare gli indirizzi di ricezione; vedere Script per la disattivazione degli indirizzi di ricezione. Per eseguire lo script e disattivare gli indirizzi di ricezione, copiare il contenuto del codice in un file denominato enabledisableallrecloc.vbs e immettere il seguente testo da una riga di comando:
    cscript enabledisableallrecloc.vbs disable
  3. Nello snap-in Gestione computer, impostare il Tipo di avvio per i servizi BizTalk Server su Manuale. Eseguire questa procedura su tutti i computer appartenenti al gruppo o all'insieme di server.
  4. Eseguire Setup.exe su tutti i computer appartenenti al gruppo o all'insieme di server.

    Nota  È necessario che i servizi SQL Server siano in esecuzione durante l'installazione. In caso contrario, sarà necessario ripetere l'installazione.

  5. Riavviare i servizi BizTalk Server, modificare il Tipo di avvio ripristinando l'impostazione precedente e attivare gli indirizzi di ricezione.
  6. Per attivare tutti gli indirizzi di ricezione, immettere il seguente comando per eseguire lo script:
    cscript enabledisableallrecloc.vbs enable

    Importante    Non eseguire alcun riavvio nella farm finché il SP1 non è stato installato su tutti i computer.

Fare clic qui per lo script per disattivare o attivare gli indirizzi di ricezione

Aggiunta o rimozione di funzionalità oppure aggiornamento dopo l'installazione del SP1

È possibile aggiungere o rimuovere le funzionalità del prodotto senza la reinstallazione del SP1.

Se si desidera aggiornare l'edizione di BizTalk 2004 dopo l'installazione del SP1 (ad esempio, da Standard a Enterprise), è necessario disinstallare il SP1. Installare la nuova versione di BizTalk Server, quindi reinstallare il SP1.

Nota  È possibile eseguire l'aggiornamento da Partner a Standard, da Partner a Enterprise, da Standard a Enterprise e da Evaluation a Enterprise. Non è possibile eseguire l'aggiornamento da Developer a Partner, da Developer a Standard o da Developer a Enterprise. I downgrade non sono supportati.

Installazione invisibile all'utente

È possibile installare il Service Pack 1 eseguendo Setup.exe dalla riga di comando. L'installazione non elimina i file una volta terminata o se viene annullata l'installazione automatica. Iniziare copiando i file estratti in una cartella. È possibile controllare il comportamento dell'installazione tramite alcune opzioni della riga di comando.

L'installazione include le seguenti opzioni della riga di comando:

Opzioni della riga di comando Descrizione
/? Mostra l'utilizzo di questo comando.
/s Consente l'esecuzione in modalità invisibile all'utente.
/w Consente di non visualizzare le pagine della procedura guidata.
/u Disinstalla il Service Pack 1. Non viene visualizzato alcun messaggio di sistema o schermata di conferma.

Per utilizzare setup.exe dalla riga di comando per l'installazione del Service Pack 1

  1. Aprire una finestra Prompt dei comandi. Passare alla directory in cui sono stati copiati i file estratti.
  2. Al prompt dei comandi digitare Setup.exe /s, quindi premere Invio.
  3. L'installazione viene eseguita senza messaggi o schermate di conferma.

Disinstallazione del Service Pack 1

Prima di disinstallare il SP1, è necessario rimuovere la configurazione di tutte le funzionalità del prodotto configurate dopo l'installazione del SP1.

Inoltre, se si disinstalla il SP1, è necessario disinstallarlo su tutti i server appartenenti al gruppo o all'insieme Web. Interrompere tutti i servizi BizTalk Server prima di disinstallare il SP1.

Gli aggiornamenti applicati dopo il Service Pack 1 vengono mantenuti e non vengono rimossi se si disinstalla il SP1. È necessario reinstallare gli aggiornamenti che erano stati applicati prima di installare il Service Pack 1.

Per controllare i dettagli della disinstallazione, è possibile visualizzare il file di registro della disinstallazione, Microsoft BizTalk Server 2004 Service Pack - (SP1)_uninstall.log nella directory Temp dell'account a cui l'utente è connesso. Ad esempio, per un utente CurrentUser, questa directory è c:\Documents and Settings\Utente corrente\Impostazioni locali\Temp.

Per disinstallare il Service Pack 1

  1. Se si utilizza l'adattatore EDI, è necessario arrestarlo e consentire l'elaborazione dei messaggi rimanenti.
  2. Interrompere i servizi BizTalk Server e disattivare gli indirizzi di ricezione. Nello snap-in Gestione computer, impostare il Tipo di avvio per i servizi BizTalk Server su Manuale. Eseguire questa procedura su tutti i computer appartenenti al gruppo o all'insieme di server.
  3. Utilizzare Installazione applicazioni per disinstallare il Service Pack 1 su tutti i computer appartenenti al gruppo o all'insieme di server.

    Nota   È necessario che i servizi SQL Server siano in esecuzione durante la disinstallazione. In caso contrario, sarà necessario ripetere la disinstallazione.

  4. Riavviare i servizi BizTalk Server, modificare il Tipo di avvio ripristinando l'impostazione precedente e attivare gli indirizzi di ricezione.

    Importante    Non eseguire alcun riavvio nella farm finché il SP1 non è stato disinstallato su tutti i computer.

Per disinstallare BizTalk Server 2004 e il Service Pack 1

Novità del Service Pack 1

Microsoft® BizTalk® Server 2004, Service Pack 1 fornisce nuovi contatori delle prestazioni, consente di accelerare l'adapter FTP, aggiunge ulteriore gestione delle transazioni per i componenti pipeline, fornisce maggiori informazioni nei messaggi di errore di SQL Adapter e supporta l'utilizzo dei caratteri GB18030 (cinese semplificato).

In questa sezione:

Contatori di prestazioni

Il Service Pack 1 fornisce nuovi contatori di prestazioni aggiuntivi. Tutti i contatori sono di tipo lungo.

Contatore Commenti
Indirizzi di ricezione attivi Numero di indirizzi di ricezione attivati in questa istanza di host.

Questo conteggio potrebbe non corrispondere al numero di indirizzi nella console di amministrazione di BizTalk se BizTalk Server disattiva temporaneamente un indirizzo.

Thread di ricezione attivi Numero di thread del motore di messaggistica che elaborano messaggi ricevuti da adapter in questa istanza di host.

Questo conteggio mostra quanto è occupato il motore di messaggistica durante l'elaborazione della ricezione. Se il contatore è vicino al numero massimo di thread nel pool, il motore può iniziare ad accelerare.

Messaggi di invio attivi Numero di messaggi sottoposti all'elaborazione per l'invio nel motore di messaggistica. Questo contatore include messaggi sottoposti all'elaborazione della pipeline di trasmissione nonché i messaggi di risposta per adapter di ricezione.

Un valore elevato può indicare un carico pesante, a seconda della velocità e della capacità dell'adapter.

Thread di invio attivi Numero di thread del motore di messaggistica che elaborano messaggi da inviare agli adapter in questa istanza di host.

Poiché a un thread è possibile associare numerosi messaggi, il contatore non è una misura diretta del numero di messaggi.

Documenti inviati nuovamente Numero totale di documenti inviati nuovamente dagli adapter di trasmissione.
Batch di ricezione in sospeso Numero di batch ricevuti dal motore di messaggistica la cui elaborazione non è stata completata. Il conteggio include batch elaborati in modo asincrono dagli adapter di trasmissione.
Messaggi trasmessi in sospeso Numero di messaggi inviati dal motore di messaggistica agli adapter di trasmissione la cui elaborazione non è stata completata. Questo include messaggi di risposta per gli adapter di ricezione.

Il contatore consente di diagnosticare i sistemi che risultano bloccati durante l'invio. Se il valore del contatore è basso e il valore dei messaggi di invio attivi è alto, l'elaborazione della mappa o della pipeline risulta lenta. Se questo numero è all'incirca uguale ai messaggi di invio attivi, l'adapter correntemente riorganizza molti messaggi. Se il numero continua ad aumentare, è possibile che sia presente un problema nell'adapter.

Timeout richiesta/risposta Numero di messaggi di richiesta che non hanno ricevuto un messaggio di risposta entro il limite di tempo specificato dall'adapter.

Quando si utilizza HTTP o SOAP, indica il timeout dell'elaborazione del messaggio. Un valore elevato spesso indica un problema, ad esempio che il sistema è occupato, si è verificato un errore downstream, oppure non è arrivata la risposta a una richiesta iniziale.

Batch di ricezione accelerati Numero di batch bloccati alla ricezione dal motore di messaggistica a causa del carico elevato.

Se il valore del contatore è diverso da zero, significa che viene eseguito il backup del lavoro nella memoria. La latenza totale dell'elaborazione in ingresso aumenterà. Spesso, questo è importante per gli adapter SOAP e HTTP.

Per ulteriori informazioni sui contatori di prestazioni, vedere l'argomento relativo ai contatori di prestazioni nella Guida di BizTalk Server 2004.

Accelerazione FTP

È possibile accelerare l'adapter FTP creando o impostando la voce della chiave del Registro di sistema FtpMaxConcurrentConnections. Questa voce definisce il numero massimo di porte di invio che l'adapter può utilizzare su un server specificato. Per accelerare l'adapter FTP su più server, è necessario modificare la voce della chiave del Registro di sistema in ciascun server.

Se la chiave FtpMaxConcurrentConnections è assente o zero (0), l'adapter utilizza il valore predefinito pari a due (2).

Avviso  L'utilizzo errato dell'editor del Registro di sistema può causare problemi che richiedono la reinstallazione del sistema operativo. L'utente utilizza l'editor del Registro di sistema a proprio rischio.

Per accelerare l'adapter FTP in un server

  1. Scegliere Start quindi Esegui.
  2. Nella casella di testo Esegui digitare regedit.exe per avviare l'editor del Registro di sistema.
  3. Passare a [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTSSvcguid] dove guid è un GUID univoco in ciascuna installazione di BizTalk Server.
  4. Se FtpMaxConcurrentConnections non è presente, è necessario crearla: fare clic con il pulsante destro del mouse su BTSSvcguid, quindi scegliere Valore DWORD. Assegnare al nuovo valore il nome FtpMaxConcurrentConnections.
  5. Fare clic con il pulsante destro del mouse su FtpMaxConcurrentConnections nel riquadro di destra, selezionare Modifica, quindi digitare il nuovo valore nella finestra di dialogo Modifica valore DWORD. Scegliere OK.
  6. Chiudere l'editor del Registro di sistema.

Interfaccia IPipelineContextEx

L'interfaccia IPipelineContextEx estende IPipelineContext. Fornisce un metodo che consente a un componente pipeline ricevente di recuperare un oggetto transazione DTC dal motore BizTalk.

Interfaccia IPipelineContextEx

Per l'unico membro, vedere Metodo IPipelineContextEx.GetTransaction.

[Visual Basic]
<Guid("05AC2000-2ED5-41F0-A961-2838A1836A22")>
<InterfaceType(ComInterfaceType.InterfaceIsIUnknown)>
Public Interface IPipelineContextEx
[C#]
[Guid("05AC2000-2ED5-41F0-A961-2838A1836A22")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IPipelineContextEx
[C++]
[Guid("05AC2000-2ED5-41F0-A961-2838A1836A22")]
[InterfaceType(ComInterfaceType::InterfaceIsIUnknown)]
public __gc __interface IPipelineContextEx
[JScript]
public
   Guid("05AC2000-2ED5-41F0-A961-2838A1836A22")
   InterfaceType(ComInterfaceType.InterfaceIsIUnknown)
interface IPipelineContextEx

Spazio dei nomi: Microsoft.BizTalk.Component.Interop

Piattaforme: Windows 2000, Windows XP Professional, Windows Server 2003

Assembly: Microsoft.BizTalk.Pipeline.dll

Metodo IPipelineContextEx.GetTransaction

Restituisce un oggetto transazione DTC dal motore BizTalk.

[Visual Basic]
Function GetTransaction() As Object
[C#]
object GetTransaction();
[C++]
object* GetTransaction();
[JScript]
function GetTransaction() : object;

Per richiamare il metodo come membro di un'interfaccia COM utilizzare la seguente sintassi:

HRESULT GetTransaction([out, retval] IUnknown** ppVal);

GetTransaction restituisce un riferimento null se non vi è alcuna transazione.

Nota    Utilizzare GetTransaction solo in pipeline di ricezione. In un pipeline di invio, il metodo genera un'eccezione di oggetto aperto.

Durante l'esecuzione di pipeline di ricezione, se vi è una transazione nel motore BizTalk Server, nel contesto pipeline viene reso disponibile un puntatore alla transazione. Qualsiasi componente all'interno di un pipeline in qualsiasi fase del pipeline può richiedere una transazione.

Quando viene elaborato un batch di messaggi, il motore utilizza lo stesso oggetto transazione per tutti i componenti pipeline che elaborano il batch. Se per un batch non è disponibile alcuna transazione, la prima richiesta di un oggetto transazione avvia una nuova transazione. All'interno di un batch, tutte le successive richieste di una transazione ricevono lo stesso oggetto transazione.

Quando il motore BizTalk Server pubblica il messaggio o il batch in una finestra di messaggio, il motore vincola la transazione se ne è il creatore. Se la transazione è stata creata da un adapter, quest'ultimo ha la responsabilità di vincolarla.

Il codice seguente mostra come è possibile utilizzare GetTransaction in un pipeline di ricezione per recuperare la transazione dal motore BizTalk Server ed eseguire un aggiornamento all'interno di tale transazione. Il codice presuppone che la transazione venga creata e vincolata dal motore BizTalk Server.

public IBaseMessage Execute(IPipelineContext pc, IBaseMessage inMsg)
{
    string customerId;
    string companyName;

    //TODO: Add the code to read the customerId 
    //      and companyName from the input message inMsg

    IPipelineContextEx pcx = pc as IPipelineContextEx;

    if (pcx != null)
    {
        ITransaction trans = null;
        trans = (ITransaction)pcx.GetTransaction();

        if (trans != null)
        {
            SqlConnection nwindConn = 
                new SqlConnection(
                "Data Source=localhost;Integrated Security=SSPI;" +
                "Initial Catalog=Northwind;Enlist=false;");
            SqlCommand cmd = 
                new SqlCommand(
                "INSERT INTO Customers (CustomerID, CompanyName) " +
                "Values(@CustomerId, @CompanyName)", nwindConn);

            cmd.Parameters.Add("@CustomerId", SqlDbType.VarChar, 5).Value 
                = customerId;
            cmd.Parameters.Add("@CompanyName", SqlDbType.VarChar, 
                40).Value = companyName;

            nwindConn.Open();
            pc.ResourceTracker.AddResource(nwindConn);

            nwindConn.EnlistDistributedTransaction(trans);

            try
            {
                cmd.ExecuteNonQuery();
            }
            catch (SqlException e)
            {
                throw(e);
            }
        }
        else
            throw new
            ArgumentNullException("IPipelineContextEx:GetTransaction()");
    }

    return inMsg;
}

Messaggi di errore di SQL Adapter migliorati

I messaggi di errore di SQL Adapter ora forniscono maggiori informazioni. Per gestire i messaggi di errore più lunghi può essere necessario apportare alcune modifiche.

Utilizzo di caratteri GB18030

Nel Service Pack 1 è possibile utilizzare i caratteri GB18030 (cinese semplificato). L'utilizzo di questi caratteri richiede un programma di installazione di Microsoft® SQL Server™ personalizzato. Per ulteriori informazioni, vedere l'articolo della Knowledge Base, "Using GB18030 Characters in BizTalk Server 2004, Service Pack 1", disponibile all'indirizzo http://go.microsoft.com/fwlink/?linkid=39417 (in inglese).

Problemi noti

In questa sezione vengono descritti i problemi noti relativi a BizTalk Server 2004, Service Pack 1 nelle seguenti aree di prodotti:

Problemi di installazione

Azione personalizzata o di post-installazione non riuscita

Se l'installazione del SP1 termina con un messaggio di errore, ad esempio indicante che l'installazione è riuscita ma alcune azioni di post-installazione non sono riuscite, oppure che una delle azioni personalizzate è riuscita, è possibile che il servizio SQL Server non fosse disponibile durante l'installazione.

Controllare il file Setup.log per verificare la presenza di eventuali errori. I messaggi di errore in cui viene specificato che è impossibile risolvere il database o applicare patch a uno o più database BizTalk possono indicare che il servizio SQL Server non era disponibile.

La posizione predefinita di Setup.log è C:\Documents and Settings\All Users\Dati applicazioni\Microsoft\E-Business Servers Updates\BTS2004\SP1\. Un collegamento a questo file viene visualizzato anche nell'ultima pagina dell'installazione guidata.

Riavvio non riuscito dopo la richiesta

In alcuni casi, la selezione dell'opzione Riavvia al termine dell'installazione o della disinstallazione potrebbe non riavviare il computer. Riavviare il computer manualmente.

Problemi relativi agli adapter

Configurazione dell'adapter MSMQT (BizTalk Message Queuing, Accodamento messaggi di BizTalk)

Quando si configura MSMQT per l'utilizzo di più computer nello stesso gruppo BizTalk, è necessario prima configurare il servizio NLB (Network Load Balancing, Bilanciamento del carico di rete) per il bilanciamento del carico MSMQT. Utilizzare il nome del cluster NLB virtuale come nome del computer nella Configurazione guidata in tutti i computer.

Per ulteriori informazioni sul servizio NLB, vedere l'articolo 323437 della Knowledge Base, "How To Configure Network Load Balancing Parameters in Windows Server 2003", disponibile all'indirizzo http://go.microsoft.com/fwlink/?linkid=39509 (in inglese).

Come contattare il supporto tecnico

Per problemi tecnici sul Service Pack 1 non descritti nel presente documento o negli articoli della Microsoft Knowledge Base, Microsoft offre servizi di supporto tecnico.


Le informazioni contenute nel presente documento, compresi gli URL e gli altri riferimenti a siti Web Internet, sono soggette a modifica senza preavviso. Se non specificato diversamente, ogni riferimento a società, organizzazioni, prodotti, nomi di dominio, indirizzi di posta elettronica, loghi, persone, luoghi ed eventi utilizzati nelle riproduzioni delle schermate e negli esempi è puramente casuale e nessuna associazione a società, organizzazione, prodotto, nome di dominio, indirizzo di posta elettronica, logo, persona, luogo o evento reale è intenzionale o può essere presupposta. Il rispetto di tutte le leggi applicabili in materia di copyright è a esclusivo carico del cliente. Fermi restando tutti i diritti coperti da copyright, nessuna parte di questo documento potrà comunque essere riprodotta o inserita in un sistema di riproduzione o trasmessa in qualsiasi forma e con qualsiasi mezzo (in formato elettronico, meccanico, su fotocopia, come registrazione o altro) per qualsiasi scopo, senza il permesso scritto di Microsoft Corporation.

Microsoft può essere titolare di brevetti, domande di brevetto, marchi, copyright e altri diritti di proprietà intellettuale relativi all'oggetto del presente documento. Salvo quanto espressamente previsto in un contratto scritto di licenza Microsoft, la consegna del presente documento non implica la concessione di alcuna licenza su tali brevetti, marchi, copyright o altra proprietà intellettuale.

Microsoft, MS-DOS, BizTalk, Windows e Windows NT sono marchi o marchi registrati di Microsoft Corporation negli Stati Uniti e/o in altri paesi.

I nomi di società e di prodotti esistenti citati nel presente documento possono essere marchi dei rispettivi proprietari.