Previous  
Product: Cluster Server Guides   
Manual: Cluster Server 4.1 Bundled Agents Reference Guide   

VRTSWebApp Agent

Brings Web applications online, takes them offline, and monitors their status. The application is a Java Web application conforming to the Servlet Specification 2.3/JSP Specification 1.2 and runs inside of the Java Web server installed as a part of the VRTSweb package. This agent is used to monitor the Web Consoles of various VERITAS products, such as VCS and VVR.

Entry Points

  • Online---Starts the Web application with the specified parameters. If the Web server is not already running, it first starts the server.
  • Offline---Removes the Web application from the Web server. If no other Web application is running, it shuts down the Web server.
  • Monitor---Checks if the specified Web application is currently running inside the Web server. If the application is running, monitor reports ONLINE. If the application is not running, monitor reports OFFLINE.
  • Clean---Removes the Web application from the Web server. If no other Web application is running, it shuts down the Web server.

State Definitions

  • ONLINE---Indicates that the Web application is running.
  • OFFLINE---Indicates that the Web application is not running.
  • UNKNOWN---Indicates that the agent could not determine the state of the resource or that the resource attributes are invalid.

Type Definition


type VRTSWebApp (
        static str ArgList[] = { AppName, InstallDir, TimeForOnline }
        str AppName
        str InstallDir
        int TimeForOnline
        static int NumThreads = 1
)

Required Attributes

Required Attribute Description, Type and Dimension, Default, and Example

AppName

Name of the application as it appears in the Web server.

Access the applications at: http://localhost:8181/vcs.

  • Type and dimension: string-scalar
  • Example: For VCS, use vcs.

InstallDir

Path to the Web application installation. The Web application must be installed as a .war file with the same name as the AppName parameter; the vcs application must be installed as vcs.war. This attribute should point to the directory that contains this .war file.

  • Type and dimension: string-scalar
  • Example: If AppName is vcs and InstallDir is /opt/VRTSweb/VERITAS, the agent constructs the path for the Web application as: "/opt/VRTSweb/VERITAS/vcs.war"

TimeForOnline

The time the Web application takes to start after it is loaded into the Web server. This parameter is returned as the exit value of the online script, which inform VCS of the time it needs to wait before calling monitor on the Web application resource. This attribute is typically at least five seconds.

Sample Configuration


VRTSWebApp VCSweb (
  AppName = "vcs"
  InstallDir = "/opt/VRTSweb/VERITAS"
  TimeForOnline = 5
  )
 ^ Return to Top Previous  
Product: Cluster Server Guides  
Manual: Cluster Server 4.1 Bundled Agents Reference Guide  
VERITAS Software Corporation
www.veritas.com