N1 Grid Service Provisioning System User's Guide and Release Notes for the WebLogic 8 Plug-In 1.0

Managing WebLogic Domains, Servers, and Clusters

This section describes the tasks that are commonly performed with WebLogic servers and clusters after they have been installed.

Domains and Administrative Servers

Clusters

Managed Servers

Managing WebLogic Domains and Administration Servers

This section contains procedures for managing WebLogic Domains and Administration Servers.

ProcedureHow to Remove a WebLogic Domain and Administration Server

By removing a WebLogic domain through the provisioning system, you automatically perform the following tasks.


Note –

The WebLogic virtual hosts cannot contain components that do not belong to the plug-in. To successfully remove the WebLogic domain, all components that do not belong to the plug-in must be removed before running the domain uninstall plan.


Before You Begin

To remove a WebLogic 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. In the Common Tasks section in the browser interface, click WebLogic 8.

  2. Click the Domain Management: Remove link.

    The plan's Details page displays.

  3. Click Run.

    The plan's Run page displays.

  4. 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.


  5. Type the name of the WebLogic domain, in the WebLogic Domain Name field.

  6. If you want to remove the WebLogic domain, Administration Server, clusters, and Managed Server from the provisioning system and plan to keep the domain running in the WebLogic environment, select the markOnly option.

  7. Click Run Plan (Includes Preflight).

Managing WebLogic Clusters

The following section describes how to start, stop, and remove clusters.

ProcedureHow to Start or Stop Clusters

When you start or stop a cluster, you start or stop all cluster members within the cluster.


Note –

All cluster members must be in the same state to use this feature.


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

  2. Click the Cluster Management: Start or Stop link.

    The component Details page displays.

  3. In the Component Procedures list, select the row containing the Start or Stop procedure and click Run.

    The plan's Run page displays.

  4. Select the cluster that you plan to start or stop.

    The cluster name is a part of the installPath.

  5. Click Run Selected Installations.

    The plan's Run page displays.

  6. Click Run Plan (Includes Preflight).

ProcedureHow to Remove a WebLogic Cluster

When you remove a cluster, all cluster members associated with that cluster are also removed. .

For more information about the behavior of cluster members returning to the role of Managed Servers, see How to Remove a WebLogic Cluster Member.


Note –

When the Managed Servers are removed from the cluster, they are stopped. If you plan to continue using the Managed Server, you must restart it. See How to Start a Managed Server


Before You Begin

To remove a cluster, 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. In the Common Tasks section in the browser interface, click WebLogic 8.

  2. Click the Cluster Management: Remove link.

    The plan's Details page displays.

  3. Click Run.

    The plan's Run page displays.

  4. In the Target Host field, select the domain that hosts the cluster.

  5. Deselect the Target Host Set checkbox.

  6. In the WebLogic Cluster Name field of the Plan Variables section, type the cluster name that would display in the WebLogic interface.

  7. Select the markOnly option if you want to remove the WebLogic Cluster from the provisioning system but plan to keep the cluster running in the WebLogic environment.

  8. Click Run Plan (Includes Preflight).

ProcedureHow to Remove a WebLogic Cluster Member

When you remove a cluster member, the cluster member component is removed from the Managed Server and the Managed Server that acted as the cluster member returns to its original state. Applications that were targeted to the cluster, and therefore cluster members, are no longer hosted by the Managed Server after it is restarted. Applications targeted directly to the Managed Server continue to target the Managed Server.

When a Managed Server is removed from a cluster, the Managed Server is left in a stopped state. If you plan to continue using the Managed Server, you must restart it. See How to Start a Managed Server.

Before You Begin

To remove a cluster member, 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. In the Common Tasks section in the browser interface, click WebLogic 8.

  2. Click the Clusters Member Management: Leave link.

    The plan's Details page displays.

  3. Click Run.

    The plan's Run page displays.

  4. Choose the Managed Server that you plan to remove.

  5. Deselect the Target Host Set checkbox.

  6. If you want to remove the WebLogic cluster member from the provisioning system but plan to keep the cluster member running in the WebLogic environment, select the markOnly option.

  7. Click Run Plan (Includes Preflight).

Managing WebLogic Managed Servers

ProcedureHow to Start a Managed Server

Before You Begin

To start a Managed Server, 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. In the Common Tasks section in the browser interface, click WebLogic 8.

  2. Click the Application Server Management: Start link.

    The component Details page displays.

  3. In the Component Procedures list, select the row containing the Start procedure and click Run.

    The plan's Run page displays.

  4. Select the Managed Server that you need to start.

    Managed Servers follow the format host (install-path), where host represents the name of the physical host and install-path represents the name of the managed server. The managed server name displays as server_wls_managedServerName, for example, server_wls_Server-One

  5. Click Run Selected Installations.

    The plan's Run page displays.

  6. Set the Plan Variables.

    1. (Optional) To override the standard memory arguments passed to Java, type the name in the VmArgs field.

      The format used for the vmArgs field is virtualMachineName. For example, -Xms32m -Xmx200m.

    2. To specify how long the provisioning system waits before verifying that the server started, type the number of seconds in the Seconds to Wait Before Failing Verify Step field.

  7. Click Run Plan (Includes Preflight).

ProcedureHow to Stop a Managed Server

Before You Begin

To stop a Managed Server, 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. In the Common Tasks section in the browser interface, click WebLogic 8.

  2. Click the Application Server Management: Stop link.

    The component Details page displays.

  3. In the Component Procedures list, select row containing the Stop procedure and click Run.

    The plan's Run page displays.

  4. Select the Managed Server that you need to start.

    Managed Servers follow the format host (install path), where host represents the name of the physical host and install path represents the name of the managed server. The managed server name displays as server_domainName_managedServerName. For example, server_wls_Server-One.

  5. Click Run Selected Installations.

    The plan's Run page displays.

  6. Click Run Plan (Includes Preflight).

ProcedureHow to Remove a Managed Server

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

  2. Click the Application Server Management: Remove link.

    The plan's Details page displays.

  3. Click Run.

    The plan's Run page displays.

  4. Select the Managed Server that you plan to remove.

  5. Modify the plan variables if necessary.

    1. Type the name of the WebLogic Managed Server.

    2. Type the name of the WebLogic domain that the Managed Server is registered with.

    3. If you want to remove the WebLogic Managed Server from the provisioning system but want to keep the Managed Server running in the WebLogic environment, select the markOnly option.

  6. Click Run Plan (Includes Preflight).