manageprofiles 指令

請利用 manageprofiles 指令來建立、刪除、擴增、備份及還原定義執行時期環境的設定檔。 利用設定檔來取代多重產品安裝架構,可以節省磁碟空間及簡化產品的更新,因為只需要維護一組核心產品檔案。

指令檔位於 app_server_root/bin 目錄中。指令檔是一個名稱為 manageprofiles 的 Script。

註: 在 z/OS 上,不支援直接執行 manageprofiles.sh 來建立設定檔。
記住: 如果您搭配受管理的設定檔範本來使用這個指令,就不會建立應用程式伺服器。 不過,如果您聯合節點,仍會使用各個埠。
重要: manageprofiles 的預設行為是使用許可權 755 建立檔案,而忽略系統面的 Umask。如果您想修改這些許可權,每次您要在使用者之間傳遞設定檔時,請使用 chmod 指令。

語法

manageprofiles 指令可以用來執行下列作業:
  • 建立設定檔 (-create)
  • 刪除設定檔 (-delete)
  • 擴增設定檔 (-augment)
  • 取消擴增設定檔 (-unaugment)
  • 取消擴增所有以特定擴增範本擴增的設定檔 (-unaugmentAll)
  • 刪除所有設定檔 (-deleteAll)
  • 列出所有設定檔 (-listProfiles)
  • 列出設定檔的擴增 (-listAugments)
  • 取得設定檔名稱 (-getName)
  • 取得設定檔路徑 (-getPath)
  • 驗證設定檔登錄 (-validateRegistry)
  • 驗證及更新設定檔登錄 (-validateAndUpdateRegistry)
  • 取得預設設定檔名稱 (-getDefaultName)
  • 備份設定檔 (-backupProfile)
  • 還原設定檔 (-restoreProfile)
  • 執行包含在回應檔內的 manageprofiles 指令作業 (-response)
如需以 manageprofiles 指令完成之每一個作業的詳細說明(包括必要的參數),請使用 -help 參數。下列範例在 Windows 作業系統上,在 manageprofiles -augment 指令中使用 help 參數:
app_server_root\bin\manageprofiles.bat -augment -help

依您想要利用 manageprofiles 指令來執行的作業而定,您必須提供一或多個下列參數。 指令行工具會驗證是否有提供必要參數及所輸入這些參數的值是否有效。 請務必輸入大小寫正確的參數名稱,因為指令行工具不會驗證參數名稱的大小寫。 當未正確地鍵入參數大小寫時,可能會發生不正確的結果。

  • -adminPassword adminPassword
  • -adminUserName adminUser_ID
  • -applyPerfTuningSetting standard | peak | development
  • -appServerNodeName application_server_node_name
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name(選用參數)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword password
  • -dmgrAdminUserName user_name
  • -dmgrHost dmgr_host_name(選用參數)
  • -dmgrPort dmgr_port_number
  • -dmgrProfilePath dmgr_profile_path
  • -enableAdminSecurity true | false
  • -federateLater true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName host_name
  • -ignoreStack(選用參數)
  • -importPersonalCertKS keystore_path
  • -importPersonalCertKSAlias keystore_alias
  • -importPersonalCertKSPassword keystore_password
  • -importPersonalCertKSType keystore_type
  • -importSigningCertKS keystore_path
  • -importSigningCertKSAlias keystore_alias
  • -importSigningCertKSPassword keystore_password
  • -importSigningCertKSType keystore_type
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword keystore_password
  • -listAugments
  • -listProfiles
  • -nodeDefaultPorts
  • -nodeName node_name
  • -nodePortsFile node_ports_file_path
  • -nodeProfilePathnode_profile_path
  • -omitAction feature1 feature2... featureN(選用參數)
  • -personalCertDN distinguished_name
  • -personalCertValidityPeriod validity_period(選用參數)
  • -portsFile file_path(選用參數)
  • -profileName profile_name
  • -profilePath profile_root
  • -response response_file
  • -restoreProfile
  • -securityLevel security_level
  • -serverName server_name
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • -setDefaultName
  • -signingCertDN distinguished_name
  • -signingCertValidityPeriod validity_period(選用參數)
  • -startingPort starting_port | -portsFile ports_file_path | -defaultPorts
  • -supportedProtocols supported_protocols
  • -templatePath template_path
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -webServerCheck true | false
  • -webServerHostnamewebserver_host_name
  • -webServerInstallPath webserver_installpath_name
  • -webServerName webserver_name
  • -webServerOS webserver_operating_system
  • -webServerPluginPath webserver_plugin_path
  • -webServerPort webserver_port
  • -webServerType webserver_type
下列範例在 AIX® 或 Linux 之類的作業系統上使用 manageprofiles -create 指令:
app_server_root/bin/manageprofiles.sh -create
   -profileName profile_name
   -profilePath profile_root
   -templatePath template_path 

參數

manageprofiles 指令可使用下列選項:

-adminPassword adminPassword
針對以 -adminUserName 參數指定的管理安全使用者 ID,指定密碼。
-adminUserName adminUser_ID
指定要用於管理安全的使用者 ID。
-applyPerfTuningSetting option
指定最符合應用程式伺服器將執行之環境類型的效能調整設定。

這個參數只對預設設定檔範本有效。

standard
標準設定是為了一般用途而最佳化的標準原裝預設配置設定。
peak
尖峰效能設定是針對應用程式很少變更、最佳執行時期效能非常重要的正式作業環境而最佳化。
開發
開發設定是針對應用程式經常更新、最低限度耗用系統資源的開發環境而最佳化。
重要: 請勿將開發設定用於正式作業伺服器。

如果您沒有使用 -applyPerfTuningSetting 參數指定選項,預設值為 standard

如果您同時指定了 -isDeveloperServer-applyPerfTuningSetting 參數,依 -applyPerfTuningSetting 的所選選項而定,-applyPerfTuningSetting 可能會置換 -isDeveloperServer

