Contents

Index

Plug-in Procedures

This page contains the following information:

How to Create a New Cluster By Using This Plug-in
How to Add Nodes to Existing Clusters By Using This Plug-in
How to Use This Plug-In to Only Install Sun Cluster Software
How to Delete Clusters By Using This Plug-in
How to Remove Nodes from a Cluster by Using This Plug-in
How to Use This Plug-In to Uninstall Sun Cluster Software
How to Add or Remove Quorum Disk Devices by Using This Plug-in

How to Create a New Cluster By Using This Plug-in

This procedure describes how to use the Sun Cluster Framework plug-in to create new Sun Cluster clusters.

1. Prepare the hosts.

For each new node in the cluster, follow the steps described in How to Prepare Hosts for Sun Cluster Installation.

2. Configure the N1SPS virtual hosts.

• Create the required virtual hosts as described in How to Create N1SPS Virtual Hosts for Use With This Plug-in.
• Configure virtual host variables as described in Variables for Plug-in Virtual Hosts of Type "clusterNode"
  and Variables for Plug-in Virtual Hosts of Type "cluster".

3. (Optional) Configure a host set for each cluster.

Optionally, configure a host set for each cluster as described in How to Create Host Sets for Use With This Plug-in.

4. Run the "scCreateCluster" composite plan.

Click the "create clusters" button on the "Sun Cluster" plug-in page, then, click the "run" button.

5. Configure component variables.

The only component installed by this plan with variables that you might need to change is the "sunCluster"
component itself. Do not change variables for any of the other components.

Configure the "sunCluster" component variables as described in Variables for Plug-in Component "sunCluster".

6. Select the target hosts.

For each cluster being created, select the complete set of per-cluster "clusterNode" hosts as targets.
Or, more conveniently, you can use the host sets that are described in How to Create Host Sets for Use With This Plug-in.

7. Set the plan variables.

Set the following three fields, or "plan variables":

Java Availability Suite distribution:
Java Availability Suite installer state file:
Require fully connected quorum disks, even on clusters of more than two nodes?

Refer to How to Prepare Hosts for Sun Cluster Installation for information about
how to set the first two of these three variables. The third variable is checked by default, since this
variable can provide greater availability in clusters of greater than two nodes.

The plan for creating new clusters only attempts to install Sun Cluster software when it is not found to
already be installed, either by this plug-in or by other means. If the Sun Cluster framework software is
already installed, the first two of these "plan variables" are ignored.

8. Set the plan "limits".

• Set the limit on the number of hosts that run at the same time to no less than the total number of target hosts.
• Set the limit on the overall running time for this plan to at least 60 minutes.
• Set the limit on the running time of native calls for this plan to at least 30 minutes.

This plan results in a reboot of each cluster node. And, the reboot step can be time consuming. Therefore,
set limits to allow enough time for reboots to complete. However, if the limits are set too high, it might
take you more time than otherwise needed to notice a failed reboot.

9. Run the plan.

Click the "run plan" button.

How to Add Nodes to Existing Clusters By Using This Plug-in

This procedure describes how to add nodes to an already-existing Sun Cluster configuration by using
this plug-in.

1. Prepare hosts.

For each new node in the cluster, follow the steps that are described in How to Prepare Hosts for Sun Cluster Installation.

2. Configure the N1SPS virtual hosts.

Create the required virtual hosts as described in How to Create N1SPS Virtual Hosts for Use With This Plug-in.
Configure virtual host variables as described in Variables for Plug-in Virtual Hosts of Type "clusterNode" and
Variables for Plug-in Virtual Hosts of Type "cluster".

3. Update host sets for each cluster.

For each cluster with a cluster host set, update that host set with the new "clusterNode" N1SPS virtual
host that you created in the previous step.

4. Run the "scAddClusterNode" plan.

Click "add nodes" on the "Sun Cluster" plug-in page, then, click the "run" button.

5. Configure component variables.

The only component that this plan installs that has variables that you might need to change is the
"sunCluster" component itself. Do not change variables for any of the other components.

Configure the "sunCluster" component variables as described in Variables for Plug-in Component "sunCluster".

6. Select the target hosts.

Add each new N1SPS virtual host of type "clusterNode" to the list of target hosts.

7. Set the plan variables.

Set the following fields, or "plan variables":

Java Availability Suite distribution:
Java Availability Suite installer state file:

Refer to How to Prepare Hosts for Sun Cluster Installation for information about how to set these two variables.

