OpManager -

The network, server and virtualization monitoring software

OpManager Installation Guide

System Requirements

# of devices/interfacesProcessorRAMFree Hard DiskSupported Operating System
Up to 50 devices or 300 Interfaces 1.7 GHz 1 GB 40 GB

Windows: 2012, 2008, 2003 Server, Vista, 2000 professional +SP4, XP Professional

Linux: RedHat 7.x and above, Debian 3.0, Suse, Fedora & Mandrake

Up to 300 devices or 2000 Interfaces 3.4 GHz 2 GB
Up to 1000 devices or 5000 interfaces 2 * 3.4 GHz 4 GB 80 GB
More than 1000 device or 5000 interfaces 4 * 3.4 GHz 8 GB

Supported Browsers: Latest versions of Firefox, Chrome,and IE.

Installing on Windows

Steps to install:

  1. Download OpManager for Windows.
  2. Execute the downloaded OpManager.exe to install and follow the instructions in the installation wizard.
  3. Click Next to begin the installation process. Go through the license agreement and click Yes to proceed to the next step.
  4. In the subsequent steps of the wizard, select the OpManager Edition (30day trial or Free), language and the directory to install OpManager. Proceed to the next step.
  5. If you want to install OpManager as Windows service, select Install OpManager as service option and proceed to the next step.
  6. Select the Program folder to add the OpManager shortcuts and click Next.
  7. Specify the port number to run OpManager Web Server and click Next.
  8. Register for technical support by supplying your contact information such as name, email id etc.
  9. Verify the installation details and click Next.
  10. Select the Server Mode i.e., Primary or Standby server and click Next.
    1. If the Server Mode is selected as Standby, then enter the Primary webserver host, port and login details and complete the installation.
  11. Select the database. OpManager supports both, PostgreSQL and MSSQL as database and click Next.
  12. Click Finish to complete the installation process.

Note:

  • For Vista installations after successfully completing the installation, if there is any issue in discovering the devices, then allow the ICMP ping requests via the Firewall. This is because by default, Vista installed devices has the in-built firewall configured such that the system does not respond to ICMP requests.
  • Make sure that your date settings are set to current date and time before installation. If your system date is set to a future or a past date, you will not be able to start the OpManager server after installation.
  • A shortcut to start OpManager Server will be created on the desktop and in the Start > Programs > ManageEngine OpManager menu.
  • After successful installation, if you have chosen to install OpManager as Windows service, OpManager service will be started automatically and the Web client will be launched.

Enabling ICMP Ping requests in Windows Vista

  1. From the Control Panel choose System and Maintenance.
  2. Click on Administrative Tools.
  3. Select Windows Firewall with Advanced Security.
  4. Click on Inbound Rules then right click on it and choose New Rule.
  5. Click on the Custom radio button and click Next.
  6. Click on All programs and click Next.
  7. Set the Protocol Type to ICMPv4 and click the Customize... button.
  8. Select Specific ICMP types, enable Echo Request and click on the OK button.
  9. Click Next.
  10. Verify if Any IP addresses is selected two times and click on the Next button.
  11. Verify if the Allow the connection radio button is selected and click Next.
  12. Verify that all three rules (Domain, Private and Public) are enabled and click Next.
  13. Specify a Name, perhaps a Description and click Finish.
  14. Verify if this new rule now is Enabled and close all open windows.

ICMP requests are now allowed to flow via the firewall.

Installing OpManager on Linux

Prerequisites:

  1. If OpManager is installed in Debian machines, make sure that the iputils-ping package is installed.

    This is required because OpManager uses the options of the Ping command provided by the iputils-ping package. Debian OS has two different packages, netkit-ping (installed by default) and iputils-ping. If iputils-ping package is not installed, OpManager will not be able to ping any of the managed devices and also itself and hence reports the status of all devices to be down.
  2. Sometimes, you might encounter errors such as database connection not getting established or the server not starting up. To workaround these issues, comment the IPv6 related entries in the etc/hosts file.
  3. Check if the DNS resolves properly to the IP Address on the system in which OpManager is installed. Add an entry to etc/host file with ipaddress and host name if there is trouble starting OpManager.

Now, to install OpManager on Linux machines, follow the steps given below:

  1. Download OpManager for Linux.
  2. Login as root user.
  3. Assign the executable permission to the downloaded file using the following command:
    chmod a+x OpManager.bin
  4. Execute ./OpManager.bin. The installation wizard pops up.
  5. Click Next to begin the installation process. Go through the license agreement and proceed to the next step.
  6. In the subsequent steps of the wizard, select the OpManager Edition (Professional or Free), language, the directory to install OpManager, and the port number to run OpManager Web Server. Proceed to the next step.
  7. Verify the installation details and click Next.
  8. Click Finish to complete the installation process.

