主页
产品
Red Hat JBoss Operations Network
3.3
Using JBoss Operations Network for Monitoring, Deploying, and Managing Resources
23.2. Configuring the Apache SNMP Module

此内容没有您所选择的语言版本。

23.2. Configuring the Apache SNMP Module

To discover a Red Hat JBoss Web Server's virtual hosts and collect metrics for them, the SNMP module must be configured on that Red Hat JBoss Web Server.

Apache HTTP Server 2.2 is supported on Red Hat Enterprise Linux and Windows Server.

Important

To monitor Apache HTTP Server using JBoss ON, the SNMP module needs to be compiled prior to configuration following the instructions in Section 23.2.1, “Preparing the Apache SNMP module for use with Apache HTTP Server”.

The SNMP Plugin is already installed and enabled for JBoss ON 3.3, and the SNMP modules are pre-installed within Red Hat JBoss Web Server. To configure Red Hat JBoss Web Server for monitoring with JBoss ON:

Open the httpd.conf file for editing.

sudo vim JWS_install_directory/conf/httpd.conf

$ sudo vim JWS_install_directory/conf/httpd.conf

Copy to Clipboard

Toggle word wrap

Enable the module by adding these lines to the httpd.conf file under the Dynamic Shared Object Support section.

LoadModule snmpcommon_module JWS_install_directory/modules/snmpcommon.so
LoadModule snmpagt_module JWS_install_directorymodules/snmpmonagt.so
		
SNMPConf   JWS_install_directory/conf
SNMPVar    JWS_install_directory/var

LoadModule snmpcommon_module JWS_install_directory/modules/snmpcommon.so
LoadModule snmpagt_module JWS_install_directorymodules/snmpmonagt.so
		
SNMPConf   JWS_install_directory/conf
SNMPVar    JWS_install_directory/var

Copy to Clipboard

Toggle word wrap

For Windows Server:

LoadModule snmpcommon_module modules/libsnmpcommon.so
LoadModule snmpagt_module modules/libsnmpmonagt.so
		
SNMPConf   conf
SNMPVar    var

LoadModule snmpcommon_module modules/libsnmpcommon.so
LoadModule snmpagt_module modules/libsnmpmonagt.so
		
SNMPConf   conf
SNMPVar    var

Copy to Clipboard

Toggle word wrap

Verify the main configuration section of the httpd.conf file, as well as each <VirtualHost> configuration block, contains a ServerName directive with a port. The SNMP module uses this directive to uniquely identify the main server and each virtual host, so each ServerName directive must contain a unique value. For example:
```
ServerName main.example.com:80
...
		
<VirtualHost vhost1.example.com:80>
ServerName vhost1.example.com:80
...
</VirtualHost>
```
```
ServerName main.example.com:80
...
		
<VirtualHost vhost1.example.com:80>
ServerName vhost1.example.com:80
...
</VirtualHost>
```
Copy to Clipboard Toggle word wrap
If there is more than one Apache instance on the same machine, it is possible to use different SNMP files for each instance.
1. Each web server instance has its own httpd.conf file. Set the SNMPConf directory in each file to its own SNMP configuration directory. For example, for instance1:
  $ sudo vim instance1-httpd.conf SNMPConf /opt/apache-instance1/conf
  Copy to Clipboard Toggle word wrap
  Then, for instance2:
  $ sudo vim instance2-httpd.conf SNMPConf /opt/apache-instance2/conf
  Copy to Clipboard Toggle word wrap
  Each snmpd.conf file should be in the specified directory.
2. Edit the agentaddress property in JWS_install_directory/conf/snmpd.conf so that each instance has a different value agent address and port, so there is no conflict between instances.
  See the snmpd.conf documentation for a description of this property's syntax.
Restart Red Hat JBoss Web Server.
```
sudo apachectl -k restart
```
```
$ sudo apachectl -k restart
```
Copy to Clipboard Toggle word wrap

Verify that the SNMP module is installed and configured by inspecting the Red Hat JBoss Web Server error log for notices regarding the SNMP module:

grep SNMP JWS_installation_dir/logs/error_log

$ grep SNMP JWS_installation_dir/logs/error_log

[Wed Mar 19 09:54:34 2008] [notice] Apache/2.0.63 (Unix) CovalentSNMP/2.3.0 configured -- resuming normal operations
[Wed Mar 19 09:54:35 2008] [notice] SNMP: CovalentSNMP/2.3.0 started (user '1000' - SNMP address '1610' - pid '26738')

