# Installing OpManager agent in your devices

OpManager's [agent-based monitoring](https://www.manageengine.com/network-monitoring/help/agent-monitoring.html?utm_agent-installation) feature allows you to deploy an agent on your end-device. The agent comprehensively collects the data from your end-device and sends it to OpManager for further inspection and analysis. Furthermore, even if the connection between OpManager and the end-device is lost, the agent stores the data locally and then sends it to OpManager the moment the connection is reestablished.

You can install the OpManager agent in your network devices in 3 different ways. Before proceeding with the installation, ensure that all [prerequisites for agent installation](https://www.manageengine.com/network-monitoring/help/agent-monitoring.html#prerequisites?utm_agent-installation) are met. Once the agent is successfully installed, the devices are automatically discovered, and monitoring will begin immediately.

1. [Installation for Windows](#windows)
   - [From OpManager's web console](#web_console)
   - [Manual installation](#manual_inst)
   - [Using Active Directory (bulk installation)](#ad_gpo)
   - [Using SCCM](https://www.manageengine.com/network-monitoring/help/agent-installation-sccm.html?utm_agent-installation)
   - [Using ManageEngine Endpoint Central](https://www.manageengine.com/network-monitoring/help/agent-deployment-endpoint-central.html?utm_agent-installation)
2. [Installation for Unix](#unix)
   - [Manual Installation](#manual)
   - [As a Non-Root User](#non_root)
   - [Using Organizational Proxy](#proxy)

## Installation for Windows

### 1. From OpManager's web console:

To remotely install the agent in your device from OpManager's web console:

1. Go to **Settings → Discovery → Deploy Agent.**
2. Enable the **"Push Remotely"** option to initiate the installation process.
3. Provide the name/IP address of the device where you want to install the agent.
4. Provide the credentials for the device. You can choose from existing credential profiles or manually enter the credentials.

![Agent deployment page in OpManager: Add credentials page](https://www.manageengine.com/network-monitoring/help/images/agent-deploy-page.png)

5. Click **"Deploy"** to initiate the installation process. Once completed, a success message will be displayed and the device will be available under the Inventory.
6. You can also view all devices where agents have been installed from **Settings → ITOM Agents → Monitoring Agents**.

In case there are any errors displayed during the installation, [visit this page](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html?utm_agent-installation) to learn about possible error messages during agent deployment and how to resolve them.

**Note:** It is mandatory to download a fresh copy of the OpManagerAgent.zip file and use the files within it for the installation process.

### 2. Manual installation:

You can manually download the Agent installation file from **Settings → Discovery → Deploy Agent**, and click the **"Download"** button at the top of the page. The OpManager Agent zip file will then be downloaded. Extract the zip file and place the extracted `OpManagerAgent.msi` and `OPMServerInfo.json` files in the same local directory. Use these files to manually install the OpManager agent on any Windows device.

Once installed, the agent automatically syncs the device details to OpManager, and the device is listed under the Inventory page.

**Note:** Place the extracted `OpManagerAgent.msi` and `OPMServerInfo.json` files in the same directory before initiating the installation of the agent.

### 3. Using Active Directory (bulk installation):

You can push the agent to multiple devices in your network by using Windows GPO in your Active Directory server.

Installation using GPO can be done in two methods:

- [Using GPO scheduler:](https://www.manageengine.com/network-monitoring/help/agent-installation-gpo-scheduler.html?utm_agent-installation) Agent can be instantly pushed to devices in the domain. Fastest method of installation.
- [Using GPO startup script:](https://www.manageengine.com/network-monitoring/help/agent-installation-gpo-startup.html?utm_agent-installation) Agent will be installed during the next refresh cycle.

**Note:** To switch from agentless monitoring to agent-based mode for an existing device, deploy the agent using any of the methods mentioned above and then follow the steps mentioned [here](https://www.manageengine.com/network-monitoring/how-to/converting-to-agent-based-monitoring.html?utm_agent-installation).

## Installation for Unix

### 1. Manual Installation

To manually install the Unix agent for your network, follow these steps:

1. Go to **Settings → Discovery → Deploy Agent.** Select the appropriate Unix system section.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-1.png)

2. To download the **Unix Monitoring Agent archive file**, click the **Download** button or access the appropriate version from the [download page](https://www.manageengine.com/network-monitoring/unix-agent-download.html?utm_agent-installation).
3. Follow the steps provided in the [file integrity page](https://www.manageengine.com/network-monitoring/help/file-integrity-verification.html?utm_agent-installation) to verify the integrity of the downloaded file.
4. After successfully verifying the integrity, copy the downloaded Agent archive file to the OpManager Application Installer Server and extract it to the **OpManager Home\agent\resources\unix directory**.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-2.png)

5. After extracting the archive file, verify that the listed folders and files are present and properly extracted.

   - **Folders**
     - `\agent\resources\unix\installer\arm`

   - **Files**
     - Under `unix` folder:
       1. `version.properties`
     - Under `unix\installer` folder:
       1. `OpManagerFullStackAgent_x86Linux.install`
       2. `OpManagerFullStackAgent_x64Linux.install`
       3. `OpManagerFullStackAgent_CrossPlatform.install`
       4. `OpManagerFullStackAgent_LinuxIns.sh`
     - Under `unix\installer\arm` folder:
       1. `OpManagerFullStackAgent_x64Linux.install`

6. Reload the OpManager web client once to cross-verify that all files and their integrity are in the proper state.
7. If everything is in the proper state, you will see only two steps listed under the appropriate Unix flavor section.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-3.png)

8. If the file is in an improper state, an error message such as "file not found" or "file integrity failed" will appear. Resolve the issue using the provided details, then reload the OpManager web client to confirm that no error messages are shown under **Deploy Agent → Appropriate Unix Flavor**.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-5.png)

**Note:** You don’t need to download the files every time you visit the **Deploy Agent** section—this is a one-time setup. Once the required files are properly placed, you’re all set to start using the Unix Server Monitoring Agent.

9. Connect to the target monitoring server through the terminal for agent installation.
10. Copy and run the download command in the terminal to transfer the agent installer script file `OpManagerFullStackAgent_LinuxIns.sh` to the target end server.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-6.png)

**Note:** In the above command, ensure that the OpManager server's host details are reachable from the target server. If not, modify the command with the correct and reachable host information.

11. Ensure that the installer script file `OpManagerFullStackAgent_LinuxIns.sh` has been fully downloaded without any interruptions.
12. Copy and run the install command to begin agent installation.

![agent installation-OpManager](https://www.manageengine.com/network-monitoring/help/images/agent-installation-unix-7.png)

**Note:** In the above install command, verify that the OpManager server's host details—such as Hostname, IP Address, or NAT Server details—are correct and reachable. If not, update them accordingly and run the modified command in the terminal.

13. After successful installation, you will find the agent listed under **Settings → ITOM Agents → Monitoring Agents**.
14. If the respective device is already being monitored using credentials in OpManager, associate the agent with that device by clicking the **Associate** option.
15. If the device is not previously monitored and is being added for the first time, it will be auto-added and monitoring will begin automatically.

### 2. As a Non-Root User

Append `-nr` or `-nr=<Custom Installation Path where to install>` argument to the install command while performing the installation.

**Example install command:**

```bash
OpManagerFullStackAgent_Linux.sh -i -nr=/home/test/ManageEngine/OpManager-agent_type=server .....
```

OR

```bash
OpManagerFullStackAgent_Linux.sh -i -nr -agent_type=server .....
```

### 3. Using Organizational Proxy

Add the proxy argument to the install command as shown below:

```bash
OpManagerFullStackAgent_LinuxIns.sh .......... proxy=user:password@proxyhost:proxyport
```

OR

```bash
OpManagerFullStackAgent_LinuxIns.sh .......... proxy=host:port
```