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

使用 manageprofiles 指令來建立和擴增設定檔

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

開始之前

若要在 WebSphere ESB 中使用 manageprofiles, 您應已利用「建立設定檔」精靈(圖形式使用者介面或使用無聲自動回應檔), 使用您要的選項來建立新設定檔或擴增現有的設定檔。(請勿使用 manageprofiles 來初次建構擴增或建立指令。)

執行這項作業的原因和時機

因使用「建立設定檔」精靈或無聲自動安裝而產生的指令行會擷取到日誌檔中。您將使用這個日誌檔中的內容,來建立類似的指令行, 以便在後續使用 manageprofiles 指令來建立或擴增設定檔時使用。

所擷取之用來建立設定檔的指令行,將含有 -create 參數(通常採 manageprofiles -create 格式)。所擷取之用來擴增設定檔的指令行,將含有 -augment 參數(通常採 manageprofiles -augment 格式)。請勿在指令行中切換這些參數。例如, 請勿用 -create 來替代 -augment。產生的 Script 將無法運作, 這是因為其他的參數和引數將不正確。

註: WebSphere ESB 不支援擴增要聯合至部署管理程式的設定檔。您必須先取消聯合這類的設定檔, 再加以擴增,然後執行 addNode 指令行工具以重新聯合它。

這項作業的步驟

  1. 在您使用「建立設定檔」精靈或無聲自動安裝來建立或擴增設定檔後, 請開啟已產生的日誌檔。 檔案路徑和名稱如下:profile_root/logs/pcatLogNNNNNNNNNNNNN.txt, 其中 profile_root 為設定檔建立所在的目錄, NNNNNNNNNNNNN 為時間戳記值。
  2. 在日誌檔中,請搜尋開頭為 "CAPTURED COMMAND LINE" 的字行,並將此行(包括其下的任何折行文字)儲存到新檔案中。
    1. 從 "CAPTURED COMMAND LINE" 文字開始,一直選取到檔案尾端。
    2. 將此文字複製到新檔案中。
    3. 在新檔案中,將 "CAPTURED COMMAND LINE" 字句以及其前面的所有文字從所複製的字串中移除。
    4. 儲存檔案。(可使用任何有效的唯一檔案名稱)。 此時,您已將先前「建立設定檔」精靈執行作業的相同指令行儲存在這個檔案中。
  3. 請修改指令行,以反映任何變更。 在文字編輯器中,此時您必須修改您所儲存的指令, 以反映您想執行的新設定檔建立或擴增作業。以下為必須或可以修改的值。
    註: 請勿變更其他任何值,或額外新增指令行中所沒有的(或manageprofiles 參數中沒有指定的)參數。
    .
    如果您要... 請...
    建立或擴增設定檔 您必須將檔案中任何出現 "MASKED_PARAMETER_VALUE" 字串之處換成有效的密碼。基於安全, 當初所插入的是 "MASKED_PARAMETER_VALUE" 字串,而非指定的密碼。您必須更換這些字串。如需詳細資訊,請參閱manageprofiles 參數
    擴增現有的設定檔 請確定 -profileName-profilePath-cellName-nodeName 參數的值完全符合您要擴增的這些設定檔。視原始的指令行以及您所要修改的設定檔而定, 您可能需要修改值。
    擴增現有的設定檔 請確定指令行中的設定檔範本和您想擴增的設定檔是同類型的(獨立式、 部署管理程式或自訂)。若未做好確認, 可能導致結果不正確。
    建立新設定檔 修改 -profileName、-profilePath、-cellName 和 -nodeName,以確定它們是唯一的。
    建立新設定檔 重新指定您在「建立設定檔」精靈中所定義之埠。指令行不包含您原先使用 「建立設定檔」精靈時所定義之埠。請新增 -portsFile 或 -startPort 參數和適當的埠值到指令行尾端。如需指定這些埠的相關資訊, 請參閱 WebSphere Application Server 資訊中心之 wasprofile 指令的相關資訊。
    在另一個 WebSphere ESB 安裝環境 (可位於原始設定檔建立所在的相同電腦上,或位於另一部上)中使用這個指令行 必要時, 請修改路徑名稱值,以反映不同 WebSphere ESB 安裝環境的位置, 以及修改此指令檔所在之目錄位置的完整路徑。
  4. 使用修改過的指令行檔案來建立新設定檔或擴增現有的設定檔..
    1. 讓檔案變成執行檔。
      • UNIX platforms LINUX platforms 若為 UNIX 和 Linux 系統,請給予副檔名 .sh,並給予執行權。
      • For Windows platforms 若為 Windows 系統,請給予副檔名 .bat
    2. 從指令行執行檔案。 指令會在執行期間顯示其狀態。 請靜待其完成。

