Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Cluster Data Service for Sun Java System Application Server EE (HADB) Guide |
Oracle Solaris Cluster HA for Sun Java System Application Server EE (HADB) Overview
Configuration Planning Questions
Installing and Configuring the Sun Java System Application Server EE (HADB) Software
Creating a Sun Java System Application Server EE (HADB) Database
How to Create a Sun Java System Application Server EE (HADB) Database
Installing the Oracle Solaris Cluster HA for Sun Java System Application Server EE (HADB) Packages
How to Maintain the HADB Database
This procedure describes how to use the Oracle Solaris Cluster maintenance commands to register and configure the Oracle Solaris Cluster HA for Sun Java System Application Server EE (HADB) data service as a resource mastered on multiple nodes at one time.
Note - See Tools for Data Service Resource Administration in Oracle Solaris Cluster Data Services Planning and Administration Guide for details about additional options that enable you to register and configure the data service.
To perform this procedure, you need the following information about your configuration.
The name of the resource type for Oracle Solaris Cluster HA for Sun Java System Application Server EE (supporting HADB versions before 4.4), which is SUNW.hadb
The names of the cluster nodes that can master the data service
The sections that follow contain instructions for registering and configuring resources for Oracle Solaris Cluster HA for Sun Java System Application Server EE (HADB). For information about the extension properties, see Appendix B, Properties for Oracle Solaris Cluster HA for Sun Java System Application Server EE (HADB Versions Before 4.4). The Tunable entry indicates when you can update a property.
See Appendix A, Standard Properties, in Oracle Solaris Cluster Data Services Planning and Administration Guide for details about all of the Oracle Solaris Cluster properties.
To set an extension property of a resource, include the following option in the clresource(1CL) command that creates or modifies the resource:
-p property=value
Identifies the extension property that you are setting.
Specifies the value to which you are setting the extension property.
You can also use the procedures in Chapter 2, Administering Data Service Resources, in Oracle Solaris Cluster Data Services Planning and Administration Guide to configure resources after the resources are created.
Perform the following steps to complete your configuration.
# clresourcetype register SUNW.hadb
# clresourcegroup create -n nodelist \ -p Maximum_primaries=nodes_in_rg \ -p Desired_primaries=nodes_in_rg resource_group
Specifies a comma-separated subset of cluster nodes to run Sun Java System Application Server EE (HADB). If this option is omitted, all cluster nodes run Sun Java System Application Server EE (HADB). Use the clnode list command to find the node list names.
Specifies the maximum number of nodes on which the resource can start. You must specify the same number as the value of the Desired_primaries property.
Specifies the desired number of nodes on which the resource can start. You must specify the same number as the value of the Maximum_primaries property.
If you do not require the auto-recovery feature, execute the following command.
# clresource create -g resource_group -t SUNW.hadb \ -p Confdir_list=config_directory_list \ -p HADB_ROOT=install_directory \ -p DB_name=database_name resource
Specifies that the resource is to be added to the resource group named resource_group.
Specifies the predefined resource type name.
Specifies the path to the configuration directory.
Specifies the installation directory.
Specifies the name of the HADB database.
The resource is created in the enabled state.
If you do want to use the auto-recovery feature, execute the following command.
# clresource create -g resource_group -t SUNW.hadb \ -p Confdir_list=config_directory_list \ -p HADB_ROOT=install_directory \ -p DB_name=database_name \ -p Auto_recovery=TRUE \ -p Auto_recovery_command=command \ -p DB_password_file=password_file resource
Specifies that you are using the auto-recovery feature.
Specifies the command to execute after the database recovery. This extension property is optional, regardless of the value of the Auto_recovery property.
Specifies the file from which HADB reads the database password. See the Sun Java System Application Server documentation for the format and content of the password file.
The resource is created in the enabled state.
Note - The auto-recovery command and the database password file must both exist in the local file system on each node.
# clresourcegroup online resource_group
Specifies the name of the application resource group that is being enabled.
# cluster status # ps -ef
# hadbm status database_name --nodes
The output should indicate that the database that you specified is running.
Example 2-1 Creating a SUNW.hadb Resource With Auto-Recovery
This example shows the creation of a SUNW.hadb resource with auto-recovery.
In this example the resource has the following characteristics:
The resource is named hadb-rs.
The resource is a member of a resource group named hadb-rg.
The resource is an instance of the SUNW.hadb resource type. The registration of the resource type is not shown in this example.
The configuration directory is located at /etc/opt/SUNWhadb/dbdef/hadb.
The installation directory is located at /opt/SUNWappserver7/SUNWhadb/4.
The HADB database instance associated with this resource is named hadb.
Auto-recovery is on.
The full path to the command to execute after auto-recovery is /usr/local/etc/create-session-store.
The HADB password file is /usr/local/etc/hadb-password-file.
clresource create -g hadb-rg -t SUNW.hadb \ -p Confdir_list=/etc/opt/SUNWhadb/dbdef/hadb \ -p HADB_ROOT=/opt/SUNWappserver7/SUNWhadb/4 \ -p DB_name=hadb \ -p Auto_recovery=true \ -p Auto_recovery_command=/usr/local/etc/create-session-store \ -p DB_password_file=/usr/local/etc/hadb-password-file hadb-rs