-appServerNodeName application_server_node_name
指定您要聯合到 Cell 中之應用程式伺服器的節點名稱。 當您建立 Cell 的部署管理程式部分,以及建立 Cell 的應用程式伺服器部分時,請指定這個參數。
-augment
請使用 augment 參數,以擴增範本來變更現有的設定檔。augment 參數會導致 manageprofiles 指令使用 -templatePath 參數中的範本,來更新或擴增 -profileName 參數中識別的設定檔。 您可以使用的擴增範本是由安裝在環境中的 IBM® 產品與版本來判定。
重要: WebSphere® Application Server Network Deployment 產品隨附的範本只能用來建立設定檔,不能用來擴增現有的設定檔,因為產品只隨附建立範本。

此外,請勿手動修改 install_dir/ profileTemplates 目錄中的檔案。 比方說,如果您在設定檔建立期間變更埠,請在 manageprofiles 指令上使用 -startingPort 或 -portsFile 引數,不要修改設定檔範本目錄中的檔案。

如果設定檔範本是相對於 app_server_root/profileTemplates 目錄,您可以對 -templatePath 參數指定相對路徑。 否則,請指定完整的範本路徑。 例如:
 manageprofiles -augment -profileName profile_name -templatePath template_path

另請參閱 -unaugment 參數。

-backupFile backupFile_name
將設定檔登錄檔備份到指定檔案。您必須對 backupFile_name 提供完整的檔案路徑。
-backupProfile
執行設定檔資料夾及設定檔登錄檔中之設定檔 meta 資料的檔案系統備份。 在呼叫設定 -backupProfile 選項的 manageprofiles 指令之前,必須先停止您想要備份其所用設定檔的任何伺服器。 -backupProfile 參數必須與 -backupFile-profileName 參數搭配使用,例如:
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

當您使用 -backupProfile 選項備份設定檔時,必須先停止伺服器及您要備份之設定檔的執行中程序。

-cellName cell_name(選用參數)
指定設定檔的 Cell 名稱。 每一個設定檔都使用唯一的 Cell 名稱。
避免困難 避免困難: 即使您打算將自訂設定檔或獨立式設定檔聯合到部署管理程式 Cell 中,也要使用唯一名稱。聯合要求使用唯一 Cell 名稱,節點才能成為部署管理程式 Cell 的一部分。 在任何情況下,如果產品是在相同的實體機器或機器叢集(如 Sysplex)中執行,Cell 名稱必須是唯一的。另外,在任何需要實體間之網路連線的情況中,只要這個連線是在 Cell 之間,或是來自必須與每個 Cell 通訊的用戶端,Cell 名稱也必須是唯一的。另外,如果 Cell 的名稱空間是聯合的,Cell 名稱也必須是唯一的。否則,您可能會遇到 javax.naming.NameNotFoundException 錯誤之類的症狀;在這種情況下,請建立有唯一名稱的 Cell。gotcha

這是選用性參數。 如果您省略這個參數,就會指派預設 Cell 名稱。

預設 Cell 名稱如下:
  • dmgr 範本:profilenameNetwork
  • default 範本:shorthostname_profilename
  • managed 範本:shorthostname_profilename
  • Cell 範本:與所建立兩個設定檔的先前 dmgr 範例相同。

這個參數值不能包含空格或任何無效字元,例如:*、?、"、<、,、/、\、| 等等。

-create
建立設定檔。
指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help,以取得關於建立設定檔的特定資訊。可用的範本包括:
  • cell - 部署管理程式 Cell(dmgr 和 default)
  • management - 管理。搭配 -serverType 參數來指示管理設定檔的類型。
  • secureproxy - 安全 Proxy
  • default - 應用程式伺服器
  • managed - 自訂
-debug
開啟 manageprofiles 指令所用的 Ant 公用程式的除錯功能。
-personalCertValidityPeriod validity_period(選用參數)
這個選用參數會指定預設個人憑證有效的時間量(年)。如果您沒有搭配 -personalCertDN 參數指定這個參數,預設個人憑證的有效期為一年。
-defaultPorts
將預設值或基本埠值指派給設定檔。

當使用 -startingPort-portsFile 參數時,請勿使用此參數。

在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。

記住: 如果您使用受管理設定檔範本,請勿使用此參數。
-delete
刪除設定檔。

當您刪除設定檔時,也會刪除設定檔的目錄,因此,您不需要手動刪除目錄即可重建設定檔。

如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。

避免困難 避免困難: 如果您要刪除已移轉的舊節點,請先關閉新的已移轉的部署管理程式,再刪除舊的節點。 這可以確保不會從新的已移轉的 Cell 中,意外移除新的已移轉的節點。gotcha
-deleteAll
刪除所有登錄的設定檔。

當您刪除設定檔時,也會刪除設定檔的目錄,因此,當您重建設定檔時,不會有過時的資訊需要管理。

如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。

-dmgrAdminPassword password
如果要聯合某個節點,且部署管理程式已啟用管理安全,請指定部署管理程式的有效使用者名稱。 請搭配 -dmgrAdminUserName 參數和 -federateLater 參數來使用這個參數。
-dmgrAdminUserName user_name
如果要聯合某個節點,且部署管理程式已啟用管理安全,請指定部署管理程式的有效密碼。 請搭配 -dmgrAdminPassword 參數和 -federateLater 參數來使用這個參數。
-dmgrHost dmgr_host_name(選用參數)
識別執行部署管理程式的機器。 請在建立自訂設定檔時,指定這個參數和 dmgrPort 參數來聯合這個自訂設定檔。

主機名稱可以是部署管理程式機器的長或短的 DNS 名稱或 IP 位址。