It is recommended to install OpManager in the opt folder. By default, OpManager is installed in the /opt/ManageEngine/OpManager directory.

Here is a quick walk-through of the installation process in - console mode (when you are installing remotely, and in the absence of X-windows environment):

If you choose a different directory (outside opt), perform the following steps before starting the server:

  1. Execute the command chmod -R 755 OpManager Home . You should specify the absolute path for in this command.
  2. Then execute the command chmod 755 directory_name for each of the directory in the absolute path including root directory.
  3. Select the port number to run OpManager Web Server. Proceed to the next step.
  4. Verify the installation details and click Next. This installs the product in your system
  5. Click Finish to complete the installation process.

Uninstalling OpManager

  1. To uninstall from a Windows machine, try Start > Programs > ManageEngine OpManager > Uninstall OpManager.
  2. To uninstall from a Linux machine, execute the command ./uninstaller.bin from the /bin/_uninst directory under OpManager installation.

Installing NetFlow plug–in

NetFlow plug-in supports Windows and Linux platforms. Go through the steps given below to install the NetFlow plug–in:

  1. Shut down OpManager. If OpManager is running as a Windows service, then stop the service from Control Panel > Services window
  2. Download the NetFlow plug–in.
  3. Execute the downloaded NetFlow plug–in and follow the on screen instructions.
  4. Enter the Web Server and NetFlow listener port numbers. By default, NetFlow plug–in uses 8080 as Web Server port and 9996 as NetFlow listener port. If you want to run them on different ports, then change the port number here.
  5. Enter the default SNMP Read community, Write community and Port number. Read Community and Port details are used to retrieve the interface names and interface speeds, while the Write community is required to enable NBAR data collection.
  6. Provide your Name, E–mail ID, Company Name etc. in order to register for Technical Support.
  7. Click Finish to complete the installation.
  8. Now start the OpManager server.

Uninstalling NetFlow plug–in

  1. Shut down OpManager. If OpManager is running as a Windows service, then stop the service from Control Panel > Services window.
  2. From the Control Panel open Add⁄Remove Programs.
  3. Select ManageEngine NetFlow plug–in and click Change⁄Remove button.
  4. Click Yes to confirm to uninstall the plug–in.
  5. Click Finish. The plug–in has been uninstalled successfully.

Installing NCM plug–in

NCM plug–in supports only Windows platform. Go through the steps given below to install the NCM plug–in:

  1. Shut down OpManager. If OpManager is running as a Windows service, then stop the service from Control Panel > Services window.
  2. Download the NCM plug–in
  3. Execute the downloaded NCM plug–in and follow the on screen instructions.
  4. Provide your Name, E–mail ID, Company Name etc. in order to register for Technical Support
  5. Click Finish to complete the installation.
  6. Now start the OpManager server.

Note: Once you start the OpManager service it will take few minutes to configure the NCM plug–in.

Uninstalling NCM plug–in

  1. Shut down OpManager. If OpManager is running as a Windows service, stop the service from Control Panel > Services window.
  2. From the Control Panel open Add⁄Remove Programs.
  3. Select ManageEngine NCM plug–in and click Change⁄Remove button.
  4. Click Yes to confirm to uninstall the plug–in.
  5. Click Finish. The plug–in has been uninstalled successfully.

Installing IPAM plug-in

  1. Download the IPAM plug-in.
  2. Execute the downloaded IPAM plug-in on the OpManager installed machine and follow the on screen instructions.
  3. By default, IPAM plug-in uses 7080 and 7443 as HTTP and HTTPs Web Server ports respectively. If you want to run them on different ports, then change the port number here.
  4. Provide your Name, E-mail ID, Company Name etc. in order to register for Technical Support.
  5. Click Finish to complete the installation.

Uninstalling IPAM plug-in

  1. From the Control Panel open Add/Remove Programs.
  2. Select ManageEngine IPAM plug-in and click Change/Remove button.
  3. Click Yes to confirm to uninstall the plug-in.
  4. Click Finish. The plug-in has been uninstalled successfully.

Installing Applications Monitoring plug-in

  1. Download the Application Monitoring plug-in.
  2. Execute the downloaded Application Monitoring plug-in on the OpManager installed machine and follow the on screen instructions.
  3. By default, Application Monitoring plug-in uses 9090 and 8443 as Web and SSL ports respectively. If you want to run them on different ports, then you can change the port number.
  4. Provide your Name, E-mail ID, Company Name etc. in order to register for Technical Support.
  5. Click Finish to complete the installation.

Uninstalling Applications Monitoring plug-in

  1. From the Control Panel open Add/Remove Programs.
  2. Select ManageEngine APM plug-in and click Change/Remove button.
  3. Click Yes to confirm to uninstall the plug-in.
  4. Click Finish. The plug-in has been uninstalled successfully.