範例

以下是所擷取(未修改)的指令行,用以建立新設定檔。在本例中, 如同 -create 參數所指示,此指令用來建立新設定檔:


(Nov 3, 2005 9:24:08 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
 /opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "ESB01" -profilePath 
"/opt/o054 4.12/profiles/ESB01" -templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver"
 -federateLater "true" -hostName  "eexfvt99.rchland.ibm.com" -nodeName "eexfvt99Node28"
 -cellName  "eexfvt99Node26Cell" -dmgrHost  "localhost" -dmgrP ort  "8879" -OS_NAME  "Linux" 
-winserviceCheck  "true" -winserviceAccountType  " localsystem" -winserviceUserName  "root"
 -winservicePassword  "MASKED_PARAMETER_ VALUE" -winserviceStartupType  "manual" -dbJDBCClasspath 
 "null" -dbType  "CLOUD SCAPE" -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "MASKED_PARAMETER_VALUE"
 -cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  "" 
-ce iDbUser  "" -ceiDbPwd  "MASKED_PARAMETER_VALUE" -ceiDbSysUser  ""
 -ceiDbSysPwd "MASKED_PARAMETER_VALUE" -ceiDbJdbcDriverClasspath  "" 
-ceiDbJdbcDriverType  "" -ceiDbServerName  "" -ceiDbServerPort  ""
 -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity  "true" -scaSecurityUserId 
 "root" -scaSecurityPassword  "MASKED_PARAMETER_VALUE" 

以下是指令行範例, 它已經過修改,移除了檔案標頭資訊以及更換遮蔽的密碼。以下是指令行範例, 它已經過修改,移除了檔案標頭資訊以及更換遮蔽的密碼。
/opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "myProfile"
 -profilePath "/opt/o054 4.12/profiles/myProfile" 
-templatePath "/opt/o0544.12/profileTemplates/default.  wbiserver" 
-federateLater "true" -hostName  "eexfvt99.rchland.ibm.com"
 -nodeName "myNodeName" -cellName  "myCellName" -dmgrHost  "localhost" 
-dmgrPort  "8879" -OS_NAME  "Linux" -winserviceCheck  "true" -winserviceAccountType 
 " localsystem" -winserviceUserName  "root" -winservicePassword  "rootPassword" 
-winserviceStartupType  "manual" -dbJDBCClasspath  "null" -dbType  "CLOUD SCAPE"
 -ceiSampleJmsUser  "root" -ceiSampleJmsPwd  "myRootPwd" 
-cei SampleServerName  "server1" -ceiDbProduct  "CLOUDSCAPE_V51_1" -ceiDbName  "" 
-ce iDbUser  "" -ceiDbPwd  "myPassword" -ceiDbSysUser  "" -ceiDbSysPwd "myPassword"
 -ceiDbJdbcDriverClasspath  "" -ceiDbJdbcDriverType  "" -ceiDbServerName  ""
 -ceiDbServerPort  "" -ceiDbNodeName  "" -ceiDbExecuteScript s  "" -configureScaSecurity
  "true" -scaSecurityUserId  "root" -scaSecurityPassword  "myRootPwd" 

UNIX platforms LINUX platforms 下列範例顯示在 UNIX 系統上執行的 Script。在本例中, "myCommandline.sh" 為已建立的 Script 名稱:
/opt/IBM/WebSphere/ESB/bin>myCommandline.sh
INSTCONFSUCCESS: 此時設定檔已存在。
INSTCONFSUCCESS: 設定檔擴增已順利完成。
INSTCONFSUCCESS: 設定檔擴增已順利完成。

/opt/IBM/WebSphere/ESB/bin>

For Windows platforms 下列範例顯示在 Windows 系統上執行的 Script。在本例中, "myCommandline.bat" 為已建立的 Script 名稱:
C:\Program Files\IBM\WebSphere\ESB\bin>myCommandline.bat
INSTCONFSUCCESS: 此時設定檔已存在。
INSTCONFSUCCESS: 設定檔擴增已順利完成。
INSTCONFSUCCESS: 設定檔擴增已順利完成。


C:\Program Files\IBM\WebSphere\ESB\bin>


Task topic

使用條款 | 此頁的評等

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

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