![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
manageprofiles 指令
請利用 manageprofiles 指令來建立、刪除、擴增、備份及還原定義執行時期環境的設定檔。 利用設定檔來取代多重產品安裝架構,可以節省磁碟空間及簡化產品的更新,因為只需要維護一組核心產品檔案。
manageprofiles 指令及其圖形使用者介面(設定檔管理工具),是建立執行時期環境僅有的方法。
指令檔位於 app_server_root/bin 目錄中。指令檔是一個名稱為 manageprofiles 的 Script。
語法
app_server_root\bin\manageprofiles.bat -augment -help
依您想要利用 manageprofiles 指令來執行的作業而定,您必須提供一或多個下列參數。 指令行工具會驗證是否有提供必要參數及所輸入這些參數的值是否有效。 請務必輸入大小寫正確的參數名稱,因為指令行工具不會驗證參數名稱的大小寫。 當未正確地鍵入參數大小寫時,可能會發生不正確的結果。
app_server_root/bin/manageprofiles.sh -create
-profileName profile_name
-profilePath profile_root
-templatePath template_path
參數
manageprofiles 指令可使用下列選項:
- 針對以 -adminUserName 參數指定的管理安全使用者 ID,指定密碼。
- 指定要用於管理安全的使用者 ID。
- 指定最符合應用程式伺服器將執行之環境類型的效能調整設定。
這個參數只對預設設定檔範本有效。
- 標準設定是為了一般用途而最佳化的標準原裝預設配置設定。
- 尖峰效能設定是針對應用程式很少變更、最佳執行時期效能非常重要的正式作業環境而最佳化。
- 開發設定是針對應用程式經常更新、最低限度耗用系統資源的開發環境而最佳化。
重要: 請勿將開發設定用於正式作業伺服器。
如果您沒有使用 -applyPerfTuningSetting 參數指定選項,預設值為 standard。
如果您同時指定了 -isDeveloperServer 和 -applyPerfTuningSetting 參數,依 -applyPerfTuningSetting 的所選選項而定,-applyPerfTuningSetting 可能會置換 -isDeveloperServer。
- 指定您要聯合到 Cell 中之應用程式伺服器的節點名稱。 當您建立 Cell 的部署管理程式部分,以及建立 Cell 的應用程式伺服器部分時,請指定這個參數。
- 請使用 augment 參數,以擴增範本來變更現有的設定檔。augment 參數會導致 manageprofiles 指令使用 -templatePath 參數中的範本,來更新或擴增 -profileName 參數中識別的設定檔。
您可以使用的擴增範本是由安裝在環境中的 IBM® 產品與版本來判定。重要: WebSphere® Application Server Network Deployment 產品隨附的範本只能用來建立設定檔,不能用來擴增現有的設定檔,因為產品只隨附建立範本。
此外,請勿手動修改 install_dir/ profileTemplates 目錄中的檔案。 比方說,如果您在設定檔建立期間變更埠,請在 manageprofiles 指令上使用 -startingPort 或 -portsFile 引數,不要修改設定檔範本目錄中的檔案。
指定 -templatePath 的完整檔案路徑。例如:
manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath template_path
如果設定檔範本是相對於 app_server_root/profileTemplates 目錄,您可以對 -templatePath 參數指定相對路徑。 否則,請指定完整的範本路徑。 例如:manageprofiles -augment -profileName profile_name -templatePath template_path
另請參閱 -unaugment 參數。
- 將設定檔登錄檔備份到指定檔案。您必須對 backupFile_name 提供完整的檔案路徑。
- 執行設定檔資料夾及設定檔登錄檔中之設定檔 meta 資料的檔案系統備份。
在呼叫設定 -backupProfile 選項的 manageprofiles 指令之前,必須先停止您想要備份其所用設定檔的任何伺服器。
-backupProfile 參數必須與 -backupFile 及 -profileName 參數搭配使用,例如:
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name
當您使用 -backupProfile 選項備份設定檔時,必須先停止伺服器及您要備份之設定檔的執行中程序。
- 指定設定檔的 Cell 名稱。
每一個設定檔都使用唯一的 Cell 名稱。
避免困難: 即使您打算將自訂設定檔或獨立式設定檔聯合到部署管理程式 Cell 中,也要使用唯一名稱。聯合要求使用唯一 Cell 名稱,節點才能成為部署管理程式 Cell 的一部分。 在任何情況下,如果產品是在相同的實體機器或機器叢集(如 Sysplex)中執行,Cell 名稱必須是唯一的。另外,在任何需要實體間之網路連線的情況中,只要這個連線是在 Cell 之間,或是來自必須與每個 Cell 通訊的用戶端,Cell 名稱也必須是唯一的。另外,如果 Cell 的名稱空間是聯合的,Cell 名稱也必須是唯一的。否則,您可能會遇到 javax.naming.NameNotFoundException 錯誤之類的症狀;在這種情況下,請建立有唯一名稱的 Cell。gotcha
這是選用性參數。 如果您省略這個參數,就會指派預設 Cell 名稱。
這個參數的預設值是根據簡短主機名稱、常數 Cell 及結尾號碼的組合:
預設 Cell 名稱如下:
這個參數值不能包含空格或任何無效字元,例如:*、?、"、<、,、/、\、| 等等。
- 建立設定檔。指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help,以取得關於建立設定檔的特定資訊。可用的範本包括:
- 開啟 manageprofiles 指令所用的 Ant 公用程式的除錯功能。
- 這個選用參數會指定預設個人憑證有效的時間量(年)。如果您沒有搭配 -personalCertDN 參數指定這個參數,預設個人憑證的有效期為一年。
- 將預設值或基本埠值指派給設定檔。
當使用 -startingPort 或 -portsFile 參數時,請勿使用此參數。
在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。
記住: 如果您使用受管理設定檔範本,請勿使用此參數。 - 刪除設定檔。
刪除設定檔,並不會連同設定檔目錄一起刪除。 比方說,假設您在 /usr/WebSphere/AppServer/profiles/managedProfile 目錄中建立設定檔。 在您刪除設定檔之後,仍會保留目錄。
您可以刪除或保留目錄。然而,profile_root/logs 目錄包含解除安裝設定檔的相關資訊。例如,您可能會保留 _nodeuninst.log 檔案,以在解除安裝程序期間判定任何問題的原因。
當您刪除設定檔時,也會刪除設定檔的目錄,因此,您不需要手動刪除目錄即可重建設定檔。
如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。
避免困難: 如果您要刪除已移轉的舊節點,請先關閉新的已移轉的部署管理程式,再刪除舊的節點。 這可以確保不會從新的已移轉的 Cell 中,意外移除新的已移轉的節點。gotcha
- 刪除所有登錄的設定檔。
刪除設定檔,並不會連同設定檔目錄一起刪除。 比方說,假設您在 /usr/WebSphere/AppServer/profiles/managedProfile 目錄中建立設定檔。 在您刪除設定檔之後,仍會保留目錄。
您可以刪除或保留目錄。然而,profile_root/logs 目錄包含解除安裝設定檔的相關資訊。例如,您可能會保留 _nodeuninst.log 檔案,以在解除安裝程序期間判定任何問題的原因。
當您刪除設定檔時,也會刪除設定檔的目錄,因此,當您重建設定檔時,不會有過時的資訊需要管理。
如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。
- 如果要聯合某個節點,且部署管理程式已啟用管理安全,請指定部署管理程式的有效使用者名稱。 請搭配 -dmgrAdminUserName 參數和 -federateLater 參數來使用這個參數。
- 如果要聯合某個節點,且部署管理程式已啟用管理安全,請指定部署管理程式的有效密碼。 請搭配 -dmgrAdminPassword 參數和 -federateLater 參數來使用這個參數。
- 識別執行部署管理程式的機器。
請在建立自訂設定檔時,指定這個參數和 dmgrPort 參數來聯合這個自訂設定檔。
主機名稱可以是部署管理程式機器的長或短的 DNS 名稱或 IP 位址。
指定這個選用的參數會引導 manageprofiles 指令嘗試將自訂節點聯合到部署管理程式 Cell 中,因為它會以受管理的 -templatePath 參數來建立自訂設定檔。 當建立部署管理程式設定檔或應用程式伺服器設定檔時,會忽略 -dmgrHost 參數。
當部署管理程式不在執行中,或是因為啟用了安全權限或其他原因而無法使用時,如果您聯合自訂節點,則日誌中的安裝指示碼便是 INSTCONFFAIL,這指出完全失敗。產生的自訂設定檔無法使用。您必須先將自訂設定檔目錄移出設定檔儲存庫(也就是設定檔安裝根目錄),才能建立另一個具有相同設定檔名稱的自訂設定檔。
如果您已啟用安全或變更預設 JMX 連接器類型,則不能以 manageprofiles 指令來聯合。 請改用 addNode 指令。
這個參數的預設值為 localhost。這個參數值必須是格式正確的主機名稱,且不能包含空格或無效字元,例如:*、?、"、<、,、/、\、| 等等。您也必須有部署管理程式的連線以搭配 dmgrPort 參數一起使用。
- 識別部署管理程式的 SOAP 埠。
請在建立自訂設定檔時,指定這個參數和 dmgrHost 參數來聯合這個自訂設定檔。
部署管理程式必須在執行中且可存取。
如果您已啟用安全或已變更預設「Java™ 管理延伸 (JMX)」連接器類型,就無法利用 manageprofiles 指令來聯合。 請改用 addNode 指令。
這個參數的預設值為 8879。 您指出的埠必須為正整數,且部署管理程式的連線必須可以與 dmgrHost 參數一起使用。
- 指定通往 Cell 的部署管理程式部分的設定檔路徑。 當您建立 Cell 的應用程式伺服器部分時,請指定這個參數。
- 啟用管理安全。有效值包括 true 或 false。預設值為 false。
- 當 enableAdminSecurity 設為 true 時,您還必須指定參數 -adminUserName 及 -adminPassword,以及這些參數的值。
您無法利用 -enableAdminSecurity 參數來啟用自訂設定檔的管理安全。 如果要啟用自訂設定檔的安全,自訂設定檔必須聯合到部署管理程式中。 部署管理程式必須啟用管理安全,聯合的自訂設定檔才能啟用安全。
可以建立 Linux 服務。 有效值包括 true 或 false。此參數的預設值為 false。
在 -enableService 選項設為 true 的情況下,執行 manageprofiles 指令時,如果由 root 使用者執行指令,則會建立 Linux 服務與設定檔。 當非 root 使用者執行 manageprofiles 指令時,只會建立設定檔,而不會建立 Linux 服務。 因為非 root 使用者沒有足夠的許可權來設定服務,所以不會建立 Linux 服務。 建立設定檔結束時,會顯示 INSTCONPARTIALSUCCESS 結果,設定檔建立日誌 app_server_root/logs/manageprofiles_create_profilename.log 會包含一則訊息,指出現行使用者不具備足以設定 Linux 服務的許可權。
- 指出建立設定檔期間是否會聯合受管理設定檔,或者是否稍後使用 addNode 指令加以聯合。如果 dmgrHost、dmgrPort、dmgrAdminUserName 和 dmgrAdminPassword 參數沒有值,這個參數的預設值為 true。 有效值包括 true 或 false。
- 傳回預設設定檔的名稱。
- 取得給定名稱之設定檔的檔案系統位置。需要 –profileName 參數。
- 取得在給定 -profilePath 參數登錄的設定檔名稱。
- 顯示指令語法。
- 指定您在其中建立設定檔的主機名稱。這個主機名稱應該與您在安裝起始產品時所指定的主機名稱相符。 這個參數的預設值是完整格式的網域名稱系統。 這個參數值必須是有效的 IPv6 主機名稱,且不能包含空格或任何無效字元,例如:*、?、"、<、>、,、/、\、| 等等。
- 這個選用參數會搭配 -templatePath 參數使用,來取消擴增已擴增的特定設定檔。請參閱 -unaugment 參數。
- 指定當您建立設定檔時,用來匯入個人憑證之金鑰儲存庫檔的路徑。個人憑證是伺服器的預設個人憑證。-importPersonalCertKS 參數與 -personalCertDN 參數互斥。如果您未明確建立或匯入個人憑證,依預設會建立一個個人憑證。
最佳作法: 當您匯入個人憑證作為預設個人憑證時,請匯入簽章個人憑證的主要憑證。 否則,manageprofiles 指令會將個人憑證的公開金鑰新增到 trust.p12 檔中,且會建立一個主要簽署憑證。bprac
當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。
- 指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔中的憑證別名。
該憑證會新增至伺服器預設金鑰儲存庫檔,並且作為伺服器預設個人憑證使用。
當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。
- 指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔的密碼。
當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。
- 指定您在 -importPersonalCertKS 參數中指定之金鑰儲存庫檔的類型。其值可以是 JCEKS、CMSKS、PKCS12、PKCS11 和 JKS。不過,這份清單會根據 java.security 檔中的提供者而變更。
當您指定任何以 -importPersonal 開頭的參數時,必須將這些參數全部指定。
- 指定當您建立設定檔時,用來匯入主要憑證之金鑰儲存庫檔的路徑。該主要憑證是您作為伺服器預設主要憑證使用的憑證。
-importSigningCertKS 參數與 -signingCertDN 參數互斥。如果您沒有特別建立或匯入一個主要簽署憑證,則會以預設值建立一個。
當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。
- 指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔中的憑證別名。該憑證會新增至伺服器預設主要金鑰儲存庫,並且作為伺服器預設主要憑證使用。
當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。
- 指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔的密碼。
當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。
- 指定您在 -importSigningCertKS 參數中指定之金鑰儲存庫檔的類型。有效值可以是 JCEKS、CMSKS、PKCS12、PKCS11 和 JKS。不過,這份清單會根據 java.security 檔中的提供者而變更。
當您指定任何一個以 -importSigning 開頭的參數時,您必須指定所有這些參數。
- 指定由伴隨的 -profileName 參數所識別的設定檔一旦登錄之後,便會成為預設設定檔。當發出尋找預設設定檔的指令時,不需要使用指令的 -profileName 屬性。
- 指定伺服器只適用於開發用途。
將應用程式部署於正式作業應用程式伺服器之前,在建立設定檔以在非正式作業伺服器上測試應用程式時,這個參數很有用。
這個參數只對預設設定檔範本有效。
如果您同時指定了 -isDeveloperServer 和 -applyPerfTuningSetting 參數,依 -applyPerfTuningSetting 的所選選項而定,-applyPerfTuningSetting 可能會置換 -isDeveloperServer。
- 指定在建立設定檔期間,要用於所有已建立之金鑰儲存庫檔的密碼。金鑰儲存庫檔是專為預設的個人憑證和主要簽署憑證而建立。
- 列出在設定檔登錄之設定檔中已登錄的擴增項目。 您必須以 -listAugments 參數來指定 -profileName 參數。
- 列出在設定檔登錄中的設定檔。
- 在與 Cell 範本一起建立設定檔時,定義一組埠。如果指定此選項,則您無法同時指定 -nodePortsFile 或 nodeStartingPort 選項。
- 指定隨著新設定檔所建立之節點的節點名稱。請在 Cell 內或在機器上使用唯一的值。共用同一組產品二進位檔的每一個設定檔,都必須有唯一的節點名稱。
這個參數的預設值是根據簡短主機名稱、設定檔類型及結尾號碼。
預設節點名稱如下:
這個參數值不能包含空格或任何無效字元,例如:*、?、"、<、>、,、/、\、| 等等。
- 指定您要建立的 Cell 之節點部分的埠。 如果您指定這個選項,您就無法同時指定 -nodeDefaultPorts 或 -nodeStartingPort 選項。
- 指定通往 Cell 的節點部分的設定檔路徑。 當您建立 Cell 的部署管理程式部分時,請指定這個參數。
- 排除設定檔功能的選用性參數。每個設定檔範本都已預先定義,並含部分選用功能。下列選用特性可以搭配下列設定檔範本的 -omitAction 參數使用:
- 指定在建立設定檔時,所建立之個人憑證的識別名稱。請在引號中指定識別名稱。這個預設個人憑證位於伺服器金鑰儲存庫檔中。-importPersonalCertKSType 參數與 -personalCertDN 參數互斥。 請參閱 -personalCertValidityPeriod 參數和 -keyStorePassword 參數。
- 為一選用參數,指定通往定義新設定檔之埠設定的檔案路徑。
當使用 -startingPort 或 -defaultPorts 參數時,請勿使用此參數。
在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。
- 指定設定檔的名稱。建立設定檔時,請使用唯一的值。每個設定檔 (共用同一組產品二進位檔) 都必須有唯一名稱。預設設定檔名稱是以設定檔類型及尾端號碼為基礎,例如:
其中<profile_type><profile_number>
這個參數值不能包含空格或無效字元,例如下列中的任何字元:*、?、"、<、>、,、/、\、| 等等。
您不可以選擇使用中的設定檔名稱。
- 指定設定檔的完整路徑,稱為 profile_root。
請指定完整路徑以避免一項將設定檔聯合到 Cell 時,可能導致失敗的 Ant Script 限制。 例如:
-profilePath profile_root
如果完整路徑包含空格,請以引號含括該值。
預設值是根據 app_server_root 目錄、設定檔子目錄及設定檔的名稱為基礎。
預設值是根據 user_data_root 目錄、設定檔子目錄及設定檔的名稱為基礎。
比方說,預設值是:
WS_WSPROFILE_DEFAULT_PROFILE_HOME 元素定義在 app_server_root/properties 目錄內的 wasprofile.properties 檔中。WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
註: wasprofile.properties 檔含有下列內容:- WS_CMT_PI_MODPERMS
- 這個內容指定後置安裝程式是否應該修改它所建立之任何檔案的許可權。
有效值為 true 或 false。任何其他值都預設為 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 來指定值。
避免困難: 由於指定的值有區分大小寫,指定值中包含的字母必須是大寫字母。gotcha
- 您可以指定後置安裝程式保留日誌的時間量。指定值可以是 1 到 999 之間的任何整數,後面接著:
- D:如果以天來指定值。
- W:如果以週來指定值。
- M:如果以月來指定值。
- Y:如果以年來指定值。
避免困難: 由於指定的值有區分大小寫,指定值中包含的字母必須是大寫字母。gotcha
- 您可以指定特定日期,在該日期之後便刪除日誌。必須使用數值來指定值,並使用以橫線區隔的 DD-MM-YYYY 格式。舉例來說,如果您指定 WS_CMT_PI_LOGS=12-31-2013,所有日誌會在 2013 年 12 月 31 日刪除。
避免困難: 如果您沒有使用指示的格式(以橫線來區隔數字)來指定值,則會忽略這個內容設定。gotcha
- 從指令行利用 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
- 請勿在回應檔中指定空白行。這可能會導致錯誤。
Windows 作業系統中的 Path 陳述式可使用正斜線 (/) 或反斜線 (\)。如果 path 陳述式使用反斜線,則回應檔需要使用雙反斜線,回應檔才能正確瞭解該路徑。下面就是使用雙反斜線的建立作業回應檔範例:
create templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
最佳作法: 當切換平台時,請利用正斜線來減少出錯的機會。bprac
- 當您指定值時,請勿在值的開頭或結尾指定雙引號 (") 字元,即使這個值包含空格也一樣。
- 重要: 只有在相同修正套件層次建立的備份才支援 manageProfiles -restoreProfile 指令。還原設定檔備份。必須與 -backupFile 參數搭配使用,例如:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
如果要還原設定檔,請執行下列步驟: - 指定安全 Proxy 伺服器的起始安全層次設定。 有效值有 low、medium 和 high。 預設值為 high。安全層次是根據啟動使用者許可權、遞送考量、管理選項及錯誤處理程序。 在建立安全 Proxy 伺服器設定檔之後,您可以選擇性地變更您的安全設定。
- 指定伺服器的名稱。請只對 default 範本及 secureproxy 範本指定這個參數。 如果在使用 default 範本或 secureproxy 範本時,您沒有指定這個參數,預設設定檔的預設伺服器名稱是 server1,安全 Proxy 設定檔的預設伺服器名稱是 proxy1。
- 指定管理設定檔的類型。部署管理程式伺服器指定 DEPLOYMENT_MANAGER,管理代理程式伺服器指定 ADMIN_AGENT,工作管理程式伺服器指定 JOB_MANAGER。 當您建立管理設定檔時,這個參數是必要的。
請指定在建立 Linux 服務期間所用的使用者 ID,以便利用這個使用者 ID 來執行 Linux 服務。 Linux 服務在使用者 ID 登入時即可執行。
- 將預設設定檔設為其中一個現有的設定檔。其必須搭配使用 -profileName 參數使用,例如:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
- 指定在建立設定檔時,所建立之主要簽章憑證的識別名稱。請在引號中指定識別名稱。這個預設個人憑證位於伺服器金鑰儲存庫檔中。-importSigningCertKS 參數與 -signingCertDN 參數互斥。如果您沒有特別建立或匯入一個主要簽署憑證,則會以預設值建立一個。請參閱 -signingCertValidityPeriod 參數和 -keyStorePassword。
- 這個選用參數會指定主要簽章憑證有效的時間量(年)。如果您沒有搭配 -signingCertDN 參數來指定這個參數,主要簽署憑證在 15 年內有效。
- 請指定起始埠號,以產生及指派設定檔的所有埠號。
系統會從 -startingPort 值依序指派埠值,但略過那些已在使用中的埠。系統會辨識並解析目前在使用中的埠,並判定所指派的埠號以避免埠號衝突。
埠值會從 -startingPort 值開始,循序指派。
請勿將這個參數搭配 -defaultPorts 或 -portsFile 參數使用。
在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。
小心: 如果您使用受管理設定檔範本,請勿使用此參數。 - 請指定對安全 Proxy 伺服器至 Proxy 要求有效的通訊協定。 有效值有 SIP、HTTP 和 HTTP,SIP。
- 指定連至安裝根目錄中之範本檔案的目錄路徑。在 profileTemplates 目錄內,有各種對應於不同設定檔類型的目錄,且會因所安裝的產品類型而異。設定檔目錄是使用 -templatePath 選項時指出的路徑。您可以指定位於安裝根目錄以外的設定檔範本(如果有的話)。
如果設定檔範本是相對於 app_server_root/profileTemplates 目錄,您可以對 -templatePath 參數指定相對路徑。 否則,請指定完整的範本路徑。 F
default 範本路徑是 app_server_root/profileTemplates/default。 您可以對 -templatePath 參數使用相對路徑。 路徑是循序相對於現行工作目錄或 app_server_root/profileTemplates。 下列範例是根據獨立式應用程式伺服器的預設值來建立設定檔:
manageprofiles -create -profileName MyProfile -startingPort 10380
在設定檔概念主題中,有可用範本的說明。
- 擴增是利用擴增範本來變更現有設定檔的能力。
如果要取消擴增已擴增的設定檔,您必須指定 -unaugment 參數和 -profileName 參數。
如果執行了一系列的 manageprofiles 擴增,且只指定這兩個參數來取消擴增設定檔,取消擴增動作會先復原最後的擴增動作。
如果要取消擴增已擴增的特定設定檔,請額外搭配 -templatePath 參數來指定 -ignoreStack 參數。 您通常不會將特定設定檔取消擴增,因為您必須確定沒有違反設定檔範本相依關係。
使用 -templatePath 參數時,請為該參數指定完整的檔案路徑。
當使用 -templatePath 參數時,您可以指定參數的相對檔案路徑。
另請參閱擴增參數。
- 取消擴增所有以特定擴增範本擴增的設定檔。
-unaugmentAll 參數必須搭配 -templatePath 參數使用。
使用 -templatePath 參數時,請為該參數指定完整的檔案路徑。
當使用 -templatePath 參數時,您可以指定參數的相對檔案路徑。
您可以選擇性地同時指定 -unaugmentDependents 參數和 -unaugmentAll 參數,以取消擴增所有的設定檔,這些設定檔是正在取消擴增之設定檔的必備項目。
註: 如果您使用這個參數時,沒有以設定檔範本所擴增的設定檔,則可能會送出錯誤。另請參閱擴增參數。
- 如果指定的話,對於 -unaugmentAll 參數所取消擴增的設定檔,這個參數會將所有作為必要條件的已擴增的設定檔取消擴增。
如果沒有指定,就不會針對要取消擴增的設定檔,將作為必要條件的已擴增的設定檔取消擴增。
請搭配 -unaugmentAll 參數來指定 -unaugmentDependents 參數。
- 檢查所有列在設定檔登錄中的設定檔,看看檔案系統中是否有這些設定檔。從登錄移除任何遺漏的設定檔。然後傳回一份已從登錄刪除的遺漏設定檔清單。
- 檢查埠以驗證它們未保留或不在使用中。這個參數可協助您識別不在使用中的埠。如果判定已使用該埠,則會停止建立設定檔,且會顯示錯誤訊息。您可以隨時在建立指令行使用這個參數。建議您搭配 –portsFile 參數來使用這個參數。
- 檢查所有列在設定檔登錄中的設定檔,看看檔案系統中是否有這些設定檔。傳回遺漏設定檔的清單。
- 指出是否要設定 Web 伺服器定義。有效值包括 true 或 false。此參數的預設值為 false。
- 伺服器的主機名稱。此參數的預設值為本端機器的長主機名稱。
- Web 伺服器的本端或遠端安裝路徑。此參數的預設值取決於本端機器的作業系統及 webServerType 參數值。例如:
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “C:\” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath 預設為 “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath 預設為 “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath 預設為 “?” webServerType=APACHE: webServerInstallPath defaulted to “?” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath 預設為 “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath 預設為 “” webServerType=APACHE: webServerInstallPath 預設為 “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath 預設為 “n/a”
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”
- Web 伺服器的名稱。這個參數的預設值為 webserver1。
- Web 伺服器所在的作業系統。有效值包括:Windows、linux、solaris、aix、hpux、os390 和 os400。 請將這個參數搭配 webServerType 參數使用。
- Web 伺服器使用的外掛程式的路徑。此參數的預設值為 WAS_HOME/plugins。
- 指出將用來存取 Web 伺服器的埠。 這個參數的預設值為 80。
- Web 伺服器的類型。有效值包括:IHS、SUNJAVASYSTEM、IIS、DOMINO、APACHE 和 HTTPSERVER_ZOS。 請將此參數與 webServerOS 參數搭配使用。
針對設定檔建立之 Windows 服務的擁有者帳戶類型。 有效值包括 specifieduser 或 localsystem。 localsystem 值是以建立此設定檔之使用者的區域帳戶來執行 Windows 服務。 這個參數的預設值為 localsystem。
如果這個值是 specifieduser,就需要 winservicePassword 參數。 如果沒有指定,winserviceUserName 參數預設為環境使用者名稱值。
有效值是 True 或 False。 指定 true,以針對在設定檔內建立的伺服器程序建立 Windows 服務。指定 false 則不建立 Windows 服務。此參數的預設值為 false。
重要: 當使用自訂設定檔時,您無法利用這個參數來建立 Windows 服務。 相反地,請利用 WASService 指令來個別建立服務。指定要擁有 Windows 服務之區域帳戶或指定的使用者的密碼。
可能的 startup_type 值如下:
請閱讀 WASService 指令的相關文章,以取得 Windows 服務的相關資訊。
這個參數的預設值為 automatic。
指定您的使用者 ID,以便 Windows 作業系統可驗證您的 ID 是否可建立 Windows 服務。您的使用者 ID 必須屬於 Administrator 群組且擁有下列進階使用者權限:
重要: 當您利用指定的使用者和密碼來建立含有 Windows 服務的設定檔,且使用者是一位網域使用者時,您必須如下列範例所示,來使用雙重反斜線:winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
使用實務
下列範例示範正確的語法。 請在單行中,發出下列任何範例中的指令。 各範例用多行來顯示指令是為了看起來清楚。
日誌
範例:建立部署管理程式設定檔
安裝核心產品檔之後,您可以建立部署管理程式設定檔。 部署管理程式對於一或多部機器上的應用程式伺服器邏輯群組,提供了單一管理介面。請利用 manageprofiles.sh -create 指令來建立部署管理程式設定檔。
如果要建立名稱為 shasti 的部署管理程式設定檔,請執行下列動作:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
manageprofiles.sh -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath C:\shasti\WebSphere
-templatePath C:\IBM\WebSphere\AppServer\profileTemplates\management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetnt
-nodeName dmgr1
![[IBM i]](../images/iseries.gif)
manageprofiles -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
如果在建立設定檔期間,您沒有指定其中一個埠選項,就會使用建議的埠值集。 埠衝突解決演算法決定了這些埠。 建議的埠集不能有衝突。 如果您想要使用 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
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
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_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
下列範例利用 manageprofiles 指令的 startingPort 參數,以先前範例所顯示的內容,從起始值 20002 開始建立埠:
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath G:\shasti\WebSphere
-templatePath G:\shasti\WebSphere\profileTemplates\default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-profileName shasti
-profilePath app_server_root/profiles/shasti
-templatePath app_server_root/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[IBM i]](../images/iseries.gif)
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 參數來指定所產生之設定檔的完整路徑。
如果您沒有指定這個參數,每個設定檔路徑的預設值都是根據 app_server_root 目錄、設定檔子目錄及設定檔的名稱為基礎。
您建立的兩個設定檔,每一個都可以利用 -profilePath 參數來指定所產生之設定檔的完整路徑。
如果您沒有指定這個參數,每個設定檔路徑的預設值都是根據目錄、設定檔子目錄及設定檔的名稱為基礎。
構成 Cell 設定檔的兩個範本,彼此之間有相依關係,在兩個建立呼叫之間,需要一些相符的參數值。 如果要建立完整能運作的 Cell,在 cell_dmgr 設定檔和 cell_node 設定檔之間,-nodeProfilePath、-cellName、-appServerNodeName、-nodeName 等參數必須有相同的值。 就埠而言,尤其是動態配置的埠,當建立 Cell 後半部分時,必須參照 Cell 前半部分所用的埠。 請參照代表 Cell 前半部分之設定檔的下列檔案來使用 -portsFile 和 -nodePortsFile 引數:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[IBM i]](../images/iseries.gif)
![[Windows]](../images/windows.gif)
如需建立 Cell 設定檔的詳細說明,請使用下列指令:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/dmgr
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\dmgr
-help
![[IBM i]](../images/iseries.gif)
app_server_root/bin/manageprofiles -create
-templatePath
app_server_root/profileTemplates/cell/dmgr
-help
或
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/default
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\default
-help
![[IBM i]](../images/iseries.gif)
app_server_root/bin/manageprofiles -create
-templatePath
app_server_root/profileTemplates/cell/default
-help
當建立 Cell 部署管理程式設定檔和 Cell 節點設定檔時,-help 參數的輸出指定哪些參數是必要的,哪些是選用的。
建立 Cell 設定檔的部署管理程式和節點部分之後,兩部伺服器之間,必須進行同步化。 依預設,在兩部伺服器之間,會依照指定的間隔來自動進行同步化。 不過,如果同步化已停用、間隔太長,或發生問題導致無法及時同步化,請執行 syncNode 指令,將部署管理程式和節點同步化。
您必須使用 portsFile 或 nodePortsFile 參數,以及 startingPort 或 nodeStartingPort 參數。
如果您使用 manageprofiles 指令,您可以選擇您想要作為預設值的設定檔。
如果您在建立 Cell 設定檔的過程中利用 -appServerNodeName 參數來聯合應用程式伺服器節點,則該節點不會有原始配置。
如果您在建立 Cell 設定檔期間所建立的節點上使用 -removeNode 指令,指令會指出節點移除公用程式無法移除節點及將節點還原為基本配置。
如果要順利移除在建立 Cell 設定檔的過程中所聯合的節點,請利用 manageprofiles 指令來刪除節點的設定檔。
刪除節點的設定檔之後,請在「部署管理程式」上,利用 -cleanupNode 指令從 Cell 儲存庫中移除節點配置。
您可以利用「設定檔管理工具」或 manageprofiles 指令來建立新的設定檔。
範例:使用預先定義的埠號
當您沒有明確設定埠值時,manageprofiles 指令會建議起始埠值。 您可以改用預先定義的埠值。
設定檔 | 檔案路徑 |
---|---|
應用程式伺服器 | 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 |
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 指令,以使用者定義的埠值來建立設定檔之後,會顯示成功或失敗的結果。
![[IBM i]](../images/iseries.gif)
manageprofiles 指令會在 profile_root\properties 目錄中建立現行 portdefs.props 檔的副本。
在 manageprofiles 指令中,請只用 -startingPort、-defaultPorts 或 -portsFile 這三個埠值參數其中一個。 這三個參數互斥。