Attributes

Required attributes

Required attribute

Description

ConfigFile 

Full path and file name of the main configuration file for the Apache server. 

Type and dimension: string-scalar 

Example: /apache/server1/conf/httpd.conf 

Example: "/apache/server1/conf/httpd.conf" 

 

httpdDir 

Full path of the directory to the httpd binary file 

Type and dimension: string-scalar 

Example: /apache/server1/bin 

Example: "/apache/server1/bin" 

 

SecondLevelMonitor 

 

Enables second-level monitoring for the resource. Second-level monitoring is a deeper, more thorough state check of the Apache HTTP server. An HTTP GET request on the Web server's root directory performs the monitoring. Valid attribute values are 1 (true) and 0 (false). Specifying this attribute is required. 

Type and dimension: boolean-scalar 

Default: 0 

Example: 1 

Example: "1" 

 

ResLogLevel 

Controls the agent's logging detail for a specific instance of a resource. Values are: 

  • ERROR: Logs error messages.
  • WARN: Logs error and warning messages.
  • INFO: Logs error, warning, and informational messages.
  • TRACE: Logs error, warning, informational, and trace messages. Trace logging is verbose. Use for initial configuration or troubleshooting.

Type and dimension: string-scalar 

Default: INFO 

Example: TRACE 

Example: "TRACE" 

 

PidFile 

This attribute is required when you want to enable the detection of a graceful shutdown outside of VCS control. 

See PidFile 

 

Optional attributes

Optional attribute

Description

DirectiveAfter 

A list of directives that httpd processes after reading the configuration file. 

Type and dimension: string-association 

Example: DirectiveAfter{} = { KeepAlive=On } 

 

DirectiveBefore 

A list of directives that httpd processes before it reads the configuration file. 

Type and dimension: string-association 

Example: DirectiveBefore{} = { User=nobody, Group=nobody } 

 

User 

Account name the agent uses to execute the httpd program. If you do not specify this value, the agent executes httpd as the root user. 

Type and dimension: string-scalar 

Example: apache1 

Example: "apache1" 

 

EnableSSL 

Set to 1 (true) to have the online agent function add support for SSL by including the option -DSSL in the start command. For example:
/usr/sbin/httpd -f path_to_httpd.conf -k start -DSSL 

Where path_to_httpd.conf file is the path to the httpd.conf file. 

Set to 0 (false) it excludes the -DSSL option from the command. 

Type and dimension: boolean-scalar 

Default: 0 

Example: 1 

Example: "1" 

 

HostName 

The virtual host name that is assigned to the Apache server instance. The host name is used in second-level monitoring to establish a socket connection with the Apache HTTP server. 

Note   The HostName attribute is only required when the value of SecondLevelMonitor is 1 (true).

Type and dimension: string-scalar 

Example: web1.symantec.com 

Example: "web1.symantec.com" 

 

Port 

Port number where the Apache HTTP server instance listens. The port number is used in second-level monitoring to establish a socket connection with the server. Specify this attribute only if SecondLevelMonitor is set to 1 (true). 

Type and dimension: integer-scalar 

Default: 80 

Example: 80 

Example: "80" 

 

EnvFile 

Full path and file name of the file that is sourced before executing httpdDir/httpd. With Apache 2.0, the file ServerRoot/bin/envvars, which is supplied in most Apache 2.0 distributions, is commonly used to set the environment before executing httpd. Specifying this attribute is optional. If EnvFile is specified, the shell for user root must be Bourne, Korn, or C shell. 

Type and dimension: string-scalar 

Example: /apache/server1/bin/envvars 

Example: "/apache/server1/bin/envvars" 

 

PidFile 

The PidFile attribute sets the file to which the server records the process ID of the daemon. The value of PidFile attribute must be the absolute path where the Apache instance records the pid. 

This attribute is required when you want the agent to detect the graceful shutdown of the Web server. For the agent to detect the graceful shutdown of the Web server, the value of the IntentionalOffline resource type attribute must be 1 (true). 

Type and dimension: string-scalar 

Example: /var/run/httpd.pid 

Example: /var/run/httpd.pid 

 

SharedObjDir 

Full path of the directory in which the Apache HTTP shared object files are located. Specifying this attribute is optional. It is used when the HTTP Server is compiled using the SHARED_CORE rule. If you specify this attribute, the directory is passed to the -R option when executing the httpd program. Refer to the httpd man pages for more information about the -R option. 

Type and dimension: boolean-scalar 

Example: /apache/server1/libexec 

Example: "/apache/server1/libexec" 

 

SecondLevelTimeout 

The number of seconds that the monitor agent function waits on the execution of second-level monitor. If the second-level monitor program does not return to calling the monitor agent function before the SecondLevelTimeout window expires, the monitor agent function no longer blocks on the program sub-process. It does, however, report that the resource is offline. The value should be high enough to allow the second level monitor enough time to complete. The value should be less than the value of the agent's MonitorTimeout. 

Type and dimension: integer-scalar 

Default: 30