InfoScale™ Cluster Server 9.0 Bundled Agents Reference Guide - AIX

ConfigFile

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

Type and dimension: string-scalar

Example: "/etc/httpd/conf/httpd.conf"

httpdDir

Full path of the Apache HTTP server binary file or full path of the directory in which the httpd binary file is located.

Type and dimension: string-scalar

Example: "/usr/apache2/bin"

PidFile

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

See Table: Optional attributes.

EnvFile

This attribute may be required when you use IBM HTTP Server.

See Table: Optional attributes.

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"

EnableSSL

If this attribute is set to 1 (true) the online agent function will 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.

If this attribute is set to 0 (false) the agent excludes the SSL support.

Type and dimension: boolean-scalar

Default: 0

Example: "1"

HostName

The virtual host name that is assigned to the Apache server instance. The host name is used in second-level monitoring for benchmarking the Apache HTTP server.

You can use IPv4 or IPv6 addresses for the HostName attribute.

Type and dimension: string-scalar

Example: "web1.example.com"

Port

Port number where the Apache HTTP server instance listens. The port number is used in second-level monitoring for benchmarking the Apache HTTP server. Specify this attribute only if you have enabled in-depth monitoring by setting the LevelTwoMonitorFreq attribute.

Type and dimension: integer-scalar

Default: 80

Example: "80"

EnvFile

Full path and file name of the file that is sourced before executing Apache HTTP server commands. Specifying this attribute is optional. If EnvFile is specified, the shell for the user must be Bourne, Korn, or C shell.

This attribute may be required when you use the IBM HTTP Server if the online action fails. For example: set the EnvFile to /usr/IBM/HTTPServer/bin/envvars.

Type and dimension: string-scalar

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 Apache HTTP server. For the agent to detect the graceful shutdown of the Apache HTTP server, the value of the IntentionalOffline resource type attribute must be 1 (true).

Type and dimension: string-scalar

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"

ResLogLevel

This attribute has been deprecated.

Use the resource type attribute LogDbg to enable debug logs. Set LogDbg attribute to DBG_5 to enable debug logs for the Apache HTTP server agent. By default, setting the LogDbg attribute to DBG_5 enables debug logs for all Apache resources in the cluster. If debug logs must be enabled for a specific Apache resource, override the LogDbg attribute.

For information on how to use the LogDbg attribute, refer to the Cluster Server Administrator's Guide.

LevelTwoMonitorFreq

Specifies the frequency at which the agent must perform second-level or detailed monitoring. You can also override the value of this attribute at the resource level. The value indicates the number of monitor cycles after which the agent will monitor Apache in detail.

For example, the value 5 indicates that the agent will monitor Apache in detail after every five online monitor intervals.

Type and dimension: integer-scalar

Default: 0

IntentionalOffline

For information on how to use the IntentionalOffline resource type attribute, refer to the Cluster Server Administrator's Guide.