Windchill Business Reporting 安装后说明
在以下情况下,需要在安装后手动执行一些步骤:
• 更新现有 Windchill 安装以包括 Windchill Business Reporting。有关详细信息,请参阅“更新现有安装”一节。
• Windchill Business Reporting 与 Windchill 安装使用的 PTC HTTP Server 不同。有关详细信息,请参阅“单独的 PTC HTTP Server 的反向代理配置”一节。
以下各部分包括可用来确认 Windchill Business Reporting 的安装是否正确的验证,以及可根据是否适合站点而选择执行的安装后手动操作步骤。
这些验证包括:
• 登录至 Windchill Business Reporting
• 确认存在出厂设置报告
• 访问 Cognos 配置工具
这些可选步骤包括:
• 配置 Windchill Business Reporting 访问控制
• 使用 HTTPS 配置 Windchill Business Reporting
• 添加用于验证的企业 LDAP
• 更新模型并加载报告
验证
登录至 Windchill Business Reporting
要确认 Windchill Business Reporting 是否已成功安装,请导航至以下 URL:
<计算机>:<端口>/Cognos
,其中 <计算机> 是安装 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 解决方案安装 Windchill Requirements Management、Windchill Aerospace and Defense 或 Windchill MPMLink,则每个产品的出厂设置报告的文件夹都会出现在 Windchill 文件夹中。
您也可以在 Windchill 解决方案的“报告”页面中访问这些报告。
访问 Cognos 配置工具
如果验证失败或者您希望在 Cognos 中执行某些附加配置,请使用 Cognos 配置工具。如果在安装期间创建了快捷方式,也可以通过选择“Cognos 配置”快捷方式来访问该工具。除此之外,也可以在以下位置访问 Cognos 配置工具:
• 对于 Windows 32 位系统:<WBR_Home>\bin\cogconfigw.exe
• 对于 Windows 64 位系统:<WBR_Home>\bin64\cogconfigw.exe
• 对于 UNIX:<WBR_Home>/bin64/cogconfig.sh
其中 <WBR_Home> 是安装了 Windchill Business Reporting 的机器。有关详细信息,请参阅 Cognos 配置工具中提供的文档。
配置 Windchill Business Reporting 访问控制
出厂设置 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 (《Cognos 管理与安全指南》),该指南可从 Windchill Business Reporting 文档页面获取。该页面位于安装了 Windchill Business Reporting (主机组件或网关服务器) 的计算机的以下位置:
<WBR_Home>\webcontent\documentation
其中 <WBR_Home> 是 Windchill Business Reporting 的安装位置。
使用 HTTPS 配置 Windchill Business Reporting
您可使用以下常规步骤将 Windchill Business Reporting 配置为使用 SSL 协议,以便使用 HTTPS 而非 HTTP 进行通信:
2. 请遵照文档页面提供的 Windchill Business ReportingSecure Deployment Guide (《安全部署指南》) 中的指示,按上一部分所述将 配置为使用 SSL。
4. 重新启动 Windchill Business Reporting。
添加用于验证的企业 LDAP
添加 LDAP 验证名称空间
请按照验证部分所述,访问 Cognos 配置工具。请遵照 Cognos Installation and Configuration Guide (《Cognos 安装和配置指南》) 中的指示,根据需要添加与您的企业 LDAP 对应的 LDAP 或“活动目录”类型的新名称空间资源。您还必须指定以下字段的值:
• 名称空间 ID (Namespace ID)
• 主机和端口
• 基础可分辨名称 (Base Distinguished Name)
登录
Windchill Business Reporting 后,会显示供用户选取的可用名称空间下拉列表,其中包含由 PSI 配置的原始管理 LDAP 以及新的企业 LDAP。要将登录默认值设置为企业 LDAP,请参阅
设置默认名称空间 (可选)。随后您可以移除默认名称空间,并恢复到下拉列表。
配置您的 Web 服务器
然后,请配置您的 Web 服务器,以便在验证 Windchill Business Reporting 请求时识别企业 LDAP。有关您站点上安装的 Web 服务器的详细信息,请参阅本指南前面的章节。以下几部分包含对各个 Web 服务器非常有用的具体信息。
Windows 上的 PTC HTTP Server
要将 PTC HTTP Server 配置为识别企业 LDAP,以验证 Windchill Business Reporting 请求,请使用以下步骤:
1. 在 Windchill shell 中浏览至安装 PTC HTTP Server 的目录。
2. 在命令行中运行以下命令:
ant -f webAppConfig.xml addCognosAuthProvider
-DappName=<COGNOS_WEBAPP_NAME>
-DproviderName=<ENTERPRISE_LDAP_NAME>
-DldapUrl=<ENTERPRISE_LDAP_URL>
-DdocBase=<WBR_HOME>
其中
◦ <COGNOS_WEBAPP_NAME> 是 Cognos Web 应用程序的名称,默认情况下是 Cognos。
◦ <ENTERPRISE_LDAP_NAME> 是企业 LDAP 的唯一名称。该值必须与 Cognos 配置工具中的“企业 LDAP 节点”值相匹配。
◦ <ENTERPRISE_LDAP_URL> 是企业 LDAP 的完整 URL,包括基础可分辨名称。例如:
ldap://mymachine.mycompany.com:389/cn=EnterpriseLdap,cn=Windchill_10.0,o=myorg
◦ <WBR_Home> 为 Windchill Business Reporting 的安装位置。
如有必要,您可以选择包含 -DbindDn 和 -DbindPwd 元素。
| 如果其中一个自变量的任何位置含有空格或等号 ( = ),则您必须用双引号 ( " ) 将整个自变量括起来。 |
3. 重新启动 PTC HTTP Server。
Internet 信息服务 (IIS)
IIS 只能使用一个 LDAP 来验证
Windchill Business Reporting 请求。根据
“配置 IIS 和 Tomcat”一章中的说明,PTC 建议您在最初配置系统时使用捆绑的
PTC HTTP Server,然后再切换到 IIS。
1. 按照“Windows 上的 PTC HTTP Server”部分中的步骤操作,并确保配置正确工作。
2. 遵照 Cognos Installation and Configuration Guide (《Cognos 安装和配置指南》) 中包含的指示来为 Windchill Business Reporting 配置 IIS。
3. 请关闭 PTC HTTP Server,然后启动 IIS。PTC HTTP Server 和 IIS 可在不同时运行时使用同一个端口。
配置登录时的 Cognos 名称空间选择行为 (可选)
可以配置在登录到 Windchill Business Reporting 时的 Cognos 名称空间选择行为,方法是选择以下选项之一。
或者
一次只能配置上述一个选项。如果这两个选项均未配置,则在登录到 Windchill Business Reporting 时,系统会显示供用户选取的可用名称空间下拉列表。
设置默认名称空间
要默认使用企业 LDAP 验证用户,请使用以下步骤来设置 Windchill Business Reporting 网关名称空间。该网关名称空间是 Windchill Business Reporting 用于验证的默认名称空间,这意味着只能使用指定的名称空间进行验证。
1. 请按照验证部分所述,访问 Cognos 配置工具。
2. 选择“资源管理器”树中的“环境”节点。
3. 在
“特性”面板中,指定
“网关名称空间”特性的值,使其与您输入的新企业 LDAP 名称空间资源 (在
添加 LDAP 验证名称空间中创建) 的名称空间 ID 值相同。
| 如果将企业 LDAP 设置为网关名称空间,则只有企业 LDAP 的用户才能登录 Windchill Business Reporting。这表示管理 LDAP 的用户 (例如 wcadmin 或 wbradmin) 无法登录到 Windchill Business Reporting,但是具有类似权限的企业 LDAP 的用户可以登录。随后可移除此网关名称空间,然后返回至登录到 Windchill Business Reporting 时为用户提供的名称空间下拉列表。 |
使 Windchill 传递用户的 Cognos 名称空间
要使 Windchill 能够显式地传递用户的 Cognos 名称空间,请使用 xconf 管理器在 wt.properties 文件中设置以下特性:
• wt.cognos.explicitNamespace.enabled - 当此特性设置为 TRUE 时,Windchill 会尝试确定当前用户的 Cognos 名称空间,并在 Windchill 中执行 Windchill Business Reporting 报告时,将此名称空间作为 URL 参数显式传递。如果无法确定名称空间,则会显示一个标准名称空间下拉列表,如上所述。将此特性设置为 FALSE (默认值) 会恢复到下拉列表行为。
• wt.cognos.startup.location - 将此特性值设置为 cogstartup.xml Cognos 配置文件的路径位置。如果 Windchill 解决方案和“WBR 网关服务器”安装在同一台计算机上,则可将此特性值设置为:
$wt.cognos.home\\configuration\\cogstartup.xml
如果 Windchill 解决方案和“WBR 网关服务器”安装在不同的计算机上,则可能需要将文件复制到可访问位置,或者可能需要将文件所在的目录共享以访问文件。
更新模型并加载报告
如果安装过程中未加载出厂设置报告 (例如,如果未加载基础数据),或者对您需要加载到 Windchill Business Reporting 的报告进行了更新,则必须更新数据模型并在安装 Windchill 解决方案的计算机上加载报告。要完成该操作,请在 Windchill shell 中运行以下脚本。(要成功运行此脚本,必须运行 Windchill 解决方案、Windchill Business Reporting、Web 服务器和 servlet 引擎。)
ant -f <wt_home>/installer/wnc/wbr_actions.xml
更新现有安装
如果正在更新现有 Windchill 安装,以使其包含 Windchill Business Reporting,则应完成以下手动执行的安装后步骤:
• 为 Cognos 创建新的数据库应用程序用户。有关详细信息,请参阅“创建新的 Cognos 数据库用户”一节。
• 使用 xconfmanager 设置特性。有关详细信息,请参阅“设置特性”一节。
• 按照前一节“更新模型并加载报告”所述,运行 wbr_actions.xml 脚本。
创建新的 Cognos 数据库用户
在
Windchill PDMLink 的顶部安装 Cognos 之前必须创建新的 Cognos 数据库用户。有关详细信息,请参阅
配置数据库应用程序用户,并遵守适用于您的数据库的说明。
设置特性
使用 xconfmanager 设置以下特性,并采用适合具体安装的值:
• 对于 wt.properties:
wt.reporting.thirdParty.enabled=true
wt.auth.trustedHosts=<WBR host> <WBR gateway> localhost
• 对于 db.properties:
wt.cognos.namespace=AdministrativeLDAP
wt.cognos.endpointUrl=http://<WBR host>:<WBR port>/p2pd/servlet/dispatch
wt.cognos.home=<WBR host components installation directory on host machine>
wt.cognos.model.dir.location=$(wt.cognos.model.dir)
wt.cognos.admin.uid=<Windchill site administrator user>
wt.cognos.admin.password=<Windchill site administrator password>
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)<OS specific separator> $(wt.cognos.model.name) 其中,<OS specific separator> 对于 Windows 系统为反斜杠 ( \ ),对于 Unix 系统为正斜杠 ( / )。 |
单独的 PTC HTTP Server 的反向代理配置
如果 Windchill Business Reporting 和 Windchill 解决方案使用不同的 PTC HTTP Server,则需要反向代理配置。
成功安装 Windchill Business Reporting 和 Windchill 解决方案后,必须:
| Windchill 解决方案和 Windchill Business Reporting 必须使用相同的 LDAP。 |
配置 Windchill
必须对以下位置的 Windchill 解决方案进行更改:
• wt.properties 文件
将 wt.properties 修改为包含将 Windchill Business Reporting 作为受信任主机安装的计算机的地址:
wt.auth.trustedHosts=<machine_ip_addr> <serverhost>
其中 <machine_ip_addr><serverhost> 是安装 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。例如:
http://server1.mycompany.com/Cognos
• PTC HTTP Serveradditions.conf