Attributes for Solaris

Required attributes for Solaris

Required attribute

Description

StartProgram 

The executable, created locally on each node, which starts the application. Specify the complete path of the executable. Applicable command line arguments follow the name of the executable and are separated by spaces. 

For applications running in Solaris 10 zones, use the path as seen from the zone that is running the application—its relative path. 

Type and dimension: string-scalar 

Examples: 

/usr/sbin/samba start 

"/usr/sbin/samba start" 

Example in global and non-global zones for Solaris 10:
/usr/sbin/samba start 

Example in global and non-global zones for Solaris 10:
"/usr/sbin/samba start" 

StopProgram 

The executable, created locally on each node, that stops the application. Specify the complete path of the executable. Applicable command line arguments follow the name of the executable and are separated by spaces. 

For applications running in Solaris 10 zones, use the path as seen from the zone that is running the application—its relative path. 

Type and dimension: string-scalar 

Example: 

/usr/sbin/samba stop 

"/usr/sbin/samba stop" 

Example in global and non-global zones for Solaris 10:
/usr/sbin/samba stop 

Example in global and non-global zones for Solaris 10:
"/usr/sbin/samba stop" 

At least one of the following attributes: 

  • MonitorProcesses
  • MonitorProgram
  • PidFiles

See Optional attributes for Solaris

Optional attributes for Solaris

Optional attribute

Description

CleanProgram 

The executable, created locally on each node, which forcibly stops the application. Specify the complete path of the executable. Applicable command line arguments follow the name of the executable and are separated by spaces.  

For applications running in Solaris 10 zones, use the path as seen from the zone that is running the application—its relative path. 

Type and dimension: string-scalar 

Examples:  

Solaris 8 and 9: /usr/sbin/samba force stop 

Solaris 8 and 9: "/usr/sbin/samba force stop" 

Solaris 10: Example in global and non-global zones:
/usr/sbin/samba force stop 

Solaris 10: Example in global and non-global zones:
"/usr/sbin/samba force stop" 

ContainerName 

Non-global zone support for Solaris 10 and above. Defines the name of the non-global zone. 

Type and dimension: string-scalar 

Example: zone1 

Example: "zone1" 

ContainerType 

Do not change. For internal use only. 

MonitorProcesses 

A list of processes that you want monitored and cleaned. Each process name is the name of an executable. Qualify the executable name with its complete path if the path starts the executable. 

The process name must be the full command line argument displayed by the ps -u user -o args | more command for the process. 

Type and dimension: string-vector 

Example: nmbd 

Example: "nmbd" 

MonitorProgram 

The executable, created locally on each node, which monitors the application. Specify the complete path of the executable. Applicable command line arguments follow the name of the executable and are separated by spaces. 

For applications running in Solaris 10 zones, use the path as seen from the zone that is running the application—its relative path. 

MonitorProgram can return the following VCSAgResState values: offline value is 100; online values range from 101 to 110 (depending on the confidence level); 110 equals confidence level of 100%. Any other value = unknown.  

Type and dimension: string-scalar 

Examples:  

Solaris 8 and 9:
/usr/local/bin/sambaMonitor all 

Solaris 8 and 9:
"/usr/local/bin/sambaMonitor all" 

Solaris 10: Example in global and non-global zones:
/usr/local/bin/sambaMonitor all 

Solaris 10: Example in global and non-global zones:
"/usr/local/bin/sambaMonitor all" 

PidFiles 

A list of PID files that contain the process ID (PID) of the processes that you want monitored and cleaned. These are application generated files. Each PID file contains one monitored PID. Specify the complete path of each PID file in the list.  

For applications running in Solaris 10 non-global zones, include the zone root path in the PID file's path—the global zone's absolute path—see the example below. 

The process ID can change when the process restarts. If the application takes time to update the PID file, the agent's monitor script may return an incorrect result. If this occurs, increase the ToleranceLimit in the resource definition. 

Type and dimension: string-vector 

Examples:  

/var/lock/samba/smbd.pid 

"/var/lock/samba/smbd.pid" 

Example in a global zone for Solaris 10:
/var/lock/samba/smbd.pid 

Example in a global zone for Solaris 10:
"/var/lock/samba/smbd.pid" 

Example in a non-global zone for Solaris 10:
$zoneroot/var/lock/samba/smbd.pid 

Example in a non-global zone for Solaris 10:
"$zoneroot/var/lock/samba/smbd.pid" 

Where the $zoneroot is the root directory of the non-global zone, as seen from the global zone. 

User 

The user ID for running StartProgram, StopProgram, MonitorProgram, and CleanProgram. The processes specified in the MonitorProcesses list must run in the context of the specified user. Monitor checks the processes to make sure they run in this context. 

Type and dimension: string-scalar 

Default: root 

Default: "root"