如何為 Cognos 11 設置網關
我們經常被問到的一個問題是：“可選網關是否曾經成為必需品？“
而答案是，“沒錯！“
必須設置可選網關的最常見場景之一是設置單點登錄 (SSO)。 在這篇博文中，我將介紹如何在 Cognos Analytics 中設置可選網關 11.0.2和11.0.3版. 關注過的人 可以在此處找到 IIS 配置指南. 為了讓這一切變得更容易，IBM 提供了一個小工具，您可以 在這裡下載 自動化過程。
服務器架構
IBM Cognos Analytics 使用基於 Web 的多層服務器架構，該架構由三個服務器層組成：
- 網絡層
- 應用層
- 數據層
IBM Cognos Analytics 中的 Web 通信通常通過 Web 層進行路由，該層便於用戶連接到 IBM Cognos 分析應用程序，負責此操作的組件是 IBM Cognos Analytics Gateway。
IBM Cognos Analytics Gateway 組件可以安裝在與 Content Manager 或應用程序層不同的服務器上，IBM 將此稱為可選網關安裝。
安裝 IIS 應用程序請求路由 (ARR) 擴展
對於這兩種反向代理設置方法，我將使用 IIS 8（Internet 信息服務）。 但首先，您需要確保安裝了 IIS 應用程序請求路由 (ARR) 擴展。 這是允許 IIS 充當反向代理的擴展。
1. 在新的瀏覽器會話中，輸入以下地址：http://www.iis.net/downloads/microsoft/application-request-routing 並單擊綠色的“安裝此擴展”按鈕。
2. 然後系統會提示您保存名為“ARRv3_0.exe”的文件。 將它保存在您機器上的某個位置，然後運行它。 安裝程序啟動後，如果您接受條款和條件，請按“我接受”按鈕。
3. 然後安裝程序將下載並安裝 ARR 擴展。 完成後單擊“完成”按鈕。 如果您看到任何其他頁面，只需退出所有頁面。
4. 要確保您的擴展程序安裝正確，請從 Windows 中的“管理員工具”啟動 IIS 管理器。 啟動後，單擊屏幕左上角的服務器名稱。 然後，在中間的 IIS 窗格中，現在應該可以看到 URL 重寫功能。
現在您已經安裝了 ARR 擴展，您可以繼續設置反向代理。 為此，您需要做的就是根據您的需要遵循以下方法之一。 注意：我如果您的最終目標是將 Cognos Analytics 配置為使用 SSO，然後繼續執行方法 2.
反向代理設置
方法 1：IIS 和應用程序請求路由 (ARR) 擴展配置。 （不適用於 SSO）
此方法提供了一種使用 IIS 8 在可選網關服務器上設置反向代理的簡單方法。此方法適用於僅嘗試設置 Web 服務器所在的外部 IBM Cognos Analytics 網關的用戶，類似於 主機服務器 可用的、公開可用的或防火牆外部的。
1. 如果尚未打開 Internet 信息服務 (IIS) 管理器，請打開它。 展開左側面板上的導航樹。 在“站點”下右鍵單擊您的網站並選擇“添加虛擬目錄”。 注意：如果您沒有網站設置，則只需右鍵單擊“站點”下的“默認網站”。
2. 在“別名”下輸入任何名稱。 我按照IBM的做法，直接輸入了“CA11”。 在“物理路徑”下導航到您為此目的在系統上的任何位置創建的空文件夾。 我再次關注 IBM 並將我的指向“C:CA”。 不要擔心“測試設置...”或“連接為...”按鈕，然後單擊“確定”。 當你擴展你的網站時，或者在我的例子中是“默認網站”，你應該看到你新創建的網站作為一個文件夾。 我看到了“CA11”。
3. 現在您需要設置 URL Rewrite，您可以在其中設置反向代理以將所有 Web 請求從 Web 層重定向到應用程序層。 單擊左側面板上的新虛擬目錄，然後雙擊位於中心的“URL 重寫”。
4. 單擊位於右側面板下“操作”下的“添加規則...”。
5. 雙擊“入站和出站規則”部分下的“反向代理”。
6. 在“入站規則”部分，您應該會看到一個文本框。 輸入您的應用程序層的 :/ 。 確保選中“啟用 SSL 卸載”並單擊“確定”。
7. 您現在應該會看到在“URL 重寫”頁面的“入站規則”部分下創建了一個新條目。 你需要做更多的工作，但直到你到達 步驟9. 在右側面板上，單擊“查看服務器變量...”。 單擊“添加”並輸入以下變量：HTTP_X_BI_PATH。 注意：該變量的值是絕對值，不能為任何其他格式。
8. 單擊右側面板上的“返回規則”以退出此部分。
9. 突出顯示您在其中創建的入站反向代理項 步驟6，然後在右側面板上單擊位於“入站規則”下的“編輯”。
10. 向下滾動，直到看到“服務器變量”部分並將其展開。 然後點擊“添加”按鈕。
11. 在新對話框中，選擇“服務器變量名稱”下拉菜單下的 HTTP_X_BI_PATH。 在“值”下，使用您在步驟 2 中選擇的名稱，並按以下格式輸入：/”步驟 2 中的名稱”/bi/v1。 所以對我來說，這看起來像 /CA11/bi/v1。 單擊“確定”按鈕，然後單擊“操作”部分下的“應用”。 單擊“返回規則”。
12. 現在您已完成設置反向代理。 您需要做的就是通過左側樹的最上方節點重新啟動 IIS，然後單擊右側面板中“操作”下的“重新啟動”。
13. 要測試配置，請打開瀏覽器會話並輸入以下內容：http://” web_server”:”port”/alias/bi/
請注意，bi 後面的“/”很重要，必須在那裡。 如果設置成功，那麼您現在應該能夠看到您的 Cognos Analytics 登錄屏幕。
方法 2：IIS 和 ARR 與 Cognos Analytics Server 網關（SSO 的正確方法）
在此方法中，您將首先使用 IBM Cognos Analytics Server 安裝程序將 IBM Cognos Analytics 作為“可選網關”安裝，然後使用它來配置您的反向代理。
1. 啟動 Cognos 安裝程序可執行文件。 我的那個看起來像這樣：ca_srv_win64_11.0.3.xxxxxxx.exe。 這將啟動 IBM Cognos Analytics 安裝程序。
2. 選擇一種語言，然後單擊“下一步”。 然後在下一個窗口中選擇“我接受……”，如果您同意許可協議，請單擊“下一步”。
3. 在下一個窗口中，為您的可選網關選擇一個安裝位置，為您的文件夾命名，然後單擊“下一步”。
4. 在“安裝類型”部分選擇“自定義”單選按鈕，然後單擊下一步。
5. 在“自定義安裝”部分，選擇“首次安裝”單選按鈕，然後單擊下一步。
6. 在“選擇組件”部分，選中“可選網關”複選框，然後單擊下一步。
7. 在下一部分驗證一切正常，然後單擊“安裝”。
8. 此處將安裝 Cognos Analytics，完成後單擊“完成”。 現在您已經安裝了 Cognos Analytics，使用 IIS 將其配置為用作反向代理。
9. 打開 Internet 信息服務 (IIS) 管理器。
10. 展開左側樹上最上面的節點，右鍵單擊“應用程序池”節點並選擇“添加應用程序池...”
11. 在“名稱”文本框中輸入任何名稱。 我跟隨 IBM 並以“IBM Cognos Analytics”的身份進入我的。 保留“.Net CLR 版本”和“託管管道模式”不變，然後單擊“確定”。
12. 展開 IIS 管理器左側的樹，然後右鍵單擊位於“站點”節點下的網站。 我的機器上沒有網站設置，所以我選擇了“默認網站”。 在右鍵菜單中選擇“添加虛擬目錄...”
13. 在別名下，輸入任何名稱。 跟著IBM進了CAGATE11。 然後單擊“物理路徑”下的省略號並導航到 Cognos Analytics 安裝位置的 webcontent 文件夾。 單擊確定。
14. 展開左側樹中的網站節點（在本例中為默認網站），您現在應該會看到一個新文件夾，其中包含您在上一步中選擇的別名。 展開它並突出顯示“bi”文件夾。
15. 雙擊中心面板中的“URL Rewrite”圖標。 這應該會將您帶到“URL Rewrite”面板。 單擊右側面板中的“添加規則...”，然後雙擊“反向代理”。
16. 在“入站規則”部分，您應該會看到一個文本框。 輸入以下內容：“APP_SERVER_HOST”：“PORT”/bi。 確保選中“啟用 SSL 卸載”並單擊“確定”。
17. 在右側面板上單擊“查看服務器變量”。 單擊添加並鍵入以下名稱：HTTP_X_BI_PATH。 注意：此變量名稱不能為任何其他格式。 如上所示鍵入它，然後單擊“確定”。
18. 單擊右側面板上的“返回規則”以退出此部分。
19. 突出顯示您在步驟 16 中創建的入站反向代理項目，然後在右側面板上單擊位於“入站規則”下的“編輯”。
20. 向下滾動，直到看到“服務器變量”部分並將其展開。 然後點擊“添加”按鈕。
21. 在新對話框中，選擇“服務器變量名稱”下拉菜單下的 HTTP_X_BI_PATH。 在 value 下使用您在步驟 13 中選擇的名稱，並按以下格式輸入：/”NAME from step 13″/bi/v1。 所以對我來說，這看起來像 /CAGATE11/bi/v1。 單擊“確定”，然後單擊“操作”部分下的“應用”。 單擊“返回規則”。
現在您已完成設置反向代理。 您需要做的就是通過左側樹的最上方節點重新啟動 IIS，然後單擊右側面板中“操作”下的“重新啟動”。
Cognos ISAPI 設置（SSO 需要，需要上述方法 2）
配置反向代理後，只需再執行一個步驟：設置 SSO 所需的 Cognos ISAPI。 下面的步驟將首先展示如何為 cgi-bin 創建一個 IIS 應用程序，它將 IBM Cognos Analytics 網關模塊映射到在上述方法 2 中創建的應用程序池。 然後，我將向您展示如何通過模塊映射使用 ISAPI 模塊設置 Internet 服務器應用程序編程接口。
需要注意的一件重要事情是 IBM 的文檔在這裡似乎缺少幾個步驟，根據您是在 Cognos 11.0.2 還是 11.0.3 上進行設置而有所不同。 但是您無需擔心，因為我將解釋如何讓這些 Cognos Analytics 版本的每個版本都正常工作。
1. 回到 IIS 管理器，找到您在方法 2 中創建的虛擬目錄（我記得它叫做“CAGATE11”），右鍵單擊它並選擇“添加應用程序”。
2. 使用以下信息填寫字段：
1.別名： cgi bin
2. 應用池： 單擊選擇並在下拉菜單中選擇“IBM Cognos Analytics”並選擇確定。
3. 物理路徑： Cognos Analytics 網關安裝中 cgi-bin 子目錄的位置。 單擊確定。
3. 展開導航樹並突出顯示位於虛擬目錄下的 cgi-bin 節點。 然後在中央面板中雙擊“處理程序映射”。
4. 單擊右側面板上的“添加模塊映射...”並提供以下信息：
1. 請求路徑： 認知api.dll （注意：此值必須與我在此處顯示的完全相同）
2. 模塊： 從下拉列表中選擇 IsapiModule。 （注意：如果您無法找到此值，請參閱本指南的附錄 A）
3. 可執行： 指定您的 cognosisapi.dll 的路徑。 該文件位於 /cgi-bin 下
4。 名稱: 隨便起個名字。 我再次關注 IBM，並給出了我的“IBMCOGNOS-ISAPI”。 單擊確定。
5. 將出現一個對話框，要求獲得允許此新 ISAPI 擴展的權限。 單擊是。
現在這是 IBM 的文檔遺漏了一些東西的地方。 如果您嘗試啟動以下 URL，您可能會遇到錯誤： http(s)://cgi-bin/cognosIsapi.dll?b_action=xts.run&m=portal/main.xts&m_redirect=//bi/
要解決此問題，您需要執行以下步驟：
IBM Cognos 分析 11.0.2
1. 啟動 IBM Cognos 配置。
2. 單擊左側面板上的環境節點。
3. 找到“Dispatcher URIs for gateway”並為它提供以下調度器服務器的值：http://”appserver_host”:”port”/p2pd/servlet/dispatch/ext
4. 在 IBM Cognos 配置窗口中單擊“保存”，您就完成了。 (注意：不要單擊配置窗口頂部的綠色“運行”按鈕，因為這不適用於我們的可選網關設置。）
5. 重新啟動 IIS 並再次測試上面的 URL，如果一切正常，那麼您應該會看到 Analytics 登錄屏幕。
IBM Cognos 分析 11.0.3
1. 啟動 IBM Cognos 配置。
2. 單擊左側面板上的環境節點。
3. 找到“Dispatcher URIs for gateway”並為它提供以下調度器服務器的值：http://”appserver_host”:”port”/p2pd/servlet/dispatch/ext
4. 然後找到“配置服務器”，點擊鉛筆進行編輯。
5. 在新窗口中單擊“檢索”按鈕。
6. 向您的 Content Manager 服務器提供身份驗證信息，然後單擊確定。
- 再次單擊確定以保存新的配置服務器值。
- 在 IBM Cognos 配置窗口中單擊“保存”，您就完成了。 （注意：不要單擊配置窗口頂部的綠色“運行”按鈕，因為這不適用於我們的可選網關設置。）
- 重新啟動 IIS 並再次測試上面的 URL，如果一切正常，那麼您應該會看到 Analytics 登錄屏幕。
結論
在本指南中，我介紹瞭如何在 Cognos Analytics 11.0.2 和 11.0.3 中設置可選網關。 為此，我向您展示瞭如何使用兩種方法之一設置反向代理，然後向您展示瞭如何設置 SSO 所需的 Cognos ISAPI。 我希望你喜歡這個教程！ 請在本博文下方的評論部分留下任何問題。
附錄A
如果在上面的“添加模塊映射”步驟中看不到 ISAPI 模塊，則需要手動添加。 請按照以下步驟執行此操作：
- 在 Windows 中啟動程序和功能。
- 單擊“打開或關閉 Windows 功能”。
- 深入到 Internet 信息服務 > 萬維網服務 > 應用程序和開發功能。 並檢查以下選項：ISAPI 擴展和 ISAPI 過濾器。
- 單擊“確定”。
- 重新啟動 IIS。
- 檢查並驗證 ISAPI 模塊現在是“添加模塊映射”窗口中的一個選項。