指定這個選用的參數會引導 manageprofiles 指令嘗試將自訂節點聯合到部署管理程式 Cell 中,因為它會以受管理的 -templatePath 參數來建立自訂設定檔。 當建立部署管理程式設定檔或應用程式伺服器設定檔時,會忽略 -dmgrHost 參數。

當部署管理程式不在執行中,或是因為啟用了安全權限或其他原因而無法使用時,如果您聯合自訂節點,則日誌中的安裝指示碼便是 INSTCONFFAIL,這指出完全失敗。產生的自訂設定檔無法使用。您必須先將自訂設定檔目錄移出設定檔儲存庫(也就是設定檔安裝根目錄),才能建立另一個具有相同設定檔名稱的自訂設定檔。

如果您已啟用安全或變更預設 JMX 連接器類型,則不能以 manageprofiles 指令來聯合。 請改用 addNode 指令。

這個參數的預設值為 localhost。這個參數值必須是格式正確的主機名稱,且不能包含空格或無效字元,例如:*、?、"、<、,、/、\、| 等等。您也必須有部署管理程式的連線以搭配 dmgrPort 參數一起使用。

-dmgrPort dmgr_port_number
識別部署管理程式的 SOAP 埠。 請在建立自訂設定檔時,指定這個參數和 dmgrHost 參數來聯合這個自訂設定檔。 部署管理程式必須在執行中且可存取。

如果您已啟用安全或已變更預設「Java™ 管理延伸 (JMX)」連接器類型,就無法利用 manageprofiles 指令來聯合。 請改用 addNode 指令。

這個參數的預設值為 8879。 您指出的埠必須為正整數,且部署管理程式的連線必須可以與 dmgrHost 參數一起使用。

-dmgrProfilePath dmgr_profile_path
指定通往 Cell 的部署管理程式部分的設定檔路徑。 當您建立 Cell 的應用程式伺服器部分時,請指定這個參數。
-enableAdminSecurity true | false
啟用管理安全。有效值包括 truefalse。預設值為 false
enableAdminSecurity 設為 true 時,您還必須指定參數 -adminUserName-adminPassword,以及這些參數的值。

您無法利用 -enableAdminSecurity 參數來啟用自訂設定檔的管理安全。 如果要啟用自訂設定檔的安全,自訂設定檔必須聯合到部署管理程式中。 部署管理程式必須啟用管理安全,聯合的自訂設定檔才能啟用安全。

-federateLater true | false
指出建立設定檔期間是否會聯合受管理設定檔,或者是否稍後使用 addNode 指令加以聯合。如果 dmgrHostdmgrPortdmgrAdminUserNamedmgrAdminPassword 參數沒有值,這個參數的預設值為 true。 有效值包括 truefalse
-getDefaultName
傳回預設設定檔的名稱。
-getPath
取得給定名稱之設定檔的檔案系統位置。需要 –profileName 參數。
-getName
取得在給定 -profilePath 參數登錄的設定檔名稱。
-help
顯示指令語法。
-hostName host_name
指定您在其中建立設定檔的主機名稱。這個主機名稱應該與您在安裝起始產品時所指定的主機名稱相符。 這個參數的預設值是完整格式的網域名稱系統。 這個參數值必須是有效的 IPv6 主機名稱,且不能包含空格或任何無效字元,例如:*、?、"、<、>、,、/、\、| 等等。
-ignoreStack(選用參數)
這個選用參數會搭配 -templatePath 參數使用,來取消擴增已擴增的特定設定檔。請參閱 -unaugment 參數。
-importPersonalCertKS keystore_path
指定當您建立設定檔時,用來匯入個人憑證之金鑰儲存庫檔的路徑。個人憑證是伺服器的預設個人憑證。
最佳作法 最佳作法: 當您匯入個人憑證作為預設個人憑證時,請匯入簽章個人憑證的主要憑證。 否則,manageprofiles 指令會將個人憑證的公開金鑰新增到 trust.p12 檔中,且會建立一個主要簽署憑證。bprac
-importPersonalCertKS 參數與 -personalCertDN 參數互斥。如果您未明確建立或匯入個人憑證,依預設會建立一個個人憑證。

當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。

-importPersonalCertKSAlias keystore_alias
指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔中的憑證別名。 該憑證會新增至伺服器預設金鑰儲存庫檔,並且作為伺服器預設個人憑證使用。

當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。

-importPersonalCertKSPassword keystore_password
指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔的密碼。

當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。

-importPersonalCertKSType keystore_type
指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔的類型。其值可以是 JCEKSCMSKSPKCS12PKCS11JKS。不過,這份清單會根據 java.security 檔中的提供者而變更。

當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。

-importSigningCertKS keystore_path
指定當您建立設定檔時,用來匯入主要憑證之金鑰儲存庫檔的路徑。該主要憑證是您作為伺服器預設主要憑證使用的憑證。 -importSigningCertKS 參數與 -signingCertDN 參數互斥。如果您沒有特別建立或匯入一個主要簽署憑證,則會以預設值建立一個。

當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。

-importSigningCertKSAlias keystore_alias
指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔中的憑證別名。該憑證會新增至伺服器預設主要金鑰儲存庫,並且作為伺服器預設主要憑證使用。

當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。

-importSigningCertKSPassword keystore_password
指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔的密碼。

當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。

-importSigningCertKSType keystore_path
指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔的類型。有效值可以是 JCEKSCMSKSPKCS12PKCS11JKS。不過,這份清單會根據 java.security 檔中的提供者而變更。

當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。

-isDefault
指定由伴隨的 -profileName 參數所識別的設定檔一旦登錄之後,便會成為預設設定檔。當發出尋找預設設定檔的指令時,不需要使用指令的 -profileName 屬性。
-isDeveloperServer
指定伺服器只適用於開發用途。 將應用程式部署於正式作業應用程式伺服器之前,在建立設定檔以在非正式作業伺服器上測試應用程式時,這個參數很有用。

