How to manually install the AppLogs agent

How to manually install the AppLogs agent

The AppLogs agent automatically discovers and uploads your server and application logs to Site24x7. Site24x7's AppLogs agent comes installed with the  Site24x7 Full-Stack agent, you can also manually install or reinstall the AppLogs agent by following the instructions below:

Windows

  1. If the AppLogs agent is already installed, then stop the Site24x7 Applog Agent service as an administrator. To do this, navigate to Start > Settings > Control Panel > Administrative Tools > Services. 
    1. Alternatively, open Run (Windows + R), type services.msc and press Enter. If you haven't installed the AppLogs agent, then you can directly go to step 3.
  2. Delete the Applogbin folder, if it exists. The folder will be located at:
    64 bit: C:\Program Files (x86)\Site24x7\WinAgent\monitoring\bin\Applogbin
    32 bit: C:\Program Files\Site24x7\WinAgent\monitoring\bin\Applogbin
    In addition to the bin folder, delete the applog configuration folder located at:
    64 bit: C:\Program Files (x86)\Site24x7\WinAgent\monitoring\conf\applog
    32 bit: C:\Program Files\Site24x7\WinAgent\monitoring\conf\applog
  3. Download the zip file (64 bit | 32 bit).
  4. Verify the checksum for the AppLogs agent mentioned in the section "Steps to validate checksum for Windows servers" of this document.
  5. After the successful checksum validation, extract the zip file downloaded in Step 3 into the path below:
    For 64 bit: C:\Program Files (x86)\Site24x7\WinAgent\monitoring\
    For 32 bit: C:\Program Files\Site24x7\WinAgent\monitoring\
  6. Check if the Site24x7 Applog Agent service is present. If not, open Command Prompt as an administrator and execute the following command:
    sc create "Site24x7 Applog Agent" binPath= "C:\Program Files (x86)\Site24x7\WinAgent\monitoring\bin\Applogbin\Site24x7ApplogAgent.exe"
  7. Start the Site24x7 Applog Agent service.

    8. Linux

    1. If you have already installed the applogs agent and want to re-install, follow the steps below:
      1. Execute the below command to identify the PID of the AppLogs agent process. If it's not running, proceed to step 1c.
        ps aux | grep -i Site24x7Applog
      2. Replace the <process_id> and execute the command below to kill the AppLogs agent.
        kill -9 <process_id>
      3. Delete the existing applogs agent folder by executing command below:
        rm -r /opt/site24x7/monagent/lib/applog
    2. Download the relevant AppLogs agent zip file (64 bit | 32 bit | Cross-Platform)
    3. Verify the checksum of the downloaded AppLogs agent by following the steps outlined in the "Steps to validate checksum for Linux servers" section.
    4. After the successful checksum validation, extract the zip file mentioned in step 5 into /opt/site24x7/monagent/
    5. Restart the Full-Stack agent by executing the command:
      /opt/site24x7/monagent/bin/monagent restart silent
    NotesIf the Full-Stack agent is installed as non-root, use the respective install directory in the commands and folder path.

    Steps to validate checksum for Windows servers

    1. Open Command Prompt from your Windows machine.
    2. Execute the following command:
      For 32-bit: certutil -hashfile applog_windows32.zip   SHA256
      For 64-bit: certutil -hashfile applog_windows64.zip   SHA256
    3. 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 servers

  1. Open the Terminal from your Linux machine.
  2. Execute the following command:
    For 32-bit: sha256sum applog_linux32.zip
    For 64-bit: sha256sum applog_linux64.zip
    For Cross-Platform: sha256sum applog_source_agent.zip
  3. Download the checksum file based on your architecture (64-bit | 32-bit | Cross-Platform).
Verify if the value returned in the Terminal window and the value in the downloaded checksum file is the same.
NotesIf the checksum values differ, do not unzip or open the file, and contact support@site24x7.com.



    • Related Articles

    • APM Insight .NET agent bulk installation using ManageEngine Endpoint Central

      You can install the APM Insight .NET agent on multiple machines at once by following the steps given below: Download the APM Insight .NET agent from the Site24x7 account. Log in to the ManageEngine Endpoint Central portal and click the Software ...

    • How to set the PHP path during agent installation?

      This is only applicable to the agent versions 4.2 and above. For Linux Step 1: Download the installation script. wget -O InstallAgentPHP.sh https://staticdownloads.site24x7.com/apminsight/agents/AgentPHP/linux/InstallAgentPHP.sh Step 2: Set your PHP ...

    • Error 2503 during Windows server monitoring agent installation

      Issue Facing the error 2503 during the installation of the Windows server monitoring agent. Cause During installation, the installer package files have to be written to the "C:\Windows\Temp" folder. When Windows is unable to write these files to this ...

    • How do I disable the AppLogs agent (process/service)?

      When you disable the AppLogs agent, log collection on that server will stop and the AppLogs Agent service/process will not run in your server. To disable the AppLogs agent: Navigate to the Server tab. Click on the server monitor in which the agent ...

    • Prerequisites for Python agent installation

      For a smooth Python agent installation, ensure that you've fulfilled the following prerequisites: The environment should support Python version 3.7 or above. The application should be built on any of the supported frameworks. The application user ...