安裝 Azure BizTalk 服務 SDK

更新日期: 2015年7月

Microsoft Azure BizTalk 服務的安裝步驟。Microsoft Azure BizTalk 服務有三個主要元件:開發人員 SDK、BizTalk Adapter 服務 執行階段和 Windows PowerShell Cmdlet 工具。本主題內容:

BizTalk 服務 SDK 元件說明

軟體需求

安裝 BizTalk 服務 SDK

將 BizTalk 服務 SDK 升級至最新版本

移轉 BizTalk 配接器服務執行階段環境

移除 BizTalk 服務 SDK

下表列出 BizTalk 服務 SDK 內的元件,並列出會安裝的元件:

 

服務 詳細資料

開發人員 SDK

下載 BizTalk 服務 SDK

下載結構描述

在包含 Visual Studio 的開發電腦上,已安裝 Microsoft Azure BizTalk 服務 SDK 來開發和設計 BizTalk 服務 應用程式。開發人員 SDK 會自動安裝:

  • Visual Studio 中用來建立 XML 橋接器 的 BizTalk 服務專案範本。

  • Visual Studio 中用來建立轉換和結構描述的 BizTalk 服務成品專案範本。

  • BizTalk Adapter Pack 2013:適用於 BizTalk 服務應用程式將訊息傳送給內部部署企業營運 (LOB) 系統時,包括 SAP、SQL Server、Siebel、Oracle Database 或 Oracle E-Business Suite。

    note附註
    安裝 BizTalk Adapter Pack 32 位元和 64 位元版本。

  • Microsoft WCF LOB 配接器 SDK:Microsoft BizTalk Adapter Pack 所需。

  • Visual Studio 中用來建立 BizTalk Adapter 服務 所使用之 LOB Relay 和 LOB 目標 的 BizTalk Adapter 服務 伺服器總管外掛程式。

Runtime

使用網際網路資訊服務 (IIS),[執行階段] 電腦可管理您的 Microsoft Azure BizTalk 服務 應用程式與內部部署企業營運 (LOB) 應用程式之間的連線。

Important重要事項
如果您的應用程式使用內部部署 LOB 系統,則必須在具有 IIS 和網際網路存取的電腦上安裝 BizTalk Adapter 服務 執行階段。如果應用程式未連線到內部部署 LOB 系統,則不需要安裝 BizTalk Adapter 服務 執行階段。

此選項會自動安裝:

  • BizTalk Adapter 服務 執行階段:在內部部署執行,並使用 WCF Web 服務來管理內部部署 LOB 系統與 BizTalk 服務應用程式之間的通訊。

  • Microsoft WCF LOB 配接器 SDK:Microsoft BizTalk Adapter Pack 2013 所需

  • BizTalk Adapter Pack 2013:適用於 BizTalk 服務應用程式將訊息傳送給內部部署企業營運 (LOB) 系統時,包括 SAP、SQL Server、Siebel、Oracle Database 或 Oracle E-Business Suite。

    note附註
    在 64 位元電腦上,會安裝 BizTalk Adapter Pack 32 位元和 64 位元版本。在 32 位元電腦上,會安裝 BizTalk Adapter Pack 32 位元版本。

  • Windows Communication Foundation HTTP 啟動功能 (.NET Framework 3.5)

  • ASP.NET 4.5 功能 (.NET Framework 4.5)

  • Internet Information Services (IIS) 功能,包含:

    • ASP.NET 3.5

    • ASP.NET 4.5

    • CGI

    • ISAPI 擴充程式

    • ISAPI 篩選器

    • Windows 驗證

  • Windows 處理序啟用服務功能

執行階段元件:BizTalk Adapter 服務會說明結構。

工具