這個參數只對預設設定檔範本有效。

如果您同時指定了 -isDeveloperServer-applyPerfTuningSetting 參數,依 -applyPerfTuningSetting 的所選選項而定,-applyPerfTuningSetting 可能會置換 -isDeveloperServer

-keyStorePassword keystore_password
指定在建立設定檔期間,要用於所有已建立之金鑰儲存庫檔的密碼。金鑰儲存庫檔是專為預設的個人憑證和主要簽署憑證而建立。
-listAugments
列出在設定檔登錄之設定檔中已登錄的擴增項目。 您必須以 -listAugments 參數來指定 -profileName 參數。
-listProfiles
列出在設定檔登錄中的設定檔。
-nodeDefaultPorts
在與 Cell 範本一起建立設定檔時,定義一組埠。如果指定此選項,則您無法同時指定 -nodePortsFile 或 nodeStartingPort 選項。
-nodeName node_name
指定隨著新設定檔所建立之節點的節點名稱。請在 Cell 內或在機器上使用唯一的值。共用同一組產品二進位檔的每一個設定檔,都必須有唯一的節點名稱。
預設節點名稱如下:
  • 部署管理程式、管理代理程式或工作管理程式的 management 範本:profilenameManager
  • default 範本:shorthostname_profilename
  • managed 範本:shorthostname_profilename
  • cell:請參閱先前的 management 和 default 範本範例,依適當情況來套用於所建立的兩個設定檔。
  • secureproxy 範本:shorthostname_profilename

這個參數值不能包含空格或任何無效字元,例如:*、?、"、<、>、,、/、\、| 等等。

-nodePortsFile node_ports_path
指定您要建立的 Cell 之節點部分的埠。 如果您指定這個選項,您就無法同時指定 -nodeDefaultPorts 或 -nodeStartingPort 選項。
-nodeProfilePath node_profile_path
指定通往 Cell 的節點部分的設定檔路徑。 當您建立 Cell 的部署管理程式部分時,請指定這個參數。
-omitAction feature1 feature2... featureN(選用參數)
排除設定檔功能的選用性參數。
每個設定檔範本都已預先定義,並含部分選用功能。下列選用特性可以搭配下列設定檔範本的 -omitAction 參數使用:
  • default - 應用程式伺服器
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • management - 部署管理程式、管理代理程式或工作管理程式的管理設定檔
    • deployAdminConsole
  • cell - 由 dmgr 及 default 設定檔範本組成的部署管理程式 Cell
    • cell_dmgr (建立 Cell 設定檔期間所建立的 dmgr)
      • deployAdminConsole
      • defaultAppDeployAndConfig
-personalCertDN distinguished_name
指定在建立設定檔時,所建立之個人憑證的識別名稱。請在引號中指定識別名稱。這個預設個人憑證位於伺服器金鑰儲存庫檔中。-importPersonalCertKSType 參數與 -personalCertDN 參數互斥。 請參閱 -personalCertValidityPeriod 參數和 -keyStorePassword 參數。
-portsFile file_path(選用參數)
為一選用參數,指定通往定義新設定檔之埠設定的檔案路徑。

當使用 -startingPort-defaultPorts 參數時,請勿使用此參數。

在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。

-profileName profile_name
指定設定檔的名稱。建立設定檔時,請使用唯一的值。每個設定檔 (共用同一組產品二進位檔) 都必須有唯一名稱。預設設定檔名稱是以設定檔類型及尾端號碼為基礎,例如:
<profile_type><profile_number>
其中
  • <profile_type>AppSrvDmgrAdminAgentJobMgr,或 Custom 之類的值
  • <profile_number> 是建立唯一設定檔名稱的序號

這個參數值不能包含空格或無效字元,例如下列中的任何字元:*、?、"、<、>、,、/、\、| 等等。

您不可以選擇使用中的設定檔名稱。

-profilePath profile_root
指定設定檔的完整路徑,稱為 profile_root
請指定完整路徑以避免一項將設定檔聯合到 Cell 時,可能導致失敗的 Ant Script 限制。 例如:
-profilePath profile_root

預設值是根據 user_data_root 目錄、設定檔子目錄及設定檔的名稱為基礎。

比方說,預設值是:
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
WS_WSPROFILE_DEFAULT_PROFILE_HOME 元素定義在 app_server_root/properties 目錄內的 wasprofile.properties 檔中。
註: wasprofile.properties 檔含有下列內容:
WS_CMT_PI_MODPERMS
這個內容指定後置安裝程式是否應該修改它所建立之任何檔案的許可權。 有效值為 truefalse。任何其他值都預設為 false。 從檔案中移除這個內容,也會導致預設為 false。 當設為 false 時,後置安裝程式所建立的任何檔案都會有基於系統 Umask 設定的許可權。

這個參數的值必須是有效的目標系統路徑,且目前不可在使用中。

QEJBSVR 設定檔必須有寫入目錄的許可權。

