How to manually install the AppLogs agent

How to manually install or reinstall the AppLogs agent

The AppLogs agent is used to automatically discover and upload your server and application logs to Applications Manager. Applications Manager's AppLogs agent works with the existing Applications Manager FSO agent and comes with AppLogs installed. You can also manually install or reinstall (in case of issues) the AppLogs agent by following the steps below:

Windows

If you have already installed the AppLogs agent, stop the ManageEngine Applications Manager Applog Agent service as an administrator. To accomplish this, navigate to Start → Settings → Control Panel. Under Administrative Tools, click Services. You can also navigate to services.msc from Run.
If you haven't installed the AppLogs agent, then you can directly go to step 3.
Delete the Applogbin folder, if it exists. The path is:
- C:\Program Files (x86)\ManageEngine\AppManagerWinAgent\monitoring\bin\Applogbin
Download the provided zip file.
Verify the checksum for the AppLogs agent mentioned in the section "Steps to validate checksum for Windows systems" of this document.
After the successful checksum validation, extract the zip file mentioned in step 4 into the path below:
- C:\Program Files (x86)\ManageEngine\AppManagerWinAgent\monitoring\bin

Check if the Applications Manager Applog Agent service is present. If not, open Command Prompt as an administrator and execute the following command:


sc create "Applications Manager Applog Agent" binPath= "C:\Program Files (x86)\ManageEngine\AppManagerWinAgent\monitoring\bin\Applogbin\MEApplicationsManagerApplogAgent.exe"

Start the ManageEngine Applications Manager Applog Agent service.

Linux

If you have already installed the AppLogs agent, open a Terminal and stop the AppLogs agent by executing the command:
```
sudo /opt/ManageEngine/AppManager/FSO-Agent/bin/applogs.sh stop
```
If not, go to step 5.
Execute the following command to check if the Applications Manager AppLogs process has been stopped properly:
```
ps aux | grep -i applogs
```
If the AppLogs agent still runs, kill the process using the command:
```
sudo kill -9 <process_id>
```
Delete the /opt/ManageEngine/AppManager/FSO-Agent/lib/applog folder, if it exists.
Download the provided zip file.
Verify the checksum for the AppLogs agent mentioned in the section "Steps to validate checksum for Linux systems" of this document.
After the successful checksum validation, extract the zip file mentioned in step 5 into /opt/ManageEngine/AppManager/FSO-Agent/

Start the agent by executing the command:

sudo /opt/ManageEngine/AppManager/FSO-Agent/bin/applogs.sh start

Steps to validate checksum for Windows systems

Open Command Prompt from your Windows machine.

Execute the following command:

For 32-bit:

certutil -hashfile applog_windows32.zip SHA256

For 64-bit:

certutil -hashfile applog_windows64.zip SHA256

Download the checksum file based on your architecture (64-bit | 32-bit).
Verify if the value returned in the Command Prompt and the value in the downloaded checksum file are the same.

Steps to validate the checksum for Linux systems

Open the Terminal from your Linux machine.

Execute the following command:

For 32-bit:
```
sha256sum applog_linux32.zip
```
For 64-bit:
```
sha256sum applog_linux64.zip
```

Download the checksum file based on your architecture (64-bit | 32-bit).
Verify if the value returned in the Terminal window and the value in the downloaded checksum file are the same.

Note: If the checksum values differ, do not unzip or open the file, and contact appmanager-support@manageengine.com.