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
這是必要的參數,並且必須是您指定的第一個參數。值 backupDirectory 指定目錄的名稱,以供指令 Script 用來存放所儲存的配置。
避免困難 避免困難: 對於 WebSphere Application Server 備份目錄的位置而言,WAS_INSTALLUSER_INSTALL 根目錄是無效目錄。gotcha

這也是供 WASPostUpgrade 指令從中讀取配置的目錄。

如果目錄不存在,WASPreUpgrade 指令 Script 會建立它。

currentWebSphereDirectory
這是必要的參數,並且必須是您指定的第二個參數。這可能是 WebSphere Application Server 7.0 版或更新版本的任何支援移轉的版本。
currentWebSphereDirectory 值指定您想要移轉的來源 WebSphere Application Server 實例 7.0 版或更新版本設定檔的實例或設定檔根目錄的名稱。
  • 設定檔根目錄可能是在建立設定檔時所選擇的唯一值,但下列目錄是預設值:
    • 若為 7.0 版(基本): /QIBM/UserData/WebSphere/AppServer/V7/Base/profiles/profile
    • 若為 7.0 版 WebSphere Application Server, Network Deployment /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/profile
-properties
這是選用性參數。 properties_file_name 值指定內容檔的路徑,內容檔包含用來定義 WASPreUpgrade 之類移轉工具要如何操作的參數內容。

您可以在移轉內容檔中定義參數內容,而不在指令行上指定大部分的選用參數。 如果在內容檔定義參數也在指令行指定參數,則指令行所指定的參數優先。

註: 在內容檔中,無法指定某些參數,例如,-properties 參數本身及 -username-password。 如需無法作為內容來定義的參數清單,請參閱 app_server_root/bin 目錄中的範本檔 migration.properties
-traceString
這是選用性參數。 值 trace_spec 指定您要收集的追蹤資訊。

如果要收集所有的追蹤資訊,請指定 "*=all=enabled"(含雙引號)。

如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。

-traceFile
這是選用性參數。 值 file_name 會指定輸出檔的名稱,以取得追蹤資訊。

如果沒有指定 -traceString 或 -traceFile 參數,依預設,指令會建立一個追蹤檔,並將它放在 backupDirectory/logs 目錄中。

-workspaceRoot
這是選用性參數。 值 user_workspace_folder_name_x 針對一或多個設定檔,指定管理主控台自訂「我的作業」設定的位置。
-username
這是選用性參數。 user name 值指定現行 WebSphere Application Server 安裝架構的管理使用者名稱。
如果下列狀況屬實,則此為必要的參數:
  • 您在移轉部署管理程式。
  • 在來源安裝架構中啟用管理或廣域安全。
  • 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
-password
這是選用性參數。 password 值指定現行 WebSphere Application Server 安裝架構的管理密碼。
如果下列狀況屬實,則此為必要的參數:
  • 您在移轉部署管理程式。
  • 在來源安裝架構中啟用管理或廣域安全。
  • 您正在移轉的 WebSphere Application Server 安裝架構是 8.0 版或更新版本。
-javaoption
這是選用性參數。 請利用這個參數來指定 WASPreUpgrade 指令所用的 Java™ 資料堆記憶體大小。

"-Xms...m" 值是指定來指示起始資料堆大小的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果起始資料堆大小是 128 MB,請將這個參數指定為: -javaoption -Xms128m

"-Xms...m" 值是指定來指示資料堆大小上限的參數。 請將 "..." 更換為您想使用的大小 (MB)。 比方說,如果資料堆大小上限是 1024 MB,請將這個參數指定為:-javaoption -Xmx1024m

-requireEmbeddedDBMigration
這是用來移轉內嵌資料庫的選用參數。

如果將值指定為 true,您在移轉內嵌資料庫時所發生的任何異常狀況,都會造成 WASPreUpgrade 指令失敗。如果將值指定為 false,會將您在移轉內嵌資料庫時所發生的任何異常狀況,記載到追蹤檔中,並繼續執行 WASPreUpgrade 指令。

預設值為 true。

-keepDmgrEnabled
這是用來移轉 8.0 版部署管理程式設定檔的選用參數。

WASPreUpgrade 執行時,會停止 8.0 版部署管理程式設定檔。依預設,部署管理程式維持停止狀態。如果將值指定為 true,在指令執行完成之前,WASPreUpgrade 就會啟動部署管理程式。

預設值為 false。

記載

WASPreUpgrade 工具執行時,會在畫面中顯示狀態。工具也會將一組較廣泛的記載資訊,儲存在寫入至 backupDirectory 目錄的 WASPreUpgrade.time_stamp.log 檔中,其中 backupDirectory 是指定給 backupDirectory 參數的值。您可以使用文字編輯器來檢視 WASPreUpgradetime_stamp.log 檔。

移轉的資源

WASPreUpgrade 會儲存您所有的資源,但不會移轉 classes 目錄中的實體。

移轉作業會將下列檔案儲存在 backupDirectory 目錄中。
  • config
  • properties

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-iseries&topic=rmig_WASPreUpgrade
檔名:rmig_WASPreUpgrade.html