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:
Tenere presenti i seguenti requisiti:
Non è necessario ridistribuire le applicazioni distribuite prima dell'installazione di BizTalk Server 2004 SP1.
È necessario installare il seguente software prima dell'installazione del Service Pack 1:
Per ulteriori informazioni sull'aggiornamento BizTalk Server 2004 SP1 per .NET Framework 1.1, vedere l'articolo 890673 della Knowledge Base, disponibile all'indirizzo http://go.microsoft.com/fwlink/?linkid=39454 (in inglese).
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
cscript enabledisableallrecloc.vbs disable
Nota È necessario che i servizi SQL Server siano in esecuzione durante l'installazione. In caso contrario, sarà necessario ripetere l'installazione.
cscript enabledisableallrecloc.vbs enable
Importante Non eseguire alcun riavvio nella farm finché il SP1 non è stato installato su tutti i computer.
Per disattivare o attivare gli indirizzi di ricezione prima dell'installazione è possibile utilizzare il seguente script:
'------------------------------------------------------------------------- ' ' WMI script to enable/disable the receive locations ' '------------------------------------------------------------------------- ' This file is part of the Microsoft BizTalk Server 2004 SDK ' ' Copyright (c) Microsoft Corporation. All rights reserved. ' ' This source code is intended only as a supplement to Microsoft BizTalk ' Server 2004 release and/or on-line documentation. See these other ' materials for detailed information regarding Microsoft code samples. ' ' THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY ' KIND, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE ' IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR ' PURPOSE. '------------------------------------------------------------------------- Option Explicit EnumRecLocs Sub EnumRecLocs() 'error handling is done by explicity checking the err object rather 'than using the VB ON ERROR construct, so set to resume next on error. On Error Resume Next 'Get the command line arguments entered for the script Dim objArgs: Set objArgs = WScript.Arguments 'Make sure the expected number of arguments were provided 'on the command line. 'if not, print usage text and exit. If (objArgs.Count < 1) Or (objArgs.Count >1) Then PrintUsage() WScript.Quit 0 End If dim sEnable:set sEnable = "FALSE" If (objArgs(0) = "enable") then sEnable = "TRUE" elseif (objArgs(0) = "disable" ) then sEnable = "FALSE" else PrintUsage() WScript.Quit 0 end if on error resume next Dim InstSet, Inst set InstSet = GetObject ("winmgmts:\root\MicrosoftBizTalkServer").InstancesOf("MSBTS_ReceiveLocation") 'Check for error condition before continuing. If Err <> 0 Then PrintWMIErrorThenExit Err.Description, Err.Number End If
'Report on number of receive locations found and list each one. wscript.echo "A Total of " & InstSet.Count & " Receive Locations were found." If InstSet.Count > 0 Then For Each Inst In InstSet wscript.echo if ( sEnable = "TRUE" ) then wscript.echo "Enabling Receive Location: " & Inst.Name else wscript.echo "disabling Receive Location: " & Inst.Name end if wscript.echo " Receive Port Name : " & Inst.ReceivePortName EnableReceiveLocation Inst.ReceivePortName, Inst.Name ,sEnable wscript.echo next End If End Sub Sub EnableReceiveLocation(strReceivePortName, strReceiveLocationName, sEnable) 'error handling is done by explicity checking the err object rather than using 'the VB ON ERROR construct, so set to resume next on error. On Error Resume Next Dim objInstSet, objInst, strQuery 'set up a WMI query to acquire a list of receive locations with the given Name and 'ReceivePortName key values. This should be a list of zero or one Receive Locations. strQuery = "SELECT * FROM MSBTS_ReceiveLocation WHERE ReceivePortName =""" & strReceivePortName & """AND Name =""" & strReceiveLocationName & """" Set objInstSet = GetObject("Winmgmts:!root\MicrosoftBizTalkServer").ExecQuery(strQuery) 'Check for error condition before continuing. If Err <> 0 Then PrintWMIErrorThenExit Err.Description, Err.Number End If 'If Receive Location found, enable it, otherwise print error and end. If objInstSet.Count > 0 then For Each objInst in objInstSet 'Now enable /disable receive location if sEnable= "TRUE" then objInst.Enable else objInst.Disable end if If Err <> 0 Then PrintWMIErrorThenExit Err.Description, Err.Number End If if sEnable = "TRUE" then WScript.Echo "The Receive Location was successfully enabled" else WScript.Echo "The Receive Location was successfully disabled" end if Next Else WScript.Echo "No Receive Location was found matching that Name." End If End Sub 'This subroutine deals with all errors using the WbemScripting object. Error descriptions 'are returned to the user by printing to the console. Sub PrintWMIErrorThenExit(strErrDesc, ErrNum) On Error Resume Next Dim objWMIError : Set objWMIError = CreateObject("WbemScripting.SwbemLastError") If ( TypeName(objWMIError) = "Empty" ) Then wscript.echo strErrDesc & " (HRESULT: " & Hex(ErrNum) & ")." Else wscript.echo objWMIError.Description & "(HRESULT: " & Hex(ErrNum) & ")." Set objWMIError = nothing End If 'bail out wscript.quit 0 End Sub Sub PrintUsage() WScript.Echo "Usage:" + Chr(10) + Chr(10) + _ "cscript enabledisableallrecloc [enable/disable]" + _ Chr(10) + " Example to enable all receive locations: enabledisableallreclo enable "+ Chr(10) + Chr(10) End Sub
È 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.
È 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
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
Nota È necessario che i servizi SQL Server siano in esecuzione durante la disinstallazione. In caso contrario, sarà necessario ripetere la disinstallazione.
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
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:
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.
È 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
L'interfaccia IPipelineContextEx estende IPipelineContext. Fornisce un metodo che consente a un componente pipeline ricevente di recuperare un oggetto transazione DTC dal motore BizTalk.
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
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; }
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.
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).
In questa sezione vengono descritti i problemi noti relativi a BizTalk Server 2004, Service Pack 1 nelle seguenti aree di prodotti:
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.
In alcuni casi, la selezione dell'opzione Riavvia al termine dell'installazione o della disinstallazione potrebbe non riavviare il computer. Riavviare il computer manualmente.
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).
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.