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.
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 for the AppLogs agent mentioned in the section "Steps to validate checksum for Linux servers" of this document.
  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.