更新為新維護版
Windchill PDM Essentials 會使用 PTC Solution Installer (PSI),而不是
「Windchill 安裝助理」 (僅用於全新安裝或作為升級至新發行版本的一部份),來以與
Windchill PDMLink 相同的方式更新。如果要將平台維護版更新套用至
Windchill PDM Essentials 的部署,您必須由 PTC 支援網站 (
http://www.ptc.com/support/support.htm) 上的
Windchill PDM Essentials 下載檔案部份下載
Windchill Service Pack。
下載完所需的圖像之後,請遵循下列步驟來套用維護版更新:
|
在生產環境中部署 Windchill 產品之前,PTC 建議您先使用測試 (預先生產) 系統來確保產品可發揮預期的功能。如此一來您即可在測試系統上識別任何潛在的問題,而不使生產系統活動受到干擾。在測試系統上安裝好維護版且對結果感到滿意之後,便可在生產系統中重複維護版安裝流程。由於您已在測試系統上完成許多工作,因此,在生產系統上安裝維護版所需花費的時間應該較少。
如果您選擇直接更新生產伺服器,請務必備份伺服器與資料庫或拍攝快照 (如果您已在虛擬環境中部署)。如果更新發生問題,這可讓您還原系統。如需備份詳細資訊,請參閱下述的步驟三。
|
更新之前,請確定是否將您的來源系統設定為使用單純數字 (也稱為 Harvard 序列) 版本配置。任何現有文件或 CAD 文件都擁有版本與版序位置。如果文件與 CAD 文件的版本顯示為 1.1, 1.2,....2.1, 2.2,... 等,則表示版本配置是單純數字 (Harvard 序列)。如果您的系統使用單純數字 (Harvard 序列) 版本配置,請先記下再開始;更新流程需要額外步驟。如需詳細資訊,請參閱單純數字 (Harvard 序列) 版本配置的後更新步驟。
1. 在目標系統針對您下載的圖像建立暫置目錄。將媒體檔案置於新的暫置目錄中:
a. 按一下「複製到暫存」。
b. 按一下「瀏覽」,導覽至包含 CD zip 檔案的目錄或插入產品 CD 的光碟機。
c. 按一下「確定」。
|
暫置目錄是您在開始安裝之前,複製產品媒體的目錄。這可以讓 PTC Solution Installer 存取每個 CD 圖像,而無須在安裝期間停止來進行提示。
使用暫置區可為您提供更快的安裝體驗,而且在安裝期間無須插入媒體。
|
2. 若在您的網站實行 Windchill 涉及修改由 PTC 提供的檔案,請您務必了解維護安裝程序可能會覆寫任何由 PTC 提供的檔案 (site.xconf 檔案除外)。這也包括您可能已加以修改的檔案。
如果您已進行網站修改且要更新至維護版或升級版,PTC 建議您依照在「說明中心」的
設定目錄結構以管理自訂檔案與自訂文字主題中的這些最佳作法。您尤其應確保所有網站修改檔案都位於
<Windchill>/wtSafeArea/siteMod 目錄中。
您可利用測試系統將源自 PTC 的更新納入任何網站修改檔案,並用您自己的自訂來驗證維護版或單點版,而不影響到在生產系統上執行的工作。PTC 建議您將所有網站修改檔案備份儲存在 Windchill 安裝目錄下的安全區域目錄結構中。然後請遵循下列指示,在服務套件安裝類型選項設定為「將網站所修改的檔案更新為安全區」的情況下執行 PTC Solution Installer。您將能夠存取 PTC 已針對維護版變更的檔案,而且可以相應更新網站修改檔案。更新完網站修改檔案之後,您可以再次依照下列指示,在測試系統上執行「完整」Service Pack 安裝,來核對已合併網站修改的更新系統是否按照您的需求執行。
在測試系統上安裝好維護版或升級版且對結果感到滿意後,即可將您已更新的網站修改檔案複製到您生產系統的安全區域目錄 (<Windchill>/wtSafeArea/siteMod) 中。接著,在生產系統重複執行維護版或升級版安裝程序。
3. 執行下列步驟,針對更新準備系統:
a. 請確保測試系統與生產系統處於同步處理狀態。
b. 停止可能會與 Windchill 產品檔案互動的 Web 伺服器、servlet engine 或 Windchill 伺服器,使您的生產系統離線。這包括停止 Windchill 與 Apache 服務 (services.msc),以及關閉任何可能會開啟 Windchill 檔案的應用程式 (例如,文字編輯器、Windchill shell 或 Windchill 記錄檔)。
c. 刪除 <Windchill>\Tomcat\instances\ 資料夾的內容。
d. 當您的系統已處於離線狀態,但尚未安裝維護版之前,執行所有必要的備份。備份檔案是過程中很重要的一個步驟。若您沒有備份檔案,發生錯誤後您可能無法還原檔案。至少您應備份下列項目:
▪ Windchill資料庫 - 使用可供 SQL Server 環境使用的資料庫備份程序。此備份應在您的網站資料還原程序之後執行。
▪ Windchill 解決方案安裝目錄 - 依預設,此目錄為 C:\ptc。將它備份,方法是先建立它的副本,然後將它放置在網站還原程序之後的某個位置中。
▪ Windchill 解決方案 LDAP 目錄內容 (LDIF 檔案) - 執行
匯出項目至 LDIF 檔案中所述的 LDAP 匯出程序。依照您的網站資料復原流程儲存 LDIF 檔案。
▪ PTC Solution Installer 全域登錄目錄 - 在 <Installation_Location>/PSI 目錄中建立名為 "installer" 之 PTC Solution Installer 全域目錄的重複副本。將此 PTC Solution Installer 全域登錄目錄放在您的網站資料還原程序之後。
4. 如果您所更新的系統包括 Windchill Workgroup Manager,請確保用戶端 JAR 檔案為最新。「Windchill 服務套件」安裝會自動重新建構用戶端 JAR 檔案。當在 PTC Solution Installer 中選取選項時,請務必選取選用產品下的 Windchill Workgroup Manager (請參閱步驟 13)。
5. 啟動 PSI:
a. 插入 PTC Solution Installer CD。
b. 從指令提示視窗中,導覽至光碟機,然後輸入下列指令:setup.vbs
PSI 即會開啟。
6. 選擇此安裝工作階段的語言,並按一下「確定」。
|
「事前準備」面板提供了安裝 Windchill 解決方案所需文件集的連結。
|
7. 接受「PTC 客戶授權合約」。
8. 選擇「更新現有安裝」並按一下「下一步」。
9. 選取要更新的安裝,然後按一下「下一步」。
10. 在「選取產品」頁上,選取「安裝維護版」,然後按一下「下一步」
◦ 如果您的解決方案不在指定目錄中,安裝程式會顯示「要更新的產品」面板,供您指定產品位置。
◦ 如果您已進行網站修改,安裝程式會檢查儲存這些修改的目錄是否存在:<Windchill>/wtSafeArea/siteMod (其中 <Windchill> 是 Windchill Services 安裝目錄)。安裝程式會假設此目錄含有所有網站修改檔案的副本。如果找不到目錄,「確認無網站修改目錄」訊息會出現,這樣您便可確認不存在網站修改檔案。按一下「是」繼續,或按一下「否」及「取消」結束安裝。
11. 指定包含媒體的暫置目錄,然後按一下「下一步」。
12. 選取是否保留現有 web 組態,然後按一下「下一步」。
13. 如果安裝 Windchill Workgroup Manager 的更新作為 Windchill 更新的一部份,請選取您要安裝的所有適用 Windchill Workgroup Manager 編寫應用程式旁邊的核取方塊。
|
除了在 Windchill Workgroup Manager 伺服器安裝 Windchill 以外,使用者還必須安裝 Windchill Workgroup Manager 用戶端軟體。這些指示位於指南以及「Windchill Workgroup Manager 說明中心」中適用 CAD 或編寫工具的「安裝與組態」部份下。
|
14. 在「選取安裝類型」面板中選取「完整」,然後按一下「下一步」。
15. PSI 會列出必須更新的產品與元件。此外,PSI 還會列出需重新安裝才能完成更新的產品。
按一下「下一步」。
16. 如果 Apache Web 伺服器與 Tomcat 需要更新,此面板會提供保留組態檔案的選項。若您清除此核取方塊,則現有 httpd.conf 檔案將會被 Apache 提供的預設 httpd.conf 檔案覆寫。若您選取此核取方塊,則現有的 httpd.conf 檔案將不會遭到覆寫。
按一下「下一步」。
17. 在「安裝概觀」頁上,審核資訊,然後按一下「安裝」。
18. 安裝成功完成時,「安裝完成」面板上會顯示受安裝影響的目錄。視執行的安裝類型而定,這些目錄可能包括安裝所在的所選目錄、所選目錄及 <Windchill>/wtSafeArea/ptcCurrent 目錄,或是只有 <Windchill>/wtSafeArea/ptcCurrent 目錄。
安裝記錄檔案位於 <Windchill>/installer/logs 目錄中。安裝的記錄檔會命名為:
WSP_InstallLog.xml
WSP_PtcInstall.log
|
如果安裝失敗,則會顯示一個面板,其中包含錯誤訊息及相關記錄檔的名稱。記錄檔有助於協助您判斷失敗的原因。
其他 Windchill Service Pack 安裝疑難排解資訊可在 疑難排解您的維護安裝主題中找到。
|
如果您提出安裝支援請求,請務必包括記錄檔。針對您執行的每個 Windchill Service Pack 安裝都有單獨的記錄檔。每組記錄檔都位於安裝目錄下的 installer/logs 目錄中。
20. 應在使用 Windchill Service Pack 選項完成現有安裝的更新 (例如維護版更新) 之後,執行更新工具。
|
在執行「更新」工具之前,Web 伺服器、Windchill Directory Server 和資料庫應該處於正常運作狀態。
|
欲執行更新工具,必須由 Windchill 管理員 (wcadmin) 從 Windchill shell 執行下列指令:
Update_Tool.bat -username <username> -password <password> -noui
|
如果伺服器在更新工具完成執行之前關閉,當 Windchill 服務嘗試自動啟動時,會在啟動期間發生錯誤:The Windchill service on Local Computer started and then stopped. Some services stop automatically if they are not in use by other services or programs。
要解決這個問題:
a. 在安全模式下啟動電腦。
b. 從「開始」選單存取 Windows 服務: > 。
c. 將 Windchill PDM Essentials 之 Windows 服務的「啟動類型」內容值從「自動」變更為「手動」。
d. 重新啟動電腦。
e. 執行更新工具。
|
如果出現下列訊息,即表示「更新」工具已成功完成:「在資料庫中將載入新資料階段標記為已完成」。
21. 針對更新 Windchill 解決方案安裝目錄的 Windchill Service Pack 安裝,請導覽至Windchill > > 產品的版本正確無誤。
「發行版本」與「日期代碼」欄位應反映正確的已更新版本。
您也可以執行 windchill version 指令來核對 Windchill 的正確版本。
若 Windchill 版本顯示有未完成的任何元件安裝,請選取「復原」安裝類型選項,重新執行安裝。
|
若您是先安裝至測試系統,則您必須在生產系統上重覆執行安裝。
|
此 URL 可引領您瀏覽 PTC 線上支援網頁的參考文件。設定文件搜尋條件:請於「產品」下拉清單中選取您的產品,在「發行版本」下拉清單中選取目前版本,然後在「文件類型」下拉清單中選取「使用須知」,並於「使用者角色」下拉清單中選取「管理員」。
23. 當作為更新的一部份將模型表格的表格區從 WCAUDIT 變更為其他一些表格區時,在「升級資料庫結構描述」階段,會偵測到變更,並會產生下列指令集:
<windchill>\Upgrade\UpgradeReports\UpgradeDatabaseSchema\MoveTablesSql-<date>.sql
如果指令集存在於已列出的位置,您便需要手動執行此指令集,來將表格移至 WCAUDIT 表格區,以符合現成的資料庫結構描述。
24. 針對 Apache Web 伺服器與 Windchill 伺服器重新啟動 Windows 服務,使系統恢復上線。
如需有關
Windchill Service Pack 更新的詳細資訊,請參閱
更新現有安裝。
單純數字 (Harvard 序列) 版本配置的後更新步驟
成功完成更新之後,如果您的來源系統已設定為使用單純數字 (Harvard 序列) 版本配置,請執行下列額外步驟:
|
任何現有文件或 CAD 文件都擁有版本與版序位置。如果文件與 CAD 文件的版本顯示為 1.1, 1.2,....2.1, 2.2,... 等,則表示版本配置是單純數字 (Harvard 序列)。
|
在 windchill shell 中,鍵入下列指令來新增正確的內容:
• xconfmanager -s wt.series.HarvardSeries.Number.delimiter=. -s wt.series.HarvardSeries.Number.depth=16 -s wt.series.HarvardSeries.Number.level.1=wt.series.IntegerSeries -t codebase/wt.properties -p
• xconfmanager --add wt.series.HarvardSeries.seriesNames=MilSpec,Number -t codebase/wt.properties -p
如需有關 xconfmanager 公用程式的詳細資訊,請參閱
使用 xconfmanager 公用程式
如果未執行這些步驟,會發生下列錯誤:
ERROR [ajp-bio-8010-exec-1] com.ptc.core.htmlcomp.jstable.JSPersistableDataUtility cadauth
- JSPersistableDataUtility.getValue :: wt.util.WTRuntimeException:
Unable to construct version identifier for series: wt.series.HarvardSeries.Number;
nested exception is:
java.lang.reflect.InvocationTargetException
wt.util.WTRuntimeException: Unable to construct version