使用配置文件部署自定义
您能够通过 Servigistics InService 使用 XML 配置文件 custom.conf.xml 部署任何自定义。使用预定义配置文件部署自定义的目的是自动移动、复制或删除文件,并在多个环境 (开发、测试、生产等) 中应用相同配置。这样便于在各个环境中手动应用这些操作,并降低在此期间出错的可能性。
如果要以编程方式将一组自定义文件从一个环境移动到另一个环境,则建议您使用 custom.conf.xml 文件部署自定义。例如,在已升级的环境中应用相同的自定义,或者从一个环境移动到另一个环境 (例如,从开发到测试,或从测试到生产) 时。
您可以在安装或更新 Servigistics InService 时部署自定义。在部署自定义时,请确保配置文件中包含的任何配置均不会覆盖默认配置。
|
|
• 您仅能通过使用配置文件部署自定义的此设置过程,来替换自定义规范中要求将文件从一个位置复制到另一个位置的任何步骤。对于其他操作 (例如编译文件或安装后步骤),必须遵循要求的步骤,即使在使用此设置选项时也是如此。
• 由于无法恢复更改内容,因此您必须对所有目录或文件进行备份,然后再对其进行自定义。
|
可以在下列情况下部署自定义:
• 第一次安装 Servigistics InService:
• 升级或更新的当前 Servigistics InService 安装:
• 在不更新 Servigistics InService 的情况下部署自定义。如果不进行升级而进行自定义,则必须使用已经部署的安装包。
还可以在下列情况下部署自定义:
• 离线安装 Servigistics InService
• 在静默安装期间
有关安装或更新
Servigistics InService 的详细信息,请参阅
配置 Servigistics InService 静默安装。
对于离线安装,您必须遵循与静默安装相同的过程,不同之处在于您无法从用户界面将其禁用。也就是说,在离线安装过程中,配置文件中 OEM 指定的自定义说明始终具有优先级。
示例配置文件
<Installation_Home>\media\PTC_Servigistics_InService_Delivery_Base\Setup\Base\SystemCommon\Home\CONFIG\System\Config 中提供了一个示例配置文件 custom.conf.xml.example,其中 <Installation_Home> 是您从 Servigistics InService 中提取文件的目录。
| 默认情况下,文件名为 custom.conf.xml.example。但是,使用此文件部署自定义时,必须将其重命名为 custom.conf.xml。 |
默认情况下,custom.conf.xml.example 文件包括以下代码:
<?xml version="1.0"?>
<customization customizationVersion="7.501">
<file op="copy" from="web.xml" to="{bin.home}\\Applications\\Windchill.ear\\Deployment.war\\WEB-INF"> </file>
<file op="copy" from="testFile.txt" to="{bin.home}\\Applications"> </file>
<file op="copy" from="testDirectory" to="{bin.home}\\Applications"> </file>
<file op="delete" from="{bin.home}\\Applications\\testFile.txt"> </file>
</customization>
| {bin.home} 表示关于 <INS_HOME>\\InS_SW 目录的路径,其中 <INS_HOME> 是您安装 Servigistics InService 的目录。 |
配置示例配置文件
必须在 custom.conf.xml.example 文件中配置下列内容,以指定用于部署自定义的最新版本和自定义文件:
• 将 customization 元素的 customizationVersion 属性中的版本值更改为晚于当前安装的版本的数值。如果不进行版本升级,则无法完成自定义部署过程。
• 指定一个具有 copy 或 delete 操作的 file 元素的顺序列表以应用于自定义文件。有关使用文件操作的详细信息,请参阅 指定自定义文件操作。
当您指定 custom.conf.xml.example 文件中的 file 元素时,请注意以下几点:
◦ 对于 Windows 设置,请使用双反斜杠 \\ 分隔源位置或目标位置路径的组件。
◦ 对于 Linux 设置,请使用斜杠 / 来分隔源位置或目标位置路径的组件。
◦ 不包括任何空元素。
配置 custom.con.xml.example 文件后,必须将其保存为同一目录中的 custom.conf.xml 文件。
| 若为首次部署自定义,则可以使用 custom.conf.xml.example 文件中指定的默认 customizationVersion 属性值。但是,若要再次修改自定义,则必须将自定义版本更新到更高的值。例如,自定义版本的默认值为 7.501。当再次修改自定义时,则必须将上述值更改为 7.502 或更高的值。 |
指定自定义文件操作
为 custom.conf.xml.example 文件 file 元素中的自定义文件指定下列操作之一:
• copy:将指定的自定义文件从源位置复制到目标位置,并在每个位置保留文件的副本。源位置和目标位置在 file 元素的 from 和 to 属性中指定。
例如,可以将此配置文件条目包含于 custom.conf.xml.example 文件中,以将 web.xml 文件从源位置复制到目标位置,如以下列表所示:
◦ 文件名:web.xml
◦ 源位置:PTC_Servigistics_InService_Delivery_Base\Setup\Base\SystemCommon\Home\CONFIG\System\Config\CustomizationFiles
◦ 目标位置:<INS_HOME>\\InS_SW\\SW\\Applications\\Windchill.ear\\Deployment.war\\WEB-INF
◦ 配置文件条目:<file op="copy" from="web.xml" to="<INS_HOME>\\InS_SW\\SW\\Applications\\Windchill.ear\\Deployment.war\\WEB-INF"> </file>
| 在此示例中,web.xml 文件放于与 custom.conf.xml.example 文件相同的位置。因此,仅文件名在 file 元素的 to 属性中指定。 |
• delete:安装 Servigistics InService 后,从目标位置删除指定的自定义文件。目标位置在 file 元素的 to 属性中指定。
例如,将此配置条目包括在 custom.conf.xml.example 文件中,以从目标位置删除 testFile.txt 文件,如以下列表所示:
◦ 文件名:testFile.txt
◦ 目标位置:<INS_HOME>\\InS_SW\\SW\\Applications
◦ 配置文件条目:<file op="delete" from="<INS_HOME>\\InS_SW\\SW\\Applications\\testFile.txt"> </file>