Installing Log File Monitoring Agent

  1. Go to Admin-> Agents.
  2. Click on Download Agent button to download the .msi file.
  3. Execute the downloaded agent.msi file on the Windows server containing the log files.

Uninstalling Log File Monitoring Agent

  1. From the Control Panel open Add/Remove Programs.
  2. Select OpManager Agent and click Change/Remove button.
  3. Click Yes to confirm to uninstall the plug-in.
  4. Select 'Automatically close applications and attempt to restart them after setup is complete' check box and click OK.

Upgrading OpManager

Different types of OpManager upgrades are periodically released. These include Service Packs, Upgrade Packs, Hot Fixes, and Migration Packs.

Following is the URL where the latest upgrades are hosted for download:

http://www.manageengine.com/network-monitoring/service-packs.html

  1. Shut down OpManager. If OpManager is running as a Windows service, stop the service from Control Panel > Services window. Take a backup of the data and configurations in OpManager.
  2. Take a backup of the data and configurations in OpManager.
  3. Make sure all the processes that are running in the system are killed. Open "Task Manager" and ensure that there are no java, mysql, apache processes are running. Also terminate if any anti–virus software is running.
  4. Open the Update Manager tool
    For Windows installations: Click Start > Programs > ManageEngine OpManager > Update Manager.
    For Linux installations: Execute the script ⁄bin⁄UpdateManager.sh
    [If the Update Manger UI does not open, then click here to upgrade via console mode]
  5. Click Install and then click Browse to select the upgrade pack file (file with .ppm extension).
  6. Click Finish. This installs the service pack for OpManager.
  7. Start OpManager Server.

Reverting Upgrades

It is recommended not to revert any patches using the same open instance of UpdateManager. Exit UpdateManager if open and invoke again to revert the applied patches. Here are the steps to revert:

  1. Shut down OpManager. If OpManager is running as a Windows service, then stop the service from Control Panel > Services window
  2. pen the Update Manager tool
    For Windows installations: Click Start > Programs > ManageEngine OpManager > Update Manager.
    For Linux installations: Execute the script ⁄bin⁄UpdateManager.sh
    [If the Update Manger UI does not open, then click here to upgrade via console mode]
  3. Select the ppm file to be uninstalled from the Installed Service Pack list and click Uninstall. This will uninstall the service pack for OpManager.
  4. Start OpManager Server.

OpManager OVF Deployment

Deploy an OVF Template

Use the VMware vSphere Client to deploy the OVF template.

  • Start the vSphere client and log on to the ESX(i) server.
  • In the vSphere Client, select File > Deploy OVF Template (Deploy OVF Template wizard appears)
  • Provide URL link to the OVF Template in the "Deploy from a file or URL" field, then click Next.
  • Verify the OVF Template Details and click Next
  • Provide a desired name for the template and select the folder location within the inventory for deployment.
  • Select the deployment configuration from the drop-down menu and click Next. (This page appears only if the OVF template contains deployment options)
  • Select the host or cluster to deploy the OVF template and click Next.
  • Choose the resource pool where you want to run the OVF template and click Next.
  • Select a datastore to store the deployed OVF template (for storing the virtual machine files), and click Next.
  • Select the disk format to store the virtual machine virtual disks, and click Next
  • Map each network used in the OVF template to the networks in your inventory, by selecting the drop-down list in the Destination Networks column. Then click Next.
  • Review all the settings you have specified and click Finish. The OVF template is deployed to your virtual machine.

Use Cases

The following use cases help you to confirm the flawless working of OpManager post upgrade:

  • Check the build number [From OpManager webclient, click the About link available at the top right to view the build number]. It should show the number to which you have upgraded.
  • Check whether all the tabs are available for Admin user
  • Just do a random check to ensure whether the devices are correctly classified under respective categories. For example servers are grouped under Servers, routers under routers etc.
  • Do a test monitor for a device to ensure whether OpManager collects and displays data [from the device snapshot page, click on edit icon of a monitor and click Test Monitor button]
  • Just generate any availability⁄health report of a device
  • Verify whether the dashboard displays alerts, health status of devices
  • Verify the mail server and sms server settings
  • Add a device into OpManager and ensure whether it is getting added into OpManager
  • Randomly verify the threshold settings of some monitors
  • Perform the routine tasks done by an admin⁄user after 1 hour
  • Restart the windows server on which OpManager is running and check whether OpManager starts up as a service correctly
  • If DB replication is enabled, then check the status of the replicated DB

Refer to the Quick Start Guide to help you get started with configuring OpManager to monitor your network. Feel free to drop a line to us at our Support Portal incase of any queries or clarifications