Come installare un'applicazione BizTalk

Articolo
07/21/2023

In questo argomento viene descritto come installare un'applicazione nel computer locale facendo doppio clic sul file dell'applicazione di Windows Installer con estensione msi contenuto nell'interfaccia di Windows oppure digitando msiexec nella riga di comando. È anche possibile avviare l'Installazione guidata come ultimo passaggio dell'Importazione guidata, come descritto in Come importare un'applicazione BizTalk.

Attenzione

Se l'applicazione è già stata installata sul computer in uso, viene offerta la possibilità di ripristinarla. Il ripristino è supportato soltanto se per l'applicazione è stato installato un solo file con estensione msi. In caso contrario, è consigliabile non selezionare questa opzione. Infatti, se in questo caso si seleziona l'opzione Ripristina, tutte le modifiche apportate dai file con estensione msi installati successivamente al primo vengono annullate, il che può portare a un funzionamento errato dell'applicazione.

Prima di poter attivare un'applicazione è necessario installarla nei computer BizTalk Server in cui verrà eseguita. Quando si installa un'applicazione le risorse ad essa associate vengono memorizzate nel file system locale. A seconda del tipo, del contenuto e della configurazione dell'applicazione, l'installazione può implicare l'esecuzione delle attività elencate di seguito:

Aggiunta di assembly alla Global Assembly Cache (GAC)
Installazione di certificati e directory virtuali
Aggiunta di componenti al Registro di sistema di Windows
Esecuzione di script di preelaborazione o postelaborazione, se presenti nel file con estensione msi

Per informazioni in background, vedere Informazioni sugli artefatti durante l'installazione e la disinstallazione.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario accedere con un account che dispone delle autorizzazioni di scrittura sul file system locale. A seconda degli elementi inclusi nell'applicazione è possibile che sia necessario disporre delle autorizzazioni in scrittura anche per il Registro di sistema di Windows, la GAC, l'archivio certificati e il servizio Internet Information Services. L'account Amministratori del computer locale dispone di tali autorizzazioni. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Considerazioni per l'installazione di un'applicazione

Per l'installazione di un'applicazione è possibile applicare le considerazioni riportate di seguito:

