WASPreUpgrade 指令
WebSphere® Application Server 9.0 版的 WASPreUpgrade 指令會將 WebSphere Application Server 先前安裝版本的配置儲存到移轉特定備份目錄中。
位置
指令檔在 9.0 版 app_server_root/bin 目錄中,且必須從這個目錄來執行。
權限
如果要執行這個指令 Script,您的使用者設定檔必須具備 *ALLOBJ 權限。
語法
WASPreUpgrade backupDirectory
currentWebSphereDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
[-username < user name>]
[-password < password >]
[-javaoption < -Xms...m> -javaoption < -Xmx...m > ]
[-requireEmbeddedDBMigration true | false]
[-keepDmgrEnabled true | false]
參數
指令的參數如下:
- 這是必要的參數,並且必須是您指定的第一個參數。值 backupDirectory 指定目錄的名稱,以供指令 Script 用來存放所儲存的配置。
避免困難: 對於 WebSphere Application Server 備份目錄的位置而言,WAS_INSTALL 和 USER_INSTALL 根目錄是無效目錄。gotcha
這也是供 WASPostUpgrade 指令從中讀取配置的目錄。
如果目錄不存在,WASPreUpgrade 指令 Script 會建立它。
- 這是必要的參數,並且必須是您指定的第二個參數。這可能是 WebSphere Application Server 7.0 版或更新版本的任何支援移轉的版本。
currentWebSphereDirectory 值指定您想要移轉的來源 WebSphere Application Server 實例 7.0 版或更新版本設定檔的實例或設定檔根目錄的名稱。
- 這是選用性參數。
properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPreUpgrade 之類移轉工具要如何操作的參數內容。
您可以在移轉內容檔中定義參數內容,而不在指令行上指定大部分的選用參數。 如果在內容檔定義參數也在指令行指定參數,則指令行所指定的參數優先。
註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username 和 -password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties。 - 這是選用性參數。
值 trace_spec 指定您要收集的追蹤資訊。
如果要收集所有的追蹤資訊,請指定 "*=all=enabled"(含雙引號)。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
- 這是選用性參數。
值 file_name 會指定輸出檔的名稱,以取得追蹤資訊。
如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。
- 這是選用性參數。 值 user_workspace_folder_name_x 針對一或多個設定檔,指定管理主控台自訂「我的作業」設定的位置。
- 這是選用性參數。
user name 值指定現行 WebSphere Application Server 安裝架構的管理使用者名稱。
如果下列狀況屬實,則此為必要的參數:
- 您在移轉部署管理程式。
- 在來源安裝架構中啟用管理或廣域安全。
- 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
- 這是選用性參數。
password 值指定現行 WebSphere Application Server 安裝架構的管理密碼。
如果下列狀況屬實,則此為必要的參數:
- 您在移轉部署管理程式。
- 在來源安裝架構中啟用管理或廣域安全。
- 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
- 這是選用性參數。
請利用這個參數來指定 WASPreUpgrade 指令所用的 Java™ 資料堆記憶體大小。
"-Xms...m" 值是指定來指示起始資料堆大小的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果起始資料堆大小是 128 MB,請將這個參數指定為: -javaoption -Xms128m
"-Xms...m" 值是指定來指示資料堆大小上限的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xmx1024m
- 這是用來移轉內嵌資料庫的選用參數。
如果將值指定為 true,您在移轉內嵌資料庫時所發生的任何異常狀況,都會造成 WASPreUpgrade 指令失敗。如果將值指定為 false,會將您在移轉內嵌資料庫時所發生的任何異常狀況,記載到追蹤檔中,並繼續執行 WASPreUpgrade 指令。
預設值為 true。
- 這是用來移轉 8.0 版部署管理程式設定檔的選用參數。
在 WASPreUpgrade 執行時,會停止 8.0 版部署管理程式設定檔。依預設,部署管理程式維持停止狀態。如果將值指定為 true,在指令執行完成之前,WASPreUpgrade 就會啟動部署管理程式。
預設值為 false。
記載
當 WASPreUpgrade 工具執行時,會在畫面中顯示狀態。工具也會將一組較廣泛的記載資訊,儲存在寫入至 backupDirectory 目錄的 WASPreUpgrade.time_stamp.log 檔中,其中 backupDirectory 是指定給 backupDirectory 參數的值。您可以使用文字編輯器來檢視 WASPreUpgradetime_stamp.log 檔。
移轉的資源
WASPreUpgrade 會儲存您所有的資源,但不會移轉 classes 目錄中的實體。