[工具] 包含 Windows PowerShell Cmdlet,可用來管理 BizTalk Adapter 服務 執行階段元件及部署的 BizTalk 服務 應用程式。工具會自動安裝:

  • Windows PowerShell 延伸模組來管理 BizTalk Adapter 服務 執行階段和 Microsoft Azure BizTalk 服務。

  • Microsoft WCF LOB 配接器 SDK:Microsoft BizTalk Adapter Pack 2013 所需。

  • BizTalk Adapter Pack 2013:適用於 BizTalk 服務應用程式將訊息傳送給內部部署企業營運 (LOB) 系統時,包括 SAP、SQL Server、Siebel、Oracle Database 或 Oracle E-Business Suite。

    note附註
    在 64 位元電腦上,會安裝 BizTalk Adapter Pack 32 位元和 64 位元版本。在 32 位元電腦上,會安裝 BizTalk Adapter Pack 32 位元版本。

Important重要事項
  • Microsoft Azure BizTalk 服務 SDK 和 BizTalk Adapter 服務 會自動隨附 BizTalk Adapter Pack。不需要分別安裝或授權。

  • BizTalk Adapter 服務 Windows PowerShell 模組名稱為 Microsoft.BizTalk.Adapter.Services.Powershell.dll。因此,使用預覽版本的 Cmdlet 所撰寫的 PowerShell 指令碼可能會在升級後失敗。

  • 可在 Setup 資料夾取得 EULA 副本。可列印該副本。

安裝程式區分為三種環境:開發、執行階段和工具。可在單一電腦或個別電腦上設定環境。若為完整安裝,請在相同的電腦上設定 Visual Studio 開發和 BizTalk Adapter 服務 執行階段/工具環境。下表列出在不同電腦上安裝 Microsoft Azure BizTalk 服務 環境的軟體需求:

 

軟體 詳細資料 電腦

作業系統

可為下列任一項:

  • Windows 7

  • Windows Server 2008 R2

  • Windows 8

  • Windows Server 2012

Important重要事項
Visual Studio 2012 需要安裝 Windows 7 和 Windows 2008 R2 Service Pack 1

  • 開發

  • Runtime

  • 工具

.NET Framework

必要的版本包括:

  • .NET Framework 3.5.1

    Windows Server:開啟 [伺服器管理員],選取 [功能],然後選取 [.NET Framework 3.5]。

    Windows 7/Windows 8:開啟 [控制台],依序選取 [程式和功能]、[開啟或關閉 Windows 功能]、[Microsoft .NET Framework 3.5]。

  • .NET Framework 4.5

    Windows Server 2008 R2/Windows 7:下載 Microsoft .NET Framework 4.5

    Windows Server 2012/Windows 8:在 [功能] 中,選取 [.NET Framework 4.5 進階服務]。

  • 開發

  • Runtime

  • 工具

Microsoft Visual Studio 2012

Microsoft Visual C# .NET 是最低需求。安裝 Visual Studio 提供更多資訊。

Important重要事項
不支援 BizTalk 服務 SDK 的 Visual Studio 2012 Express 版本 (Web/Desktop)。

  • 開發

LOB 伺服器用戶端程式庫

BizTalk Adapter 服務 需要「LOB 伺服器」用戶端程式庫才能與 LOB 系統通訊。因此,請在安裝 BizTalk Adapter 服務 的任何地方同時安裝 LOB 用戶端程式庫。

如果未使用或不需要 BizTalk Adapter 服務,則您不需要安裝「LOB 伺服器」用戶端程式庫。

BizTalk Server 2013 安裝指南 為需要哪些用戶端程式庫及從哪些位置安裝這些程式庫提供更特殊的詳細資料。

  • 開發

  • Runtime

  • 工具

服務匯流排 命名空間

BizTalk Adapter 服務 會使用 服務匯流排 命名空間和 服務匯流排 簽發者名稱/簽發者金鑰值。在您的 Visual Studio 專案中建立 LOB 連線時,請輸入下列值。

請參閱作法:建立或修改服務匯流排服務命名空間

  • 開發

Internet Explorer

Internet Explorer 是用於存取 Microsoft Azure BizTalk 服務入口網站,可從具有網際網路存取的任何電腦中存取。支援的 Internet Explorer 版本包括:

  • Internet Explorer 9 desktop

  • Internet Explorer 10 desktop

  • Internet Explorer 11 desktop

