Come installare la versione stub della soluzione orientata ai servizi

Nelle procedure seguenti viene descritto come preparare il computer prima di installare la versione stub della soluzione orientata ai servizi e come installare la soluzione nel computer in uso.

• Preparare il computer per l'installazione della versione stub della soluzione orientata ai servizi

• Installare il client IBM WebSphere MQ per Windows

• Creare directory virtuali in IIS per la soluzione orientata ai servizi

• Compilare la soluzione orientata ai servizi

• Creare le voci e i valori di Enterprise Single Sign-On (SSO) nel database SSO

• Distribuire la definizione BAM per la soluzione orientata ai servizi

• Distribuire la soluzione orientata ai servizi

Preparare il computer per l'installazione della versione stub della soluzione orientata ai servizi

Per preparare il computer per l'installazione della versione stub della soluzione orientata ai servizi

1. Assicurarsi che il sito Web predefinito sia configurato per l'uso di ASP.NET 2.X.

   1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Strumenti di amministrazione e quindi Gestione Internet Information Services (IIS).

   2. In Gestione Internet Information Services (IIS) il nome del computer, espandere Siti, espandere Sito Web predefinito, espandere aspnet_client, espandere system_web.

   3. Verificare che la sottocartella sia 2.X.

2. Fare clic su Start, scegliere Tutti i programmi, scegliere Strumenti di amministrazione e quindi fare clic su Servizi. Usando la console servizi , assicurarsi che i servizi seguenti siano in esecuzione:

   • Pubblicazione sul Web

3. Fare clic su Start, scegliere Tutti i programmi, scegliere Strumenti di amministrazione, console di gestione computer e quindi aggiungere l'account del servizio BizTalk al gruppo Administrators locale.

4. Se è stato installato Windows SharePoint Services, escludere il (radice) del sito Web predefinito da Windows SharePoint Services Percorsi gestiti come indicato di seguito: Fare clic su Start, scegliere Tutti i programmi, scegliere Strumenti di amministrazione e quindi fare clic su Amministrazione centrale SharePoint.

   1. In Configurazioneserver virtuale selezionare Configura impostazioni server virtuali.

   2. Nella pagina Elenco server virtuale fare clic su Sito Web predefinito.

   3. Nella pagina Impostazioni server virtuale fare clic su Definisci percorsi gestiti.

   4. Nella sezione Percorsi inclusi della pagina Percorso gestito definito selezionare Radice e quindi fare clic su Rimuovi percorsi selezionati.

   5. Al prompt dei comandi eseguire IISReset.

5. Disconnettersi dal computer, quindi accedervi con l'account del servizio BizTalk.

6. Aprire una finestra del prompt dei comandi, digitare il comando seguente, quindi premere INVIO per impostare l'ambiente %BTSSolutionsPath%. Chiudere la finestra del prompt dei comandi.

   • setx BTSSolutionsPath "\Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\Scenarios"

     Nota

     Se si utilizza un computer a 64 bit, utilizzare %Programmi(x86)% anziché %Programmi%.

     Nota

     Per altre informazioni sul comando SETX, vedere il sito Web Microsoft TechNet all'indirizzo https://go.microsoft.com/fwlink/?LinkId=67831.

Installare il client IBM WebSphere MQ per Windows

Per installare il client IBM WebSphere MQ per Windows

1. Scaricare la versione più recente del client IBM WebSphere MQ per Windows.

   Nota

   È necessario installare il server IBM WebSphere anche se non richiesto per la versione stub della soluzione, poiché l'applicazione client fa riferimento al file amqmdnet.dll disponibile nel client IBM WebSphere MQ per Windows. Il client della versione stub non chiama effettivamente un'API nella DLL. È necessario solo per la compilazione e l'esecuzione dell'applicazione client. È possibile scaricare il client IBM WebSphere MQ per Windows dal sito Web IBM.

2. Installare il client IBM WebSphere MQ per Windows.

   Nota

   Non è necessario configurare il client IBM WebSphere MQ per Windows. Mantenere tutte le impostazioni predefinite.

