# OpManager Standard/ Professional Installation

- [Installing OpManager on Windows](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#opw)
- [Installing OpManager on Linux](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#opl)
- [Installing OpManager on Linux using Console mode/ Silent mode](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#oplc)
- [Installing OpManager on Linux with MSSQL database](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#mssql-linux)
- [Installing OpManager with Kingbase DB](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#kingbase-db)
- [Installing OpManager on AWS](https://www.manageengine.com/network-monitoring/help/installing-opmanager-aws.html)
- [Installing OpManager with Amazon RDS](https://www.manageengine.com/network-monitoring/help/installing-opmanager-with-amazon-rds-mssql.html)
- [Installing OpManager on Microsoft Azure](https://www.manageengine.com/network-monitoring/help/installing-OpManager-in-microsoft-azure.html)
- [Installing OpManager Enterprise edition](https://www.manageengine.com/network-monitoring/help/installing-opmanager-enterprise.html?help_installing_opmanager)
- [Prerequisites to Installing OpManager on CIS Hardened server](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#iochs)
- [Starting OpManager on Linux](https://www.manageengine.com/network-monitoring/help/installing-opmanager.html#sol)

## Installing OpManager on Windows

### Steps to install

**Step 1:** Download [OpManager for Windows](https://www.manageengine.com/network-monitoring/download.html?opm-installation).

**Step 2:** Execute the downloaded "ManageEngine_OpManager_64bit.exe" file to install and follow the instructions in the installation wizard.

**Step 3:** Click "Next" to start the installation process. Go through the license agreement and click "Yes" to proceed to the next step.

**Step 4:** Choose the directory where you wish to install OpManager in the subsequent steps of the wizard.

**Step 5:** Specify the port number to run OpManager Web Server (OpManager uses 8060 as the default web server port) and click "Next".

**Step 6:** Register for technical support by providing your contact information such as Name, E-mail ID, etc., and click "Next".

**Step 7:** OpManager is bundled with PostgreSQL by default. However, it also supports MSSQL databases. Choose the desired database option and click "Next".

**Step 8:** Click "Finish" to complete the installation process.

## Installing OpManager on Linux

### Steps to install

1. Download [OpManager for Linux](https://www.manageengine.com/network-monitoring/download.html?opm-installation).
2. Login as root user.
3. Assign the executable permission to the downloaded file using the following command:

```
chmod a+x ManageEngine_OpManager_64bit.bin
```

4. Execute `./ManageEngine_OpManager_64bit.bin` with administrator privileges (`sudo`). This will display the installation wizard.
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, 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.

**Troubleshooting steps:**

- In Linux setups, you may occasionally face issues such as the OpManager server failing to start or database connection errors. To resolve this, check the `/etc/hosts` file and comment out any IPv6-related entries, as these can interfere with proper hostname resolution.
- Verify that DNS resolution is working correctly in Linux setups. If not, manually add an entry in the `/etc/hosts` file with the server's IP address and hostname to ensure proper connectivity and successful startup of OpManager.

## Installing OpManager on Linux using Console mode

You can install OpManager on your Linux system through the console terminal if your server does not have a graphical user interface (GUI) or if you are accessing it remotely or via a cloud-based Linux machine. Unlike a UI-based installation, the command-line installation requires you to execute a series of commands to complete the setup.

### Steps to install

1. Download the **ManageEngine OpManager (.bin)** installation file.
2. Once downloaded, open the Command Terminal and navigate to the directory where the installation file is located.
3. Login as **root user** and assign executable permissions:

```
chmod a+x ManageEngine_OpManager_64bit.bin
```

4. Execute the downloaded OpManager file using the following command:

```
sudo ./ManageEngine_OpManager_64bit.bin -i console
```

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-1.png)

5. An introduction to **InstallAnywhere Wizard for OpManager** will be displayed in the console.

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-2.png)

6. Read the **License Agreement**, press **Enter** to continue and accept the terms.
7. Register for technical support based on your preference.

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-3.png)

8. Select your **country** from the list and enter the corresponding numerical value.
9. Review ManageEngine’s Privacy Policy, then choose from the available options (Next, Skip, Cancel, or Back).

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-4.png)

10. Specify the **Installation Directory** (default or absolute path).

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-5.png)

11. Enter the **Web Server Port** (default: 8060 and 8061). Ensure the ports are open.

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-6.png)

12. A **Pre-installation Summary** will be displayed.

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-7.png)

13. Press Enter to proceed and wait for the installation to complete.

![OpManager:Linux download](https://www.manageengine.com/network-monitoring/help/images/console-8.png)

14. Navigate to the bin directory:

```
cd <OpManager_Home>/bin
```

15. Start OpManager:

```
sh StartOpManager.sh
```

After starting the service successfully, you can open the OpManager UI through the configured web server port.

## Installing OpManager on Linux with MSSQL database

From version 12.8.330, MSSQL database is supported for Linux setups. MSSQL cannot be configured directly from the installation wizard for Linux. Perform a default installation with PgSQL and then migrate to MSSQL.

**Note:** MSSQL database is not included with the setup for Linux installations.

### Steps to migrate to MSSQL DB

1. In terminal, go to `<OpManager_Home>/bin` and execute the **DBConfiguration.sh** file.
2. Provide the SQL server details with the DB name.
3. Leave the **Migrate data from existing database** option unchecked.

![OpManager installation: Migration to MSSQL database](https://www.manageengine.com/network-monitoring/help/images/migrate-mssql.jpg)

4. Click OK to start migration.

A success message will be displayed after migration.

**Note:**

- The DBConfiguration.sh file can be executed either directly from the Linux machine or from X11 enabled environments.
- Executing DBConfiguration.sh from the console mode is currently not supported.
- For BCP utility details, refer to [this link](https://www.manageengine.com/network-monitoring/help/hardware-and-software-requirements.html#bcp-linux).

## Installing OpManager with Kingbase DB

From version **12.8.658** onwards, OpManager supports the Kingbase database. The Kingbase option is not available in the installation wizard. Install using PostgreSQL (PgSQL) and then reconfigure to Kingbase using DBConfiguration.

The DBConfiguration method is applicable for both Windows and Linux. On Linux, it is supported only in X11-enabled environments or when accessed directly from the Linux machine.

1. Install OpManager using the PgSQL database option. Do not start OpManager after installation.
2. Open the command prompt/terminal and navigate to `<OpManager_Home>/bin`.
3. Execute:
   - **Windows:** `DBConfiguration.bat -showKingbaseDB`
   - **Linux:** `sh DBConfiguration.sh -showKingbaseDB`
4. Select Kingbase from the database options, provide the required database details, and click OK.

![Kingbase DB Configuration](https://www.manageengine.com/network-monitoring/help/images/Kingbase_DBConfig.png)

5. Configure the Read-Only User (ROUser) as below.
6. Start OpManager.

### Read only user configuration

1. Connect to the Kingbase database used by OpManager.
2. Execute the following queries:

```
CREATE USER rouser WITH PASSWORD '<ROPASSWORD>';
REVOKE ALL ON SCHEMA public FROM rouser, public;
GRANT CONNECT ON DATABASE "<DatabaseName>" TO rouser, public;
GRANT USAGE ON SCHEMA public TO rouser, public;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO rouser, public;
ALTER DEFAULT PRIVILEGES FOR ROLE <Superuser> IN SCHEMA public GRANT SELECT ON TABLES TO rouser, public;
GRANT USAGE ON SCHEMA public TO rouser;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO rouser;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO rouser;
```

Replace `<ROPASSWORD>`, `<DatabaseName>`, and `<Superuser>` with appropriate values.

3. Edit `<OpManager_Home>/conf/database_params.conf` and add:

```
ro_password=<ROPASSWORD>
```

## Installing OpManager on CIS Hardened server

Before installing, check execute permission in the `/tmp` directory:

```
mount | grep /tmp
```

Example output:

```
tmpfs on /tmp type tmpfs (rw,nosuid,nodev,noexec,seclabel)
```

If `/tmp` is mounted with `noexec`, use one of the following approaches:

**a) Modify 'noexec' to 'exec':**

```
mount -o remount,exec /tmp
```

After installation, revert:

```
mount -o remount,noexec /tmp
```

**b) Use another directory as temp directory:**

```
mkdir /opt/tmp
export IATEMPDIR=/opt/tmp
```

**Note:** Changes to IATEMPDIR are session-specific and revert after the terminal is closed.

The above steps were carried out in Red Hat Enterprise Linux 7 OS with CIS Benchmark - Level 1 hardening.

## Starting OpManager on Linux

### Steps for starting the setup as a service:

1. Install the product.
2. Go to `<OpManager_Home>/bin/`
3. Run:

```
sh linkAsService.sh
```

4. Start the product:

```
systemctl start OpManager.service
```

or

```
/etc/init.d/OpManager.service
```

**Note:**

1. Step 4 may vary based on the Linux OS type and version.
2. After starting OpManager, run:

```
cat nohup.out
```

to view startup information.

## Post Installation Quick links

- [Starting OpManager](https://www.manageengine.com/network-monitoring/help/starting-opmanager.html)
- [MSSQL Server Configuration](https://www.manageengine.com/network-monitoring/help/mssql-configuration.html)
- [Configuring System Settings](https://www.manageengine.com/network-monitoring/help/configuring-system-settings.html)
- [What you should monitor](https://www.manageengine.com/network-monitoring/help/what-you-should-monitor.html)
- [Adding credentials](https://www.manageengine.com/network-monitoring/help/add-credentials.html)
- [Discovering devices](https://www.manageengine.com/network-monitoring/help/add-device.html)
- [Creating users](https://www.manageengine.com/network-monitoring/help/create-users.html)