WS_CMT_PI_LOGS
這個內容指定後置安裝程式是否及何時應該清除它在 PROFILE_HOME/logs/service/productDir 目錄各產品的日誌。 這個內容的設定可讓您指定下列的日誌清理準則:
  • 您可以指定在 PROFILE_HOME/logs/service/productDir 目錄中所要保存的各產品的日誌數目。 指定值可以是 1 到 999 之間的任何整數。舉例來說,如果您指定 WS_CMT_PI_LOGS=5,則後置安裝程式會保留每一項產品最近的 5 份日誌。
  • 您可以指定日誌可佔用的儲存體量上限。指定值可以是 1 到 999 之間的任何整數,後面接著:
    • KB:如果以 KB 來指定值。
    • MB:如果以 MB 來指定值。
    • GB:如果以 GB 來指定值。
    舉例來說,如果您指定 WS_CMT_PI_LOGS=10MB,當日誌佔用的儲存體量超過 10 MB 時,後置安裝程式會開始刪除最舊的日誌。
    避免困難 避免困難: 由於指定的值有區分大小寫,指定值中包含的字母必須是大寫字母。gotcha
  • 您可以指定後置安裝程式保留日誌的時間量。指定值可以是 1 到 999 之間的任何整數,後面接著:
    • D:如果以天來指定值。
    • W:如果以週來指定值。
    • M:如果以月來指定值。
    • Y:如果以年來指定值。
    舉例來說,如果您指定 WS_CMT_PI_LOGS=2W,表示每一份日誌保留兩週。
    避免困難 避免困難: 由於指定的值有區分大小寫,指定值中包含的字母必須是大寫字母。gotcha
  • 您可以指定特定日期,在該日期之後便刪除日誌。必須使用數值來指定值,並使用以橫線區隔的 DD-MM-YYYY 格式。舉例來說,如果您指定 WS_CMT_PI_LOGS=12-31-2013,所有日誌會在 2013 年 12 月 31 日刪除。
    避免困難 避免困難: 如果您沒有使用指示的格式(以橫線來區隔數字)來指定值,則會忽略這個內容設定。gotcha
-response reponse_file
從指令行利用 manageprofiles 指令存取所有 API 函數。

指令行介面可以由回應檔驅動,該回應檔包含內容檔中給定指令的輸入引數(以金鑰及值的格式)。如果要判定各種類型設定檔範本及動作所需的輸入引數,請搭配使用 manageprofiles 指令與 -help 參數。

