Come esportare un'applicazione BizTalk

Articolo
07/21/2023

In questo argomento viene descritto come utilizzare la console di amministrazione BizTalk Server o la riga di comando per esportare un'applicazione. Quando si esporta un'applicazione BizTalk viene creato un file con estensione msi di Windows Installer contenente l'applicazione e tutti i relativi elementi scelti per essere esportati. Benché l'opzione predefinita preveda l'esportazione di tutti gli elementi dell'applicazione, è possibile selezionarne un sottoinsieme. Sarà quindi possibile importare il file con estensione msi in un altro gruppo BizTalk per aggiungere gli elementi in un'applicazione appartenente al nuovo gruppo, aggiornare gli elementi di un'applicazione esistente o creare nel gruppo una nuova applicazione contenente gli elementi importati. Per altre informazioni, vedere Come importare un'applicazione BizTalk. Usare anche il file .msi per installare l'applicazione nei computer che lo eseguiranno, come descritto in Come installare un'applicazione BizTalk. Se l'applicazione contiene elementi basati su file, affinché l'applicazione funzioni è necessario installare anche questi elementi.

Quando si esporta un'applicazione, ricordare i seguenti punti importanti:

I binding esistenti vengono sovrascritti automaticamente dai binding importati. Se si desidera che i binding contenuti nell'applicazione in cui si sta importando il file con estensione msi non vengano sovrascritti dai binding contenuti nell'applicazione che si sta esportando, evitare di selezionare il file di associazione come risorsa da esportare. Quando in un'applicazione esistente si importa un file con estensione msi contenente un file di associazione, i binding esistenti vengono sovrascritti da quelli importati, anche nel caso in cui l'opzione di sovrascrittura degli elementi esistenti non sia stata selezionata.
È possibile che un elemento venga modificato da un utente durante l'esportazione dell'applicazione. Se durante l'esecuzione di un'operazione di esportazione un utente apporta modifiche a un elemento basato su database, ad esempio una directory virtuale, un certificato o un criterio, tali modifiche non verranno incluse nel file con estensione msi esportato. Di conseguenza è consigliabile pianificare le operazioni di esportazione in fasce orarie in cui è improbabile che gli utenti apportino modifiche agli elementi basati su database.
È possibile visualizzare un errore non corretto durante l'installazione di un .msi in Windows Vista. Quando si installa un pacchetto .msi esportato tramite BizTalk Server, è possibile che venga visualizzato l'errore errato seguente: "Il programma di installazione ha rilevato un errore imprevisto durante l'installazione del pacchetto. L'errore può essere dovuto a problemi del pacchetto. Il codice di errore è 2869." Per correggere l'errore, importare prima il pacchetto .msi usando BizTalk Server e quindi ripetere l'esportazione e installare il pacchetto.
È possibile che l'applicazione presenti dipendenze da un'altra applicazione. Ciò può influire sul modo in cui l'applicazione viene distribuita. Per altre informazioni, vedere Dipendenze e distribuzione di applicazioni.
La directory di destinazione delle risorse dell'applicazione può essere cambiata prima dell'esportazione. Per modificare il percorso di destinazione, espandere il nodo risorse dell'applicazione, fare clic con il pulsante destro del mouse sulla risorsa da modificare e scegliere Modifica. Nella finestra di dialogo Modifica risorse immettere una nuova posizione in per Percorso di destinazione.
L'esportazione avrà esito negativo se l'applicazione contiene un criterio che è stato rimosso dal database Motore regole di business. Quando si rimuove un criterio dal database Motore regole di business mediante la Distribuzione guidata Motore regole di business, esso verrà riportato nella console di amministrazione come "Non pubblicato" e non sarà possibile esportare l'applicazione. Per altre informazioni sulla Distribuzione guidata motore di regole, vedere How to Deploy and Undeploy Policies and Vocabularies .For more information about the Rule Engine Deployment Wizard, see How to Deploy and Undeploy Policies and Lessies.

Importante

Un file con estensione msi potrebbe contenere dati riservati. Assicurarsi di applicare procedure che ne garantiscano la protezione. Per altre informazioni, vedere Sicurezza e Windows Installer.

Durante l'esportazione dell'applicazione le password vengono rimosse dai binding dell'applicazione. Dopo aver installato l'applicazione dal file con estensione msi, sarà necessario riconfigurare le password per garantire il funzionamento dell'applicazione. Tuttavia, le password non vengono rimosse dai file di associazione che sono stati aggiunti esplicitamente all'applicazione.

