[AIX Solaris HP-UX Linux Windows]

Creating custom profiles

Create a custom profile so that you can include application servers, clusters, or other Java™ processes, such as a messaging server, in its empty node. You can use the 設定檔管理工具 to create a custom profile.

Before you begin

使用「設定檔管理工具」之前,請先安裝產品檔案。

支援的配置 支援的配置:設定檔管理工具」是 manageprofiles 指令的圖形使用者介面,只有 AIX®、Linux 和 Windows 才支援它。在 HP-UX、IBM® i 和 Solaris 中,請改用 manageprofiles 指令。sptcfg

您必須提供足夠的系統暫存空間來建立設定檔。如需相關資訊,請閱讀有關設定檔的檔案系統需求的說明。

Attention: 啟動「設定檔管理工具」時,在下列狀況中,如果是非 root 使用者,工具可能鎖定:以 root 身分登入機器、利用 SetPermissions 公用程式來將使用者 x 變更為 y。 假設您是使用者 x,且重新登入機器。啟動「設定檔管理工具」,按一下設定檔管理工具,然後按一下建立。按一下建立之後,再按一下,可能會鎖定工具。

About this task

After installing the core product files for the WebSphere® Application Server, Network Deployment product, you must create a profile. This article describes creating a custom profile using the 設定檔管理工具. A custom profile is an empty node that you can customize to include application servers, clusters, or other Java processes, such as a messaging server.

You can also use the manageprofiles command to create a custom profile. See the description of the manageprofiles command for more information.

Templates for each profile are located in the app_server_root/profileTemplates directory.

Multiple directories exist within this directory, which correspond to different profile types and vary with the type of product that is installed. The directories are the paths that you indicate while using the manageprofiles command with the -templatePath option. You can also specify profile templates that exist outside the profileTemplates directory, if you have any.

You can specify the -templatePath parameter on the manageprofiles command to obtain a description of the available templates. These templates are also described in the Profile concepts topic.

By default, the 設定檔管理工具 federates a custom node when you create a custom profile. Federating the node makes the node operational. You must have access to a running deployment manager to federate the node. Otherwise, a connection error displays. You can federate the node later if you do not have access to a running deployment manager, or for any other reason.

If the custom profile is on a machine that does not have a deployment manager, then the deployment manager must be accessible over the network to support the federation of the node.

您可以在「設定檔管理工具」中,利用建立一般設定檔程序或建立進階設定檔程序,來建立設定檔。建立一般設定檔程序使用預設值,且會指派唯一埠值。您可以選擇性依所容許來設定各個值。如果是建立進階設定檔程序,您可以接受預設值,或指定您自己的值。

