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 have spaces separating them. 

For applications running in Solaris 10 zones, use the path as seen from the non-global zone. 

Note   Do not use the opening and closing ({ }) brace symbols in this string.

Type and dimension: string-scalar 

Example: /usr/sbin/samba start 

Example: "/usr/sbin/samba start" 

 

StopProgram 

The executable, created locally on each node, which stops the application. Specify the complete path of the executable. Applicable command line arguments follow the name of the executable and have spaces separating them. 

For applications running in Solaris 10 zones, use the path as seen from the non-global zone. 

Note   Do not use the opening and closing ({ }) brace symbols in this string.

Type and dimension: string-scalar 

Example: /usr/sbin/samba stop 

Example: "/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 have spaces separating them. 

For applications running in Solaris 10 zones, use the path as seen from the non-global zone. 

Type and dimension: string-scalar 

Example: /usr/sbin/samba force stop 

Example: "/usr/sbin/samba force stop" 

 

ContainerName 

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

Type and dimension: string-scalar 

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.  

Provide the full path name of the executable if the agent uses that path to start the executable.  

The process name must be the full command line argument that the ps -u user -o args command displays 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 have spaces separating them. 

For applications running in Solaris 10 zones, use the path as seen from the non-global zone. 

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.  

Note   Do not use the opening and closing ({ }) brace symbols in this string.

Type and dimension: string-scalar 

Example: /usr/local/bin/sambaMonitor all 

Example: "/usr/local/bin/sambaMonitor all" 

 

PidFiles 

A list of PID (process ID) files that contain the 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. 

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

Type and dimension: string-vector 

Example:  

/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 that is 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