SUNW.s1mq

, s1mq

- resource type implementation for failover and scalable Sun Glassfish Message Queue (s1mq)

Description

The SUNW.s1mq resource type represents the Sun Glassfish Message Queue application in an Oracle Solaris Cluster configuration. This application was formerly known as Sun Java System Message Queue.

You must set the following properties on an SUNW.s1mq resource by using clresource(1CL).

Standard Properties

See r_properties(5) for a complete description of the following resource properties.

Network_resources_used (string array)

A list of logical-hostname or shared-address network resources upon which this resource has a dependency. This list contains all network-address resources that appear in the properties Resource_dependencies, Resource_dependencies_weak, Resource_dependencies_restart, or Resource_dependencies_offline_restart.

This property is updated automatically by the RGM, based on the setting of the resource-dependencies properties. You do not set this property directly. Instead, use the Resource_dependencies property.

Category

Conditional/Optional

Default

The empty list

Tunable

When disabled

Resource_dependencies (string array)

Specifies a list of resources upon which a resource depends. This list includes any logical-hostname or shared-address network resources that are used by a resource. The default value for this property is null.

You can specify one or more resource names. Each network resource can contain one or more logical host names. See the clreslogicalhostname(1CL) and clressharedaddress(1CL) man pages for more information.

You can specify an alternate kind of dependency by using the Resource_dependencies_weak, Resource_dependencies_restart, or Resource_dependencies_offline_restart property instead of the Resource_dependencies property. For more information, see the r_properties(5) man page.

Category

Optional

Default

The empty list

Tunable

Any time

Port_list

Default

No default

Tunable

At creation

Retry_count

Maximum

10

Default

2

Tunable

Any time

Retry_interval

Maximum

3600

Default

740

Default

Any time

Thorough_probe_interval

Maximum

3600

Default

60

Tunable

Any time

Extension Properties

Bin_dir

Type string. This property indicates the location of Message Queue server binaries for Sun Glassfish Message Queue versions beginning with 4.4. You must specify this property at resource creation time.

Confdir_list

Type string array. This property is a path name set to install-dir/domains/domain/server which is the path name of an s1mq instance directory. You must specify this property at resource creation time.

Broker_Name

Type string. No default. This property contains the name of the broker to start and monitor. The imqcmd command needs this name to stop the broker if Smooth_Shutdown is set to TRUE.

Broker_User

Type string. Default is "". This property contains the Message Queue user name of the managed broker. This user name is used to shut down the broker if Smooth_Shutdown is set to TRUE. Smooth_Shutdown defaults to FALSE. If Smooth_Shutdown=FALSE, the broker is sent SIGTERM to shut it down. If Smooth_Shutdown is set to TRUE the broker will be shut down by using imqcmd. Using imqcmd exposes the broker user password on the imqcmd command line.

Probe_timeout

Type string. Default is 120 seconds. Minimum value is 2. This property is tunable at anytime and sets the timeout value for the probe.

Examples

Example 1 Creating a Failover s1mq Resource in an Existing Group

For this example to work, the SUNWscs1mq data service package must first be installed. This example creates a failover s1mq resource named message-queue-failover in an existing resource group named mq-rg. The mq-rg resource group contains a LogicalHostname resource, which identifies the logical hostname associated with the resource group. This example includes the Bin_dir extension property used by Message Queue beginning in version 4.4.

example# clresourcetype register SUNW.s1mq
example# clresource create -g mq-rg -t SUNW.s1mq \
-p Confdir_list=/global/s1mq/instances/hamq1 
\-p Bin_dir=/opt/mq/bin \
-p Network_Resources_used=logical host \
-p Port_List=7676\tcp \
-p Broker_Name=hamq1 message-queue-failover

In the preceding example, the s1mq resource created is named message-queue-failover. The s1mq resource listens on port 7676, with a corresponding s1mq instance in the directory /global/s1mq/instances/hamq1.

Example 2 Creating a Failover s1mq Resource with Smooth_Shutdown=TRUE

For this example to work, the SUNWscs1mq data service package must be first installed. This example creates a failover s1mq resource named message-queue-failover, which listens on port 7676 in an existing resource group named mq-rg.

example# clresourcetype register SUNW.s1mq
example# clresource create -g mq-rg -t SUNW.s1mq \
-p Confdir_list=/global/s1mq/instances/hamq1 \
-p Network_Resources_used=logical host \
-p Port_List=7676 -p Broker_Name=hamq1 -p Broker_User=admin \
-p Smooth-Shutdown=TRUE message-queue-failover 

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

clresourcetype(1CL), clresourcegroup(1CL), scha_resource_get(3HA), pmfadm(1M), attributes(5), r_properties(5), scalable_service(5)

Oracle Solaris Cluster Data Service for Sun Java System Message Queue Guide, and Oracle Solaris Cluster Data Services Planning and Administration Guide