Copy to Clipboard

Toggle word wrap

The HTTP Server can now be added to the JBoss ON monitored resources using the JBoss ON User Interface by selecting the Inventory tab, followed by the Discovery Queue under the Resources menu.

Report a bug

23.2.1. Preparing the Apache SNMP module for use with Apache HTTP Server
复制链接

If the SNMP connectors are required for supported versions of Apache HTTP Server (other than Red Hat JBoss Web Server 2.x), they need to be compiled from source and installed.

Important

To use the Response Time module, the Apache server needs to have been compiled with shared object support. For Red Hat Enterprise Linux systems and Red Hat JBoss Web Server servers, this is enabled by default.

To verify that the Apache HTTP Server was compiled with shared object support, use the apachectl -l command to list the compiled modules and look for the mod_so.c module:

sudo apachectl -l

$ sudo apachectl -l
						
	Compiled in modules:
		  core.c
		  prefork.c
		  http_core.c
		  mod_so.c

Copy to Clipboard

Toggle word wrap

To compile Apache HTTP Server with shared object support, use the --enable-module=so option:

./configure --enable-module=so
make install

$ ./configure --enable-module=so
$ make install

Copy to Clipboard

Toggle word wrap

Apache connectors can be compiled for other platforms, like Solaris, from the source files in connector-apache.zip.
Download the source files for the Apache modules from the JBoss ON UI.
1. Log into the JBoss ON UI.
  https://server.example.com:7080
  Copy to Clipboard Toggle word wrap
2. Click the Administration tab in the top menu.
3. In the Configuration menu box on the left, select the Downloads item.
  
  View larger image
4. Scroll to Connector Downloads, and click the connector-apache.zip link to download the Apache connectors.
Note
The zip file containing the source files for the SNMP module can be found at JON_SERVER_INSTALL_DIR/modules/org/rhq/server-startup/main/deployments/rhq.ear/rhq-downloads/connectors/connector-apache.zip.
To compile the SNMP modules, you need to have the following packages installed: perl, make, automake and libtool.
```
sudo yum install perl make automake libtool
```
```
sudo yum install perl make automake libtool
```
Copy to Clipboard Toggle word wrap
Additionally apxs should be present as part of your Apache installation.

Unzip the Apache connectors and run the build script.

sudo unzip connector-apache.zip
sudo cd apache-snmp/sources/
sudo chmod 755 ./build_apache_snmp.sh
sudo ./build_apache_snmp.sh 2.0 [APACHE_INSTALL_DIR/sbin/apxs]

$ sudo unzip connector-apache.zip
$ sudo cd apache-snmp/sources/
$ sudo chmod 755 ./build_apache_snmp.sh
$ sudo ./build_apache_snmp.sh 2.0 [APACHE_INSTALL_DIR/sbin/apxs]

Copy to Clipboard

Toggle word wrap

Install the module from the directory where build_apache_snmp.sh is located. For example:

sudo cd snmp_module_#
sudo cp module/* apache_install_directory/modules
sudo cp conf/* apache_install_directory/conf
sudo mkdir apache_install_directory/var

$ sudo cd snmp_module_#
$ sudo cp module/* apache_install_directory/modules
$ sudo cp conf/* apache_install_directory/conf
$ sudo mkdir apache_install_directory/var

Copy to Clipboard

Toggle word wrap

Where # is the Apache version (either 2.0 or 2.2)

On Windows Server:

> xcopy /e JON_AGENT_INSTALL_DIR\product_connectors\apache-snmp\binaries\x86

> xcopy /e JON_AGENT_INSTALL_DIR\product_connectors\apache-snmp\binaries\x86

Copy to Clipboard

Toggle word wrap

The Apache SNMP module is now ready to be configured using the same process as configuring the module for Red Hat JBoss Web Server, detailed in Section 23.2, “Configuring the Apache SNMP Module”.

Report a bug

返回顶部

此内容没有您所选择的语言版本。

23.2. Configuring the Apache SNMP Module

23.2.1. Preparing the Apache SNMP module for use with Apache HTTP Server
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

此内容没有您所选择的语言版本。

23.2. Configuring the Apache SNMP Module

23.2.1. Preparing the Apache SNMP module for use with Apache HTTP Server复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

23.2.1. Preparing the Apache SNMP module for use with Apache HTTP Server
复制链接