WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 作業系統: AIX, HP-UX, Linux, Solaris, Windows

manageprofiles 指令

manageprofiles 指令行工具可用來建立所有 WebSphere ESB 執行時期環境, 是除了使用圖形式「建立設定檔」精靈以外的另一種做法。這個指令會建立設定檔, 以藉由這一組檔案來定義部署管理程式、自訂設定檔或獨立式伺服器設定檔的執行時期環境。此指令可用來建立、刪除、擴增、取消擴增、 列出或驗證設定檔。

「建立設定檔」精靈是一個 InstallShield for Multiplatforms (ISMP) 應用程式。您可以利用精靈來輸入這個主題所說明的大部分參數。 不過,有些參數會要求您使用 manageprofiles 指令。例如, 您必須利用 manageprofiles 指令來刪除或取消擴增設定檔, 因為「建立設定檔」精靈不提供刪除功能。

不過, 「建立設定檔」精靈也會執行 manageprofiles 指令無法執行的作業。比方說,精靈可以為它所建立的每個設定檔建立一項 Windows 服務。它也可以根據先前的埠指派來指派不衝突的埠。

當使用「建立設定檔」精靈(互動或無聲自動方式)初次建立或擴增設定檔時, 會在日誌檔中寫入建立或擴增設定檔的指令行版本。您可以從日誌檔擷取這個指令行, 並小心修改,然後用它來建立或擴增其他的設定檔。

重要: 為了能順利建立新 WebSphere ESB 設定檔,或擴增現有的 WebSphere Application Server 設定檔, 您應先使用「建立設定檔」精靈或無聲自動安裝程序, 並且只使用 manageprofiles 指令來「複製」這類的設定檔或建立相當類似的設定檔。使用 manageprofiles 指令來建立和擴增設定檔含有這項程序的逐步指示。
請參閱下列各節以取得進一步資訊:

設定檔類型

install_root/profileTemplates 目錄含有每一個設定檔的範本。

這個目錄含有各個對應至不同設定檔類型的目錄。這些目錄是您在 manageprofiles 指令中以 -templatePath 選項指出的路徑。您也可以指定位於安裝根目錄外的設定檔範本 (如果您剛好有的話)。

WebSphere ESB 中的 manageprofiles 指令可建立下列類型的 ESB 設定檔:
  • 獨立式伺服器設定檔使用 install_root/profileTemplates/default.esbserver 範本。
  • 部署管理程式設定檔使用 install_root/profileTemplates/dmgr.esbserver 範本。
  • 自訂設定檔使用 install_root/profileTemplates/managed.esbserver 範本。

指令檔的位置

指令檔在 install_root/bin 目錄中。指令檔是個名稱為 manageprofiles.sh(用於 Linux 和 UNIX 平台)或 manageprofiles.bat(用於 Windows 平台)的 Script。

「建立設定檔」精靈是指令行工具的圖形式使用者介面。 不同的作業系統平台,呼叫「建立設定檔」精靈之指令的檔案名稱也各不相同。

記載

每一次呼叫 manageprofiles 時都會在 install_root/logs/wasprofile 目錄中建立兩個日誌。
  • wasprofile_<mode>_profile_name.log 將含有 manageprofiles 指令所呼叫之動作的詳細資料。
  • manageprofile_<mode>_profile_name.log 將含有給定呼叫所套用的範本說明(相當簡略)以及其回覆碼。
例如,當使用 manageprofiles 指令來建立 名為 profile1 的設定檔時,會建立下列兩個日誌檔:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageprofile-create-profile1.log
LINUX 平台 UNIX 平台

manageprofiles.sh 指令語法

請在 manageprofiles 指令中使用下列語法和參數, 以取得您設定檔的相關資訊、刪除設定檔或取消擴增設定檔。若要使用 manageprofiles 來建立或擴增設定檔, 請遵循使用 manageprofiles 指令來建立和擴增設定檔中的指示進行。

列出現有的設定檔:
# ./manageprofiles.sh -listProfiles 
                 
