test

Sun N1 Service Provisioning System User's Guide for BEA WebLogic 8 Plug-In 3.0

ProcedureHow to Create a WebLogic 8 Domain and Administration Server

You need to create a domain and Administration Server before you can set up Managed Servers to host your applications. A domain is a set of WebLogic servers that is managed by an Administration Server. All information about the domain is contained in a configuration file that is stored on the Administration Server.

When you create a new domain by installing the AdminServer component, you also:

You can use this procedure to create a new domain or you can use this procedure to register an existing domain within the provisioning system by selecting the markOnly option.

Note –

In this document, two similar terms are used: AdminServer and Administration Server. The prepackaged Sun N1 Service Provisioning System WebLogic 8 component is called the AdminServer component. AdminServer represents the provisioning system component and Administration Server represents the installed application running in the WebLogic 8 environment.

Before You Begin

To create a WebLogic 8 domain, you must belong to a user group that has the Run Component Procedures permission on the folder that contains the component. You must also have the Allow on Host Set permission for the host set on which you plan to deploy the component.

Steps

  1. Verify that your WebLogic session variables, WL_DEFAULT_USER and WL_DEFAULT_PASSWORD, are set.

    WebLogic session variables must be seven characters long and include a number.

    For more information about session variables, see Chapter 5, Session Variables, in Sun N1 Service Provisioning System 5.2 Plan and Component Developer’s Guide.

  2. In the Common Tasks section in the browser interface, click WebLogic 8.

  3. Click the Domain Management: Create link.

    The plan's Details page displays.

  4. Click Run.

    The Run page displays.

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

    • 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 AdminServer component.

        domainName

        Required. The WebLogic domain name.

        adminPort

        Required. The default TCP port for the AdminServer virtual host to use.

        Before the domain is created, a check is performed to verify that this port is available. To fix this error, free the port and run the startAdminServer component procedure found on the AdminServer component Details page.

        secureConnect

        Optional. True specifies that the SSL port can be used to connect the Administration Server.

        startScriptWindows

        Required for Windows systems. This variable specifies the name of the domain start script for Windows Systems. The value of this variable must be a .cmd file.

        production

        Required. This variable determines whether the managed server is run in production mode. The default value of production is false. This variable can be set to true or false.

        Variables that are updated less often include configuration variables such as the following:

        adminManagedServer

        Required. The name of the managed server that hosts the domain administration console. The default value is myserver. If performing a markOnly install, set the variable to the server name used during the WebLogic install.

        adminHost

        Required. The hostname or IP address that managed servers use to connect to the Admin Server. The default value is the hostname of the Remote Agent on which the Admin Server resides.

        targetRefName

        Required. This variable becomes the name of the domain's virtual host. The substitution variable is based on the values for the host name and for the domain name. This variable follows the format :[target:sys.hostName]_weblogic_admin_ :[domainName]. For example, sqa-420_weblogic_admin_wls.

        The Select Variable Settings From List window displays.

        1. In the text field at the top of the table, type the name of the new variable settings set.

        2. To change the WebLogic Domain name, select the domainName row and type the new domain name.

        3. To change the port number for the Administration Server from the default value of 7001, select the adminPort row and type the new port number.

        4. To specify that secure HTTP be used to connect to the Administration Server, select the secureConnect row and type True in the text field.

        5. To change the path to where WebLogic is installed, select the beaHome row and type the correct path.

          The installPath variable, beaHome variable, and the WebLogic BEAHome of installation plan variable must contain the same value .

          The default value for these three variables is /usr/local/bea.

          Note –

          The value for the installPath variable is treated as a relative path to the default Remote Agent directory, unless you specify an absolute path, such as /opt or c:\mydir. For example, for a Windows Remote Agent, if you set the installPath variable to c\mydir and deploy the file to an Agent with a default home directory of c:\Program Files\N1 Service Provisioning System\agent, the file is deployed to c:\Program Files\N1 Service Provisioning System\agent\c\mydir.

        6. If necessary, modify the value of the remaining predefined variable.

          The targetRefName is pre-defined for you, although you can modify it if necessary. The targetRefName is created based on the values for the host name and for the domain name. This variable follows the format :[target:sys.hostName]_admin_:[domainName]

      • To use variable components from another component, click Import Set.

        For more information about importing variable sets, see How to Run a Plan in Sun N1 Service Provisioning System 5.2 Operation and Provisioning Guide.

        The Import Variable Settings window displays.

        1. If necessary, go to the folder that contains the component with the variable settings to import.

        2. Select the component's version.

          Note –

          Variable settings can vary between component versions.

        3. Click Import Variable Settings.

          The imported variable settings display in the table.

        4. Click Select.

  6. Select the target host.

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

    Note –

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

  7. If you are capturing an existing WebLogic domain within the provisioning system, select the markOnly option.

  8. Click Run Plan (Includes Preflight).