Windchill 基礎原理 > PDM Essentials 與 Global Product Development Package 1 > Windchill PDM Essentials > 繼續進展:進行中的 Windchill 管理 > 系統管理任務 > 更新、升級與上移 > 更新為新維護版
  
更新為新維護版
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 自訂基礎一節。
在測試系統上安裝好維護版或升級版且對結果感到滿意後,即可將您已更新的網站修改檔案複製到您生產系統的安全區域目錄 (<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 環境使用的資料庫備份程序。此備份應在您的網站資料還原程序之後執行。
如需詳細資訊,請參閱 Backing Up the SQL Server Source Database (備份 SQL Serv r 來源資料庫)。
Windchill 解決方案安裝目錄 - 依預設,此目錄為 C:\ptc。將它備份,方法是先建立它的副本,然後將它放置在網站還原程序之後的某個位置中。
Windchill 解決方案 LDAP 目錄內容 (LDIF 檔案) - 執行匯出項目至 LDIF 檔案中所述的 LDAP 匯出程序。依照您的網站資料復原流程儲存 LDIF 檔案。
如需詳細資訊,請參閱 Backing up LDAP Directory Data
PTC Solution Installer 全域登錄目錄 - 在 <Installation_Location>/PSI 目錄中建立名為 "installer" 之 PTC Solution Installer 全域目錄的重複副本。將此 PTC Solution 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 目錄中。
19. 如果您的網站使用 HTTPS,請在更新解決方案之後,將授權的憑證重新匯入到 jssecacerts 檔案。如需詳細資訊,請參閱針對 PTC HTTP 伺服器與 Windchill 配置 HTTPS
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 PDM Essentials」,來確認已更新 Windchill 產品的版本正確無誤。
「發行版本」「日期代碼」欄位應反映正確的已更新版本。
您也可以執行 windchill version 指令來核對 Windchill 的正確版本。
Windchill 版本顯示有未完成的任何元件安裝,請選取「復原」安裝類型選項,重新執行安裝。
* 
若您是先安裝至測試系統,則您必須在生產系統上重覆執行安裝。
22. 如需適用於您要更新之維護版的手動組態特殊指示,請參閱《Windchill 使用須知》。您可於下列 PTC 網站位置下載維護版的最新《Windchill 使用須知》http://www.ptc.com/appserver/cs/doc/refdoc.jsp
此 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