OpManager Installation Guide
OpManager Installation Guide
OpManager
www.manageengine.com/opmanager
Table of Contents
a. Hardware Requirements 3
b. Software Requirements 4
c. Port Requirements 5
d. Database Requirements 7
III. Installation 12
V. Failover 38
The system requirements mentioned below are minimum requirements for the specified number of
devices. The sizing requirements may vary based on the load.
Hardware Requirements
OpManager <250
2 GHz 4 GB 20 GB
OpManager 500
2.5 GHz 8 GB 20 GB
OpManager 1000
Quad Core 2.5 GHz
16 GB 40 GB
or higher
Enterprise Edition
Dual Quad Core 3.5 GHz
16 GB 100 GB
or higher
1. In the case of OpManager Enterprise, the hardware requirements are the same for both the
Central and Probe.
2. Dedicated resources must be available in the case of VMs
Software Requirements
The following table lists the recommended software requirements for an OpManager installation.
Port Requirements
The following table summarizes the ports and protocols that OpManager uses for communication.
514 UDP Static SYSLOG Receiver SYSLOG Receiver Port can be changed
Port via web client.
Note: Dynamic ports change during each server startup based on the ports available in the system
■ Databases
The following table lists the basic requirements for your OpManager database server.
PGSQL Bundled with the product. For evaluation purposes only. Please use MSSQL for production.
Collation:
English with collation setting (SQL_Latin1_General_CP1_CI_AS)
Norwegian with collation setting (Danish_Norwegian_CI_AS)
Simplified Chinese with collation setting (Chinese_PRC_CI_AS)
Japanese with collation setting (Japanese_CI_AS)
German with collation setting (German_PhoneBook_CI_AS)
Authentication:
Mixed mode (MSSQL & Windows Authentication).
BCP (Only for Enterprise Edition (or) Standard/ Professional Edition with the NFA addon):
The "bcp.exe" and "bcp.rll" must be available in the OpManager bin directory.
The BCP utility provided with Microsoft SQL Server is a command line utility that allows
you to import and export large amounts of data in and out of SQL server databases
quickly. The bcp.exe and bcp.rll will be available in the MSSQL installation directory. If
MSSQL is in a remote machine, copy bcp.exe and bcp.rll files and paste them into
\OpManager\bin directory.
Note: The SQL server version compliant with the SQL Native Client must be installed in the
same Server.
Note: If you wish to proceed with your existing server authentication credentials, please skip this
step and directly move to the installation procedure.
Step 1: To ensure proper communication between the MSSQL database server and OpManager, a
new account has to be created with the below mentioned steps.
● Open SQL Management Studio and login using your Server Account (sa)/ Windows
credentials.
● Right click on Logins
● Select New Login
Step 2: Select Authentication type. For Windows authentication, select and login using your Windows
login credentials. For SQL Server Authentication, enter the password. Then proceed with Step 3.
Note: If OpManager is run with MSSQL as the backend database, then the MSSQL database must be
configured before proceeding with the following installation.
Steps to install
Prerequisites
1. 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.
2. 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.
It is recommended to install OpManager in the opt folder. By default, OpManager is installed in the
/opt/ManageEngine/OpManager directory.
This is a quick walk-through of the console mode installation of OpManager on a Linux box - an easy
thing to do if you are working on a Windows box and want to install on a remote Linux system.
Prerequisites
To begin with, make sure you have downloaded the binary for Linux.
(http://www.manageengine.com/network-monitoring/download.html)
Steps to install
Step 3: Register for technical support (Enter Name, E-mail id, Phone, Company Name)
Go to /OpManager/bin folder
Execute: sh run.sh
Case 2: When the number of devices that need to be monitored is more than 1K devices.
ManageEngine recommends the installation of a Central server and a Probe to effectively achieve a
distributed network monitoring environment.
Central Server: Central periodically collects health, performance and fault data across all Probes and
consolidates the information in one location.
Probe Server: The Probe periodically polls the devices in the local network and updates data to the
central server. It has to be installed at the Remote Location.
Note: If OpManager is run with MSSQL as the backend database, then the MSSQL database must be
configured before proceeding with the following installation.
https://www.manageengine.com/cgi-bin/download_exe?id=4-883
Run the exe as 'administrator'
Step 5: Choose the destination folder for OpManager installation and click 'Next' to proceed
Step 6: If you want to change the default web server port for OpManager installation enter the new
port number (OpManager Central uses 80 as the default web server port) and click 'Next' to proceed.
Step 7: Register your OpManager license with required details to get technical support and click
'Next' to proceed.
Step 8: Select 'Standalone' or 'Primary' server . If you are installing failover, select standby server.
First configure standalone or primary for failover installation. Click 'Next' to proceed.
Step 9: If you select PGSQL, please proceed with Step 13. (or) If you select 'MSSQL' database
(recommended for production). Click 'Next' to proceed
Step 10: If you select SQL Authentication, provide MSSQL details like Host Name, Port, Database
Name. Use the SQL Server Authentication credentials (Username and Password) created earlier.
Click 'Next' to proceed
If you select WINDOWS Authentication, provide MSSQL details like Host Name, Port, Domain Name,
Database Name, Username and Password. Click 'Next' to proceed.
Step 12: Click on browse and select \OpManager\bin\bcp.exe. Click 'Next' to proceed.
https://www.manageengine.com/cgi-bin/download_exe?id=4-887
Step 4: Choose your language for OpManager Probe installation and click 'Next' to proceed
Step 5: Choose the destination folder for OpManager Probe installation and click 'Next' to proceed
Step 6: If you want to change the default web server, netflow ports for OpManager probe installation
enter the new port numbers (OpManager uses 80 as the default web server port and 9996 as the
default Netflow port) and click 'Next' to proceed.
Step 7: Enter the details of the proxy server (if the probe is installed behind a proxy server) and click
'Next' to proceed
Step 8: Register your OpManager license with required details to get technical support and click
'Next' to proceed.
Step 9: Select 'Standalone' or 'Primary' server. If you are installing Failover, select standby server.
Step 10: If you select PGSQL, please proceed with Step 14. (or) If you select 'MSSQL' database
(recommended for production). Click 'Next' to proceed
Step 11: Provide MSSQL details like host name, port, database name. Use the credentials (username
and password) that was created earlier while configuring SQL. Click 'Next' to proceed
Step 13: Click on browse and select \OpManager\bin\bcp.exe. Click 'Next' to proceed.
Prerequisites
1. 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.
2. 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.
Steps to install
Central Server
Probe Server
B.2 Installing OpManager Enterprise Edition on Linux using Console mode/ Silent mode
Prerequisites
To begin with, make sure you have downloaded the binary for Central and Probe for Linux OS.
(https://www.manageengine.com/network-monitoring/download.html)
Step 3: Register for technical support (Enter Name, E-mail id, Phone, Company Name)
Step 3: Register for technical support (Enter Name, E-mail id, Phone, Company Name)
Go to /OpManager/bin folder
Execute: sh run.sh
OpManager license options depend on the number of devices to be monitored. The license is
inclusive of all the interfaces, nodes or sensors in the device. A device can have any number of
interfaces, elements or sensors.
Eg: Let us assume that a network has 50 devices with 4 interfaces each and the total number of
interfaces will be 200. To monitor these 50 devices and 200 interfaces, OpManager needs a
©2021 ZOHOCorp.,ManageEngine-‐All rights reserved.
50-device license.
OpManager allows users to obtain and register for a license with ease.
1. Connect to the Webclient and click the "User" icon in the top right corner.
3. Select the "Register" tab to view your license and registration options.
There are two ways to apply for a license during the server startup.
When in the console mode, the CMD prompt will show you a message stating that your license is
about to expire and it will request the address to the directory in which the "License.xml" file is
available. Here, you can provide the path to the license file and register.
To check your license details, you can follow the simple steps below;
1. Click the "User" icon in the top right corner of your OpManager UI.
2. Under the "About" tab, you will be able to find details about your license and add-ons in the
"License Details/Add-On Details (Added/Licensed)" section respectively.
A perpetual license contains both the base product fee and the Annual Maintenance & Support
(AMS) fee. The base product fee allows you to purchase the solution for any of the proposed device
packs/ add-ons while AMS provides support to ensure healthy network monitoring from OpManager.
What is Failover?
Failover is an alternative monitoring instance that is used to ensure your network remains monitored
even when your primary monitoring setup goes down. OpManager helps in ensuring uninterrupted
monitoring of your network by allowing you to configure a secondary monitoring instance on a
separate server.
The primary server updates a value called heartbeat in the database. The heartbeat value is a
counter that is incremented by the primary server at a specific frequency of time. The secondary
server monitors the heartbeat value to check if it is being updated in the specified time interval.
When the primary server goes down, it will not be able to update the heartbeat value in the database.
The information between the primary and secondary instances are synced periodically, thus ensuring
that you don't miss critical monitoring data ( such as device status, traps, syslog messages etc., )
when your primary OpManager instance goes down.
● Apply the failover add-on: Apply the Failover - Hot Standby Engine (MSSQL only) add-on in
your primary instance. You can purchase the add-on for Professional Edition from here and
for OpManager Plus from here.
● Have the database in a separate server: Ensure that the database for your OpManager
installation is setup in a separate server and not the same server in which the primary or
secondary OpManager instance is installed (MSSQL setup preferred).
● Create a shared folder in a separate server: Some data in OpManager are stored in files
which are present in the local directory. When failover is configured, instead of a local
directory, these files are stored in a shared folder that is accessible by both primary and
secondary servers . This ensures that there is no data loss when the secondary server takes
over the monitoring process.
Create a folder in a separate server and share it with both the primary and secondary servers.
Ensure that both primary and secondary servers have access to the shared folder with write
permission.
( Note: The server in which the folder is created should be in the same domain in which your
primary and secondary servers are configured. Also, the server in which the folder is created
should not be the same server in which the primary or secondary instance is configured).
Click here to learn how to share a folder with both primary and secondary instances.
● Have a virtual IP address: A Virtual IP address is a common IP address that is shared by
both primary and secondary server on the same subnet. When one server goes down, the
virtual IP points to the other server. (This feature is available only for OpManager versions
12.5.140 and above.)
● Hardware and software requirements
■ Both the primary and secondary instances should be installed in Windows systems.
■ The same version of OpManager should be installed in both servers.
■ Both primary and secondary OpManager services should have the same port and
protocol ( http / https ).
■ Both primary and secondary servers should have the same time and time zone.
In your primary instance, go to Settings -> General Settings -> Failover Details and enter the
following details:
● Secondary Server IP: The IP address or host name of your secondary server.
● Shared folder path: The path to the empty shared folder created in a separate server.
This is generally of the form \\<Server_Name_or_IP>\<Share_Name>.
Note: Ensure that the empty folder is shared with both primary and secondary
servers. Click here to learn how to share the folder with primary and secondary
servers.
● Virtual IP: The virtual IP address. Refer to the pre-requisites to know more about
● Download the Configure_failover_server.bat file and move it to the folder where you
wish to have your secondary instance configured.
● Run the Configure_failover_server.bat file.
● Share the OpManagerHome folder to the primary server. Click here to learn how.
● Start the secondary OpManager instance.
● ● The
Theoption
optiontoto
configure failover
configure with
failover aa
with virtual IPIP
virtual address isis
address only available
only for
available OpManager
for OpManager
versions
versions12.5.140
12.5.140and
andabove.
above.
● ● OpManager does not provide
OpManager does not provide any
anykind ofof
kind database failover
database support.
failover It It
support. only provides
only application
provides
level failover support.
application level failover support.
● ● Always start the
Always start the secondary
secondary instance after
instance the
after primary
the instance
primary isis
instance completely started.
completely started.
The approximate time taken
● The approximate for taken
time the secondary server to completely
for the secondary takeover the
server to completely primary
takeover thewill be 3-4will
primary
minutes. There
be 3-4may be a minor
minutes. There loss
may of
bedata in few
a minor SNMP
loss traps,
of data syslogs
in few SNMP ortraps,
flow received during
syslogs or flow that
period.
received during that period.
Upgrading the failover setup: While upgrading your OpManager service, it is enough to apply the
PPM for the primary setup. The secondary server will be updated automatically.
Uninstalling OpManager
Windows
1. To uninstall from a Windows machine, try Start > Programs > ManageEngine OpManager >
Uninstall OpManager.
Linux
2. To uninstall from a Linux machine, execute the command ./uninstaller.bin from the
/bin/_uninst directory under OpManager installation.