note附註
Microsoft Azure BizTalk 服務入口網站 使用 Silverlight。不支援 Internet Explorer 的新瀏覽器版本。

  • Runtime

  • 工具

網際網路存取

BizTalk Adapter 服務 執行階段會在 Microsoft Azure 服務匯流排 上啟動轉送端點。執行 IIS 網站的電腦和帳戶必須具有透過防火牆存取網際網路的能力。

依據您的網路需求,您可能需要在 Forefront Threat Management Gateway (TMG) Client 上安裝 Forefront TMG Client。TMG Client 亦支援 ISA Server 2004 和 ISA Server 2006。

  • Runtime

透過 Proxy 連線使用 HTTP 1.1

若要連線至命名空間,需要透過 Proxy 連線使用 HTTP 1.1。預設會啟用 [透過 Proxy 連線使用 HTTP 1.1]。可在 Internet Explorer [選項] ([進階] 索引標籤)、網域群組原則,或在 Proxy 伺服器上啟用 HTTP 1.1 來啟用此功能。

  • Runtime

Windows PowerShell 3.0

使用 Windows PowerShell Cmdlet 需要此功能。安裝選項:

Windows Server 2008 R2/Windows 7:下載 Windows Management Framework 3.0

Windows Server 2012/Windows 8:自動隨附於作業系統。沒有個別安裝。

  • 工具

安裝之前

  • 請關閉所有 Visual Studio 執行個體。終止任何 MsBuild.exe 程序;可使用 [工作管理員] 這麼做。

  • 更新 machine.config:在舊版 Microsoft Azure BizTalk 服務 SDK 中,您可能已手動更新 machine.config 檔案或使用 RelayConfigurationInstaller.exe /i 加以更新。如果已更新 machine.config 檔案,請執行 RelayConfigurationInstaller.exe /u 來移除 machine.config 的項目。RelayConfigurationInstaller 工具可與舊版 SDK 及 2012 年 12 月版本搭配使用。您必須使用舊版 SDK 隨附的 RelayConfigurationInstaller 工具。

  • 升級:您可以執行安裝程式,從預覽版本升級至最新的 SDK 版本。如果您偏好全新安裝,請解除安裝任何舊版的 Microsoft Azure BizTalk 服務 SDK 和 BizTalk Adapter 服務。移除 BizTalk 服務 SDK會列出解除安裝步驟。

  • 建議安裝:建議的安裝至少跨越兩部電腦:開發和執行階段/工具。在不同電腦上安裝這些元件時,所有電腦都必須位於信任的網路。

  • 執行階段是選用選項:如果 BizTalk 服務 應用程式未連線至內部部署企業營運 (LOB) 系統,則您不需要 BizTalk Adapter 服務 執行階段。

  • 安裝測試憑證:使用 Azure 管理入口網站 建立 BizTalk 服務時,系統會自動建立測試憑證,您可以從 Azure 管理入口網站 中下載。您可以在安裝執行階段時使用此憑證。附錄:BizTalk 服務憑證概觀 會列出在本機電腦上安裝憑證的步驟。

  • 開啟 TCP 通訊埠:如果您要安裝執行階段,它會在繫結到連接埠 8080 (預設值) 的 IIS 中建立網站。在 IIS 伺服器上,您必須將任何防火牆內的通訊埠 8080 開啟。如果使用 Windows 防火牆,請在 TCP 連接埠 8080 上建立新的輸入規則。如何建立 Windows 防火牆輸入規則 中會列出所有步驟。

  • 「工具」可以安裝在任何使用 Windows PowerShell Cmdlet 的電腦上 (包括多部電腦)。

