Use this procedure to configure the HA for PeopleSoft application server for failover. The clsetup utility includes a wizard to guide you through the creation of logical hostname resources. The wizard creates multiple resource groups, each containing one logical hostname resource, with a different preferred node in each group.
Before You Begin
Before you run clsetup, be sure that the following tasks have been performed:
PeopleSoft application server software and agent packages are installed on the nodes of the cluster as described in Installing and Configuring the PeopleSoft Application Server Domain and Installing the Data Service Package.
All storage management software that you intend to use is installed and configured on all nodes where PeopleSoft application server is to run.
Zone clusters where you intend to run PeopleSoft application server have been created.
The logical hostnames that are to be made available by the resources have an entry in a name service database such as DNS.
If you are using IP Network Multipathing (IPMP) groups, the groups are configured on the nodes where the logical hostname resources can be brought online.
Any project you created to run PeopleSoft application server exists in the projects name service database for the user that runs the PeopleSoft application server application. For more information, see the projects(1) man page.
# /usr/cluster/bin/clsetup
The clsetup main menu is displayed.
The Data Services menu is displayed.
If you specified a Zone Cluster, the clsetup utility displays a list of zone clusters.
If you specified a Global Cluster, the clsetup utility displays a list of tasks you need to complete. Continue to Step 7.
The clsetup utility displays a list of tasks you need to complete.
If you are configuring in a zone cluster, the zone cluster nodes are displayed.
If you are configuring in a global cluster, the global cluster nodes and zone nodes are displayed.
The clsetup utility prompts you for the logical host for the first node.
The clsetup utility repeats the prompt for each node that you selected.
When you have finished specifying a logical host for each node, the wizard automatically generates names for the logical hostname resources and resource groups based on the logical hostnames you entered.
The wizard then displays a Select Resource Groups to Edit panel that shows a list of resource groups that are about to be created, with the ordered node list for each group. You can edit the names of these resource groups if you want.
The wizard displays a list of the names of the resource and resource group for the group you selected. From here you can separately edit these names.
The wizard displays the new names of the resource and resource group for the group you selected.
The Select Resource Groups to Edit panel is displayed again with the new values of all the resource groups that are to be created.
The wizard displays the Review Configuration of Logical Hostname Resources panel to display the resource name, resource group name, node list, and logical hostname that will be created. The names are not editable here, but you can type the < key to go back to the previous panel to edit.
When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
The clsetup utility returns you to the Data Services menu.
The clsetup utility displays a list of options for the PeopleSoft application server location.
The next step is optional. You should skip to Step 24 if you are not using HA for storage or you have previously configured HA for storage, either through the clsetup main menu or by using other commands.
If you specified a Zone Cluster, the clsetup utility displays a list of zone clusters.
If you specified a Global Cluster, the clsetup utility displays a list of tasks you need to complete. Continue to Step 17.
The clsetup utility displays a list of components you need to configure.
The clsetup utility prepares to start a wizard to guide you through the creation and configuration of storage resource groups for PeopleSoft application server.
Before you continue, make sure all the listed prerequisites have been met.
If you are configuring on a zone cluster, the clsetup utility displays the nodes available for you to select for storage resources to run.
If you are configuring on a global cluster, the clsetup utility displays the existing file system mount points.
The clsetup utility displays the existing file system mount points.
The clsetup utility displays a review panel where you can change the names of the objects that are about to be created.
The clsetup utility displays a screen where you can specify the new name.
The clsetup utility returns you to the list of the names of the objects that the utility will create.
The clsetup utility displays information about the configuration that the utility will create.
When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
The clsetup utility returns you to the list of options for configuring the HA for PeopleSoft application server.
The utility displays a list of prerequisites for the creation of the PeopleSoft application server resource group.
The wizard lists all the local user names from the selected cluster so you can choose the user name that should run the PeopleSoft application server.
If you do not see the user name that you want, type n to see another page of user names. If you want to use the psft user, for example, it might be listed on the second page.
For better security, you should not run the server as the root user, but you are not prevented from doing so.
The clsetup utility then displays a panel for you to specify the PeopleSoft application server installation directory location.
The directory contains the PeopleSoft application server binaries and corresponds to the directory specified as PS_HOME when you installed the PeopleSoft software. The directory must be accessible from at least one cluster node if you are setting up a failover configuration, or from each cluster node if you are setting up a multi-instance configuration.
The clsetup utility then prompts you to enter the location of the domain directory. The value displayed is the directory specified as PS_CFG_HOME when you installed the PeopleSoft software. By default the domain directory is ${PSFT_USER_HOME}/psft/pt/${PT_VERSION}.
The clsetup utility prompts you for the project to use.
If you did not create a project where PeopleSoft application server will run, select the default project. The clsetup utility prompts for the configuration mode.
In failover mode, the PeopleSoft application server instance runs only on a single node. If the fault monitor detects an error, it restarts the instance on the same node or starts an instance on another cluster node that is configured to master the PeopleSoft application server data service.
The clsetup utility displays a list of PeopleSoft application server domain configuration names that you can configure. The domain names are obtained from the domain directory that you specified.
When configuring failover mode you can select only one domain.
This option is useful if you want to use a domain that is not shown in the list.
The wizard displays the domain you have selected and you must type yes to confirm it is correct.
The clsetup utility then prompts for database information.
If you specify yes, the utility searches for database resources and presents a numbered list of resources found and prompts you to select from the list.
The utility displays a list of logical hostname resources for the application server domain.
The clsetup utility displays a list of storage resources for PeopleSoft application server files.
The clsetup utility displays a review panel that shows the storage resource group and application server domain that you have selected.
The clsetup utility displays a new panel for changing the names. You can type the number for the name you want to change, and the utility prompts you to change the name.
Type d to confirm the new names.
The utility displays a review panel of the objects that it will create.
When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
The clsetup utility returns you to the list of options for configuring PeopleSoft application server.
The clsetup utility returns to the Data Services Configuration menu.
If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again.