3. Aggiungere le classi WebSphere MQ per l'assembly .NET alla Global Assembly Cache.

   1. Al prompt dei comandi di Visual Studio passare alla directory <IBM MQSeries Installation Directory>\bin.

   2. Eseguire il comando seguente (verificare che gacutil.exe si trovi nell'ambiente del percorso):

      gacutil.exe /i amqmdnet.dll

Creare directory virtuali in IIS per la soluzione orientata ai servizi

Per creare directory virtuali in IIS per la soluzione orientata ai servizi

1. In Gestione Internet Information Services (IIS) fare clic con il pulsante destro del mouse su Pool di applicazioni selezionare Aggiungi pool di applicazioni.

   Nella finestra di dialogo Aggiungi pool di applicazioni digitare SSOStubAppPool nella casella di testo Nome e quindi fare clic su OK.

   Le directory virtuali utilizzate dalla soluzione orientata ai servizi includono il servizio Web pubblicato per la versione stub delle orchestrazioni, il servizio Web SAP dello stub, il servizio Web di registrazione pagamenti dello stub e il servizio Web delle transazioni in sospeso dello stub.

2. In Gestione Internet Information Services (IIS) fare clic con il pulsante destro del mouse sul pool di applicazioni appena creato e quindi scegliere Impostazioni avanzate.

3. Fare clic sulla colonna a destra della proprietà Identity e quindi fare clic sul pulsante con i puntini di sospensione (...).

4. Nella finestra di dialogo Identità pool di applicazioni selezionare l'opzione Account personalizzato e quindi fare clic su Imposta.

5. Nella finestra di dialogo Imposta credenziali specificare un nome utente e una password, confermare la password e quindi fare clic su OK.

   Nota

   Questo utente deve disporre dell'autorizzazione per eseguire il servizio Web del proxy di orchestrazione e deve essere aggiunto al gruppo Amministratori BizTalk Server, Amministratori SSO o Amministratori affiliati SSO.

6. Fare clic su OK per chiudere la finestra di dialogo Identità pool di applicazioni .

7. Fare clic su OK per chiudere la finestra di dialogo Impostazioni avanzate .

8. In Gestione Internet Information Services (IIS) espandere Siti Web, fare clic con il pulsante destro del mouse sul sito Web predefinito, scegliere Nuovo e quindi fare clic su Directory virtuale per eseguire creazione guidata directory virtuale.

   1. Usando la Creazione guidata directory virtuale, creare la directory virtuale seguente per il servizio Web proxy per la versione della scheda:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\OrchProxy\Stub

      Autorizzazioni di accesso = Lettura, Esecuzione script

   2. Usando la Creazione guidata directory virtuale, creare la directory virtuale seguente per il servizio Web proxy per la versione della scheda:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP

      Autorizzazioni di accesso = Lettura, Esecuzione script

   3. Usando la Creazione guidata directory virtuale, creare la directory virtuale seguente per il servizio Web proxy per la versione della scheda:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans

      Autorizzazioni di accesso = Lettura, Esecuzione script

   4. Usando la Creazione guidata directory virtuale, creare la directory virtuale seguente per il servizio Web proxy per la versione della scheda:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PaymentTrack

      Autorizzazioni di accesso = Lettura, Esecuzione script

9. In Gestione Internet Information Services (IIS) espandere Siti Web, espandere Il sito Web predefinito, fare clic con il pulsante destro del mouse su Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub, scegliere Proprietà e quindi modificare le impostazioni come indicato di seguito:

   1. Nella scheda Directory virtuale impostare il pool di applicazioni su SSOStubAppPool appena creato.

   2. Fare clic sulla scheda Sicurezza directory , fare clic su Modifica nella casella Di gruppo di controllo autenticazione e accesso, selezionare Solo autenticazione integrata abilitata e quindi deselezionare altre caselle di controllo Di accesso all'autenticazione . Fare clic su OK per uscire.

10. In Gestione Internet Information Services (IIS) espandere Siti Web, espandere Il sito Web predefinito, fare clic con il pulsante destro del mouse su Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP, scegliere Proprietà e quindi modificare le impostazioni come indicato di seguito:

    1. Nella scheda Directory virtuale impostare il pool di applicazioni su SSOStubAppPool appena creato.

    2. Fare clic sulla scheda Sicurezza directory , fare clic su Modifica nella casella Di gruppo Autenticazione e controllo di accesso e quindi selezionare Abilita accesso anonimo. Fare clic su OK per uscire.

11. In Gestione Internet Information Services (IIS) espandere Siti Web, espandere Il sito Web predefinito, fare clic con il pulsante destro del mouse su Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions, scegliere Proprietà e quindi modificare le impostazioni come indicato di seguito:

    1. Nella scheda Directory virtuale impostare il pool di applicazioni su SSOStubAppPool appena creato.

    2. Fare clic sulla scheda Sicurezza directory , fare clic su Modifica nella casella Di gruppo Autenticazione e controllo di accesso e quindi selezionare Abilita accesso anonimo. Fare clic su OK per uscire.

12. In Gestione Internet Information Services (IIS) espandere Siti Web, espandere Il sito Web predefinito, fare clic con il pulsante destro del mouse su Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker, scegliere Proprietà e quindi modificare le impostazioni come indicato di seguito:

    1. Nella scheda Directory virtuale impostare il pool di applicazioni su SSOStubAppPool appena creato.

    2. Fare clic sulla scheda Sicurezza directory , fare clic su Modifica nella casella Di gruppo Autenticazione e controllo di accesso e quindi selezionare Abilita accesso anonimo. Fare clic su OK per uscire.

Compilare la soluzione orientata ai servizi

Per compilare la soluzione orientata ai servizi

1. Avviare il prompt dei comandi di Visual Studio.

   Nota

   Nei file %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Inline\app_code\customerserviceport.asmx.cs e %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy \ Stub\app_code\customerserviceport.asmx.cs, sostituire tutte le istanze di 17f20caea2afcc8c con a1054514fc67bded.

2. Al prompt dei comandi di Visual Studio passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln, quindi eseguire il comando riportato di seguito per compilare la versione stub della soluzione orientata ai servizi.

   • SetupBTSSoln.bat

   Nota

   Nei file elencati di seguito sostituire tutte le istanze di 17f20caea2afcc8c con il token di chiave pubblica corrente.

   • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_CustomerServiceResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_ErrorResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CreditLimitResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CustomerServiceResponseDenied.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_LastPaymentResponseTimeout.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_PendingTransactionResponse.btm.cs

Creare le voci e i valori di Enterprise Single Sign-On (SSO) nel database SSO

Per creare le voci e i valori di Enterprise Single Sign-On (SSO) nel database SSO

1. Al prompt dei comandi passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln\Scripts, quindi eseguire il comando seguente per impostare l'ambiente PATH per la cartella Enterprise Single Sign-On.

   • Set PATH=%PATH%;%ProgramFiles%\"Common Files\Enterprise Single Sign-On"

2. Al prompt dei comandi passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln\Scripts, aprire ConfigStoreApp.xml tramite il Blocco note ed esaminarne il contenuto.

   Nota

   Questo file definisce l'applicazione dell'archivio di configurazione in SSO utilizzata nello scenario per archiviare i parametri di configurazione. Alcuni dei parametri di configurazione includono il valore timeout usato per comunicare con SAP (per tutte e tre le versioni). Non è necessario apportare alcuna modifica a questo file.

3. Al prompt dei comandi eseguire il comando seguente per creare l'applicazione dell'archivio di configurazione SSO.

   • ssomanage -createapps ConfigStoreApp.xml

4. Al prompt dei comandi aprire SetConfigValuesInSSO.cmd tramite il Blocco note ed esaminarne il contenuto.

   Nota

   Questo file di comando imposta i valori dei parametri di configurazione nel database SSO. Contiene diverse istruzioni SET che impostano i valori nelle variabili locali all'inizio del file di comando. I valori SAPAdapterTimeout, PendingTransactionsAdapterTimeout e PaymentTrackingAdapterTimeout vengono usati nella versione stub e adapter. I valori rimanenti vengono utilizzati nella versione inline. Non è necessario apportare alcuna modifica a questo file per la versione stub.

5. Al prompt dei comandi digitare SetConfigValuesInSSO.cmde quindi premere INVIO per archiviare i valori nell'applicazione dell'archivio di configurazione SSO.

6. Al prompt dei comandi eseguire il comando seguente per abilitare i ticket in SSO:

   • ssomanage -tickets yes yes

Distribuire la definizione BAM per la soluzione orientata ai servizi

Per distribuire la definizione BAM per la soluzione orientata ai servizi

1. Al prompt dei comandi digitare il comando seguente, quindi premere INVIO. Viene impostato il percorso per la ricerca dell'utilità BAM:

   • SET PATH=%PATH%;%programfiles%\Microsoft BizTalk Server\Tracking

2. Al prompt dei comandi passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln\BAM e digitare il comando seguente, quindi premere INVIO:

   • bm deploy-all -DefinitionFile:ServiceLevelTracking.xml

     Nota

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

Distribuire la soluzione orientata ai servizi

Per distribuire la soluzione orientata ai servizi

1. Aprire una finestra del prompt dei comandi e passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln\Scripts.

2. Modificare il file DeployStubBinding.cmd sostituendo tutte le istanze di "debug" e "development" con "release".

3. Aprire una finestra del prompt dei comandi e passare dalla directory corrente alla cartella %BTSSolutionsPath%\SO\BTSSoln\Scripts. Digitare il comando riportato di seguito, quindi premere INVIO:

   • DeployStubBinding.cmd

4. Al prompt dei comandi eseguire il comando seguente per avviare le orchestrazioni per la versione stub.

   • Startstub.vbs

Passaggi successivi

Si verifica il funzionamento della versione stub della soluzione orientata al servizio in Come eseguire la soluzione orientata al servizio.

Vedere anche

Prima di installare la soluzione orientataal servizio come installare le versioni inline e adapter del programma di installazione del computer per sviluppatori di soluzioni orientate al servizio per la soluzione orientata al servizio