Veritas Cluster Server Bundled Agents Reference Guide

Veritas™ Cluster Server Bundled Agents Reference Guide - Symantec Veritas™ Cluster Server Bundled Agents Reference Guide - Symantec

d1mj3xqaoh14j0.cloudfront.net
from d1mj3xqaoh14j0.cloudfront.net More from this publisher
17.08.2015 Views

124 Services and applications agents Process agent Table 6-8 Process agent optional attributes (continued) Optional Attributes UserName Description The user name in whose context the configured process executes. Username can be of the form username@domain.com or domain.com\username. If a user name is not specified, the configured process runs in the context of the user account used by VCS High Availability Engine (HAD). Note: This attribute can take localized values. Type and Dimension: string-scalar LanmanResName The name of the Lanman resource. The Process agent monitors the configured process in the context of the virtual name specified in the Lanman resource. Type and Dimension: string-scalar Note: When defining the StartProgram, StopProgram, or MonitorProgram attributes, enclose the path of the executable file in double quotes. Do not enclose arguments in double quotes. Sample configuration Sample 1 In the following configuration, the online function spawns the executable test.exe with online as a command-line argument. The offline function spawns the executable test.exe with offline as the command-line argument. The monitor function monitors the attribute value for StartProgram, test.exe, and checks the state. Process Process_Test ( ) Sample 2 StartProgram = "\"X:\\bin\\test.exe\" /online" StopProgram = "\"X:\\bin\\test.exe\" /offline" UserName = "Administrator" Password = bphNepE Domain = "VCS_DOMAIN"

Services and applications agents MSMQ agent 125 In the following configuration, the batch file start.bat starts an instance, MyProcess, of the executable process.exe. The batch file stop.bat stops the process instance of process.exe. The batch file monitor.bat monitors the attribute value for StartProgram, and checks the state of the process.exe. Note that the executable process.exe resides in the directory C:\batchfiles, which is specified as the StartupDirectory. PROCESS-Process_SG ( StartProgram = "C:\\batchfiles\\start.bat MyProcess" StartupDirectory = "C:\\batchfiles" StopProgram = "C:\\batchfiles\\stop.bat MyProcess" MonitorProgram = "C:\\batchfiles\\monitor.bat MyProcess" UserName = Administrator Password = jxpVmxM Domain = "mydomain.mycompany.com" ) MSMQ agent The MSMQ agent is a bundled agent that works with the Microsoft Message Queuing (MSMQ) service. The MSMQ agent creates an MSMQ service for an MSMQ resource, brings the service online, takes it offline, and monitors its status. The agent provides high availability for the MSMQ service and the queues hosted by the service, in a clustered environment. You can configure an MSMQ resource using the command line. See the Veritas Cluster Server Administrator's Guide for instructions. Dependencies The MSMQ resource depends on the MountV, Lanman, and the Registry Replication resources for operation. The MSMQ resource starts after each of these resources is brought online. The following figure illustrates the agent's dependency graph.

124<br />

Services and applications agents<br />

Process agent<br />

Table 6-8<br />

Process agent optional attributes (continued)<br />

Optional Attributes<br />

UserName<br />

Description<br />

The user name in whose context the configured process<br />

executes. Username can be of the form username@domain.com<br />

or domain.com\username.<br />

If a user name is not specified, the configured process runs in<br />

the context of the user account used by VCS High Availability<br />

Engine (HAD).<br />

Note: This attribute can take localized values.<br />

Type and Dimension: string-scalar<br />

LanmanResName<br />

The name of the Lanman resource.<br />

The Process agent monitors the configured process in the<br />

context of the virtual name specified in the Lanman resource.<br />

Type and Dimension: string-scalar<br />

Note: When defining the StartProgram, StopProgram, or MonitorProgram<br />

attributes, enclose the path of the executable file in double quotes. Do not enclose<br />

arguments in double quotes.<br />

Sample configuration<br />

Sample 1<br />

In the following configuration, the online function spawns the executable test.exe<br />

with online as a command-line argument. The offline function spawns the<br />

executable test.exe with offline as the command-line argument. The monitor<br />

function monitors the attribute value for StartProgram, test.exe, and checks the<br />

state.<br />

Process Process_Test (<br />

)<br />

Sample 2<br />

StartProgram = "\"X:\\bin\\test.exe\" /online"<br />

StopProgram = "\"X:\\bin\\test.exe\" /offline"<br />

UserName = "Administrator"<br />

Password = bphNepE<br />

Domain = "VCS_DOMAIN"

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!