Agent Administration

In EventLog Analyzer, an agent might be required in one of the following two scenarios:

• If you want to monitor the files in Windows file servers.
• If there are any RPC connectivity issues between the log source and the EventLog Analyzer server.

Installing the EventLog Analyzer agent

The following are the different ways in which you can deploy the EventLog Analyzer agent in devices:

• Using the EventLog Analyzer console
• Using GPOs
• Using Microsoft System Center Configuration Manager (SCCM) or some similar software deployment tool
• Manual installation

Using EventLog Analyzer console:

To install the EventLog Analyzer agent using the product console,

• In the Settings tab, navigate to Admin Settings → Manage Agents.
• Click + Install Agent and then the + icon corresponding to Device(s). 

• Select the devices on which you want to install the agent.
• Enter the login name and password to access the device(s). This account should have admin privileges to install the agent successfully. Or you can also choose the Use Default Credentials option.

• Use the Verify Credential link to validate the credentials entered.
• Finally, click Install Agent to initiate agent installation.

Using GPOs:

Before beginning to install the EventLog Analyzer agent using GPOs, place the following files in a network-shared folder of the server:

• InstallEventLogAgent.vbs (Path: <Installation Directory>\ManageEngine\EventLog Analyzer\tools\scripts)
• EventLogAgent.msi (Path: <Installation Directory>\ManageEngine\EventLog Analyzer\tools\scripts)

To install the agent via GPOs:

Step 1: Creating a GPO

Create a new GPO as follows (based on the Windows Server version):

1. Open Group Policy Management.
2. In the left pane, right-click the Group Policy Objects container and select New.

1. Give the GPO a suitable name and click OK.

Step 2: Configuring script settings

1. Right-click the newly created GPO and click Edit.

1. For Windows Server 2003, in the right pane of the GPO editor, double click Computer Configuration and navigate to Windows Settings → Scripts (Startup/Shutdown) → Startup.
2. For Windows Server 2008 and later, navigate to Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown) → Startup.

1. Right-click Startup and in the dialog box that appears, click Add.
2. In the Add Script dialog box, click Browse and select InstallEventLogAgent.vbs from the shared location.

1. In the Script Parameters field, enter the following parameters:
   /MSIPATH:"< share path of msi file>" /SERVERNAME:" <ELA server name>" /SERVERDBTYPE:"< database of server>"
   /SERVERIPADDRESS:" <IP address of server>" /SERVERPORT: "<port occupied by server>"
   /SERVERPROTOCOL:" <protocol (http/https)>" /SERVERVERSION:"<ELA version>"
   /SERVERINSTDIR:"<ELA installed directory>"
2. Click OK to return to the Startup Properties dialog box.
3. Click Apply and then OK.

Step 3: Configuring Administrative Template Settings

1. In the left pane of the Group Policy Management Editor, navigate to Computer Configuration → Administrator Templates → System.
2. Under System, select Scripts.
3. In the right pane of the GPO Editor, double-click Run logon scripts synchronously and enable it.
4. Click Apply and then OK.

1. Similarly, enable Maximum wait time for Group Policy scripts.
2. Then, navigate to Logon under System. 
3. In the right pane, double-click Always wait for the network at startup and logon and enable it.
4. Click Apply and then OK.

1. Then, navigate to Group Policy under System.
2. In the right pane, double-click Group Policy slow link detection and enable it.
3. Click Apply and then OK.

Step 4: Applying the GPO

1. On the left pane of the Group Policy Management Editor, right-click the GPO you are working on and select Properties.
2. Navigate to the Security tab and unselect the Apply Group Policy permissions for Authenticated Users. 
3. Click Add and in the dialog box that appears, click Object Types. 

1. If you want to apply the GPO to computers directly, ensure Computers is selected and then click OK. For applying it to a group, ensure Groups is selected and then click OK.
2. Enter the name of the desired computer(s) and/or group(s) and click Check Names.
3. Select the desired computer(s) and/or group(s) and click OK to return to the properties dialog box.
4. In the Security tab, apply the following permissions to the selected group(s) and/or computer(s): 
1. (i) Read > Allow
2. (ii) Apply Group Policy > Allow

1. Click Apply and then OK.
2. Restart the computers to complete applying the GPO and wait for the reset password / unlock account link to appear on the Windows logon screen.

Using Microsoft System Center Configuration Manager (SCCM) or some similar software deployment tool:

• Place Eventlogagent.msi in a network-shared folder. 
• In the device(s) on which the agent needs to be installed, execute the following command:
  Copy to Clipboard

  msiexec.exe /i "EventLogAgent.msi" /qn /norestart /L*v "Agent_Install.log" SERVERNAME=<eventlog_server_name> SERVERDBTYPE=<postgres|mssql|mysql> SERVERIPADDRESS=<eventlog_server_ip> SERVERPORT=<eventlog_server_port> SERVERPROTOCOL=<eventlog_server_protocol> SERVERVERSION=<eventlog_server_version> AGENTVERSION=<eventlog_agent_version> ENABLESILENT=yes ALLUSERS=1

  Note: Values assigned to SERVERNAME, SERVERDBTYPE, SERVERIPADDRESS, SERVERPORT, SERVERPROTOCOL, SERVERVERSION, and AGENTVERSION should be in double quotes.

Manual installation:

For Windows devices:

• In the agent machine, open any browser and execute the following command.

Copy to Clipboard

<everlog_server>:<eventlog_server_port>/event/downloadMsi.nms?platform=windows

• EventLogAgent.msi will be downloaded automatically. Double-click EventLogAgent.msi to start installation.
• After clicking Next in the welcome screen and the Confirm Installation dialog box, the following dialog box will be displayed. Enter the details and click OK.

• Installation will be completed.

For Linux devices,

The agent has to be configured in Manage File Integrity Monitoring page of EventLog Analyzer. Refer Configuring File Integrity Monitoring to configure the agent in Linux devices. If installation fails due to permission denial, you can manually install it by executing the following command.

Copy to Clipboard

eval "wget <eventlog_server_protocol>://<eventlog_server>:<eventlog_server_port>/downloadMsi.nms?platform=agentInstaller -O AgentInstaller && sh AgentInstaller <eventlog_server_protocol>://<eventlog_server>:<eventlog_server_port> lesssecure"

Managing EventLog Analyzer agents

Using EventLog Analyzer's console, you can uninstall, upgrade, and force the agent to restart.

Uninstalling the EventLog Analyzer agent

To uninstall the EventLog Analyzer from device(s),

• In the Settings tab, navigate to Admin Settings > Manage Agents.
• Select the device(s) from which you want to remove the agent.
• Click Uninstall and select Yes in the pop-up box that appears.

Another method to uninstall the EventLog Analyzer from device(s) is by using add or remove programs,

• Navigate to Windows start menu > Add or remove programs in your desktop.
• Select the "ManageEngine EventLog Analyzer Agent".
• Click Uninstall.

Forcing restart of the EventLog Analyzer agent

To force the EventLog Analyzer to restart,

• In the Settings tab, navigate to Admin Settings > Manage Agents.
• Select the device(s) on which you want to restart the agent.
• Select More Actions and click Force restart in the drop-down box that appears.
• In the pop-up box that appears, select Yes.

Forcing upgrade of the EventLog Analyzer agent

Upgrading the EventLog Analyzer agent through Force Upgrade,

• In the Settings tab, navigate to Admin Settings > Manage Agents.
• Select the device(s) on which you want to restart the agent.
• Select More Actions and click Force upgrade in the drop-down box that appears.
• In the pop-up box that appears, select Yes.