Procedure

  1. Install the product to create the core product files.
  2. 啟動設定檔管理工具來建立新的執行時期環境。
    您可以利用下列其中一種方式來啟動工具。
    • 在安裝結束時,選取用來啟動「設定檔管理工具」的勾選框。
    • 直接在命令提示字元下發出指令,來開啟 WebSphere Customization Toolbox;然後開啟「設定檔管理工具」。
    • 從「首要步驟」主控台,選取 WebSphere Customization Toolbox 選項;然後開啟「設定檔管理工具」。
    • [Windows]利用開始功能表,存取 WebSphere Customization Toolbox;然後開啟「設定檔管理工具」。
    • [Linux]使用用來啟動程式的 Linux 作業系統功能表,來啟動 WebSphere Customization Toolbox;然後,開啟「設定檔管理工具」。
  3. 在「設定檔」標籤上,按一下建立,來建立新的設定檔。

    「設定檔」標籤包含已在您的機器上建立的設定檔清單。除非設定檔可以擴增,否則,無法對選取的設定檔執行任何動作。除非您選取的設定檔可以擴增,否則,「擴增」按鈕會變成灰色。

    工具會顯示「選取環境」畫面。

  4. Select the custom profile, and click Next.

    即會顯示「設定檔建立選項」畫面。

  5. 選取建立一般設定檔建立進階設定檔,然後按下一步

    建立一般設定檔選項會建立使用預設配置設定的設定檔。當使用建立進階設定檔選項時,您可以指定您自己的設定檔配置值。

  6. If you selected Typical profile creation, then go to the step on federating the node.
  7. If you selected Advanced profile creation, then specify the custom profile name and the profile directory on the Profile name and location panel, or accept the defaults, and click Next.
    設定檔命名準則:支援雙位元組字元。設定檔名稱可以是任何唯一名稱,但有下列限制。在命名設定檔時,請勿使用下列任一字元:
    • 空格
    • 作業系統上的目錄名稱中不支援的特殊字元,例如 *&?
    • 斜線 (/) 或 (\)

    預設設定檔

    您在機器上建立的第一個設定檔會是預設的設定檔。預設設定檔是從產品安裝根目錄下的 bin 目錄中,所發出指令的預設目標。當機器上只有一個設定檔時,每一個指令都只會處理配置中的單一伺服器程序。您可以在建立另一個設定檔時,在建立進階設定檔路徑的「設定檔名稱和位置」畫面上,勾選將這個設定檔設為預設設定檔,將它設為預設設定檔。您也可以在建立設定檔之後,利用 manageprofiles 指令,將另一個設定檔設為預設設定檔。

    在多重設定檔環境中定址某個設定檔

    當機器上有多個設定檔時,如果指令所套用的設定檔不是預設設定檔,某些指令會要求您指定該設定檔。這些指令會使用 -profileName 參數來識別要處理的設定檔。您可能發現使用每一個設定檔的 bin 目錄中的指令比較容易。

    請利用這些指令,來查詢指令 Shell,以判斷發出呼叫的設定檔,並將這些指令定址至發出呼叫的設定檔。

    預設設定檔資訊

    預設設定檔名稱是 <profile_type><profile_number>
    • <profile_type> 是值 AppSrvDmgrCustomAdminAgentJobMgrSecureProxySrv
    • <profile_number> 是用來建立唯一設定檔名稱的序號。

    [AIX][Linux]預設的設定檔目錄是 app_server_root/profiles,其中 app_server_root 是安裝根目錄。

    [Windows]預設的設定檔目錄是 app_server_root\profiles,其中 app_server_root 是安裝根目錄。

    The tool then displays the Node and host names panel.

  8. Specify the node and host characteristics for the custom profile, and click Next.

    If you plan to migrate a previous installation of WebSphere Application Server, Network Deployment to 9.0 版, then use the same cell name for the 9.0 版 deployment manager that you used for the previous version of the cell. 在任何情況下,如果產品是在相同的實體機器或機器叢集(如 Sysplex)中執行,Cell 名稱必須是唯一的。另外,在任何需要實體間之網路連線的情況中,只要這個連線是在 Cell 之間,或是來自必須與每個 Cell 通訊的用戶端,Cell 名稱也必須是唯一的。另外,如果 Cell 的名稱空間是聯合的,Cell 名稱也必須是唯一的。否則,您可能會遇到 javax.naming.NameNotFoundException 錯誤之類的症狀;在這種情況下,請建立有唯一名稱的 Cell。

    After migrating the cell, the previous version's managed nodes are now managed by the 9.0 版 deployment manager in compatibility mode. You can migrate individual managed nodes in the cell to 9.0 版. To do so, you must create a 9.0 版 profile with the same node name as the previous version managed node.

    保留名稱:請避免使用保留的資料夾名稱作為欄位值。使用保留的資料夾名稱會導致無法預期的結果。下列詞彙是保留的資料夾名稱:
    • Cell
    • 節點
    • 伺服器
    • 叢集
    • 應用程式
    • 部署
    Table 1. Characteristics of the custom profile.

    This table shows the characteristics of the custom profile.

    Field Name Default Value Constraints Description
    Node name
    shortHostName
    Node
    NodeNumber
    其中:
    • shortHostName 是簡短主機名稱。
    • NodeNumber 是從 01 開始的序號
    Avoid using the reserved terms.

    Use a unique name within the deployment manager cell.

    If you plan to migrate a managed node from a previous version, then use the same node name for this 9.0 版 custom profile.

    The name is used for administration within the deployment manager cell to which the custom profile is added. Use a unique name within the deployment manager cell.

    After migrating a previous version of a deployment manager cell to a 9.0 版 deployment manager, you can migrate the previous version's custom profiles that are running in compatibility mode in the 9.0 版 deployment manager.

    Host name

    長格式的網域名稱伺服器 (DNS) 名稱。

    The host name must be addressable through your network. Use the actual DNS name or IP address of your machine to enable communication with your machine. See additional information about the host name that follows this table.
    Directory path considerations:

    [Windows]profiles_directory_path\profile_name 目錄中的字元數必須小於或等於 80 個字元。

    Host name considerations:

    主機名稱是節點安裝所在之實體機器的網路名稱。主機名稱必須解析成伺服器上的實體網路節點。如果伺服器中有多片網路卡,主機名稱或 IP 位址必須解析成其中一片網路卡。遠端節點利用主機名稱來連接這個節點,並與這個節點通訊。選取網路中其他機器能夠呼叫到的主機名稱很重要。對於此值,請勿使用一般 ID localhost。此外,如果機器的主機名稱使用雙位元組字集 (DBCS) 中的字元,請勿嘗試將 WebSphere Application Server 產品安裝在該機器上。不支援在主機名稱中使用 DBCS 字元。

    如果您在同一部電腦上,以唯一 IP 位址來定義同時存在的節點,請在網域名稱伺服器 (DNS) 查閱表中定義每個 IP 位址。獨立式應用程式伺服器的配置檔在使用單一網址的機器上,不提供對多個 IP 位址進行網域名稱解析。

    您指定給主機名稱的值,會作為獨立式應用程式伺服器之配置文件中的 hostName 內容值。請使用下列其中一種格式,來指定主機名稱值:
    • 完整網域名稱伺服器 (DNS) 主機名稱字串,例如 xmachine.manhattan.ibm.com
    • 預設簡短 DNS 主機名稱字串,例如 xmachine
    • 數值 IP 位址,例如 127.1.255.3

    完整 DNS 主機名稱的優點是明確而靈活。您可以靈活變更主機系統的實際 IP 位址,且不需要變更應用程式伺服器配置。當您利用「動態主機配置通訊協定 (DHCP)」來指派 IP 位址時,如果您打算經常變更 IP 位址,這個主機名稱值就特別有用。此格式的缺點是需倚賴 DNS。如果 DNS 無法使用,連線功能就會受損。

    簡短主機名稱也可供動態解析。簡稱格式的附加功能是能夠在本端 hosts 檔案中重新定義,因此即使網路斷線,系統也能夠執行應用程式伺服器。如果要在斷線情況下執行,請在 hosts 檔案中,將簡稱定義成迴圈位址 (127.0.0.1),以便在斷線情況下執行。這個格式的缺點是遠端存取時需倚賴 DNS。如果 DNS 無法使用,連線功能就會受損。

    數值 IP 位址的優點是不需透過 DNS 進行名稱解析。遠端節點可以連接您使用數值 IP 位址命名的節點,而不需要有可用的 DNS。此格式的缺點為數值 IP 位址是固定的。

    After specifying custom profile characteristics, the tool displays the Federation panel.

  9. If administrative security is enabled for the deployment manager, specify the host name and SOAP port of the deployment manager, and the user name and password for the deployment manager. Click Next.
    聯合之後,自訂設定檔中的程序是節點代理程式程序。節點代理程式程序是自訂節點之部署管理程式的代理程式。節點代理程式會回應部署管理程式的指令,以執行包括下列動作在內的作業:
    • 建立應用程式伺服器程序、叢集和叢集成員
    • 啟動和停止應用程式伺服器程序
    • 在部署管理程式上的現行版本與節點上現存的副本之間,將配置同步化
    • 刪除應用程式伺服器程序
    請參閱資訊中心的系統管理一節,以取得節點代理程式及其作業的相關資訊。

    應該聯合節點嗎?

    建議您在這時候聯合自訂節點。當您在「聯合」畫面中按下一步,來聯合自訂節點時,部署管理程式必須正在執行且可供存取。如果自訂設定檔位於沒有部署管理程式的機器上,部署管理程式必須正在執行,並且可透過網路存取,才能聯合節點。在您按下一步之前,如果部署管理程式不在執行中或無法存取,但此時您可以啟動它,使它成為可供存取,請執行這個動作。否則,請選取之後再聯合節點勾選框。

    如果您不確定部署管理程式是否正在執行或可以存取,請不要立即聯合節點。請在您可以驗證部署管理程式的可用性時,再聯合節點。

    部署管理程式可能已重新配置成使用非預設的遠端方法呼叫 (RMI),作為偏好的「Java 管理延伸 (JMX)」連接器。在部署管理程式的管理主控台中,按一下系統管理 > 部署管理程式 > 管理服務,來驗證偏好的連接器類型。

    如果 RMI 是偏好的 JMX 連接器,您必須之後再使用 addNode 指令,來聯合自訂設定檔。請使用 addNode 指令,以便能夠指定 JMX 連接器類型和 RMI 埠。

    如果部署管理程式使用了預設的 SOAP JMX 連接器類型,請現在指定主機名稱和 SOAP 埠並聯合節點,來建立您可自訂且可運作的節點。

    在部署管理程式無法使用時聯合

    在聯合自訂節點時,如果部署管理程式不在執行中或無法存取,就會顯示錯誤訊息。在建立設定檔程序期間,如果部署管理程式變成無法使用,日誌中的安裝指示器會是 INSTCONFFAIL,表示完全失敗。產生的自訂設定檔將無法使用。您必須刪除這個設定檔。 如需相關資訊,請閱讀有關刪除設定檔的說明。

    If you chose to federate now, and you previously selected Advanced profile creation, then the Security certificate panel displays next. Go to the step on creating and importing certificates.

    Otherwise, the Profile Creation Summary panel displays for the typical profile creation option. Go to the step on creating the custom profile.

  10. 建立預設個人憑證和主要簽章憑證,或從金鑰儲存庫檔中匯入個人憑證和主要簽署憑證,然後按下一步

    您可以同時建立或匯入這兩個憑證,也可以建立其中一個憑證,並匯入另一個憑證。

    最佳作法 最佳作法: 當您匯入個人憑證作為預設個人憑證時,請匯入簽章個人憑證的主要憑證。否則,「設定檔管理工具」會新增個人憑證的簽章者到 trust.p12 檔中。bprac

    如果您匯入預設個人憑證或主要簽署憑證,請針對您匯入的每一個憑證,指定其路徑和密碼,並選取其金鑰儲存庫類型和金鑰儲存庫別名。

  11. 驗證憑證資訊是正確的,然後按下一步

    如果是建立憑證,可以使用預設值,或是加以修改,來建立新的憑證。依預設,預設個人憑證的有效期為一年,且是由主要簽章憑證簽署。依預設,主要簽章憑證是一個有效期 15 年的自簽憑證。主要簽章憑證的預設金鑰儲存庫密碼為 WebAS。您應該變更密碼。密碼不能包含任何雙位元組字集 (DBCS) 字元,因為某些金鑰儲存庫類型(包括 PKCS12)不支援這些字元。支援的金鑰儲存庫類型取決於 java.security 檔中的提供者。

    當您建立或匯入這兩個憑證之一或全部時,所建立的金鑰儲存庫檔有 key.p12、trust.p12、root-key.p12、default-signers.p12、deleted.p12 和 ltpa.jceks。當您建立或匯入憑證時,這些檔案全都有相同的密碼,有可能是預設密碼,或是您指定的密碼。key.p12 檔包含預設個人憑證。trust.p12 檔包含預設主要憑證中的簽章者憑證。root-key.p12 檔包含主要簽署憑證。default-signer.p12 檔包含安裝並執行伺服器之後,新增到任何新金鑰儲存庫檔的簽章者憑證。依預設,預設主要憑證簽章者和 DataPower® 簽章者憑證位於 default-signer.p12 金鑰儲存庫檔中。deleted.p12 金鑰儲存庫檔用來保存 deleteKeyStore 作業所刪除的憑證,以便在必要時可以回復。ltpa.jceks 檔含有伺服器預設的「小型認證機構 (LTPA)」金鑰,可供您環境中的伺服器用來彼此通訊。

    所匯入的憑證會新增到 key.p12 檔或 root-key.p12 檔中。

    如果您匯入任何憑證,但這些憑證沒有包含您要的資訊,請按上一步,匯入另一個憑證。

    如果您先前選取了建立進階設定檔,在顯示「安全憑證」畫面之後,工具會顯示「埠」畫面。

  12. Verify that the ports within the custom profile are unique, or intentionally conflicting, and click Next.

    解決埠衝突

    如果您懷疑發生埠衝突,您可以在建立設定檔之後,再調查埠衝突。請檢查下列檔案,判斷建立設定檔期間所用的埠。
    • [AIX][Linux]profile_root/properties/portdef.props
    • [Windows]profile_root\properties\portdef.props
    這個檔案包含設定埠時所使用的索引鍵和值。如果發現埠衝突,您可以手動重新指派埠。如果要重新指派埠,請利用 ws_ant Script 來執行 updatePorts.ant 檔。

    The Profile Creation Summary panel is displayed.

  13. Click Create to create the custom profile, or click Back to change the characteristics of the custom profile.

    If you previously chose to federate the custom node on the Federation panel, the deployment manager had to be running and accessible. The deployment manager must be running and accessible when you click Create. If you think the deployment manager might no longer be running or might have become inaccessible, then start the deployment manager and make it accessible, or make it accessible if it is already running.

    即會顯示「設定檔建立進度」畫面,其中顯示配置指令正在執行。

    設定檔建立完成之後,工具會顯示「設定檔建立完成」畫面。

  14. 您可以選擇性地選取啟動「首要步驟」主控台。按一下完成,結束作業。

    您可以利用「首要步驟」主控台來建立其他設定檔,並啟動應用程式伺服器。

Results

You created a custom profile. The node within the profile is empty until you federate the node and use the deployment manager to customize the node.

目錄結構會顯示 profiles 目錄內的新設定檔資料夾。設定檔資料夾與您建立的設定檔同名。

請參閱 manageprofiles 指令的說明,瞭解如何利用指令,而不使用「設定檔管理工具」,來建立設定檔。

在建立設定檔期間,「設定檔管理工具」會建立一個日誌。此日誌位於 install_dir/logs/manageprofiles 目錄。檔案的命名型樣如下:manageprofiles_create_profile_name.log

What to do next

Federate the node into the deployment manager cell if you did not already do so when you created the node. Then, use the deployment manager to create an application server on the node.

請從部署應用程式開始。

請閱讀有關產品捷徑的說明,以開始部署應用程式。


指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: July 9, 2016 11:16
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tpro_instancesmngdnode
檔名:tpro_instancesmngdnode.html