使用組態檔部署自訂
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.conf.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>