Occorre installare anche le altre applicazioni da cui dipende l'applicazione da installare. Quando si installa un'applicazione che dipende da un elemento, quale ad esempio un assembly di BizTalk, incluso in un'altra applicazione, è necessario installare anche l'applicazione contenente tale elemento. Questa operazione è necessaria per poter far funzionare l'applicazione. Ad esempio, se Application A dipende da un assembly in Application B, è necessario installare anche Application B. È quindi possibile installare Application A. Per informazioni in background, vedere Dipendenze e distribuzione di applicazioni.
È consigliabile arrestare le applicazioni prima di eseguirne l'aggiornamento. Se l'installazione viene eseguita per aggiornare un elemento dell'applicazione, non occorre arrestare l'applicazione a meno che l'aggiornamento includa uno o più assembly la cui versione corrisponde a quella degli assembly esistenti. In questo caso, occorre arrestare l'applicazione prima di installare l'aggiornamento. Tuttavia, è consigliabile arrestare l'applicazione in ogni caso tranne se si è sicuri che l'aggiornamento non interferirà con l'applicazione durante l'esecuzione. Per altre informazioni, vedere Aggiornamento delle applicazioni BizTalk.
Quando per la stessa applicazione si installano più file con estensione msi, in Installazione applicazioni viene creata una sola voce. Questo può ad esempio accadere quando si aggiorna un'applicazione esistente. È quindi possibile utilizzare Installazione applicazioni nel Pannello di controllo per disinstallare completamente l'applicazione, compresi tutti gli elementi aggiornati. Si noti che la disinstallazione di un'applicazione tramite doppio clic sul file con estensione msi o mediante il comando msiexec non è supportata. Per altre informazioni, vedere Come disinstallare un'applicazione BizTalk.
Affinché un'applicazione possa funzionare è necessario che su tutti i computer che ospitano porte di trasmissione siano presenti dei certificati. I certificati utilizzati dalle porte di trasmissione sono contenuti nell'archivio dei certificati di altri utenti.
Per eseguire l'installazione dell'applicazione è possibile suddividerne gli elementi in più file con estensione msi. Non è necessario installare tutti gli elementi dell'applicazione su ogni computer in cui questa verrà eseguita. È invece possibile esportare dei sottoinsiemi di elementi dell'applicazione in più file con estensione msi da installare su più computer. Per istruzioni, vedere Come esportare un'applicazione BizTalk.
Se il file con estensione msi dell'applicazione contiene una directory virtuale, è necessario che il servizio Internet Information Services (IIS) sia in esecuzione sul computer locale. In caso contrario, l'installazione avrà esito negativo.
Se l'applicazione contiene una directory virtuale avente lo stesso nome di una directory virtuale già esistente sul computer locale, le risorse dell'applicazione vengono aggiunte ad essa. In caso contrario, la directory virtuale viene creata. Tutti i file esistenti il cui nome corrisponde a quello dei file aggiunti verranno sovrascritti. Inoltre, nel caso di directory virtuale già esistente, le relative impostazioni di sicurezza non vengono modificate ed è consigliabile verificare che forniscano un livello di protezione adeguato.
Prima di installare un'applicazione, creare dei pool di applicazioni per le directory virtuali. Se l'applicazione in uso comprende una directory virtuale e se in IIS non esiste già il pool di applicazioni, è opportuno crearlo manualmente prima di eseguire l'installazione. In questo modo durante l'installazione la directory virtuale verrà associata al pool di applicazioni. Se non si crea l'applicazione, durante l'installazione la directory virtuale verrà associata al pool di applicazioni predefinito.
Assicurarsi che BTSHttpReceive.dll sia registrata in Internet Information Services (IIS) 7.0 come Mapping gestore. Se l'applicazione in uso comprende una directory virtuale, questa operazione è necessaria per garantire il funzionamento dell'indirizzo di ricezione HTTP.
Quando in un computer a 32 bit si installa un'applicazione che comprende elementi a 64 bit è possibile che si verifichino dei problemi. Per altre informazioni, vedere Come aggiungere un artefatto a 64 bit a un'applicazione.
Se la lunghezza della directory di destinazione supera i 260 caratteri è possibile che si verifichino dei problemi. Se il numero di caratteri della directory di destinazione specificato durante l'installazione di un pacchetto MSI supera i 260 caratteri, l'installazione avrà esito negativo. Per risolvere questo problema, assicurarsi che il numero di caratteri specificato per la directory di destinazione non superi i 260 caratteri.
È consigliabile evitare di spostare le cartelle di installazione. Dopo aver installato un'applicazione è opportuno evitare di spostare la cartella di installazione o i file in essa contenuti. In caso contrario, se in seguito si tenta di rimuovere (ovvero disinstallare) l'applicazione, è possibile che tale operazione abbia esito negativo. In particolare, nella cartella di installazione dell'applicazione sono contenuti i file generati da BizTalk Server necessari all'esecuzione della rimozione. È opportuno non ridenominare, spostare o rimuovere questi file. I file sono:
- ApplicationDefinition.adf
- Microsoft.BizTalk.CustomInstaller.dll
- Microsoft.BizTalk.CustomInstaller.InstallState

Nota

Se si annulla l'operazione di installazione prima del completamento, BizTalk Server eseguirà il rollback dell'installazione, ad eccezione di eventuali azioni eseguite da script di pre-elaborazione o post-elaborazione prima dell'annullamento dell'operazione.

Importante

Prima di installare qualsiasi applicazione, assicurarsi che il file con estensione msi provenga da una fonte considerata attendibile. Un utente malintenzionato, infatti, può inserire in un file con estensione msi degli elementi di codice in grado di provocare effetti indesiderati sul sistema o sulla rete in uso. Per altre informazioni, vedere Sicurezza e Windows Installer.

Se l'applicazione comprende un sito Web o un'orchestrazione che utilizza un servizio Web, si tenga presente che le impostazioni di sicurezza riguardanti la directory virtuale corrispondono a quelle attivate quando il file con estensione msi viene generato durante l'esportazione dell'applicazione. Se già esiste una directory virtuale, vengono invece utilizzate le impostazioni esistenti. Dopo aver installato l'applicazione è opportuno verificare che tali impostazioni soddisfino i requisiti di sicurezza desiderati.

Tutti gli elenchi di controllo di accessodiscretionary (DACLs) vengono rimossi dai file e dalle cartelle quando un'applicazione viene esportata. Dopo aver installato un'applicazione su un'istanza di host occorre riconfigurare tutte le impostazioni di sicurezza riguardanti file e cartelle, comprese le directory virtuali.

