Go to main content

Oracle Solaris Cluster 4.3 Data Services Reference Manual

Exit Print View

Updated: September 2015
 
 

asap (5)

Name

ORCL.asap, asap - resource type implementation for the Oracle Communications ASAP managed by Oracle Solaris Cluster

Description

The ORCL.asap resource type represents the HA for the Oracle Communications ASAP component available for the Oracle Solaris Cluster configuration.

The ORCL.asap resource type is derived from, and extends, the ORCL.gds resource type. As a consequence the Probe_command, Start_command, Stop_command, and Validate_command properties are not tunable. However, all the ORCL.gds standard and extension resource type properties can be tuned. For a list of the ORCL.gds standard and extension properties, see the ORCL.gds (5) man page.


Note -  The ORCL.asap resource type can be used for ASAP deployments in a single UNIX machine and across several UNIX machines.

To register and create instances of this resource type, use the following commands:

  • To register this resource type, use the clresourcetype command.

  • To create instances of this resource type, use the clresource command.

Standard Properties

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

Application_User

Specifies the username used to run the ASAP system.

Category

Optional

Data type

String

Default

None

Tunable

When disabled

If this property is not specified, the ASAP data service will use the ASAP installation user to start the ASAP servers.

Extension Properties

ASAP_HOME

Specifies the installation directory of the Oracle Communications ASAP binaries for all types of deployments.

Category

Required

Data type

String

Default

None

Tunable

When disabled

Control_Server_Type

Specifies the type of Control Server: MASTER/SLAVE.

Category

Required

Data type

String

Default

None

Tunable

When disabled

Master_Control

Specifies the name of the Master Control Server.

Category

Required

Data type

String

Default

None

Tunable

When disabled

Slave_Control

Specifies the name of the Slave Control Server.

Category

Optional

Data type

String

Default

None

Tunable

When disabled

This is an optional property when Control_Server_Type=MASTER.

CRITICAL_PROCESS_LIST

A comma-separated list of critical processes to be monitored for taking recovery action. If the process in the list terminates abnormally and if the Control Server fails to restart the process, the HA ASAP agent would restart the resource.

Category

Optional

Data type

String array

Default

None

Tunable

Anytime

UNMONITORED_PROCESS_LIST

A comma-separated list of processes selected to be not monitored by the ASAP agent. You can perform maintenance operations without being restarted by the ASAP agent if the process is intentionally stopped. The agent will not report a status message when the selected process is stopped. The administrator should make sure the process is enabled for monitoring after performing maintenance by removing the process name from the property.

Category

Optional

Data type

String array

Default

None

Tunable

Anytime

ENV_PROFILE

Specifies the absolute path to the Oracle Communications ASAP environment file. This file is typically installed in $ASAP_HOME when Oracle Communications ASAP is installed. If the value for this property is not set, the HA ASAP data service uses the default file Environment_Profile installed under the $ASAP_HOME directory.

Category

Optional

Data type

String

Default

""

Tunable

Anytime

Detailed_probing

Controls whether detailed probing on the application is performed. If this property is set to True, the agent probe executes the run_suite command followed by checking the status of the work order using an SQL query. It uses POTS Demonstration Service Activation Model and SRP emulator. The administrator should make sure that POTS Demonstration Service Activation Model is installed and SRP emulator is running while using this property.

Category

Optional

Data type

Boolean

Default

False

Tunable

Anytime

Examples

Creating an ORCL.asap Resource to Configure HA For Oracle Communications ASAP Deployed in a Single UNIX Machine

This example shows the commands to create a failover ORCL.asap resource for ASAP Master Control Server on a two-node cluster. These commands perform the following operations:

  • Creating the asap-app-rg resource group.

  • Registering the ORCL.asap resource type.

  • Adding the asap-app-rs resource to the asap-app-rg resource group.

This example assumes that a logical host resource (log-host-rs) already exists.

phys-schost-1# clresourcetype register ORCL.asap
phys-schost-1# clresourcegroup create \ 
-p RG_affinities=++asap-hasp-rg asap-app-rg
phys-schost-1# clresource create -g asap-app-rg \ 
-t ORCL. asap \ 
-p Application_User=asap \ 
-p ASAP_HOME=/global/asap/asap72 \ 
-p Control_Server_Type=MASTER \ 
-p Master_Control=CTRLENV2 \ 
-p CRITICAL_PROCESS_LIST=SARMENV2 \ 
-p UNMONITORED_PROCESS_LIST=NEP_ENV2 \ 
-p ENV_PROFILE=/global/asap/asap72/Environment_Profile \ 
-p Detailed_Probing=TRUE \ 
-p resource_dependencies=log-host-rs,wls-mgd-rs,ora-db-rs \ 
-p resource_dependencies_offline_restart=asap-hasp-rs \ 
-d asap-app-rs
phys-schost-1# clresourcegroup online -M asap-app-rg
phys-schost-1# clresource enable asap-app-rs

In the example above, SARMENV2 and NEP_ENV2 are the names of ASAP servers configured in the database and controlled by the Master Control Server CTRLENV2. asap-hasp-rg is the resource group that manages the HAStorageplus resource asap-hasp-rs. wls-mgd-rs is the server resource managed by the HA WebLogic Server. ora-db-rs is the HA Oracle database resource. asap-slave-hasp-rs is the HAStoragePlus storage resource for Slave Control server.

Creating an ORCL.asap Resource to Configure HA For Oracle Communications ASAP Deployed Over Several UNIX Machines

This example shows the commands to create an ASAP Slave Control Server resource on a two-node cluster. These commands perform the following operations:

  • Creating the asap-slave-rg resource group.

  • Registering the ORCL.asap resource type.

  • Adding the asap-slave-rs resource to the asap-slave-rg resource group

This example assumes that a logical host resource (log-host-rs2) already exists.

phys-schost-1# clresourcetype register ORCL.asap
phys-schost-1# clresourcegroup create \ 
-p RG_affinities=++asap-hasp-rg asap-slave-rg
phys-schost-1# clresource create -g asap-slave-rg \ 
-t ORCL.asap \ 
-p Application_User=slave \ 
-p ASAP_HOME=/global/slave/asap72 \ 
-p Control_Server_Type=SLAVE \ 
-p Master_Control=CTRLENV2 \ 
-p Slave_Control=CLTRLSLV1 \ 
-p CRITICAL_PROCESS_LIST=SRPSlave \ 
-p UNMONITORED_PROCESS_LIST=NEPSlave \ 
-p ENV_PROFILE=/global/slave/asap72/Environment_Profile \ 
-p Detailed_Probing=TRUE \ 
-p resource_dependencies=log-host-rs2,wls-mgd-rs,ora-db-rs \ 
-p resource_dependencies_offline_restart=asap-slave-hasp-rs,asap-app-rs \ 
-d asap-slave-rs

In this example, SRPSlave and NEPSlave are the names of ASAP servers configured in the database and controlled by the Slave Control Server CTRLSLV1. asap-hasp-rg is the resource group that manages the HAStorageplus resource asap-hasp-rs. wls-mgd-rs is the WebLogic Managed Server resource managed by the HA WebLogic Server. ora-db-rs is the HA Oracle database resource. asap-slave-hasp-rs is the HAStoragePlus storage resource for Slave Control server.

phys-schost-1# clresourcegroup online -M asap-slave-rg
phys-schost-1# clresource enable asap-slave-rs

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/data-service/oracle-asap

See Also

clresource (1CL) , attributes (5) , r_properties (5)

Oracle Solaris Cluster Data Service for Oracle Communications ASAP Guide