test

Sun N1 Service Provisioning System User's Guide for BEA WebLogic 9 Plug-in 1.0

Creating WebLogic Machines

You can set up a WebLogic machine to use the Node Manager process to remotely manage your Managed Servers. To use the Node Manager process to control your Managed Server, you must install the WebLogic machine component, and then enroll the Machine in a domain.

Choose the appropriate procedure to create a WebLogic machine.

ProcedureHow to Create WebLogic Machines

This procedure describes how to install the WebLogic machine component and start the Node Manager process.

To incorporate an existing WebLogic machine in your N1 SPS environment, see How to Capture an Existing WebLogic Machines in Your N1 SPS Environment.

Steps

  1. In the Common Tasks section in the browser interface, click WebLogic 9.

  2. Click the WebLogic Machine Installation: Install link.

    The plan's Details page displays.

  3. Click Run.

    The Run page displays.

  4. In the Plan Parameters area, select the variable settings for the Machine component that you plan to deploy.

    The Machine component represents the Machine instance within the WebLogic 9 environment.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly updated variables for the Machine component.

        variable set name

        Required. A name for the new variable set you create

        machineName

        Required. Specifies the name for the Node Manager machine in the domain. The default value is the host name of the target host.

        nodeManagerPort

        Required. Specifies the port that the Node Manager uses to listen for communication. The default value is 5556.

        nodeManagerListenAddress

        Required. Specifies the IP address the Node Manager uses to listen. The default value is the IP address of the Remote Agent.

        unixPlatform

        Required. Specifies the type of machine to create (true,false). The default value is true.

        weblogicUser

        Required. The UNIX user to run the Node Manager. This user must exist on the host to be installed and must have write permission on the beaHome directory. The default value is the value for the weblogicUser variable that is set for the installall component.

        wlHomeDir

        Required. Specifies the location of the WebLogic software installation. Do not change this variable.

        installPath

        Required. Specifies the unique install path for the machine. Do not change this variable.

      • If you want to use another component's variable settings, click Import Set From Component.

        The Import Variable Settings window displays.

        1. If necessary, navigate to the Folder that contains the component with the variable settings you want to import.

        2. Select the component version.

          Note –

          Variable settings can vary between component versions. Ensure that the current components and the component from which you want to import variable settings share common variables. If the component from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable settings are not imported.

        3. Click Import Variable Settings.

          The variables settings are imported, and are displayed in the table.

        4. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

      • If you want to use component variable settings that are stored in a file, follow these steps.

        1. In the Import Sets from File text field, enter the path to the variable settings file that you want to use.

          To browse through the file system to find the appropriate file, click the Browse button.

        2. Click Import.

          The variables settings are imported, and are displayed in the table.

          Note –

          If the file from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable set is not imported.

        3. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

  5. Select the target host or target host set.

    The WebLogic machine resides on the Remote Agent that you target.

    Note –

    The target host must be a member of the com.sun.weblogic#InstallHS host set.

    Target the virtual host that was created when you installed the WebLogic software. See How to Install the WebLogic Software procedure.

  6. If you want to start the Node Manager after the installation, verify that the Start Node Manager checkbox is checked.

  7. (Optional) If you want to pass any Java arguments to the WebLogic Server Scripting Tool (WLST) during the installation, type the arguments in the Java Arguments Used for weblogic.WLST field.

    You might need to use WLST if the Administration Server port uses SSL and requires demo certificates.

    For information on how to perform administrative tasks and configuration changes using the WLST, see BEA's WebLogic Server Using the WebLogic Server Scripting Tool document

  8. Click Run Plan (Includes Preflight).

    The provisioning software creates the WebLogic machine.

  9. Verify that the WebLogic machine was created.

    1. In the Common Tasks section of the browser interface, click WebLogic 9.

    2. Click the WebLogic Machine Installation: View Installations link.

      The Component Details Where Installed page displays. The WebLogic machine you created appears in the Hosts Where Installed table with the extension -machine.

Next Steps

You must enroll your WebLogic machine in a WebLogic domain. For instructions, see How to Enroll WebLogic Machines in a Domain.

To use the WebLogic machine to manage your Managed Servers, you must instruct your Managed Servers to use Node Manager. See How to Create a WebLogic Managed Server.

ProcedureHow to Capture an Existing WebLogic Machines in Your N1 SPS Environment

This procedure describes how to incorporate an existing WebLogic machinein the provisioning system.

To create a new WebLogic machine, see How to Create WebLogic Machines.

