Windchill Business Reporting 後安裝指示

• 您要更新現有 Windchill 安裝以包括 Windchill Business Reporting。如需詳細資訊，請參閱「更新現有安裝」部份。

• 您的 Windchill Business Reporting 與 Windchill 安裝使用不同的 HTTP Server。如需詳細資訊，請參閱「針對不同 HTTP Server 的反向 Proxy 組態」部份。

以下幾節包含您可以執行來確認 Windchill Business Reporting 安裝正確的驗證動作，以及您可以選擇執行的選用手動後安裝步驟 (如果適用於您的網站)。

這些驗證動作包括：

這些選用步驟包括：

若要確認 Windchill Business Reporting 已成功安裝，請導覽至下列 URL：

，其中 <電腦> 是安裝 Windchill Business Reporting 的電腦，<連接埠> 是 Windchill Business Reporting 閘道電腦的 Web 伺服器埠 (如果已接受預設連接埠值 80，則無需在 URL 中指定連接埠)。

使用您為 Windchill 管理使用者 (預設為 wcadmin)或在安裝期間設定的 Windchill Business Reporting 管理使用者 (預設為 wbradmin) 指定的登入。一開始，位於「管理 LDAP」存放庫中的所有使用者都可以登入 Windchill Business Reporting。如果您要以「企業」存放庫中的使用者身分登入，或配置使 Windchill Business Reporting 管理使用者位於「企業」存放庫中，請參閱「新增企業 LDAP 以供認證」部份。

此核對步驟只適用於 Windchill PDMLink、Windchill ProjectLink、完整的 Windchill PDMLink 與 Windchill ProjectLink，以及完整的 Arbortext Content Manager 與 Windchill ProjectLink 安裝。

當您登入 Windchill Business Reporting 之後，應該會存在一個 Windchill 資料夾，其中包含為 Windchill 解決方案載入的現成報告。如果 Windchill Requirements Management、Windchill Aerospace and Defense 或 Windchill MPMLink 已同 Windchill 解決方案一起安裝，Windchill 資料夾中將出現每個產品的現成報告的資料夾。

這些報告也可以從 Windchill 解決方案中的「報告」頁上取得。

如果驗證失敗，或您想在 Cognos 中執行其他組態，請使用 Cognos 組態工具。如果在安裝期間建立捷徑，您也可以選取「Cognos 組態」捷徑來存取工具。否則，請存取下列位置的 Cognos 組態工具：

其中 <WBR_Home> 是安裝 Windchill Business Reporting 的電腦。如需進一步的資訊，請參閱 Cognos 組態工具中提供的文件集。

依預設，Windchill Business Reporting 會使所有 Windchill 網站管理員 (「管理員」群組的成員) 成為 Cognos 中「系統管理員」群組的成員，同時賦予他們所有 Windchill Business Reporting 資料與功能的完整存取權。如果您的網站有選用的 Windchill Business Reporting 模組，則必須將使用者新增至適當的 Windchill 群組，才能存取其他 Windchill Business Reporting 功能：

• Windchill Business Report Author 選用模組 - 使用者必須是 Business Report Author 群組的成員，才能存取 Report Studio 工具。

• Windchill Business Report Monitor 選用模組 - 使用者必須是 Business Report Monitor 群組的成員，才能存取 Report Monitor 工具。

最初，於安裝期間建立的 Windchill 管理使用者 (預設為 wcadmin) 與 Windchill Business Reporting 管理使用者 (預設為 wbradmin) 是這些群組的唯一成員。使用可在「網站」

> 「公用程式」中找到的「參與者管理」公用程式，可將其他使用者新增至這些群組。

如需配置存取控制的詳細資訊，請參閱文件集頁面中的《Cognos Administration and Security Guide》Windchill Business Reporting(Cognos 管理與安全性指南)。此頁可從電腦上的下列位置存取，其上已安裝 Windchill Business Reporting (主機元件或 gateway 伺服器)：

，其中，<WBR_首頁> 是 Windchill Business Reporting 的安裝位置。

可以使用下列一般步驟來配置讓 Windchill Business Reporting 與 SSL 通訊協定合作，使發生的通訊使用 HTTPS 而非 HTTP：

1. 在將 Windchill Business Reporting 配置為使用 SSL 之前，請將 Windchill Web 伺服器配置為使用 SSL。如需詳細資訊，請參閱為 Apache 與 Windchill 配置 HTTPS。

