配置遠端檔案伺服器
欲執行內容複製,必須針對主網站及「檔案伺服器」網站完成這些步驟。
以下是主網站與「檔案伺服器」的主要安裝後步驟。如需這裡的任何步驟的詳細程序,請參閱以下對應小節。
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.httpgw.url.anonymous 的屬性之值,此屬性位於您正在建立之網站的 wt.properties 檔案中。這是 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. 為主網站上的 wt.fv 與 wt.fv.master (wt.fv.verbose=true wt.fv.master.verbose=true) 套件以及遠端網站上的 wt.fv.replica 套件 (wt.fv.replica.verbose=true) 啟用冗長記錄。
2. 確定資料夾複本不是「唯讀」的,並且「已啟用」。
3. 重新啟動遠端網站應用伺服器。
啟動之後,您會立即在記錄檔中看見一行文字,說明遠端網站已從主網站請求組態。下列幾行是指定收到的組態的回應訊息。核對此組態是否有意義。
4. 重新啟動主網站應用伺服器。
啟動之後,您會立即在記錄檔中看見一行文字,說明主網站已嘗試重新整理遠端網站的組態。請檢查遠端網站 MethodServer.log 檔案,核對是否已收到組態。
手動配置服務
在「檔案伺服器」遠端網站中,遠端 Windchill 網站並沒有 Oracle 實例的存取權,並且只會執行最小的一套服務。只會啟動內容複製需要的服務。
不同於一般的 67 個或更多個服務,只配置複製中附屬的 5 個服務。確認此服務區段包含下列各項:
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 圖像的
ant -f createZip.xml -Dpsi_loadpoint.dir=<val> -Dsource_image.dir=<val>
Windchill/bin/CCSTools 執行指令集:
其中 <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 Engine
◦ Info*Engine 伺服器
◦ Windchill Services
◦ PTC Solution Installer
| 當 Apache 和 Tomcat 解壓縮時,必須共用共同目錄,例如 CD_CAPPS/Apache 和 CD_CAPPS/Tomcat。若要確保此結構被保存,Apache 和 Tomcat 必須個別複製到不同的 CD_CAPPS 資料夾,且當呼叫 createZip.xml 時必須參照該資料夾。 |
3. 將在上述步驟中建立的安裝程式 zip 收集到名為 CCsInstallerBndle.zip 的主物件配套 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 檔案。它會維護累積材料清單 (<Windchill>/CCSTools/CcsDsuBom.include),將會通過此材料清單合併任何未來的材料清單。
若要產生 ZIP 檔案,請從 Windchill Shell 執行下述指令:
ant -f <Windchill>/bin/CCSTools/create_ccsdsu.xml
-Dinstall.files.maint=true <params>
其中 <params> 是:
• -Dccsdsubom_include (選用) - 任何替代 BOM 檔案,包含相對於 <Windchill> 的內容。
這會指向要附加到 CcsDsu.zip 的內容材料清單。
• -Dccsdsu_exclude_list (選用) - 包含任何要從 DSU 排除之檔案的一般運算式清單。其預設為 <Windchill>/installer/wnc/ccsdsu_regex_exclude_list.txt)。
指令集會在 <Windchill>/CCSTools/update 目錄中執行並產生 CcsDsu.zip 與對應 MD5 加總核對檔案。
此 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. 您可以使用 WinZip (或類似的應用程式) 或 Windows 內建的 .zip 功能,在 Windows 中解壓縮。
至於 UNIX,可以使用 unzip <file name>。您可能需要安裝解壓縮功能。
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>/bin/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 shell。
2. 如果更新版本的獨立版產品與 PSI 均可用,您必須先使用 PSI 更新檔案伺服器上的現有獨立版產品,然後才能執行 install_ccsdsu.xml 檔案。
3. 開啟系統主控台,然後導覽至 <Windchill>/bin/CCSTools 目錄。
4. 確定 Windchill 目錄伺服器正在執行。
5. 使用 ANT,執行指令集檔案 install_ccsdsu.xml,如下所示:
ant -f install_ccsdsu.xml
| 如果 ant -f install_ccsdsu.xml 於第一次嘗試時失敗,請再次執行以成功完成更新流程。 |
6. 執行完成時,請啟動 Windchill。