Steps

  1. In the Application Deployments section in the browser interface, click Components.

    The Components page is displayed.

  2. If necessary, click the Change Folder link to navigate to the com/sun/weblogic9 folder.

  3. In the Components column, click Machine.

    The Components Details page is displayed.

  4. In the Component Procedures table, click the Run link in the install: markOnly row.

    The Plans Details Run page is displayed.

  5. In the Plan Parameters area, select the variable settings for the Machine component that you plan to deploy.

    The Machine component represents the Machine instance within the WebLogic 9 environment.

    • If the variable settings have been established for this component, select the appropriate settings from the menu.

    • If the settings are not available from the menu, click Select From List.

      The Select Variable Settings From List window displays.

      • To create a new set of variable settings, select Create Set.

        The following list provides commonly updated variables for the Machine component.

        variable set name

        Required. A name for the new variable set you create

        machineName

        Required. Specifies the name for the Node Manager machine in the domain. The default value is the host name of the target host.

        nodeManagerPort

        Required. Specifies the port that the Node Manager uses to listen for communication. The default value is 5556.

        nodeManagerListenAddress

        Required. Specifies the IP address the Node Manager uses to listen.

        unixPlatform

        Required. Specifies the type of machine to create (true,false). The default value is true.

        weblogicUser

        Required. The UNIX user to run the Node Manager. This user must exist on the host to be installed and must have write permission on the beaHome directory.

        wlHomeDir

        Required. Specifies the location of the WebLogic software installation.

        installPath

        Required. Specifies the unique install path for the machine.

      • If you want to use another component's variable settings, click Import Set From Component.

        The Import Variable Settings window displays.

        1. If necessary, navigate to the Folder that contains the component with the variable settings you want to import.

        2. Select the component version.

          Note –

          Variable settings can vary between component versions. Ensure that the current components and the component from which you want to import variable settings share common variables. If the component from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable settings are not imported.

        3. Click Import Variable Settings.

          The variables settings are imported, and are displayed in the table.

        4. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

      • If you want to use component variable settings that are stored in a file, follow these steps.

        1. In the Import Sets from File text field, enter the path to the variable settings file that you want to use.

          To browse through the file system to find the appropriate file, click the Browse button.

        2. Click Import.

          The variables settings are imported, and are displayed in the table.

          Note –

          If the file from which you want to import variable settings does not share common variables with the component you want to use in your plan, the variable set is not imported.

        3. On the Plan Details Run page, select the variable settings that you imported from the Variable Settings drop-down list, then click Select.

  6. Select the target host or target host set.

    The WebLogic machine resides on the Remote Agent that you target.

    Note –

    The target host must be a member of the com.sun.weblogic#InstallHS host set.

    Target the virtual host that was created when you installed the WebLogic software. See How to Install the WebLogic Software procedure.

  7. Click Run Plan (Includes Preflight).

    The provisioning software creates the WebLogic machine.

  8. Verify that the WebLogic machine was created.

    1. In the Common Tasks section of the browser interface, click WebLogic 9.

    2. Click the WebLogic Machine Installation: View Installations link.

      The Component Details Where Installed page displays. The WebLogic machine you created appears in the Hosts Where Installed table with the extension -machine.

Next Steps

You must enroll your WebLogic machine in a WebLogic domain. For instructions, see How to Enroll WebLogic Machines in a Domain.

To use the WebLogic machine to manage your Managed Servers, you must instruct your Managed Servers to use Node Manager. See How to Create a WebLogic Managed Server.

ProcedureHow to Enroll WebLogic Machines in a Domain

After you create a WebLogic machine, you must enroll the machine in a WebLogic domain. This procedure describes how to enroll a WebLogic machine in a domain.

Before You Begin

You must create a WebLogic domain before you enroll a WebLogic machine. For more information, see How to Create a WebLogic 9 Domain and Administration Server.

Steps

  1. In the Common Tasks section of the browser interface, click WebLogic 9.

  2. Click the WebLogic Machine Installation: Enroll link.

    The Plans Details Run page displays.

  3. Select the WebLogic machine that you want to enroll from the Current Installations list.

  4. Click the Run Selected Installations link.

    The Plans Details Run page refreshes to include plan parameters and options.

  5. In the Logical Host for Domain Admin Server field, type the logical host name for the Administration Server.

  6. In the Java Arguments Used for weblogic.WLST field, type any appropriate options to use with the WebLogic Scripting Tool (WLST).

    If your Administration Server is using SSL, specify the following options to use the demo SSL certificates. Specify these arguments on one line, separated by a space.


    -Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust

  7. Specify any additional options or limits as appropriate for your environment.

  8. Click Run Plan (includes preflight).