The plan for adding new cluster nodes only attempts to install Sun Cluster software when it is not found
to already be installed, either by this plug-in or by other means. If the Sun Cluster framework software
is already installed, these "plan variables" are ignored.

8. Set the plan "limits".

• Set the limit on the overall running time for this plan to at least 60 minutes.
• Set the limit on the running time of native calls for this plan to at least 30 minutes.

This plan results in a reboot of each cluster node. And, the reboot step can be time consuming. Therefore,
set limits to allow enough time for reboots to complete. However, if the limits are set too high, it might
take you more time than otherwise needed to notice a failed reboot.

9. Run the plan.

Click the "run plan" button and wait for the plan to complete successfully on each node.

10. Reconfigure all quorum disk devices.

Whenever you add a node to a cluster, reconfigure all quorum devices so that the new node is added to
the node lists of the quorum devices. To accomplish this, remove all quorum devices then add them back
to the cluster. However, if you no longer require one or more of the quorum devices, adding back any of
the removed quorum devices is optional.

Follow the steps described in How to Add or Remove Quorum Disk Devices By Using This Plug-in
to remove all quorum disk devices from each cluster to which a node has been added and then optionally
add back one or more quorum disk devices to the cluster.

How to Use This Plug-In to Only Install Sun Cluster Software

This procedure describes how use this plug-in to install Sun Cluster software on hosts without creating
any new cluster nodes or clusters.

1. Prepare the hosts.

For each host to be installed with the Sun Cluster software, follow the steps described in How to Prepare Hosts for Sun Cluster Installation.

2. Configure the N1SPS virtual hosts.

Create the required virtual hosts as described in How to Create N1SPS Virtual Hosts for Use With This Plug-in.
Configure virtual host variables as described in Variables for Plug-in Virtual Hosts of Type "clusterNode" and
Variables for Plug-in Virtual Hosts of Type "cluster".

3. Run the "scInstallPackages" plan.

Click "install" on the "Sun Cluster" plug-in page, then, click the "run" button.

4. Do not configure any component variables.

5. Select the target hosts.

Specify the "clusterNode" virtual hosts that you created in the target host list in Step 2.

6. Set the plan variables.

Set the following three fields, or "plan variables":

Java Availability Suite distribution:
Java Availability Suite installer state file:
Require fully connected quorum disks, even on clusters of more than two nodes?

Refer to How to Prepare Hosts for Sun Cluster Installation for information about
how to set the first two of these three variables. The third variable is checked by default, since this
can provide greater availability in clusters of greater than two nodes.

If the Sun Cluster framework software is already installed, the first two of these "plan variables" are ignored.

8. Run the plan.

Click the "run plan" button.

How to Delete Clusters By Using This Plug-in

This procedure describes how to use this plug-in to delete, or unconfigure, Sun Cluster configurations
that are already known to this plug-in.

1. Unconfigure Oracle RAC from each cluster.

If any of the clusters that you are deleting include Oracle RAC, unconfigure RAC before you unconfigure
the cluster. If you used the plug-in for Oracle RAC on "Sun Cluster" to set up RAC, use that same plug-in
to unconfigure it.

2. Remove all Solaris Volume Manager (SVM) device groups from each cluster.

You can remove the SVM device groups by using the SVM plug-in for "Sun Cluster", if it is available. Or,
you can do it manually by logging into each cluster and by following the procedures in the Sun Cluster
and Solaris documentation.

3. Boot all nodes into noncluster mode.

You must boot the nodes manually. This plug-in cannot be used to boot nodes into noncluster mode.

4. Run the "scDeleteCluster" plan.

Click "delete clusters" on the "Sun Cluster" plug-in page, then click the "run" button.

5. Select the target hosts.

For each cluster that you are deleting, select the complete set of per-cluster "clusterNode" hosts as targets.
Or, more conveniently, if you have created the host sets that are described in How to Create Host Sets for Use With This Plug-in,
use those host sets.

6. Run the plan.

Click the "run plan" button and wait for the plan to complete successfully on each node.

7. (Optional) Remove the Sun Cluster software from each node.

The "scDeleteCluster" plan does not uninstall the Sun Cluster software from any of the nodes. If you also
want to uninstall the software, refer to How to Use This Plug-in to Uninstall Sun Cluster Software.

How to Remove Nodes from a Cluster by Using This Plug-in

This procedure describes how to use this plug-in to remove a node from a Sun Cluster configuration of
three or more nodes.

1. Remove the nodes from the Oracle RAC configuration.

