Come esportare un'applicazione BizTalk

In questo argomento viene descritto come usare la console di amministrazione di BizTalk Server o la riga di comando per esportare un'applicazione. L'esportazione di un'applicazione BizTalk genera un file di Windows Installer (.msi) che contiene l'applicazione e i relativi artefatti selezionati per l'esportazione. L'opzione predefinita consiste nel selezionare tutti gli artefatti dell'applicazione, ma è possibile selezionare un subset di tali elementi. È quindi possibile importare il file .msi in un altro gruppo BizTalk per aggiungere gli artefatti a un'applicazione esistente nel nuovo gruppo, aggiornare gli artefatti in un'applicazione esistente o creare una nuova applicazione nel gruppo che contiene gli artefatti 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 include artefatti basati su file, è necessario installarlo anche prima di iniziare a funzionare.

Quando si esporta un'applicazione, tenere presente quanto segue:

• Le associazioni esistenti vengono sovrascritte automaticamente dalle associazioni importate. Se non si desidera che le associazioni nell'applicazione esportate sovrascrivono le associazioni in un'applicazione in cui si sta importando un file .msi, non è consigliabile selezionare il file di associazione come risorsa da esportare. Quando si importa un file di .msi che contiene un file di associazione in un'applicazione esistente, le associazioni esistenti vengono sovrascritte da quelle importate, anche quando non è stata selezionata l'opzione per sovrascrivere gli artefatti esistenti.

• Un utente potrebbe apportare modifiche a un artefatto durante l'esportazione dell'applicazione. Se un utente sta modificando un artefatto basato su database, ad esempio una directory virtuale, un certificato o un criterio, mentre è in corso un'operazione di esportazione, le modifiche non verranno riflesse nel file .msi esportato. Pertanto, è consigliabile pianificare le operazioni di esportazione durante le ore in cui gli utenti potrebbero non apportare modifiche a questi artefatti.

• È possibile visualizzare un errore errato 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 seguente: "Il programma di installazione ha rilevato un errore imprevisto durante l'installazione del pacchetto. Questo può indicare un problema con questo pacchetto. Il codice di errore è 2869". Per correggere l'errore, importare prima di tutto il pacchetto .msi usando BizTalk Server e quindi ripetere l'esportazione e installare il pacchetto.

• L'applicazione può avere dipendenze da un'altra applicazione. Ciò può influire sulla modalità di distribuzione dell'applicazione. Per altre informazioni, vedere Dipendenze e distribuzione di applicazioni.

• È possibile modificare la directory di destinazione delle risorse nell'applicazione prima dell'esportazione. Se si vuole modificare il percorso di destinazione, espandere il nodo delle risorse dell'applicazione, fare clic con il pulsante destro del mouse sulla risorsa da modificare e quindi 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 del motore di regole. Quando si rimuove un criterio dal database del motore di regole tramite la Distribuzione guidata motore di regole, verrà visualizzato nella console di amministrazione in uno stato "Non pubblicato" e non sarà possibile esportare l'applicazione. Per altre informazioni sulla distribuzione guidata del motore di regole, vedere Come distribuire e annullare la distribuzione di criteri e vocabolari.

Importante

Il file .msi può contenere dati sensibili. Assicurarsi di eseguire le operazioni necessarie per assicurarsi che il file sia sicuro. Per altre informazioni, vedere Sicurezza e Windows Installer.

Durante l'esportazione dell'applicazione, le password vengono rimosse dalle associazioni dell'applicazione. Dopo aver installato l'applicazione dal file .msi, sarà necessario riconfigurare le password affinché l'applicazione funzioni. Le password non vengono tuttavia rimosse da eventuali file di associazione aggiunti all'applicazione.

Se l'applicazione include un sito Web o un'orchestrazione che usa un servizio Web, tenere presente che le impostazioni di sicurezza nella directory virtuale sono quelle effettive quando il file .msi viene generato durante l'esportazione dell'applicazione. Se si distribuisce un'applicazione in un ambiente di produzione, prima di esportare l'applicazione, è necessario verificare che le impostazioni soddisfino i requisiti di sicurezza. Se la directory virtuale esiste già nel computer host, le impostazioni di sicurezza non vengono sovrascritte, ma i file nell'applicazione verranno aggiunti. È necessario verificare le impostazioni di sicurezza dopo l'importazione dell'applicazione.

Tutti gli elenchi di controllo di accesso discrezionale (DACL) vengono rimossi da file e cartelle quando un'applicazione viene esportata. Dopo aver installato un'applicazione, è necessario riconfigurare tutte le impostazioni di sicurezza nei file e nelle cartelle, incluse le directory virtuali.

Annotazioni

Se un'operazione di esportazione non riesce, BizTalk Server elimina tutti i file temporanei insieme al file .msi, se ne è stato creato uno.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario essere connessi con un account membro del gruppo BizTalk Server Administrators. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk. Inoltre, è necessario installare il motore delle regole aziendali. Per altre informazioni, vedere Installare BizTalk Server.

Esportare un'app usando l'Amministrazione di BizTalk Server

1. Fare clic su Start, scegliere Tutti i programmi, Microsoft BizTalk Server 20xx e quindi fare clic su Amministrazione di BizTalk Server.

2. Nell'albero della console espandere Amministrazione bizTalk Server, espandere il gruppo BizTalk e quindi espandere Applicazioni.

3. Fare clic con il pulsante destro del mouse sull'applicazione da esportare, scegliere Esporta e quindi fare clic su File MSI.

4. Nella pagina di benvenuto alla procedura guidata per l'esportazione del file MSI, fare clic su Avanti.

5. Nella pagina Seleziona risorse selezionare gli artefatti da esportare nel file .msi e quindi fare clic su Avanti.

6. 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. Verrà richiesto di specificare il server solo se la directory virtuale non è stata aggiunta in precedenza al database di gestione BizTalk, ad esempio quando è stata aggiunta all'applicazione o è stata importata in un'applicazione.

7. Nella pagina Dipendenze esaminare le dipendenze per l'applicazione e quindi fare clic su Avanti.

8. Nella pagina Destinazione, nel campo Nome applicazione di destinazione, digitare il nome dell'applicazione.

9. Nel file MSI da generare digitare il percorso completo per il file .msi e quindi fare clic su Esporta. Esempio: C:\MSI\Errorhandling.msi

   Annotazioni

   È consigliabile archiviare .msi file in una cartella sicura.

10. 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

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

2. Digitare il comando seguente, sostituendo i valori appropriati, come descritto nella tabella seguente:

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

   Annotazioni

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

   Esempio:

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

   Gli artefatti specificati vengono esportati in un file .msi nel percorso specificato.

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk da esportare. Se il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita. Se il nome include spazi, deve essere racchiuso tra virgolette doppie (").
   /Pacco	Percorso del file .msi da creare, incluso il relativo nome file.
   /ResourceSpec	Percorso del file XML della specifica della risorsa, incluso il nome 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. È necessario modificare manualmente questo file per aggiungere il nome del server host di Internet Information Services (IIS) per una directory virtuale che si desidera esportare se il server Web si trova in un computer remoto.
   /Server	Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk nel formato NomeServer\NomeIstanza,Porta. Il nome dell'istanza è obbligatorio solo quando il nome dell'istanza è diverso dal nome del server. La porta è necessaria solo quando SQL Server usa un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non specificato, viene usato il nome dell'istanza di SQL Server in esecuzione nel computer locale.
   /Banca dati	Nome del database di gestione BizTalk. Se non specificato, viene usato il database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.

Vedere anche

Esportazione di applicazioni, associazioni e criteri BizTalk
ExportApp Comando