Click here to expand

    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.

    Supported operating systems:

    EventLog Analyzer agent can be installed and run on the following operating systems

    Windows Client OS: Windows XP and Above

    Windows Server OS: Windows Server 2003 and Above

    Linux:

    • Linux RedHat RHEL
    • Linux SuSE
    • Linux Fedora
    • Linux CentOS
    • Linux Ubuntu
    • Linux Debian

    Installing the EventLog Analyzer agent

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

    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.

    Note: If multiple devices are selected, ensure that the credentials are valid for all the devices.

    • 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>:\EventLog Analyzer\lib\native)

    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

    Tip: For installing the agent on multiple computers at one go, create an AD group and add all the computers on which the agent needs to be installed to the group. Then, apply the GPO to that group.

    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.

    Agent installation via Desktop Central

    Create an MSI package:

    • MSI is an installer package file format used by Windows.
    • Log in to the Desktop Central console as an administrator.
    • Navigate to Software Deployment > Packages > Add Package and select Windows from the drop-down menu.

    Fill out the details in the fields available as follows:

    • Package Name: Choose a name, such as EventLog Analyzer Agent.
    • Package Type: Select MSI/MSP
    • License Type: Select Commercial from the drop-down menu.
    • Location installable: Choose Shared Folder.
      Note: EventLog Analyzer provides .msi files for Windows and .bin files for Linux systems.
    • Agent installation via Desktop Central
    • In the Installation tab, browse and select the desired MSI file for the MSI/MSP File Name field.
    • Update and enter the following text in the MSI/MSP Properties for Installation field.
      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> ENABLESILENT=yes ALLUSERS=1

      Example:

      msiexec.exe /i "EventLogAgent.msi" /qn /norestart /L*v "Agent_Install.log" SERVERNAME="kishore-13692" SERVERDBTYPE="postgres" SERVERIPADDRESS="10.51.241.163" SERVERPORT="8400" SERVERPROTOCOL="http" ENABLESILENT=yes ALLUSERS=1

    • Click on Add Package to save.

    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

    Note: To find agent version

    For Windows agent, open registry key in machine where agent is installed:

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ZOHO Corp\EventLogAnalyzer\LogAgent

    For Linux agent, in machine where agent is installed:

    /opt/ManageEngine/EventLogAnalyzer_Agent/conf/agentDetails

    Get download link