If any of the nodes you are removing are part of an Oracle RAC configuration, remove the nodes from the
RAC configuration before you remove the nodes from the cluster. If you used the plug-in for Oracle RAC
on "Sun Cluster" to set up RAC, use that same plug-in to remove nodes from RAC.

While the framework plug-in will attempt to remove nodes from the node lists of all resource groups in a
cluster, the preferred method to remove them from Oracle RAC is to use the Oracle RAC plug-in.

2. Remove the nodes from all Solaris Volume Manager (SVM) device groups.

You can remove the nodes by using the SVM plug-in for "Sun Cluster", if it is available. Or, you can
manually log in to each cluster and follow the procedures in the Sun Cluster and Solaris documentation.

3. Boot each node to be removed into noncluster mode.

Manually boot each node into noncluster mode. You cannot use this plug-in to boot nodes into noncluster mode.

4. Run the scRemoveNode" plan.

Click "remove nodes" on the "Sun Cluster" plug-in page, then, click the "run" button.

5. Select the target hosts.

Specify the "clusterNode" virtual host for each node that you want to remove from a cluster. Do not attempt
to remove more than one node at a time from any given cluster.

6. Run the plan.

Click the "run plan" button.

7. (Optional) Remove the Sun Cluster software from each node.

The "scRemoveNode" plan does not uninstall the Sun Cluster software from any of the nodes. If you also want
to uninstall the software, refer to How to Use This Plug-In to Uninstall Sun Cluster Software.

How to Use This Plug-In to Uninstall Sun Cluster Software

This procedure describes how use this plug-in to uninstall Sun Cluster framework software from hosts that
have already been removed from the cluster. However, the Sun Cluster framework software cannot be
uninstalled from any host that is still configured as a Sun Cluster cluster node.

1. Run the "scUnInstallPackages" plan.

Click "uninstall" on the "Sun Cluster" plug-in page, then, click the "run" button.

2. Select the target hosts.

Specify the "clusterNode" virtual host for each host from which you want to uninstall software.

3. Set the plan variables.

Set the following three fields, or "plan variables":

Java Availability Suite uninstall program: Point to the JAS uninstaller
Java Availability Suite uninstaller state file: Specify the state file that the JAS uninstaller should use
x Only uninstall hosts of type clusterNode? Checked by default. If this option is not checked, the
plan will attempt to uninstall software from any type of host, including physical hosts.

If the following two fields are checked, plug-in infrastructure software will also be uninstalled. They
are not checked by default, but if you do not plan to use this plug-in again for the selected target hosts,
you will want to check them:

_ Also uninstall scNativeScripts components
_ Also uninstall scConfigFiles components

4. Run the plan.

Click the "run plan" button.

How to Add or Remove Quorum Disk Devices by Using This Plug-in

This procedure describes how use this plug-in to add or remove quorum disk devices to or from a Sun
Cluster configuration.

1. Select the plan to run on the "Sun Cluster" plug-in page, then click the "run" button.

• If you are adding quorum disks, click "add quorum disks" to select the "scAddQuorumDevices" plan.
• If you are removing quorum disks, click "remove quorum disks" to select the "scRemoveQuorumDevices" plan.

2. Select the target hosts.

For each cluster that you update, select the N1SPS virtual host of type "cluster" for that cluster.
Or, if it is more convenient, use the host sets that you created as described in How to Create Host Sets for Use With This Plug-in.
This plan will ignore all hosts that are not of type "cluster".

3. Set the plan variables.

The first field in each of the two plans is checked by default. Configuring at least one fully connected
quorum device can provide greater availability, even in clusters of greater than two nodes:

x Require fully connected quorum disks, even on clusters of more than two nodes?

The remaining two fields in each of the two plans enable the user to specify which disks to add or remove
as quorum devices. The two fields enable you to specify the list of quorum disks either in the "quorumDevices"
field of the virtual "cluster" for each cluster or directly from a variable setting in the plan.
For example, here are the two fields from "scAddQuorumDevices":

x Add only the quorum devices associated with each "cluster host"
If not adding the "cluster host" quorum devices, use only these instead:

Two similar fields are found in the "scRemoveQuorumDevices" plan.

If you decide to use the quorum devices that are tied to the "cluster" host, refer to the description of
the "quorumDevices" variable in Variables for Plug-in Virtual Hosts of Type "cluster".

Regardless of where the list of quorum devices is specifed, the list always takes the following format:

nodename:device[,...] | did-device[,...].

4. Run the plan.

Click the "run plan" button.