移除設定檔最近擴增的項目:
# ./manageprofiles.sh -unaugment 
              -profileName profile_name 
刪除設定檔:
註: 在刪除設定檔前,您必須先移除設定檔中的所有擴增項目。在針對 WebSphere ESB 設定檔發出 delete 指令前, 請先發出 unaugment 指令兩次。這是確保設定檔和其所有相關構件都會被刪除。在刪除設定檔後, 請手動刪除 profile_root 目錄的內容,然後再嘗試重建設定檔。
# ./manageprofiles.sh -unaugment 
              -profileName profile_name
# ./manageprofiles.sh -unaugment 
              -profileName profile_name
# ./manageprofiles.sh -delete 
                -profileName profile_name | -profilePath profile_path 
                
從其路徑取得現有設定檔的名稱:
# ./manageprofiles.sh -getName 
                 -profilePath profile_path 
                
從其名稱取得現有設定檔的路徑:
# ./manageprofiles.sh -getPath 
                 -profileName profile_name 
                
檢查設定檔登錄的完整性:
# ./manageprofiles.sh -validateRegistry 
                
檢查設定檔登錄的完整性,移除找不到的設定檔:
# ./manageprofiles.sh -validateAndUpdateRegistry 
                 [-backup file_name] 
                
取得指令說明:
# ./manageprofiles.sh -help

# ./manageprofiles.sh -option_name -help
Windows 平台

manageprofiles.bat 指令語法

列出現有的設定檔:
manageprofiles -listProfiles 
             
移除設定檔最近擴增的項目:
manageprofiles -unaugment 
               -profileName profile_name 
刪除設定檔:
註: 在刪除設定檔前,您必須先移除設定檔中的所有擴增項目。在發出 delete 指令前, 請先發出 unaugment 指令兩次。這是確保設定檔和其所有相關構件都會被刪除。在刪除設定檔後, 請手動刪除 profile_root 目錄的內容,然後再嘗試重建設定檔。
manageprofiles -unaugment 
               -profileName  profile_name
manageprofiles -unaugment 
               -profileName  profile_name
manageprofiles -delete 
              -profileName profile_name | -profilePath profile_path 
            
從其路徑取得現有設定檔的名稱:
manageprofiles -getName 
               -profilePath fully_qualified_profile_path 
             
從其名稱取得現有設定檔的路徑:
manageprofiles -getPath 
               -profileName profile_name 
             
檢查設定檔登錄的完整性:
manageprofiles -validateRegistry 
             
檢查設定檔登錄的完整性,移除找不到的設定檔:
manageprofiles -validateAndUpdateRegistry 
             [-backup file_name] 
             
取得指令說明:
manageprofiles -help

manageprofiles -option_name -help

參數

WebSphere ESB manageprofiles 指令中所設的參數和 WebSphere Process Server manageprofiles 指令相同。

請參閱 manageprofiles 參數,取得要在 WebSphere ESB 中搭配 manageprofiles 指令使用的參數清單和說明。

指令輸出

一旦完成建立或擴增時, 會將下列一個陳述式列印至指令行(確切字組將視呼叫的 manageprofiles 模式而定):
  • INSTCONFSUCCESS:順利建立設定檔。
  • INSTCONFFAILED:建立設定檔失敗。
  • INSTCONFPARTIALSUCCESS:某些不重要的後置安裝配置動作失敗。
在某些情況下,陳述式會列印多次。以 WebSphere ESB 設定檔為例, INSTCONFSUCCESS 字行會列印 3 次至指令行。

範例

UnaugmentLINUX 平台 UNIX 平台
install_root/bin  manageProfiles.sh -unaugment –profileName profileName
Windows 平台
install_root\bin  manageProfiles -unaugment –profileName profileName
DeleteLINUX 平台 UNIX 平台
install_root/bin  manageProfiles.sh -delete –profileName profileName
Windows 平台
install_root\bin  manageProfiles -delete –profileName profileName

Reference topic

使用條款 | 此頁的評等

時間戳記前次更新: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ref\rwesb_manageprofile.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)