![[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
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。
- 請使用 augment 參數,以擴增範本來變更現有的設定檔。augment 參數會導致 manageprofiles 指令使用 -templatePath 參數中的範本,來更新或擴增 -profileName 參數中識別的設定檔。
您可以使用的擴增範本是由安裝在環境中的 IBM® 產品與版本來判定。重要: WebSphere® Application Server 基本 產品隨附的範本只能用來建立設定檔,不能用來擴增現有的設定檔,因為產品只隨附建立範本。
此外,請勿手動修改 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 之間進行遠端通訊時(例如:遠端 Enterprise JavaBeans 呼叫),可能會遇到問題。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 檔案,以在解除安裝程序期間判定任何問題的原因。
當您刪除設定檔時,也會刪除設定檔的目錄,因此,您不需要手動刪除目錄即可重建設定檔。如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。
- 刪除所有登錄的設定檔。
刪除設定檔,並不會連同設定檔目錄一起刪除。
比方說,假設您在 /usr/WebSphere/AppServer/profiles/managedProfile 目錄中建立設定檔。
在您刪除設定檔之後,仍會保留目錄。
您可以刪除或保留目錄。然而,profile_root/logs 目錄包含解除安裝設定檔的相關資訊。例如,您可能會保留 _nodeuninst.log 檔案,以在解除安裝程序期間判定任何問題的原因。
當您刪除設定檔時,也會刪除設定檔的目錄,因此,當您重建設定檔時,不會有過時的資訊需要管理。如果設定檔登錄中,所刪除的設定檔已登錄要擴增範本,則會自動執行取消擴增動作。
- 啟用管理安全。有效值包括 true 或 false。預設值為 false。
- 當 enableAdminSecurity 設為 true 時,您還必須指定參數 -adminUserName 及 -adminPassword,以及這些參數的值。
可以建立 Linux 服務。
有效值包括 true 或 false。此參數的預設值為 false。在 -enableService 選項設為 true 的情況下,執行 manageprofiles 指令時,如果由 root 使用者執行指令,則會建立 Linux 服務與設定檔。 當非 root 使用者執行 manageprofiles 指令時,只會建立設定檔,而不會建立 Linux 服務。 因為非 root 使用者沒有足夠的許可權來設定服務,所以不會建立 Linux 服務。 建立設定檔結束時,會顯示 INSTCONPARTIALSUCCESS 結果,設定檔建立日誌 app_server_root/logs/manageprofiles_create_profilename.log 會包含一則訊息,指出現行使用者不具備足以設定 Linux 服務的許可權。
- 傳回預設設定檔的名稱。
- 取得給定名稱之設定檔的檔案系統位置。需要 –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 參數。
- 列出在設定檔登錄中的設定檔。
- 指定隨著新設定檔所建立之節點的節點名稱。請在機器上使用唯一的值。共用同一組產品二進位檔的每一個設定檔,都必須有唯一的節點名稱。
這個參數的預設值是根據簡短主機名稱、設定檔類型及結尾號碼。
預設節點名稱如下:這個參數值不能包含空格或任何無效字元,例如:*、?、"、<、>、,、/、\、| 等等。
- 排除設定檔功能的選用性參數。每個設定檔範本都已預先定義,並含部分選用功能。下列選用特性可以搭配下列設定檔範本的 -omitAction 參數使用:
- 指定在建立設定檔時,所建立之個人憑證的識別名稱。請在引號中指定識別名稱。這個預設個人憑證位於伺服器金鑰儲存庫檔中。-importPersonalCertKSType 參數與 -personalCertDN 參數互斥。 請參閱 -personalCertValidityPeriod 參數和 -keyStorePassword 參數。
- 為一選用參數,指定通往定義新設定檔之埠設定的檔案路徑。
當使用 -startingPort 或 -defaultPorts 參數時,請勿使用此參數。
在建立設定檔期間,如果您未指定 -startingPort 參數、-defaultPorts 參數或 -portsFile 參數,則 manageprofiles 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。
- 指定設定檔的名稱。建立設定檔時,請使用唯一的值。每個設定檔 (共用同一組產品二進位檔) 都必須有唯一名稱。預設設定檔名稱是以設定檔類型及尾端號碼為基礎,例如:
其中<profile_type><profile_number>這個參數值不能包含空格或無效字元,例如下列中的任何字元:*、?、"、<、>、,、/、\、| 等等。
您不可以選擇使用中的設定檔名稱。
- 指定設定檔的完整路徑,稱為 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如果要還原設定檔,請執行下列步驟: - 指定伺服器的名稱。請只對 default 範本及 secureproxy 範本指定這個參數。 如果在使用 default 範本或 secureproxy 範本時,您沒有指定這個參數,預設設定檔的預設伺服器名稱是 server1,安全 Proxy 設定檔的預設伺服器名稱是 proxy1。
- 指定管理設定檔的類型。管理代理程式伺服器指定 ADMIN_AGENT。 當您建立管理設定檔時,這個參數是必要的。
請指定在建立 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 指令會使用自動產生的一組建議埠號。根據預設埠的可用性,建議埠值可能會不同於預設埠值。
小心: 如果您使用受管理設定檔範本,請勿使用此參數。 - 指定連至安裝根目錄中之範本檔案的目錄路徑。在 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 參數值。例如:
![[Windows]](../images/windows.gif)
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”![[Linux]](../images/linux.gif)
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”![[AIX]](../images/aixlogo.gif)
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”![[HP-UX]](../images/hpux.gif)
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”![[Solaris]](../images/solaris.gif)
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”![[IBM i]](../images/iseries.gif)
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 指令可以根據起始埠值來指派埠號。 您可以利用 -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
下列範例利用 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
範例:使用預先定義的埠號
當您沒有明確設定埠值時,manageprofiles 指令會建議起始埠值。 您可以改用預先定義的埠值。
| 設定檔 | 檔案路徑 |
|---|---|
| 應用程式伺服器 | app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props |
| 管理代理程式伺服器的管理設定檔 | app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.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
執行 manageprofiles 指令,以使用者定義的埠值來建立設定檔之後,會顯示成功或失敗的結果。
註: 建立設定檔成功之後,主控台會列印一則指示成功的訊息,且會建議您檢查 AboutThisProfile.txt 檔。
不過,當您在 IBM i 上建立用戶端設定檔或外掛程式設定檔時,不會產生 AboutThisProfile.txt 檔。manageprofiles 指令會在 profile_root\properties 目錄中建立現行 portdefs.props 檔的副本。
在 manageprofiles 指令中,請只用 -startingPort、-defaultPorts 或 -portsFile 這三個埠值參數其中一個。 這三個參數互斥。
![[AIX HP-UX Solaris]](../images/unix.gif)
參照主題