2. 依照文件集頁面中的《Secure Deployment Guide》(安全部署指南) 中的指示來配置讓 Windchill Business Reporting 使用 SSL，如上一節所述。

如「驗證」部份所述來存取 Cognos 組態工具。依照《IBM Cognos Business Intelligence 安裝與組態指南》中的指示操作，適時新增對應至您「企業 LDAP」的 LDAP 或 Active Directory 類型新命名空間資源。您還必須指定下列欄位的值：

當登入 Windchill Business Reporting 時，使用者將看見可從中選擇的可用命名空間的下拉式清單，包括 PSI 配置的原始「管理 LDAP」及新的「企業 LDAP」。欲獲得「企業 LDAP」的登入預設值，請查看設定預設命名空間 (選用)。稍後，您可以選擇移除預設命名空間並回復至下拉式清單。

接下來，配置您的 Web 伺服器，以便在驗證 Windchill Business Reporting 請求時識別「企業 LDAP」。如需安裝在您網站的 Web 伺服器的詳細資訊，請參閱本指南的前幾章。下列幾節包括對每個 Web 伺服器有幫助的特定資訊。

有關支援的軟體版本的特定資訊，請參閱「軟體支援一覽表」(可從 https://www.ptc.com/en/support/refdoc 取得)。

欲配置「HTTP Server」識別可供驗證 Windchill Business Reporting 請求的「企業 LDAP」，請遵循下列步驟：

ant -f webAppConfig.xml addCognosAuthProvider

-DappName=<COGNOS_WEBAPP_NAME>

-DproviderName=<ENTERPRISE_LDAP_NAME>

-DldapUrl=<ENTERPRISE_LDAP_URL>
-DdocBase=<WBR_HOME>

◦ <ENTERPRISE_LDAP_NAME> 是「企業 LDAP」的具唯一性名稱。此值必須符合「Cognos 組態」工具中的「EnterpriseLDAP 節點」值。

◦ <ENTERPRISE_LDAP_URL> 是「企業 LDAP」的完整 URL，包括基本辨別名稱。例如：

如果其中一個引數中有空格或等號 ( = )，您必須用雙引號 ( " ) 將完整引數括起來。

IIS 只能使用單一 LDAP 來驗證 Windchill Business Reporting 請求。如配置 IIS 和 Tomcat 一章中所述，PTC 建議您先使用隨附的 HTTP Server 配置您的系統，再轉換至 IIS。

1. 依照「Windows 上的 HTTP Server」一節中的步驟進行操作，並確認組態正常運作。

2. 依照《Cognos Installation and Configuration Guide》(Cognos 安裝與組態指南) 中包含的指示來針對 Windchill Business Reporting 配置 IIS。

3. 關閉「HTTP Server」，然後啟動 IIS。由於它們不會同時執行，「HTTP Server」與 IIS 都可以使用相同的埠。

您可以透過下列其中一個選項，來選擇當登入 Windchill Business Reporting 時的 Cognos 命名空間選擇行為。

一次只能配置一個選項。如果這兩個選項均未配置，則登入 Windchill Business Reporting 時，會向使用者顯示下拉式清單，提供可供選擇的命名空間。

若要預設使用「企業 LDAP」認證使用者，請使用下列程序設定 Windchill Business Reporting 閘道命名空間。此閘道命名空間是 Windchill Business Reporting 用於認證的預設命名空間，它表示只有指定的命名空間可用於認證。

3. 在「內容」面板中指定「閘道命名空間」屬性，其名稱與您在新增 LDAP 驗證命名空間中建立的新「企業 LDAP」命名空間資源所輸入的「命名空間 ID」相同。

如果將「企業 LDAP」設定為閘道命名空間，則只有「企業 LDAP」中的使用者可以登入 Windchill Business Reporting。這表示來自「管理 LDAP」的使用者 (例如 wcadmin 或 wbradmin) 無法登入 Windchill Business Reporting，但是來自「企業 LDAP」的具有相似權限的使用者可以登入。您稍後可以移除此閘道命名空間，然後於登入 Windchill Business Reporting 時返回顯示給使用者的命名空間下拉清單。

若要讓 Windchill 明確傳遞使用者的 Cognos 命名空間，請使用 xconf 管理員在 db.properties 檔案中設定下列內容：

• wt.cognos.explicitNamespace.enabled - 當此內容設定為 TRUE 時，Windchill 會嘗試決定目前使用者的 Cognos 命名空間，並在從 Windchill 內執行 Windchill Business Reporting 報告時，將該命名空間做為 URL 參數明確傳遞。如果無法決定命名空間，則會顯示標準命名空間下拉式清單，如上所述。將此屬性設定為 FALSE (預設值)，會還原為下拉式清單行為。

• wt.cognos.startup.location - 將此內容值設為 cogstartup.xml Cognos 組態檔案的檔案路徑位置。如果您的 Windchill 解決方案和 WBR Gateway Server 安裝在相同的機器上，則屬性值可設為︰

如果您的 Windchill 解決方案和 WBR Gateway Server 安裝在不同的機器上，則該檔案可能需要複製到可存取的位置，或需要共用該檔案的目錄中，讓檔案可供使用。

如果在安裝期間沒有載入現成報告 (例如，如果您沒有載入基準資料)，或者如果存在您需要載入至 Windchill Business Reporting 的報告更新，則必須在您安裝 Windchill 解決方案的機器上更新資料模型並載入報告。若要執行此操作，請從 Windchill Shell 中執行下列指令集。(必須執行您的 Windchill 解決方案、Windchill Business Reporting、Web 伺服器及 Servlet 引擎，此指令集才能成功執行。)

如果您要更新現有 Windchill 安裝以包含 Windchill Business Reporting，應完成下列手動後安裝步驟：

• 針對 Cognos 建立新資料庫應用程式使用者。如需詳細資訊，請參閱「建立新的 Cognos 資料庫使用者」部份。

在 Windchill PDMLink 上安裝 Cognos 之前，必須先建立新的 Cognos 資料庫使用者。如需詳細資訊，請參閱配置資料庫應用程式使用者，並遵循適用於資料庫的指示。

使用適合您安裝的值，使用 xconfmanager 設定下列屬性：

wt.cognos.namespace=AdministrativeLDAP

wt.cognos.endpointUrl=http://<WBR 主機>:<WBR 埠>/p2pd/servlet/dispatch

wt.cognos.home=<主機上的 WBR 主機元件安裝目錄>

wt.cognos.model.dir.location=$(wt.cognos.model.dir)

wt.cognos.admin.uid=<Windchill 網站管理員使用者>

wt.cognos.admin.password=<Windchill 網站管理員密碼>

wt.cognos.externalUrl=$(wt.webserver.protocol)://$(wt.rmi.server.hostname)
:$(wt.webserver.port)/Cognos/bi/v1/disp

用於 wt.cognos.namespace 內容的值必須符合「Cognos 組態」工具中的「命名空間 ID」值，其預設值為 AdministrativeLDAP。如果已變更「命名空間 ID」值，則 wt.cognos.namespace 內容必須使用該新值。

如果安裝 Windchill Business Reporting 主機與 Windchill Web 伺服器的電腦的作業系統不同，則還必須為 db.properties 設定下列內容：

wt.cognos.model.dir=$(wt.cognos.home)<作業系統特定分隔符號>

$(wt.cognos.model.name)

其中 <OS 特定分隔符號> 針對 Windows 系統是反斜線 ( \ )，針對 Unix 系統是正斜線 ( / )。

如需詳細資訊，請參閱關於 xconfmanager 公用程式。

如果 Windchill Business Reporting 與您的 Windchill 解決方案使用不同的 HTTP Server，則需要反向 Proxy 組態。

在 Windchill Business Reporting 和 Windchill 解決方案成功安裝後，您必須：

2. 配置 Windchill Business Reporting。如需詳細資訊，請參閱正在配置 Windchill Business Reporting。

下列位置的 Windchill 解決方案必須變更：

修改 wt.properties 以包括將 Windchill Business Reporting 安裝為受信任主機的電腦位址：

其中 <電腦_ip_位址><伺服器主機> 是已安裝 Windchill Business Reporting 的電腦的位址。在分散式安裝的案例中，這是已安裝 Windchill Business Reporting 主機元件的電腦。

• 在 HTTPSERVER_HOME/conf/conf.d 中建立包含下列內容的檔案 cognosreverseproxy.conf：

<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
ProxyPass /Cognos <cognos_url>
ProxyPassReverse /Cognos <cognos_url

其中 <cognos_url> 是已安裝 Windchill Business Reporting 主機元件的機器的完全合格 URL。例如：