請利用下列範例回應檔來執行建立作業:
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
當您建立回應檔時,請將下面這一組準則列入考量:
  • 當您指定值時,請勿在值的開頭或結尾指定雙引號 (") 字元,即使這個值包含空格也一樣。
    註: 這個規則與在指令行上指定值時不同。
  • 當您指定包含逗點字元的單一值時,例如 personalCertDN 和 signingCertDN 參數的識別名稱,請在逗點字元前面使用雙重反斜線。 例如,以下是如何指定含有識別名稱的 signingCertDN 值:
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
       ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US 
  • 當您指定多個值時,請用逗點字元來區隔它們,不要使用雙重反斜線。 例如,以下是如何指定 omitAction 參數的多個值:
    omitAction=deployAdminConsole,defaultAppDeployAndConfig 
  • 請勿在回應檔中指定空白行。這可能會導致錯誤。
-restoreProfile
重要: 只有在相同修正套件層次建立的備份才支援 manageProfiles -restoreProfile 指令。
還原設定檔備份。必須與 -backupFile 參數搭配使用,例如:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
如果要還原設定檔,請執行下列步驟:
  1. 停止伺服器及設定檔的執行中程序(您要還原該設定檔)。
  2. 從檔案系統中,手動刪除設定檔的目錄。
  3. 執行 manageprofiles 指令的 -validateAndUpdateRegistry 選項。
  4. 使用 manageprofiles 指令的 -restoreProfile 選項還原設定檔。
-securityLevel security_level
指定安全 Proxy 伺服器的起始安全層次設定。 有效值有 lowmediumhigh。 預設值為 high。安全層次是根據啟動使用者許可權、遞送考量、管理選項及錯誤處理程序。 在建立安全 Proxy 伺服器設定檔之後,您可以選擇性地變更您的安全設定。
-serverName server_name
指定伺服器的名稱。請只對 default 範本及 secureproxy 範本指定這個參數。 如果在使用 default 範本或 secureproxy 範本時,您沒有指定這個參數,預設設定檔的預設伺服器名稱是 server1,安全 Proxy 設定檔的預設伺服器名稱是 proxy1。
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
指定管理設定檔的類型。部署管理程式伺服器指定 DEPLOYMENT_MANAGER,管理代理程式伺服器指定 ADMIN_AGENT,工作管理程式伺服器指定 JOB_MANAGER 當您建立管理設定檔時,這個參數是必要的。
-setDefaultName
將預設設定檔設為其中一個現有的設定檔。其必須搭配使用 -profileName 參數使用,例如:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN distinguished_name
指定在建立設定檔時,所建立之主要簽章憑證的識別名稱。請在引號中指定識別名稱。這個預設個人憑證位於伺服器金鑰儲存庫檔中。-importSigningCertKS 參數與 -signingCertDN 參數互斥。如果您沒有特別建立或匯入一個主要簽署憑證,則會以預設值建立一個。請參閱 -signingCertValidityPeriod 參數和 -keyStorePassword
-signingCertValidityPeriod validity_period(選用參數)
這個選用參數會指定主要簽章憑證有效的時間量(年)。如果您沒有搭配 -signingCertDN 參數來指定這個參數,主要簽署憑證在 15 年內有效。
-startingPort startingPort
請指定起始埠號,以產生及指派設定檔的所有埠號。

埠值會從 -startingPort 值開始,循序指派。

請勿將這個參數搭配 -defaultPorts-portsFile 參數使用。

在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。

小心: 如果您使用受管理設定檔範本,請勿使用此參數。
-supportedProtocols supported_protocols
請指定對安全 Proxy 伺服器至 Proxy 要求有效的通訊協定。 有效值有 SIPHTTPHTTP,SIP
-templatePath template_path
指定連至安裝根目錄中之範本檔案的目錄路徑。在 profileTemplates 目錄內,有各種對應於不同設定檔類型的目錄,且會因所安裝的產品類型而異。設定檔目錄是使用 -templatePath 選項時指出的路徑。您可以指定位於安裝根目錄以外的設定檔範本(如果有的話)。
default 範本路徑是 app_server_root/profileTemplates/default。 您可以對 -templatePath 參數使用相對路徑。 路徑是循序相對於現行工作目錄或 app_server_root/profileTemplates。 下列範例是根據獨立式應用程式伺服器的預設值來建立設定檔:
manageprofiles -create -profileName MyProfile -startingPort 10380

設定檔概念主題中,有可用範本的說明。

-unaugment
擴增是利用擴增範本來變更現有設定檔的能力。 如果要取消擴增已擴增的設定檔,您必須指定 -unaugment 參數和 -profileName 參數。 如果執行了一系列的 manageprofiles 擴增,且只指定這兩個參數來取消擴增設定檔,取消擴增動作會先復原最後的擴增動作。

如果要取消擴增已擴增的特定設定檔,請額外搭配 -templatePath 參數來指定 -ignoreStack 參數。 您通常不會將特定設定檔取消擴增,因為您必須確定沒有違反設定檔範本相依關係。

當使用 -templatePath 參數時,您可以指定參數的相對檔案路徑。

另請參閱擴增參數。

-unaugmentAll
取消擴增所有以特定擴增範本擴增的設定檔。 -unaugmentAll 參數必須搭配 -templatePath 參數使用。

當使用 -templatePath 參數時,您可以指定參數的相對檔案路徑。

您可以選擇性地同時指定 -unaugmentDependents 參數和 -unaugmentAll 參數,以取消擴增所有的設定檔,這些設定檔是正在取消擴增之設定檔的必備項目。

註: 如果您使用這個參數時,沒有以設定檔範本所擴增的設定檔,則可能會送出錯誤。

另請參閱擴增參數。

-unaugmentDependents
如果指定的話,對於 -unaugmentAll 參數所取消擴增的設定檔,這個參數會將所有作為必要條件的已擴增的設定檔取消擴增。 如果沒有指定,就不會針對要取消擴增的設定檔,將作為必要條件的已擴增的設定檔取消擴增。

請搭配 -unaugmentAll 參數來指定 -unaugmentDependents 參數。

-validateAndUpdateRegistry
檢查所有列在設定檔登錄中的設定檔,看看檔案系統中是否有這些設定檔。從登錄移除任何遺漏的設定檔。然後傳回一份已從登錄刪除的遺漏設定檔清單。
-validatePorts
檢查埠以驗證它們未保留或不在使用中。這個參數可協助您識別不在使用中的埠。如果判定已使用該埠,則會停止建立設定檔,且會顯示錯誤訊息。您可以隨時在建立指令行使用這個參數。建議您搭配 –portsFile 參數來使用這個參數。
-validateRegistry
檢查所有列在設定檔登錄中的設定檔,看看檔案系統中是否有這些設定檔。傳回遺漏設定檔的清單。
-webServerCheck true | false
指出是否要設定 Web 伺服器定義。有效值包括 truefalse。此參數的預設值為 false
-webServerHostname webserver_host_name
伺服器的主機名稱。此參數的預設值為本端機器的長主機名稱。
-webServerInstallPath webserver_installpath_name
Web 伺服器的本端或遠端安裝路徑。此參數的預設值取決於本端機器的作業系統及 webServerType 參數值。例如:
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath 預設為 “n\a”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”
-webServerName webserver_name
Web 伺服器的名稱。這個參數的預設值為 webserver1。
-webServerOS webserver_operating_system
Web 伺服器所在的作業系統。有效值包括:Windows、linux、solaris、aix、hpux、os390 和 os400。 請將這個參數搭配 webServerType 參數使用。
-webServerPluginPath webserver_pluginpath
Web 伺服器使用的外掛程式的路徑。此參數的預設值為 WAS_HOME/plugins
-webServerPort webserver_port
指出將用來存取 Web 伺服器的埠。 這個參數的預設值為 80。
-webServerType webserver_type
Web 伺服器的類型。有效值包括:IHS、SUNJAVASYSTEM、IIS、DOMINO、APACHE 和 HTTPSERVER_ZOS。 請將此參數與 webServerOS 參數搭配使用。

使用實務

下列範例示範正確的語法。 請在單行中,發出下列任何範例中的指令。 各範例用多行來顯示指令是為了看起來清楚。

  • 建立部署管理程式

    下列範例利用 management 範本來建立名稱為 Dmgr001 的部署管理程式。 部署管理程式埠從埠號 20000 開始。

    manageprofiles -create
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath management
       -serverType DEPLOYMENT_MANAGER
       -startingPort 20000
  • 建立管理代理程式

    下列範例利用 management 範本來建立名稱為 AdminAgent001 的管理代理程式。 管理代理程式埠從埠號 24000 開始。

    manageprofiles -create
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath management
       -serverType ADMIN_AGENT
       -startingPort 24000
  • 建立工作管理程式

    下列範例利用 management 範本來建立名稱為 JobMgr001 的工作管理程式。 工作管理程式埠從埠號 25000 開始。

    manageprofiles -create
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath management
       -serverType JOB_MANAGER
       -startingPort 25000
  • 建立安全 Proxy

    下列範例利用 secureproxy 範本來建立名稱為 SecureProxySrv001 的安全 Proxy。 安全 Proxy 埠從埠號 26000 開始。

    manageprofiles -create
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath secureproxy
       -startingPort 26000
  • 建立自訂設定檔

    下列範例會建立一個自訂設定檔,然後將設定檔聯合到部署管理程式 Cell 中。

    manageprofiles -create
       -profileName Custom01
       -templatePath managed
       -startingPort 22000
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
  • 建立應用程式伺服器設定檔

    利用下列指令,建立名稱為 Default01 的應用程式伺服器設定檔。

    manageprofiles -create
       -profileName Default01
       -templatePath default
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw
  • 建立 Cell 設定檔
    建立 Cell 設定檔需要建立 Cell 設定檔的部署管理程式和應用程式伺服器部分。 兩個設定檔會鏈結起來,在 Cell 設定檔的部署管理程式和應用程式伺服器部分的各建立參數之間,有些參數必須相符。
    重要: 對於 Cell 設定檔的部署管理程式和應用程式伺服器部分,cellNamenodeNameappServerNodeName 等參數必須使用相同的值。 如果您在建立 Cell 設定檔的部署管理程式部分時,沒有指定這些參數的名稱,您必須使用第一個指令行呼叫中所指派的預設名稱。 下列範例說明在 Cell 設定檔的部署管理程式和應用程式伺服器部分中,這些參數使用相同的值。
    Dmgr:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01
                                    
    AppServer:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01
    下列範例顯示建立一個名稱為 Dmgr001 的 Cell 設定檔,Cell 名稱為 Default01Cell,節點名稱為 Default01Node。 如果要建立完整能運作的 Cell,在 cell_dmgr 設定檔和 cell_node 設定檔之間,-nodeProfilePath-cellName-appServerNodeName-nodeName 等參數必須相符。
    1. 建立 Cell 設定檔的部署管理程式部分。
      app_server_root/bin/manageprofiles -create
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath user_data_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. 建立 Cell 設定檔的應用程式伺服器部分。
      app_server_root/bin/manageprofiles -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath user_data_root/profiles/Dmgr001
         -portsFile user_data_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile user_data_root/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node

日誌

manageprofiles 指令會替它所建立的每個設定檔,各建立一個日誌。
  • 日誌是在 user_data_root/profileRegistry/logs/manageprofiles 目錄中。 檔案的命名型樣如下:profile_name_create.log
  • 這個指令也會替它所刪除的每個設定檔,各建立一個日誌。 日誌是在 user_data_root/profileRegistry/logs/manageprofiles 目錄中。 檔案的命名型樣如下:profile_name_delete.log

範例:建立部署管理程式設定檔

安裝核心產品檔之後,您可以建立部署管理程式設定檔。 部署管理程式對於一或多部機器上的應用程式伺服器邏輯群組,提供了單一管理介面。請利用 manageprofiles.sh -create 指令來建立部署管理程式設定檔。

如果要建立名稱為 shasti 的部署管理程式設定檔,請執行下列動作:

manageprofiles -create
              -profileName shasti
              -profilePath /shasti/WebSphere
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix
              -nodeName dmgr1
這個指令會在名稱為 cell1 的 Cell 中,建立一個名稱為 shasti 的部署管理程式設定檔,節點名稱為 dmgr1,位置如下:
  • /shasti/WebSphere

如果在建立設定檔期間,您沒有指定其中一個埠選項,就會使用建議的埠值集。 埠衝突解決演算法決定了這些埠。 建議的埠集不能有衝突。 如果您想要使用 IBM 預設埠,當您建立設定檔時,請使用 -defaultPorts 選項。

範例:從起點開始,遞增預設埠號

manageprofiles 指令可以根據起始埠值來指派埠號。 您可以利用 -startingPort 參數,從指令行提供起始埠值。 這個指令會從起始埠號值開始,循序指派埠號。 不過,如果順序中的某個埠值與現有的埠指派衝突,就會使用下一個可用的埠值

埠指派順序是任意的。 這些指派無法預測。

比方說,利用 -startingPort 20002 來建立的埠,看起來會類似下列範例:

指派應用程式伺服器設定檔的埠
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
指派含有聯合的應用程式伺服器設定檔之 Cell 的埠
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028
OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
指派含有部署管理程式設定檔之 Cell 的埠
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
指派含有部署管理程式伺服器之管理設定檔的埠
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
指派含有工作管理程式伺服器之管理設定檔的埠
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
指派含有管理代理程式伺服器之管理設定檔的埠
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
指派安全 Proxy 設定檔的埠
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006

下列範例利用 manageprofiles 指令的 startingPort 參數,以先前範例所顯示的內容,從起始值 20002 開始建立埠:

app_server_root/bin/manageprofiles -create
               -profileName shasti
               -profilePath user_data_root/profiles/shasti
               -templatePath app_server_root/profileTemplates/default
               -nodeName W2K03
               -cellName W2K03_Cell01
               -hostName planetnt
               -startingPort 20002

範例:建立 Cell 設定檔

如果要利用 manageprofiles 指令來建立 Cell 設定檔,您必須利用兩個不同的 manageprofiles 指令行呼叫來建立部署管理程式伺服器的 Cell 管理設定檔及 Cell 節點設定檔。 這兩個設定檔組合起來,就是 Cell 設定檔。

兩個範本用來建立 Cell 設定檔:cell_dmgr 和 cell_node。 兩個範本會鏈結起來,在這兩個呼叫的建立參數之間,有些參數必須相符。 請驗證呼叫相符。

您可以依照任何順序,或在任何時間,從指令行建立 Cell 的兩半部分。 最佳作法是先建立設定檔的部署管理程式部分。 建立 Cell 之後,Cell 會包含部署管理程式和聯合的節點。 部署管理程式部分和節點部分是在個別目錄中。

您建立的兩個設定檔,每一個都可以利用 -profilePath 參數來指定所產生之設定檔的完整路徑。 如果您沒有指定這個參數,每個設定檔路徑的預設值都是根據目錄、設定檔子目錄及設定檔的名稱為基礎。

構成 Cell 設定檔的兩個範本,彼此之間有相依關係,在兩個建立呼叫之間,需要一些相符的參數值。 如果要建立完整能運作的 Cell,在 cell_dmgr 設定檔和 cell_node 設定檔之間,-nodeProfilePath-cellName-appServerNodeName-nodeName 等參數必須有相同的值。 就埠而言,尤其是動態配置的埠,當建立 Cell 後半部分時,必須參照 Cell 前半部分所用的埠。 請參照代表 Cell 前半部分之設定檔的下列檔案來使用 -portsFile-nodePortsFile 引數:

  • profile_root/properties/portdef.props
  • profile_root/properties/nodeportdef.props
這個方式可確保 Cell 後半部分所建立的埠與 Cell 前半部分會有正確的相關性。

如需建立 Cell 設定檔的詳細說明,請使用下列指令:

app_server_root/bin/manageprofiles -create
 -templatePath
app_server_root/profileTemplates/cell/dmgr
 -help

app_server_root/bin/manageprofiles -create
 -templatePath
app_server_root/profileTemplates/cell/default
 -help

當建立 Cell 部署管理程式設定檔和 Cell 節點設定檔時,-help 參數的輸出指定哪些參數是必要的,哪些是選用的。

下列範例建立一個名稱為 Dmgr001 的 Cell 設定檔,Cell 名稱為 Default01Cell,節點名稱為 Default01Node
  1. 驗證下列路徑可用:

    當您建立 Cell 的部署管理程式和節點部分時,由於會新增每個部分的子目錄,路徑必須可用。

    • app_server_root/profiles
  2. 建立 Cell 設定檔的部署管理程式部分。
    app_server_root/bin/manageprofiles -create
     -templatePath
    app_server_root/profileTemplates/cell/dmgr
     -nodeProfilePath
    app_server_root/profiles/AppSrv01
     -profileName Dmgr001
     -cellName Default01Cell
     -nodeName Default01Node
     -appServerNodeName federated_node_name
  3. 驗證 Dmgr001 設定檔存在,因為在建立 Cell 設定檔的應用程式伺服器部分之前,它必須存在。
  4. 建立 Cell 設定檔的應用程式伺服器部分。
    重要: 您使用的 cellName、nodeName 和 appServerNodeName 參數值必須與 Cell 設定檔的部署管理程式部分所用的值相同。下列範例說明在 Cell 設定檔的部署管理程式和應用程式伺服器部分中,cellName、nodeName 和 appServerNodeName 參數使用相同的值。
    Dmgr:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01
                                    
    AppServer:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01
    如果您在建立 Cell 設定檔的部署管理程式部分時,沒有指定這些參數的名稱,您必須使用第一個指令行呼叫中所指派的預設名稱。
    app_server_root/bin/manageprofiles -create
     -templatePath
    app_server_root/profileTemplates/cell/default
     -dmgrProfilePath
    app_server_root/profiles/Dmgr001
     -portsFile
    app_server_root/profiles/Dmgr001/properties/portdef.props
     -nodePortsFile
    app_server_root/profiles/Dmgr001/properties/nodeportdef.props
     -profileName AppSrv01
     -cellName Default01Cell
     -nodeName Default01Node
     -appServerNodeName federated_node_name

建立 Cell 設定檔的部署管理程式和節點部分之後,兩部伺服器之間,必須進行同步化。 依預設,在兩部伺服器之間,會依照指定的間隔來自動進行同步化。 不過,如果同步化已停用、間隔太長,或發生問題導致無法及時同步化,請執行 syncNode 指令,將部署管理程式和節點同步化。

您必須使用 portsFile 或 nodePortsFile 參數,以及 startingPort 或 nodeStartingPort 參數。

如果您使用 manageprofiles 指令,您可以選擇您想要作為預設值的設定檔。

範例:使用預先定義的埠號

當您沒有明確設定埠值時,manageprofiles 指令會建議起始埠值。 您可以改用預先定義的埠值。

當沒有指定 -defaultPorts-startingPort-portsFile 選項時,manageprofiles 指令會建議埠值。
表 1. 預設埠值的檔案位置.

這份表格會依設定檔類型列出預設埠值的檔案位置。

設定檔 檔案路徑
應用程式伺服器 app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props
Cell - 應用程式伺服器部分 app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props
Cell - 部署管理程式部分 app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props
自訂 app_server_root/profileTemplates/managed/actions/portsUpdate/portdef.props
部署管理程式伺服器的管理設定檔 app_server_root/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props
管理代理程式伺服器的管理設定檔 app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
工作管理程式伺服器的管理設定檔 app_server_root/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props
安全 Proxy app_server_root/profileTemplates/secureproxy/actions/portsUpdate/portdef.props
如果要在建立設定檔之前,在 portdef.props 檔中自訂埠值,請執行下列步驟。 下列範例會建立預設設定檔。 如果是其他類型的設定檔,您必須將檔案路徑更換為您想建立之設定檔的檔案路徑。
  1. 從預設設定檔範本路徑中複製 app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props 檔,將檔案副本放在任意暫存目錄中,例如:
    • /temp/ports
  2. 在新檔案中,修改埠設定來指定您的埠值。
  3. 利用 manageprofiles 指令來建立您的設定檔。 使用已修改的埠值。 請在 -portsFile 參數上,指定已修改之 portdef.props 檔的位置。 請指定 -validatePorts 參數來確保不是保留埠或不是使用中的埠。 請利用下列範例作為指引:
    manageprofiles   -create
       -profileName Wow_Profile
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default
       -nodeName Wow_node
       -cellName Wow_cell
       -hostName lorriemb
       -portsFile \temp\ports\portdef.props
       -validatePorts
假設 portdef.props 檔有下列值:
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

執行 manageprofiles 指令,以使用者定義的埠值來建立設定檔之後,會顯示成功或失敗的結果。

註: 建立設定檔成功之後,主控台會列印一則指示成功的訊息,且會建議您檢查 AboutThisProfile.txt 檔。 不過,當您在 IBM i 上建立用戶端設定檔或外掛程式設定檔時,不會產生 AboutThisProfile.txt 檔。

manageprofiles 指令會在 profile_root\properties 目錄中建立現行 portdefs.props 檔的副本。

manageprofiles 指令中,請只用 -startingPort-defaultPorts-portsFile 這三個埠值參數其中一個。 這三個參數互斥。


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



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