Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Cluster Data Service for Oracle PeopleSoft Enterprise Guide Oracle Solaris Cluster 4.1 |
1. Getting Started with Oracle Solaris Cluster HA for PeopleSoft Enterprise
2. Installing and Configuring the HA for PeopleSoft Application Server
Planning the HA for PeopleSoft Application Server Installation and Configuration
Configuration Restrictions for HA for PeopleSoft Application Server
Configuration Requirements for HA for PeopleSoft Application Server
HA for PeopleSoft Application Server Data Service Configurations
Installing and Configuring the PeopleSoft Application Server Domain
How to Enable the PeopleSoft Application Server Domain to Run in a Cluster
How to Install PeopleSoft Application Server Software
Verifying Installation and Configuration of the PeopleSoft Application Server Domain
How to Verify PeopleSoft Application Server Domain Installation and Configuration
Registering and Configuring HA for PeopleSoft Application Server
Tools for Registering and Configuring HA for PeopleSoft Application Server
How to Register and Configure HA for PeopleSoft Application Server for Failover (clsetup)
How to Register and Configure HA for PeopleSoft Application Server for Multi-Instance (clsetup)
How to Register and Configure HA for PeopleSoft Application Server for Failover (CLI)
How to Remove a PeopleSoft Application Server Domain Resource From a Failover Resource Group
Verifying Installation and Configuration of the PeopleSoft Application Server Domain Resource
How to Verify HA for PeopleSoft Application Server Domain Resource Installation and Configuration
Tuning the HA for PeopleSoft Application Server Fault Monitor
Probing Algorithm and Functionality
Operations of the PeopleSoft Application Server Probe
Debugging HA for PeopleSoft Application Server
How to Activate Debugging for HA for PeopleSoft Application Server
3. Installing and Configuring the HA for PeopleSoft Process Scheduler
A. HA for PeopleSoft Application Server Extension Properties
This section contains the procedures to configure or unconfigure HA for PeopleSoft application server.
Tools for Registering and Configuring HA for PeopleSoft Application Server
How to Register and Configure HA for PeopleSoft Application Server for Multi-Instance (clsetup)
How to Register and Configure HA for PeopleSoft Application Server for Failover (CLI)
How to Remove a PeopleSoft Application Server Domain Resource From a Failover Resource Group
Oracle Solaris Cluster software provides the following tools for registering and configuring the HA for PeopleSoft application server in the global cluster or in a zone cluster:
The clsetup(1CL) utility.
The clsetup utility provides a wizard for configuring the HA for PeopleSoft application server. This wizard reduces the possibility for configuration errors that might result from command syntax errors or omissions. This wizard also ensures that all required resources are created and that all required dependencies between resources are set.
For instructions for using the wizard, see How to Register and Configure HA for PeopleSoft Application Server for Failover (clsetup) and How to Register and Configure HA for PeopleSoft Application Server for Multi-Instance (clsetup).
Oracle Solaris Cluster maintenance commands. For instructions for using the commands, see How to Register and Configure HA for PeopleSoft Application Server for Failover (CLI) and How to Register and Configure HA for PeopleSoft Application Server for Multi-Instance Configuration (CLI).
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 non-global zones that can master the resources are already configured on your cluster nodes.
# /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.
Note - The nodes in each resource group cannot be altered in this panel. The wizard sets the preferred node name automatically and ensures that a different node is the preferred node for each group. If you need to change any information about the nodes, you must go back through the wizard by pressing the < key.
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 < and press Return to go back to the previous panel to edit if you like.
When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Note - The clsetup utility rolls back the changes if it fails to complete the logical host configuration process.
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.
Note - The clsetup utility rolls back the changes if it fails to complete the storage configuration process.
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 and press Return 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 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 and press Return 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.
Note - The clsetup utility rolls back the changes if it fails to complete the database configuration process.
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.
Use this procedure to configure the HA for PeopleSoft application server for multiple instances. 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 andInstalling 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 non-global zones that can master the resources are already configured on your cluster nodes.
# /usr/cluster/bin/clsetup
The clsetup main menu is displayed.
The Data Services menu is displayed.
The clsetup utility displays a list of options for the PeopleSoft application server location.
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 components to configure.
The utility displays a list of prerequisites for the creation of logical hostname resources.
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.
Note - The nodes in each resource group cannot be altered in this panel. The wizard sets the preferred node name automatically and ensures that a different node is the preferred node for each group. If you need to change any information about the nodes, you must go back through the wizard by pressing the < key.
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 < and press Return to go back to the previous panel to edit if you like.
When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Note - The clsetup utility rolls back the changes if it fails to complete the logical host configuration process.
The clsetup utility returns you to the list of options for configuring PeopleSoft application server.
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.
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.
Note - The clsetup utility rolls back the changes if it fails to complete the storage configuration process.
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 and press Return 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 each cluster node when 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 for the configuration mode.
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.
You can select multiple domains by entering their numbers with spaces or commas in between.
This option is useful if you want to use a domain that is not shown in the list.
When you are configuring for multi-instance mode you can type the names of multiple domains. You can include domains that are shown in the list or not shown in the list. Type one domain name when prompted and press Return. Type additional domains names when prompted, one name at a time, in the same manner. When you have finished entering domain names, press Return at the prompt without typing anything else.
The wizard displays the list of domains you have selected and you must type yes to confirm they are 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 prompts you for the logical hostname for each of the selected domains.
When you have completed the logical hostname assignments, the clsetup utility displays a list of storage resources for PeopleSoft application server files.
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 and press Return 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.
Note - The clsetup utility rolls back the changes if it fails to complete the database configuration process.
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.
Before You Begin
Install the data service package during your initial Oracle Solaris Cluster installation.
If you did not install the HA for PeopleSoft application server package as part of your initial Oracle Solaris Cluster installation, go to Installing the Data Service Package.
# clresourcetype register ORCL.PeopleSoft_app_server
# clresource create -g psft-app-failover-rg -d \ -t ORCL.PeopleSoft_app_server \ -p Psft_User=Psft-username -p Psft_Domain=Psft-domainname \ -p Psft_Home=Psft-home-directory -p Psft_Cfg_Home=Psft-config-home-directory \ -p resource_dependencies=logicalhostname-resource \ -p resource_dependencies_offline_restart=hasp-resource psft-app-server-resource
Do this even if the database tier is deployed in a different zone cluster of the same global cluster.
# clresource set -p resource_dependencies+=db-instance-resource,db-listener-resource \ psft-app-server-resource
Repeat this step for each PeopleSoft application server domain instance, if multiple instances were created.
# clresource status # clresource enable psft-app-server-resource
# clresource disable psft-app-server-resource # clresource delete psft-app-server-resource
This procedure shows how to use commands to create a PeopleSoft application server multi-instance configuration that uses single-node resource groups. This method is an alternative to using the clsetup wizard described in How to Register and Configure HA for PeopleSoft Application Server for Multi-Instance (clsetup).
A single node resource group is created for each of the application server resources managing a domain. Each resource group has a strong positive affinity on storage resource group and a logical host resource group whose primary node is the node containing the application server resource group.
Note - These instructions assume a zone cluster. If you are configuring in the global cluster, omit the -Z option.
# clresourcegroup create -Z zone-name \ -p nodelist=node1,node2,node3... \ logicalhost-resource-group
# clreslogicalhostname create -Z zone-name \ -g logicalhost-resource-group -h hostname \ logicalhost-resource
# clresourcegroup online -emM -Z zone-name logicalhost-resource-group
# clresourcegroup create -Z zone-name -p nodelist=node1 \ -p RG_affinities=++logicalhost-resource-group,++scalmnt-rg psft-app-server-rg
# clresourcegroup set -p Failback=True -Z zone-name logicalhost-resource-group
# clresource create -t ORCL.PeopleSoft_app_server:1 -g psft-app-server-rg \ -p Resource_dependencies=logicalhost-resource1,zone-1:rac-proxy-rs \ -p Resource_dependencies_offline_restart=storage1-rs,storage2-rs \ -p Psft_Home=/path/to/Psft/home/dir \ -p Psft_Cfg_Home=/path/to/Psft/cfg-home \ -p Psft_User=username \ -p Psft_Domain=Psft-domain psft-application-rs
Example 2-1 Commands for Configuring HA for PeopleSoft Application Server in a Single-Node Resource Group Multi-Instance Configuration
# clresourcegroup create -Z zone-2 \ -p nodelist=vzmoney1d,vzmoney2d,vzmoney3d,vzmoney4d money-9-rg # clreslogicalhostname create -Z zone-2 -g money-9-rg -h money-9 money-9-rs # clresourcegroup online -emM -Z zone-2 money-9-rg # clresourcegroup create -Z zone-2 -p nodelist=vzmoney1d \ -p RG_affinities=++money-9-rg,++scalmnt-rg pse-PSEDB-rg # clresourcegroup set -p Failback=True -Z zone-2 money-9-rg # clresource create -Z zone-2 -t ORCL.PeopleSoft_app_server:1 -g pse-PSEDB-rg \ -p Resource_dependencies=money-9-rs,zone-1:rac-proxy-rs \ -p Resource_dependencies_offline_restart=scalmnt-crs03-rs,scalmnt-crs01-rs \ -p Psft_Home=/scalable/pse-app/PT8.52 \ -p Psft_Cfg_Home=/scalable/pse-app/psft/cfg-home \ -p Psft_User=psft -p Psft_Domain=PSEDB \ pse-PSEDB-rs