Potrebbe essere necessario modificare la designazione Percorso locale: di una directory virtuale a cui viene fatto riferimento da un indirizzo di ricezione HTTP dopo la creazione nel computer di destinazione.

Quando la directory virtuale viene creata nel computer di destinazione, punterà a una delle directory fisiche seguenti:

<unità> di installazione\Programmi\Microsoft BizTalk Server\HttpReceive

- o –

<unità> di installazione\Programmi (x86)\Microsoft BizTalk Server\HttpReceive

Se l'estensione ISAPI di ricezione HTTP BTSHTTPReceive.dll di BizTalk non si trova nella directory specificata o se nel computer di destinazione viene eseguito un sistema operativo a 64 bit, è necessario modificare la designazione Percorso locale: della directory virtuale in modo che faccia riferimento alla directory fisica che contiene il file dell'estensione ISAPI di ricezione HTTP di BizTalk. Ad esempio, se il computer di destinazione esegue la versione a 64 bit di Windows Vista, il percorso locale: la designazione della directory virtuale deve essere modificata nell'unità <>di installazione\Programmi (x86)\Microsoft BizTalk Server\HttpReceive64.

Per installare un'applicazione BizTalk

Tramite l'interfaccia di Windows

Copiare nel computer locale il file con estensione msi dell'applicazione.
Se si reinstalla o si aggiorna un'applicazione BizTalk esistente e la nuova installazione include un assembly con la stessa versione di quella già esistente nell'applicazione oppure interagisce con un artefatto che si sta aggiornando, assicurarsi che l'applicazione venga arrestata facendo clic con il pulsante destro del mouse sulla cartella dell'applicazione e quindi facendo clic su Arresta.
In Esplora risorse, fare doppio clic sul file con estensione msi per avviare l'installazione guidata.
Nella pagina Seleziona cartella di installazione digitare il percorso di installazione completo per l'applicazione BizTalk. Esempio: C:\Programmi\Generated by BizTalk\MyApplication.
Fare clic su Avanti quattro volte e quindi nella pagina Completamento installazione fare clic su Chiudi.
Se si prevede di eseguire l'applicazione in più computer, ripetere i passaggi precedenti su ciascun computer.

Dopo aver installato l'applicazione in tutti i computer che lo eseguiranno e l'applicazione è stata importata nel gruppo BizTalk, è possibile avviare l'applicazione dalla console di amministrazione BizTalk Server facendo clic con il pulsante destro del mouse sulla cartella dell'applicazione e facendo clic su Avvia. Per istruzioni complete, vedere Come avviare e arrestare un'applicazione BizTalk.

Uso della riga di comando

Copiare nel computer locale il file con estensione msi dell'applicazione.
Fare clic su Start, scegliere Esegui, digitare cmde quindi premere INVIO.
Passare al percorso in cui è memorizzato il file con estensione msi.

Per installare l'applicazione, digitare il comando riportato di seguito, fornendo i parametri e i valori appropriati, come descritto nella tabella seguente:

Importante

Per quanto concerne il comando msiexec, sono supportati soltanto i parametri riportati nella seguente tabella.

msiexec [/i] Package [/qn] TARGETDIR="value"]

Esempio: msiexec /i MyApplication.msi

Parametro	Valore
/Ho	Consente di installare l'applicazione.
Pacchetto	Nome del file con estensione msi di Windows Installer.
/qn	Consente di eseguire l'installazione senza visualizzare un'interfaccia utente.
TARGETDIR="value"	Indica la cartella di installazione dell'applicazione. Questo valore viene anche impostato nella variabile di ambiente %BTAD_InstallDir%. Esempio: TARGETDIR="C:\Programmi\BizTalk Applications\My Application"

Se si prevede di eseguire l'applicazione in più computer, ripetere i passaggi precedenti su ciascun computer.

Dopo aver installato l'applicazione in tutti i computer che lo eseguiranno, è possibile avviare l'applicazione dalla console di amministrazione di BizTalk Server facendo clic con il pulsante destro del mouse sulla cartella dell'applicazione e scegliendo Avvia. Per istruzioni complete, vedere Come avviare e arrestare un'applicazione BizTalk.

Vedere anche

Distribuzione di applicazioni BizTalk
Come disinstallare un'applicazione BizTalk

Condividi tramite