VMWARE VREALIZE END POINT OPERATIONS FOR. Apache HTTP Server. User Guide

Transcription

1 VMWARE VREALIZE END POINT OPERATIONS FOR User Guide

2 TABLE OF CONTENTS 1. Product Overview Product Version Information Known Issues/Limitations System Requirements Configuration Enable the Apache Status Module (mod_status) Configure mod_status Verify Least-Privileged User (LPU) Installing End Point Operations for Prerequisites Installing the End Point Operations Management Agent Uploading the Installation (.pak) file in vrealize Operations What to do next Viewing/Modifying Agent Configuration Settings Prerequisites Procedure What to do next End Point Agent Overview Dashboard Metrics Properties Troubleshooting Viewing Errors in the Agent Log File...9 NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. You can find the most up-to-date technical documentation on the Blue Medora support site at: The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: support@bluemedora.com. 2 Blue Medora VMware vrealize End Point Operations for

3 1. Product Overview Blue Medora VMware vrealize End Point Operations for collects performance data from your resources and makes it available within VMware vrealize Operations (vrops). 2. Product Version Information VERSION RELEASE DATE DESCRIPTION June 30, 2017 Initial release by Blue Medora 3. Known Issues/Limitations None at this time. 4. System Requirements Before installing End Point operations for, ensure your system meets the following requirements: Table 1: System Requirements Operating System (OS) vrealize Operations (vrops) Apache HTTP Server Windows Linux vrealize Operations 6.3+ Apache HTTPD 2.4+ NOTE: Apache s Status Module (mod_status) is required to return performance metrics. See section 5. Configuration for details. 3 Blue Medora VMware vrealize End Point Operations for

4 5. Configuration Before installing End Point operations for, you must configure the following on your Apache HTTP Server: Enable the Apache Status Module (mod_status) Configure mod_status Verify Apache Least-Privileged User (LPU) 5.1 Enable the Apache Status Module (mod_status) Most Apache installations will come with mod_status enabled, but if yours is not, you can enable the module in the httpd.conf configuration file. Search for mod_status, and uncomment (remove # ) the following line to enable it: #LoadModule status_module modules/mod_status.so 5.2 Configure mod_status Next, you ll want to configure mod_status by modifying the httpd.conf file. Find the mod_status section. (You may want to search for Location.) It should look like the following: # Allow server status reports generated by mod_status; # with the URL of # Change the.example.com to match your domain to enable. # # ExtendedStatus off # <Location /server-status> # SetHandler server-status # Order deny, allow # Deny from all # Allow from example.com # </Location> Configure the above section as follows: Uncomment (remove the # at beginning of each line) the entire section. Change the ExtendedStatus setting to on. Add the Host (i.e., FQDN, Hostname, or IP Address) of the machine you are using to access your web server to the Allow from example.com line within the <Location /server-status> parameter. 5.3 Verify Least-Privileged User (LPU) At a minimum, the EP Ops for user must be able to successfully run the following command: httpd -V 4 Blue Medora VMware vrealize End Point Operations for

5 6. Installing End Point Operations for To successfully install End Point Operations for, you must first install the End Point Operations Management agent on your Apache HTTPD host machines, then upload the EP Ops for installation file in vrealize Operations. 6.1 Prerequisites Obtain the End Point Operations for installation (.pak) file from the VMware Solution Exchange. 6.2 Installing the End Point Operations Management Agent Install the End Point Operations Management agent on your host machines. For instructions, refer to VMware s online help for your specific version of vrealize Operations: vrops version 6.3: End Point Operations Management Agent Installation and Deployment vrops version 6.4: End Point Operations Management Agent Installation and Deployment vrops version 6.5: End Point Operations Management Agent Installation and Deployment vrops version 6.6: End Point Operations Management Agent Installation and Deployment 6.3 Uploading the Installation (.pak) file in vrealize Operations 1. Save the.pak file in a temporary location. 2. Log in to vrealize Operations as an admin user. 3. In the left pane, select Administration, then click Solutions. 4. In the right panel, the Solutions list will be displayed. 5. Click the Add icon ( ). In the dialog that appears, browse to the location of the saved.pak file, then click Upload. NOTE: When you upload the.pak file, you ll see a notification regarding the file being unsigned. Ignore this notification and continue the installation process. 5 Blue Medora VMware vrealize End Point Operations for

6 6. Read and accept the End User License Agreement (EULA), then click Next. The upload might take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process. 7. Click Finish when the installation process is complete. 6.4 What to do next After End Point Operations for has been installed, you can view the adapter instance for the agent created in vrops and modify the configuration settings, if needed. 7. Viewing/Modifying Agent Configuration Settings After the End Point Operations for.pak file has been installed, you can view the configuration settings for the adapter instance using the Inventory Explorer. 7.1 Prerequisites Wait for vrealize Operations Manager to complete one collection cycle so that the installed agent can be discovered. 7.2 Procedure 1. In the left pane of vrealize Operations Manager, click Administration, then Inventory Explorer. 2. Click Adapter Types > EP Ops Adapter. 3. Select the applicable, then click Edit Object ( ). The Edit Object dialog will open. 6 Blue Medora VMware vrealize End Point Operations for

7 4. The following settings are configurable: NOTE: Once the EP Ops agent is running, any setting changes require the Override agent configuration data setting to be set to true. apachehttpserver.url: Check this field and verify the full Apache HTTP server-status page URL is shown. Modify the value if necessary. Credential (optional): You may add basic authentication to your agent configuration by clicking on the Plus ( ) and entering a user name and password as follows: 7.3 What to do next Your End Point Operations for agent should now start returning performance metrics for the server(s) on the configured host. Navigate to your Dashboard List and select the End Point Agent Overview dashboard. 7 Blue Medora VMware vrealize End Point Operations for

8 8. End Point Agent Overview Dashboard End Point Operations for includes the following out-of-the-box overview dashboard. Select a server from the Selector widget on the left to view its key performance metrics on the right. 9. Metrics The following metrics are collected by End Point Operations for. Table 2: Metrics RESOURCE KIND RESOURCE ATTRIBUTE Resource Availability (percent: 0 or 100) ReqPerSec (Request/sec) Total Traffic (bytes) CPU Usage (Linux only; percent) ServerLoad (Windows only) Uptime (days) TotalAccesses IdleWorkers Throughput (byes/sec) Request Size (bytes) BusyWorkers 8 Blue Medora VMware vrealize End Point Operations for

9 10. Properties The following properties are collected by End Point Operations for. Table 3: Properties RESOURCE KIND PROPERTY PID (Parent process ID) Version fullpath configfile To view these properties, select the HTTP Server for which you want to view properties from the Apache HTTP Server widget in the dashboard, then select the Object Detail ( ) icon. In the Summary tab that appears, properties for the selected server are listed in the About Me widget on the right. 11. Troubleshooting 11.1 Viewing Errors in the Agent Log File You can review EP Ops agent errors in the agent.log file, which can be viewed in the vrops user interface or in an external log viewer. The log file can be found at $VCOPS_BASE/user/log/agent.log. 9 Blue Medora VMware vrealize End Point Operations for

10 You can find the most up-to-date technical documentation on the Blue Medora support site at: The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: Copyright 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions. The Apache name (including ) and logo are trademarks or registered trademarks of The Apache Software Foundation (ASF) in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI bluemedora.com