Agent installation

    Last updated on:

    In this page

    Overview

    This page explains how the agent can be installed using the product console, GPOs, SCCM, Endpoint Central, or manually, depending on your deployment needs.

    Agent installation using the product console

    1. Log in to your account.
    2. Navigate to the Settings tab, and under Admin Settings, select Collectors/Agents.
      Agent installation
      Figure 1: Navigating to Collectors/ Agents
    3. Click + Install Agent and then the icon-add icon corresponding to Device(s).
    4. Select the devices on which you want to install the agent.
    5. Enter the Username and Password for the device(s).This account must have administrator privileges.
      Agent installation
      Figure 2: Entering username and password
    6. Click Verify Credential to validate the credentials entered.
    7. Alternatively, you can choose Use Default Credentials by selecting the checkbox next to it.
      NOTE If multiple devices are selected, ensure that the credentials are valid for all devices.
      Using default credentials
      Figure 3: Using default credentials

    Agent installation using GPOs

    Before installing the agent using Group Policy Objects (GPOs), place the following files in a network-shared folder on the server:

    • InstallLog360Agent.vbs (Path:<InstallationDirectory>\ManageEngine\Log360\tools\scripts)
    • Log360Agent.exe (download from the Manage Agents page).

    The installation process comprises the following steps:

    Creating a GPO

    1. Open Group Policy Management.
    2. In the left pane, right-click Group Policy Objects and select New.
      Creating a new group policy object
      Figure 4: Creating a new group policy object
    3. Enter a suitable name for the GPO and click OK.
      Creating a new group policy object
      Figure 5: Naming the GPO

    Configuring script settings

    1. Right-click the newly created GPO and select Edit.
      Editing GPO
      Figure 6: Editing GPO
    2. For Windows Server 2003, navigate to: Computer Configuration> Windows Settings> Scripts (Startup/Shutdown)> Startup.
    3. For Windows Server 2008 and later, navigate to: Computer Configuration> Policies> Windows Settings> Scripts (Startup/Shutdown)> Startup.
      Editing GPO
      Figure 7: Configuring script settings
    4. Right-click Startup, and in the dialog box that appears, click Add.
    5. In the Add Script dialog box, click Browse and select InstallLog360Agent.vbs from the shared location.
      Editing GPO
      Figure 8: Installing agent
    6. n the Script Parameters field, enter the following parameters:
      /INSTALLERPATH:"<share path of Log360Agent.exe">

      Example:

      .\InstallLog360Agent.vbs /INSTALLERPATH:"\\Agent-shared\Log360Agent\Log360Agent.exe"
    7. Click OK to return to the Startup Properties dialog box.
    8. Click Apply and then OK.

    Configuring Administrative Template Settings

    1. In the Group Policy Management Editor, navigate to Computer Configuration > Administrative Templates > System.
    2. Under System, select Scripts.
    3. In the right pane, double-click Run logon scripts synchronously and enable it.
    4. Click Apply and then OK.
      Enabling run logon scripts
      Figure 9: Enabling run logon scripts
    5. Similarly, enable Maximum wait time for Group Policy scripts.
    6. In the left pane, navigate to System and select Logon.
    7. Double-click Always wait for the network at startup and logon and enable it.
    8. Click Apply and then OK.
      Configuring logon setting
      Figure 10: Configuring logon setting
    9. In the left pane, navigate to System and select Group Policy.
    10. Double-click Group Policy slow link detection and enable it.
    11. Click Apply and then OK.
      Configuring group policy settings
      Figure 11: Configuring group policy settings

    Applying the GPO

    NOTE To install the agent on multiple computers simultaneously, create an AD group and add all the required computers to that group. Then, apply the GPO to the group.
    1. In Group Policy Management Editor, right-click the GPO and select Properties.
    2. Navigate to the Security tab and unselect the Apply Group Policy permissions for Authenticated Users.
    3. Click Add, then in the dialog box, select Object Types.
      • To apply the GPO to computers directly, ensure Computers is selected.
      • To apply it to a group, ensure Groups is selected.
      • Click OK to save and apply the changes.
      Selecting object types
      Figure 12: Selecting object types
    4. Enter the name of the desired computer(s) or group(s), then click Check Names.
    5. Select the correct object(s) and click OK to return to the properties dialog box.
      Selecting object types
      Figure 13: Selecting object types
    6. In the Security tab, assign the following permissions to the selected computer(s) or group(s):
      • Read: Allow
      • Apply Group Policy: Allow
        Selecting object types
        Figure 14: Configuring permissions
      • Click Apply, then OK.
      • In the Group Policy Management Console, right-click the Domain and select Link an Existing GPO.
        Selecting object types
        Figure 15: Linking an existing GPO
      • Choose the GPO you created, then click OK.
        Selecting object types
        Figure 16: Selecting GPO
      • Restart the computers to apply the GPO settings and wait for the reset password / unlock account link to appear on the Windows logon screen.
        • NOTE: After installation, disable or delete the GPO to prevent the script from running at every startup.

    Using Microsoft System Center Configuration Manager (SCCM) or similar deployment tools

    1. Place the appropriate installer file in a network-shared folder:
      • Windows: Log360Agent.exe
      • Linux: EventLogAgent_<Arch>.bin
    2. On the target devices, run the following command to install the agent:
      • For Windows:
        "Log360Agent.exe" SILENT_INSTALL /hide_progress /hide_splash
      • For Linux:
        ./EventLogAgent_64.bin > ./ELAAgent_InstallationLog.log 2>&1

    Agent installation via Endpoint Central

    Follow these steps to install the agent using Endpoint Central:

    1. Create an EXE package
    2. Deploy the package

    Create an EXE package

    NOTE EXE (Executable Installer) is a vital file format in the Windows environment, primarily used for software installation and management.
    • Log in to the Endpoint Central console as an administrator.
    • Navigate to the Software Deployment tab, select Packages, and click Add Package.
    • From the Add Package dropdown, select Windows.
      Selecting object types
      Figure 17: Adding a package
    • Fill out the package details:
      • Package Name: Enter a name, for example, Log360 Agent.
      • Package Type: Select EXE / APPX / MSIEXEC / MSU.
      • License Type: Select Commercial from the drop-down.
      • Locate Installable: To install Log360Agent.exe, choose the Local Computer option to upload the file directly or opt for the Shared Folder option and ensure the Log360Agent.exe file is placed in the shared location.
      NOTE The product console includes .exe files for Windows and .bin files for Linux systems.
      Configuring package details
      Figure 18: Configuring package details
    • Update and enter the following text in the Installation Command with Switches/Arguments field.
      Log360Agent.exe SILENT_INSTALL /hide_progress /hide_splash
    • Click Add Package to save the changes.

    Deploy the package

    After creating the EXE package, follow these steps to install the agent using Software Deployment:

    • Navigate to the Software Deployment tab, select Deployment, and click Install/Uninstall Software.
      Installing the agent
      Figure 19: Installing the agent
    • Provide a name for the installation, for example, Install Log360 Agent, and add an optional description if needed.
    • Select Install as the Operation Type, and from the Package Name dropdown, choose the package created earlier.
    • Configure the required options under Deployment Settings:
      • Configure additional install/uninstall options if needed.
      • Specify when the deployment should occur.
    • Under Define Target, select the computers or domains where the package should be deployed.
      NOTE If needed, configure Retry options in Execution Settings to handle installation failures.
    • Click Deploy to initiate the installation.
      Initiating the installation
      Figure 20: Initiating the installation
    • Track the deployment progress and status under Deployment > View Configurations.

    Manual installation

    You can also install the agent manually by downloading it from the console and running the installer on the required devices.

    For Windows devices

    1. Log in to your account and go to the Settings tab.
    2. Under Admin Settings, select Collectors/Agents.
    3. Click Install Agent in the top-right corner.
      Initiating the installation
      Figure 21: Installing agent
    4. In the installation window, select Install Manually to download the agent package.
      Initiating the installation
      Figure 22: Installing manually
    5. Run the downloaded installer on the target device.
      Initiating the installation
      Figure 23: Downloading the installer

    Read also

    This document explained when and how to install the Log360 agent using different deployment methods. To learn how to manage agents, refer to the following document: