Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Cluster Data Service for Sun Java System Message Queue Guide |
1. Installing and Configuring Oracle Solaris Cluster HA for Sun Java System Message Queue
Oracle Solaris Cluster HA for Sun Java System Message Queue Overview
Planning the Sun Java System Message Queue Installation and Configuration
Configuring and Activating Network Resources
How to Configure and Activate Network Resources
Installing and Configuring the Sun Java System Message Queue
How to Install the Sun Java System Message Queue
Verifying the Sun Java System Message Queue Installation and Configuration
How to Verify the Sun Java System Message Queue Installation and Configuration
Standard Data Service Configurations
Configuration Planning Questions
Installing the HA for Sun Java System Message Queue Packages
How to Install the HA for Sun Java System Message Queue Packages
Registering and Configuring the Oracle Solaris Cluster HA for Sun Java System Message Queue
Setting Oracle Solaris Cluster HA for Sun Java System Message Queue Extension Properties
Configuring the SUNW.HAStoragePlus Resource Type
Tuning the Oracle Solaris Cluster HA for Sun Java System Message Queue Fault Monitor
Operations by the Fault Monitor During a Probe
A. HA for Sun Java System Message Queue Extension Properties
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 Message Queue.
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 the Oracle Solaris Cluster HA for Sun Java System Message Queue is SUNW.s1mq.
The names of the cluster nodes that can master the data service.
The network resource that clients use to access the Oracle Solaris Cluster HA for Sun Java System Message Queue.
The port where the Sun Java System Message Queue listens.
The section that follows contains instructions for registering and configuring Oracle Solaris Cluster HA for Sun Java System Message Queue resources. For information about the extension properties, see Appendix A, HA for Sun Java System Message Queue Extension Properties. 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 on all 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.
# clresourcegroup create [-n node-zone-list] resource-group
# clreslogicalhostname create -g resource group -h logical-hostname logical-hostname
Note - If you require a fully qualified hostname, you must specify the fully qualified name with the -h option and you cannot use the fully qualified form in the resource name.
# clresourcetype register SUNW.s1mq
Password password
See Appendix A, HA for Sun Java System Message Queue Extension Properties for a description of the Smooth_Shutdown extension property.
[If Smooth_Shutdown will be set to FALSE (the default):] # clresource create -g resource-group -t SUNW.s1mq \ -p Confdir_list=$IMQ_VARHOME/instances/broker \ -p Broker_Name=broker \ -p Network_Resources_Used=logical hostname \ -p Port_list=port/tcp[,port/tcp] resource
[If Smooth_Shutdown is set to TRUE:] # clresource create -g resource-group -t SUNW.s1mq \ -p Confdir_list=$IMQ_VARHOME/instances/broker \ -p Broker_Name=broker \ -p Broker_User=user \ -p Network_resources_used=logical hostname \ -p Port_list=port/tcp[,port/tcp] \ -p Smooth_Shutdown=TRUE resource
The resource is created in the enabled state.
The resource group that contains the application resources is the same resource group that you created for your network resources in How to Configure and Activate Network Resources.
Specifies the type of resource to add.
Specifies a path for your Sun Java System Message Queue configuration directory. The Confdir_list extension property is required. The Confdir_list property must have exactly one entry.
Specifies the name of the broker to monitor.
Specifies the user name of the managed broker.
Specifies a comma-separated list of network resources (logical hostnames) in resource-group, which the Sun Java System Message Queue application resource must use.
Specifies a port number and the protocol to be used, for example, 80/tcp. The Port_list property must have one or two entries.
Used to shutdown the broker. Use of the impcmd command exposes the broker password in the imqcmd command string.
Specifies the Sun Java System Message Queue application resource name.
# clresourcegroup online resource-group
Specifies the name of the application resource group that is being enabled.
# clresourcegroup status # ps -ef
Example 1-1 Registering and Configuring the Oracle Solaris Cluster HA for Sun Java System Message Queue
This example shows how to register the Oracle Solaris Cluster HA for Sun Java System Message Queue.
Cluster Information Node names: phys-schost-1, phys-schost-2 Logical hostname: schost-1 Resource group: resource-group-1 (for all resources) Resources: schost-1 (logical hostname), SUNW.s1mq (Sun Java System Message Queue application resource) (Create a failover resource group.) # clresourcegroup create -n phys-schost-1,phys-schost-2 s1mq-rg (Add a logical hostname resource to the resource group.) # clreslogicalhostname -g s1mq-rg -h schost-1 schost-1 (Register the SUNW.s1mq resource type.) # clresourcetype register SUNW.s1mq (Create a Sun Java System Message Queue resource and add it to the resource group.) # clresource create -g s1mq-rg \ -t SUNW.s1mq \ -p Confdir_list=$IMQ_VARHOME/instances/hamq1 \ -p Broker_Name=hamq1 \ -p Network_resources_used=schost-1 \ -p Port_list=7676/tcp s1mq-rs (Enable the application resource group.) # clresourcegroup online s1mq-rg
Example 1-2 Registering and Configuring Oracle Solaris Cluster HA for Sun Java System Message Queue With Smooth_Shutdown Enabled
This example shows how to register Oracle Solaris Cluster HA for Sun Java System Message Queue with Smooth_Shutdown enabled.
Cluster Information Node names: phys-schost-1, phys-schost-2 Logical hostname: schost-1 Resource group: resource-group-1 (for all resources) Resources: schost-1 (logical hostname), s1mq-1 (Sun Java System Message Queue application resource) (Create a failover resource group.) # clresourcegroup create -n phys-schost-1,phys-schost-2 s1mq-rg (Add a logical hostname resource to the resource group.) # clreslogicalhostname create -g s1mq-rg -h schost-1 schost-1 (Register the SUNW.s1mq resource type.) # clresourcetype register SUNW.s1mq (Create a Sun Java System Message Queue resource and add it to the resource group.) # clresource create -g s1mq-rg \ -t SUNW.s1mq \ -p Confdir_list=$IMQ_VARHOME/instances/hamq1 \ -p Broker_Name=hamq1 \ -p Broker_User=admin \ -p Network_resources_used=schost-1 \ -p Port_list=7676/tcp \ -p Smooth_Shutdown=TRUE s1mq-rs (Enable the application resource group.) # clresourcegroup online s1mq-rg