Se l'applicazione comprende un sito Web o un'orchestrazione che utilizza un servizio Web, si tenga presente che le impostazioni di protezione riguardanti la directory virtuale corrispondono a quelle attivate quando il file con estensione msi viene generato durante l'esportazione dell'applicazione. Se si sta distribuendo un'applicazione in un ambiente di produzione, prima di esportare l'applicazione è necessario verificare che le impostazioni soddisfino i requisiti di protezione desiderati. Se la directory virtuale esiste già nel computer host, le relative impostazioni di protezione non vengono sovrascritte, ma i file contenuti nell'applicazione verranno aggiunti in tale directory. Dopo aver eseguito l'importazione dell'applicazione è necessario verificare le impostazioni di protezione.

Quando si esporta un'applicazione, tutti gli elenchi di controllo di accesso discrezionale (DACL) vengono rimossi dai file e dalle cartelle. Dopo aver installato un'applicazione occorre riconfigurare tutte le impostazioni di protezione riguardanti file e cartelle, comprese le directory virtuali.

Nota

Se un'operazione di esportazione ha esito negativo, BizTalk Server elimina tutti i file temporanei insieme al file con estensione msi, se ne è stato creato uno.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario accedere con un account membro del gruppo Amministratori BizTalk Server. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk. È inoltre necessario installare il Motore regole di business. Per altre informazioni, vedere Installare BizTalk Server.

Esportare un'app usando BizTalk Server Administration

Fare clic su Start, scegliere Tutti i programmi, Microsoft BizTalk Server 20xx e quindi fare clic su amministrazione BizTalk Server.
Nell'albero della console espandere BizTalk Server Amministrazione, espandere il gruppo BizTalk e quindi espandere Applicazioni.
Fare clic con il pulsante destro del mouse sull'applicazione da esportare, scegliere Esporta e quindi fare clic su File MSI.
Nella pagina Esportazione guidata file MSI fare clic su Avanti.
Nella pagina Seleziona risorse selezionare gli artefatti da esportare nel file .msi e quindi fare clic su Avanti.
Se richiesto, nella pagina Specifica host IIS digitare il nome del server del computer che ospita la directory virtuale da includere e quindi fare clic su Avanti. Tale operazione sarà necessaria soltanto se la directory virtuale non è già stata aggiunta al database di gestione BizTalk, ad esempio durante l'aggiunta o l'importazione in un'applicazione.
Nella pagina Dipendenze esaminare le dipendenze per l'applicazione e quindi fare clic su Avanti.
Nella pagina Destinazione digitare il nome dell'applicazione in Nome applicazione di destinazione.
Nel file MSI da generare digitare il percorso completo per il file .msi e quindi fare clic su Esporta. Esempio: C:\MSI\Errorhandling.msi

Nota

È consigliabile archiviare i file con estensione msi in una cartella protetta.
Nella pagina Riepilogo prendere nota del percorso del file di log per questa operazione e quindi fare clic su Fine.

Esportare un'app usando la riga di comando

Aprire un prompt dei comandi come indicato di seguito: fare clic su Start, fare clic su Esegui, digitare cmde quindi fare clic su OK.

Digitare il comando seguente, sostituendo i valori appropriati, come descritto nella tabella che segue:

BTSTask ExportApp [/ApplicationName:value] /Package:value [ResourceSpec:value [/Server:value] [/Database:value]

Nota

In un sistema che supporta il controllo dell'account utente, potrebbe essere necessario eseguire lo strumento con i privilegi amministrativi.

Esempio:

BTSTask ExportApp /ApplicationName:MyApplication /Package:C:/MSI/MyApplication.msi /ResourceSpec:"C:\My Files\ResourceSpec.xml" /Server:MySQLServer /Database:BizTalkMgmtDb

Gli elementi specificati vengono esportati in un file con estensione msi nell'indirizzo specificato.

Parametro	Valore
/Applicationname	Nome dell'applicazione BizTalk da esportare. Se non si specifica il nome dell'applicazione, viene utilizzata l'applicazione BizTalk predefinita. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
/Pacchetto	Percorso del file con estensione msi da creare, incluso il relativo nome.
/ResourceSpec	Percorso del file XML della specifica della risorsa, incluso il nome del file. È possibile specificare gli artefatti da esportare modificando il file XML della specifica della risorsa, che viene creato quando si esegue il comando ListApp con il parametro ResourceSpec, come descritto in Comando ListApp. Se il server Web si trova su un computer remoto, questo file deve essere modificato manualmente in modo da aggiungere il nome del server host di Internet Information Services (IIS) della directory virtuale che si desidera esportare.
/Server	Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk, nel formato NomeServer\NomeIstanza,Porta. È necessario specificare il nome dell'istanza solo se è diverso dal nome del server. È necessario specificare la porta solo se SQL Server utilizza un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non si specifica il nome dell'istanza, viene utilizzato il nome dell'istanza di SQL Server in esecuzione nel computer locale.
/Database	Nome del database di gestione BizTalk. Se omesso, verrà utilizzato il nome del database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.

Vedere anche

Esportazione di criteri, binding e applicazioni BizTalk
Comando ExportApp

Condividi tramite