安裝步驟

  1. 使用身為本機 Administrators 群組成員的帳戶登入。如果安裝「執行階段」,則在您安裝執行階段的 IIS 執行個體上,此帳戶也必須具有系統管理權限。

  2. 安裝 軟體需求

  3. 以系統管理員身分執行 32 位元或 64 位元 WindowsAzureBizTalkServicesSetup.exe

    note附註
    如果啟用 [使用者帳戶控制],則可能顯示安裝警示。選取 [是] 並繼續安裝。

  4. 接受授權合約並選取 [下一步]。

  5. 依您的需求選取 [開發人員 SDK]、[執行階段] 和/或 [工具]。BizTalk 服務 SDK 元件說明 列出其間差異。選取 [下一步]。

  6. 「摘要」列出安裝動作。選取 [安裝]。

    note附註
    若是全新安裝,則安裝動作為 [安裝]。如果已安裝某些元件,[摘要] 會列出版本和安裝動作,例如 [無] 或 [升級]。將 BizTalk 服務 SDK 升級至最新版本提供詳細資訊。

  7. 如果您選取執行階段,BizTalk Adapter 服務 安裝程式會啟動:

    1. 在歡迎頁面上選取 [下一步]。

    2. 接受授權合約,並選取 [下一步]。

    3. 在 [應用程式集區] 中,輸入具有網際網路存取的識別身分,然後選取 [下一步]。

      會以此身分識別,在 IIS 中建立和執行 BizTalk Adapter 服務 應用程式集區。需要網際網路存取的原因是,此身分識別可用來存取 服務匯流排 上的轉送端點。

    4. 在 [Azure BizTalk 服務部署詳細資料] 中,輸入 BizTalk 服務部署 URL,然後選取 [下一步]。

      此 URL 可用來確定成品存放區與您的 BizTalk 服務 訂閱相關聯。您為 BizTalk Adapter 服務 元件建立的組態設定 (例如 LOB Relay 和 LOB 目標) 會儲存在成品存放區。

    5. 選取 BizTalk Adapter 服務 網站的憑證繫結,然後選取 [下一步]。

      • 使用 SSL 確保管理服務安全:選取此選項可使用 SSL 加密 HTTP 要求。

      • 選取現有的 SSL 憑證:選取此選項,可從憑證存放區中選取現有憑證。憑證應來自信任的憑證授權單位。

      • 連接埠:輸入 BizTalk Adapter 服務 網站的連接埠號碼。預設會輸入連接埠 8080。請確認已在防火牆中開啟該連接埠。

    6. 選取 [安裝]。精靈完成時,選取 [完成] 返回 Microsoft Azure BizTalk 服務 SDK 精靈。

  8. 選取 [完成] 以完成安裝並結束精靈。

完成安裝時,會在使用者的 temp 目錄 (位於 C:\Users\UserName\AppData\Local\Temp) 中建立安裝程式記錄檔。如果安裝失敗,請參閱此記錄檔中的任何錯誤。如果安裝成功,則環境會包含建立及/或管理 BizTalk 服務應用程式所需的所有元件。

您可以將開發人員、執行階段和工具元件從 Microsoft Azure BizTalk 服務 預覽或 Microsoft Azure BizTalk 服務 (2013 年 11 月) 通用版本上市 (GA) 升級為最新版本。若要升級,請以系統管理員身分執行 WindowsAzureBizTalkServicesSetup.exe,選取要升級的元件並繼續安裝程式。安裝程式會偵測先前已安裝的元件版本,並據此建議予以升級。一般而言,您必須安裝全部三個具有相同版本的元件。例如,如果您安裝某個版本的開發人員 SDK 和執行階段,並安裝其他版本的工具元件,則安裝程式會建議所有元件應有相同的版本。

在升級期間,您現有的成品會升級至 GA,包含 BizTalk 服務專案 成品、轉換 和 BizTalk Adapter 服務 元件。此外,如果選擇升級 BizTalk Adapter 服務 執行階段元件,安裝程式也會執行 BizTalk Adapter 服務 設定移轉,也就是將設定從內部部署 SQL Server 資料庫移轉至 Microsoft Azure 儲存體。如需詳細資訊,請參閱移轉 BizTalk 配接器服務執行階段環境

