配置远程文件服务器
要执行内容复制,必须对主站点和文件服务器站点完成下列步骤。
以下是用于主站点和文件服务器的主要安装后步骤:有关其中任何步骤的详细过程,请参阅下面各对应部分。
1. 执行以下操作之一:
◦ 选项 A - 向主站点注册文件服务器。
◦ 选项 B - 在主站点上创建远程站点表示。
2. 创建远程主机、电子仓库和文件夹。
3. 安装并启用文件夹。
4. 启动远程站点。
执行这些步骤时,会显示故障排除部分,帮助您解决配置错误。
步骤 1,选项 A:向主站点注册文件服务器
使用
“文件服务器管理”实用程序 (位于 > > 中) 注册文件服务器。有关详细信息,请参阅
向主站点注册新文件服务器。
步骤 1,选项 B:在主站点上创建远程站点表示
1. 在主站点上,选择 > > (可通过
“站点”、
“存储库”和
“产品”访问)。
“站点管理”窗口随即出现。
| 标签 (本次安装) 会出现在您当前所连接站点的“站点管理”窗口中的站点名称之后。系统软件确保标记为 (本次安装) 的自动生成站点可在 wt.properties 文件中 wt.httpgw.url.anonymous 特性的值发生更改时继续充当其角色。该自动生成的站点的 URL 是 wt.properties 文件中的 wt.httpgw.url.anonymous 特性的值。如果该特性的值发生更改,系统将为其分配新的 URL,并在主站点控制台上显示一则警告消息。可以单击“更新”来配置此站点。 |
2. 在“站点管理”窗口中单击“新建”。“新建站点”窗口随即打开。
3. 请输入以下信息:
字段 | 说明 |
---|
站点名称 | 站点名称必须唯一。该字符串不区分大小写,且不能包括空格。文件服务器站点在所有主站点中都必须具有相同的名称。 标签 (本次安装) 会出现在您当前所连接站点的“站点管理”窗口中的站点名称之后。 |
URL | 输入 URL。该 URL 必须能够让主站点访问文件服务器站点。 URL 是您正在创建的站点的 wt.properties 文件中 wt.httpgw.url.anonymous 特性的值。该 URL 也是 Windchill 站点的匿名网关的 URL。如果该 URL 与您当前连接的 Windchill 站点的 URL 相同,标签 (本次安装) 会出现在“站点管理”窗口中的站点名称之后。 |
“站点类型” | 选择“文件服务器”复选框。 “主站点”和“文件服务器”选项决定了该站点进行复制时所使用的角色。您可以选择一个选项或两个都选,也可以两个都不选。 |
“上下文” | 单击“选择”可访问“选取上下文”窗口,该窗口将列出所有可能的上下文。选择一个上下文,然后单击“确定”。 | 该字段仅限站点和组织级别。上下文一旦选定,便无法进行更新。 |
|
“说明” | 输入站点的说明。最多可使用 200 个字符。 |
“承担者” | 单击“选择”可访问“选择承担者”窗口。使用“组”和“用户”选项卡上的字段选择新站点的承担者。 |
站点近似度 | 可以将站点移动到当前创建或更新的站点的邻近站点序列中。 左框包含一个所有站点的列表。您可以使用 >> 和 << 将左侧框中的站点移至右侧框中。右侧框会指示其他站点与新站点的近似度。列表顶部的站点与新站点的近似度最高。可以使用“上移”、“下移”、“移到顶部”和“移到底部”来在列表中将站点向上或向下移动。 |
4. 单击“确定”。
| 新站点会显示在“站点管理”窗口的“站点列表”表中。 |
如果需要更新现有站点,请在“站点管理”窗口中选择相应的站点,然后单击“更新”。
步骤 2:创建远程主机、电子仓库和文件夹
针对复制操作创建主机、电子仓库和文件夹。必须先创建主机,然后是电子仓库,最后是文件夹。
在创建和安装文件夹之前,必须在远程站点上手动创建文件夹。主站点必须能够对该文件夹执行读取和写入操作。开始此步骤之前,必须为每个文件电子仓库 (按照以下步骤) 创建至少一个文件夹。现在创建该文件夹。
| 每个文件夹必须安装到唯一的物理位置。否则,会出现永久的数据丢失情况。 |
请通过
“电子仓库配置”窗口创建远程主机、电子仓库和文件夹。要访问此窗口,请选择 > > (可从
“站点”、
“存储库”和
“产品”中选择)。
创建远程主机
创建一个主机将使站点与网络中的一个主机关联。
主机是网络中运行 Windchill 方法服务器的计算机,可用于存储内容文件。由于方法服务器可能在不同的主机上运行,因此每个文件夹应该对每个主机有一个不同的安装。如果不这样做,路径就可能不相同。但是,一个文件夹对应的所有安装位置应该相同。
| 系统不检验您为主机输入的 DNS 名称是否为有效的 DNS 名称。 |
要创建主机:
1. 从“电子仓库配置”窗口中选择 > > 。将打开“新建主机”窗口。
2. 在“主机名”字段中输入主机唯一的 DNS 名称。(名称中不能包含空白值。)可用下面两种方法中的一种来确定主机名称:
◦ 在 ServerManager 或 MethodServer 日志中查阅以下行:
ServerManager log
<DATE> INFO [main] wt.server.manager.startup - java.rmi.server.hostname:
<Host Name>
MethodServer log:
<DATE> INFO [main] wt.method.server.startup - java.rmi.server.hostname:
<Host Name>
◦ 执行以下命令以检索 java.rmi.server.hostname 值:
windchill wt.util.jmx.WTPropEval java.rmi.server.hostname
3. 从“站点”列表中选择远程站点。
4. 单击“确定”。
创建远程电子仓库
电子仓库是文件夹的逻辑上下文,其中的每个文件夹都代表主机上的一个存储位置。远程电子仓库是文件服务器而非主站点上的电子仓库。PTC 建议对每个远程服务器创建一个电子仓库以用于内容复制。
| 最好在“文件服务器”站点上创建缓存电子仓库,因为远程用户可以更快速地将内容上载至此电子仓库。但是,Windchill 文件服务器上存在缓存电子仓库并不是将内容复制到该站点的必要条件。 |
要创建远程电子仓库:
1. 从“电子仓库配置”窗口中选择 > > 。将打开“新建电子仓库”窗口。
2. 请输入以下信息:
字段 | 说明 |
---|
“站点” | 从列表中选择文件服务器。 |
“名称” | 输入电子仓库名称。您指定的名称在为所有站点定义的电子仓库中必须唯一。 |
“电子仓库类型” | 请选择下列任一选项: • “主要电子仓库”- 存储内容文件的 (已重新存储) 主副本。 • “副本电子仓库”- 存储复制的内容文件。 • “缓存电子仓库”- 存储上载文件,直到它们重新存储到永久存储位置。如果选择此电子仓库类型,电子仓库将用作站点的本地缓存电子仓库。每个站点仅允许使用一个缓存电子仓库。 • 主站点和文件服务器站点均支持全部电子仓库类型。 |
“默认系统目标”(针对主要电子仓库) 或“站点的默认目标”(针对副本或缓存电子仓库) | 可以选择此复选框,但无法直接将其清除。由于必须始终存在默认站点目标 (针对副本或缓存电子仓库) 或存在默认系统目标 (针对主要电子仓库),因此,当指定另一个电子仓库作为默认目标时,系统会自动清除此复选框。 每个站点必须具有一个作为其默认目标的电子仓库。 仅主站点可以具有默认系统目标电子仓库。 当指定主要电子仓库作为默认系统目标,且 wt.fv.useVaultsForAllContent 特性为 true 时,该电子仓库将成为对未被重新存储规则所覆盖的内容执行重新存储操作的目标。 若指定副本或缓存电子仓库作为站点的默认目标,则在尚未明确指定目标电子仓库时,电子仓库会成为复制操作的目标。 |
“只读” | 不要选择此复选框。如果选择,则电子仓库将不可用于存储上载的或复制的内容文件。 |
“文件夹自动创建” | 保持此复选框处于选择状态。若选择此复选框,将在现有文件夹达到其容量 (文件数量) 时自动创建一个文件夹。默认情况下,此复选框被选定。 |
“自动清理更旧的内容” | 如果适用,请选择此复选框。选择此复选框时,将根据“自动清理副本电子仓库”窗口中指定的规则和排程对该电子仓库执行自动清理。 |
3. 单击“确定”。
| 只能为每个 Windchill 文件服务器创建一个缓存电子仓库,用于复制。 |
创建远程文件夹
创建一个文件夹将会建立一个存储位置,并将该位置与电子仓库关联。
| 建议在“文件服务器”站点上创建缓存电子仓库,因为远程用户可以更快速地将内容上载到此电子仓库。但是,Windchill 文件服务器上存在缓存电子仓库并不是将内容复制到该站点的必要条件。 |
要创建文件夹:
1. 从“电子仓库配置”窗口中选择 > > 。“新建文件夹”窗口随即打开。
2. 在“名称”字段中输入文件夹的唯一名称。
3. 从“电子仓库”列表中选择电子仓库。
| 不要选择“只读”复选框。如果选择,则文件夹将不可用于存储上载的或复制的内容文件。 |
4. 单击“确定”。
步骤 3:安装并启用文件夹
定义了站点的电子仓库和文件夹并指定了站点主机之后,必须指定内容将被复制到的存储分区位置。您可通过为站点的文件夹和主机的各种组合定义安装来完成此操作。
要安装文件夹:
1. 在“电子仓库配置”窗口的左侧窗格中,展开包含文件夹的文件柜,然后选择该文件夹。
2. 选择 > 。将打开“新建安装”窗口。
3. 从“主机”列表中选择一个主机。
4. 在“路径”字段中指定文件夹路径的路径。
5. 单击“确定”。
6. 选择相应的文件夹,然后选择 > 。将打开“更新文件夹”窗口。
7. 选择“已启用”复选框,然后单击“确定”。
步骤 4:启动远程站点
启动远程站点服务器的方式与启动标准 Windchill 服务器相似。
要启动远程站点:
1. 在远程站点计算机上启动 Web 服务器、servlet 引擎和方法服务器。
2. 按下列方式之一启动 Windchill:
◦ 使用 MS-DOS 命令提示符,在 <Windchill>/bin 目录中输入下列命令:
windchill start
◦ 在 Windows“开始”菜单中,选择 > > 。
排除配置故障
本节介绍了 wt.properties 文件中与 Windchill 内容复制相关的特性和服务。如果副本配置中含有错误,则由服务创建的日志文件将提供故障排除信息。这些日志文件将显示主站点和远程站点之间的所有交互操作。对于某些错误,日志文件中将列出解决问题的建议。
要检查配置:
1. 使用 Log4j 配置,对主站点上的 wt.fv 和 wt.fv.master 包以及远程站点上的 wt.fv.replica 包启用详细日志记录。
2. 确保副本文件夹不是“只读”,且已启用它们。
3. 重新启动远程站点的方法服务器。
启动后,紧接着应该会看到,日志文件中有一行用来通知远程站点已从主站点请求配置。接下去的几行是响应消息,说明接收的配置。验证此配置是否有效。
4. 重新启动主站点的方法服务器。
启动后,紧接着应该会看到,日志文件中有一行用来通知主站点已尝试刷新远程站点的配置。检查远程站点 MethodServer.log 文件以验证配置是否已被接收。
手动配置服务
在“文件服务器”远程站点中,远程 Windchill 站点无权访问 Oracle 实例,并将运行最小的一组服务。只有内容复制所需的服务才会被启动。
只会配置与复制有关的 5 项服务,而不是通常的 67 项或更多项服务。验证服务部分是否包含以下内容:
wt.services.service.1=wt.fv.replica.ReplicaService/wt.fv.replica.StandardReplicaService
wt.services.service.2=wt.fv.replica.ReplicaServiceSvr/wt.fv.replica.StandardReplicaService
wt.services.service.3=wt.wrmf.delivery.ShippingService/wt.wrmf.delivery.StandardShippingService
wt.services.service.4=wt.wrmf.delivery.ReceiverService/wt.wrmf.delivery.StandardReceiverService
wt.services.service.5=wt.wrmf.transport.GenericTransportService/wt.wrmf.transport.StandardGenericTransportService
此时方法服务器和服务器管理器应当启动成功。通常在启动方法服务器时显示的 POM 消息将不再显示,并且使用服务器管理器进行注册相对完整 Windchill 安装而言将明显加快。
未启用 PSI 时启用远程文件服务器支持
如果在主站点安装过程中未在 PSI 中选择“启用远程文件服务器支持”,则可以使用以下部分中提供的信息启用该选项。
手动创建安装程序捆绑 Zip 文件 (CCsInstallerBndle.zip)
必须采用以下步骤手动创建包含用于副本安装的安装程序的捆绑 ZIP 文件:
1. 在以下位置找到创建安装程序 ZIP 和 MD5 文件所需的脚本:
<Windchill>/bin/CCSTools/createZip.xml
该脚本必须按照以下格式从各 CD 图像的 <Windchill>/bin/CCSTools 运行:
ant -f createZip.xml -Dpsi_loadpoint.dir=<val> -Dsource_image.dir=<val>
其中,<val> 为包含 PSI 单独管理的规则文件的 psi_loadpoint 目录。
例如:
D:\ptc\PJL\Windchill\bin\CCSTools\>ant -f createZip.xml -Dpsi_loadpoint.dir=D:\ptc\PJL\PSI -Dsource_image.dir=E:\CD_JavaSDK
结果应为位于每个 CD 的 <Windchill>/CCSTools/install 中的 <安装程序名称>.zip 和 <安装程序名称>.zip.MD5 文件。
2. 使用该脚本创建以下子安装程序的 ZIP 和 MD5 校验和。这些子安装程序的 zip 和 MD5 文件必须位于以下位置的 ZIP 存储库中:
(<Windchill>/CCSTools/install
◦ Web 服务器
◦ Servlet 引擎
◦ Info*Engine 服务器
◦ Windchill Services
◦ PTC 解决方案安装程序
| Apache 和 Tomcat 在解压缩时必须共享一个公用目录,例如 CD_CAPPS/Apache and CD_CAPPS/Tomcat。要确保保留此结构,必须将 Apache 和 Tomcat 逐一复制到单独的 CD_CAPPS 文件夹中,并且在调用 createZip.xml 时必须引用此文件夹。 |
3. 将上述创建的安装程序 zip 聚合到主捆绑包 zip 文件中,并将该文件命名为 CCsInstallerBndle.zip。要创建此 zip,请运行以下命令:
ant -f createZip.xml bundleInstallerZips
结果应为位于 <Windchill>/CCSTools/install 中的 CCsInstallerBndle.zip 文件。
手动生成 CCSDsu.zip 文件 (如有必要)
如果在解决方案的初始安装过程中未选择“启用远程文件服务器支持”,则应用维护更新之后将不存在此 ZIP 文件,所以必须手动生成该文件。
用于处理此任务的 ANT 脚本保存在以下位置中:<Windchill>/bin/CCSTools/create_ccsdsu.xml。此脚本将根据 BOM (物料清单) 创建 CcsDsu.zip。它会维护一个累积 BOM (<Windchill>/CCSTools/CcsDsuBom.include),将通过该 BOM 合并所有将来的 BOM。
要生成该 ZIP 文件,请从 Windchill 外壳程序运行以下命令:
ant -f <Windchill>/bin/CCSTools/create_ccsdsu.xml
-Dinstall.files.maint=true <params>
其中 <params> 是:
• -Dccsdsubom_include (可选) - 含有关于 <Windchill> 的内容的任何替代 BOM 文件。
这指向要追加到 CcsDsu.zip 的内容的 BOM。
• -Dccsdsu_exclude_list (可选) - 包含要从 DSU 中排除的任何文件的基于表达式的常规列表。默认为 <wt_home>/installer/wnc/ccsdsu_regex_exclude_list.txt)。
该脚本可运行和生成 CcsDsu.zip 及相应的 MD5 校验和文件 (位于 <Windchill>/CCSTools/update 目录下)。
此 CcsDsu.zip 会下载到远程“文件服务器”。请确保将该 ZIP 文件放置在主站点所在位置:<Windchill>/CCSTools/update。
在“文件服务器”上重新启动 Windchill 时,将应用该 CcsDsu.zip。
| 将某更新 (修补程序或维护版本) 应用于安装有群集的主站点时,系统会将此修补程序分别应用于群集中的各个节点。但是,为了使 CCS (文件服务器) 自动更新能够正常工作,必须将群集主节点 (后台方法服务器) 的 <Windchill>/CCSTools/update 目录下的文件复制到群集中各个节点的 <Windchill>/CCSTools/update 目录下。这是必要的步骤,以确保该 CCSDsu.zip 文件与其在所有节点上的 CCSDsu.zip.MD5 文件完全相同。 |
使用 CcsInstallerBundle.zip 和 CcsDsu.zip 安装新的文件服务器
| Windchill 10.2 之前的版本中不存在 CcsInstallerBundle.zip。 |
要使用 CcsInstallerBundle.zip 和 CcsDsu.zip 安装新的文件服务器,请采用以下步骤:
1. 下载 CcsInstallerBundle.zip。
2. 下载 CcsInstallerBundle.zip 后,将其解压缩至公共位置,然后运行已解压缩的 PTCSolnInstaller 映像文件。
3. 要在 Windows 中解压缩,可以使用 WinZip (或类似的应用程序) 或者 Windows 内置的 .zip 功能。
对于 UNIX,可使用 unzip <文件名>。可能需要安装解压缩功能。
4. 启动 PSI 时,请选择“解决方案”这种方案,选取“文件服务器”作为安装选项,然后将暂存区域指向包含所有已解压缩的图像的位置。
使用 PSI 安装文件服务器后,需要应用 CcsDsu.zip 文件。
更新文件服务器
对主站点应用维护版本或修补程序时,需要对远程文件服务器进行维护更新。更新由名为 CcsDsu.zip 的文件提供,该文件包含维护版本所需的所有更新。如果在安装解决方案时选择了“启用远程文件服务器支持”,则在应用维护更新时会在主站点上生成此 ZIP 文件。要更新文件服务器,必须:
• 使用 CCsInstallerBundle.zip 更新文件服务器上的现有独立产品
• 使用 CcsDsu.zip 更新文件服务器上的非独立产品
使用 CCsInstallerBundle.zip 更新文件服务器上的现有独立产品
要使用 CCsInstallerBundle.zip 更新文件服务器上的现有独立产品,请使用以下流程:
1. 关闭文件服务器上的方法服务器、服务器管理器和 Web 服务器。
2. 对主站点应用更新并进行重新启动后,通过 > > 访问 Windchill 页面内的“文件服务器管理”内容,并对这些内容进行检查,以查看独立产品是否已更新 (验证其更新日期)。
3. 如果独立产品已更新,则从主服务器下载 CCsInstallerBndle.zip 主捆绑包 zip 文件,并将其解压缩至暂存区域。
4. 运行位于暂存区域中的 PSI 并选择“更新现有安装”。
5. 选择要更新的文件服务器实例。
6. 提供 PSI 的暂存区域位置以安装独立产品更新。
7. 单击“下一步”,直到您到达用于运行安装的最后一个面板的终点。
使用 CcsDsu.zip 更新文件服务器上的非独立产品
要使用 CcsDsu.zip 更新文件服务器上的非独立产品,请使用以下流程:
| 如果已经完成了主站点的更新,且 wt.properties 文件中的 autoManageCCS 特性已设置为 true,则广播文件服务器配置,以使 CcsDsu.zip 文件自动下载到文件服务器的以下位置:<Windchill>/CCSTools/update。 如果 autoManageCCS 特性设置为 false,则必须通过“文件服务器管理”实用程序 (位于 > > 下) 手动从 <Windchill>/CCSTools/update 下载 CcsDsu.zip 文件。 |
使用 CcsDsu.zip 自动更新文件服务器上的非独立产品
如果将系统设置为在用维护版本或修补程序更新主站点时自动更新现有的文件服务器安装,则在主站点上的站点管理器准备好相关信息和文件、在站点上执行完更新并重新启动该站点之后,就会开始以下过程:
1. 主站点通知文件服务器需要更新。
2. 站点设置为“只读”状态。
3. 主站点将文件服务器的状况修饰符设置为“正在更新”状况。
4. 每个文件服务器自身识别是否需要更新。
5. 主站点向文件服务器推送更新。
6. 状况修饰符更改为“需要重新启动”状况。
7. 系统将通知发送给适当的管理员,并请他们执行重新启动。
8. 如果独立产品的已更新版本和 PSI 可用,则必须先使用 PSI 更新文件服务器上现有的独立产品,然后再重新启动文件服务器上的 Windchill 以应用更新。
9. 将执行重新启动。
10. 文件服务器在重新启动期间对自身进行更新。
11. 主站点会执行以下操作:
◦ 验证文件服务器的版本级别
◦ 移除文件服务器的“需要重新启动”状况修饰符
◦ 从站点移除只读状态
手动更新现有文件服务器安装上的非独立产品
如果未将系统设置为在用维护版本或修补程序更新主站点时自动更新现有的文件服务器安装,则必须手动更新各个文件服务器站点:
1. 关闭所有与 Windchill 相关的服务器应用程序,包括方法服务器、Web 服务器、servlet 引擎和服务器管理器,并退出所有 Windchill 外壳程序。
2. 如果独立产品的已更新版本和 PSI 可用,则在执行 install_ccsdsu.xml 文件前必须使用 PSI 更新文件服务器上现有的独立产品。
3. 打开系统控制台并导航至 <Windchill>/bin/CCSTools 目录。
4. 确保 Windchill Directory Server 正在运行。
5. 使用 ANT,执行脚本文件 install_ccsdsu.xml,方法如下:
ant -f install_ccsdsu.xml
| 如果首次尝试执行 ant -f install_ccsdsu.xml 失败,请再次运行以成功完成更新过程。 |
6. 执行完成后,启动 Windchill。