升級後

升級至最新版本後,請執行下列動作:

  • 重新部署已啟用批次處理的 EDI 合約。若未在合約中使用批次處理,則不需要重新部署 EDI 合約。

  • BizTalk 配接器服務 Windows PowerShell 模組名稱為 Microsoft.BizTalk.Adapter.Services.Powershell.dll。因此,使用預覽版本的 Cmdlet 所撰寫的 PowerShell 指令碼可能會在升級後失敗。必須重新撰寫這些指令碼。

  • 如需了解升級後可能發生的其他問題,請參閱 Azure BizTalk 服務的版本資訊

  • 最佳作法是建立 BizTalk 服務的備份。BizTalk 服務:備份和還原 提供建立備份的詳細資訊。

預覽版本和 2013 年 11 月 GA 版本的 BizTalk Adapter 服務 元件 (屬於 Microsoft Azure BizTalk 服務 SDK 的組件) 需要內部部署 SQL Server 資料庫才能儲存 LOB Relay 和 LOB 目標 的相關資訊。2014 年 2 月版本的 BizTalk Adapter 服務 元件可在與 BizTalk 服務 關聯的儲存機制中儲存資訊。Microsoft Azure BizTalk 服務 SDK 安裝程式可讓您將內部部署 SQL Server 資料庫儲存的資訊移轉至 BizTalk 服務相關聯的 Microsoft Azure 儲存體。下列步驟提供如何執行移轉的相關資訊:

note附註
您可以在升級過程中執行移轉。

  1. 在已安裝舊版 BizTalk Adapter 服務 的電腦上,以系統管理員身分執行 WindowsAzureBizTalkServicesSetup.exe

    note附註
    如果啟用 [使用者帳戶控制],則可能顯示安裝警示。選取 [是] 並繼續安裝。

  2. 接受授權合約並選取 [下一步]。

  3. 選取 [執行階段],然後選取 [下一步]。

  4. [摘要] 頁面列出將升級執行階段 (BizTalk Adapter 服務) 元件。選取 [下一步]。

  5. 在 [移轉] 頁面上,提供 BizTalk 服務訂閱的 URL、與 BizTalk 服務相關聯的存取控制命名空間,以及存取控制命名空間的簽發者名稱/簽發者金鑰。

    note附註
    安裝程式使用此 URL 來確定您的 BizTalk 服務 訂閱所關聯的儲存機制。您為 BizTalk Adapter 服務 元件建立的組態設定 (例如 LOB Relay 和 LOB 目標) 會儲存在 BizTalk 服務 關聯的儲存機制中。如果將 BizTalk Adapter 服務 作為使用預覽版本或 2013 年 11 月 GA 版本 SDK 所建立之現有 BizTalk 服務 應用程式的組件,精靈會將 BizTalk Adapter 服務 組態設定從本機 SQL Server 資料庫移轉至 BizTalk 服務 訂閱所關聯的儲存機制。

    選取 [安裝]。

  6. 精靈完成後,選取 [完成]。

可使用 [控制台] 解除安裝 Microsoft Azure BizTalk 服務 SDK 和 BizTalk Adapter 服務。選取 [解除安裝程式]。在 [解除安裝或變更程式] 頁面的元件上按一下滑鼠右鍵,然後選取 [解除安裝]。已安裝元件的完整清單包含:

  • Microsoft Azure BizTalk 服務 SDK

  • Microsoft BizTalk Adapter 服務

  • Microsoft Azure BizTalk 服務 工具

  • Microsoft BizTalk Adapter Pack (如果已安裝)

  • Microsoft BizTalk Adapter Pack (x64) (如果已安裝)

  • Windows Communication Foundation LOB 配接器 SDK (WCF LOB 配接器 SDK) (如果已安裝)

    Important重要事項
    務必先解除安裝 BizTalk Adapter Pack 再解除安裝 WCF LOB 配接器 SDK。

另請參閱

顯示: