Linux

Installation

The user saymon is automatically created in the system during agent installation. The agent works on behalf of this user.

If there is already such a user in the system, then the agent will work on his behalf.

Installation on a host without Internet access

  1. Download agent sh-installer for Linux 64 bit or Linux 32 bit.

  2. Move it to the user’s home directory on the host.

  3. Make the script executable:

    64 Bit
    sudo chmod +x saymon-agent-rl-linux-x64-jre-installer.sh
    32 Bit
    sudo chmod +x saymon-agent-rl-linux-i586-jre-installer.sh

  4. Execute the script:

    64 Bit
    sudo ./saymon-agent-rl-linux-x64-jre-installer.sh
    32 Bit
    sudo ./saymon-agent-rl-linux-i586-jre-installer.sh

  5. Follow further instructions in the terminal.

Installation on a host with Internet access

  1. Execute the following command:

    64 Bit
    curl https://saymon.info/downloads/saymon-agent-rl-linux-x64-jre-installer.sh -o saymon-agent-instal.sh ; chmod +x saymon-agent-instal.sh ; sudo ./saymon-agent-instal.sh
    32 Bit
    curl https://saymon.info/downloads/saymon-agent-rl-linux-i586-jre-installer.sh -o saymon-agent-instal.sh ; chmod +x saymon-agent-instal.sh ; sudo ./saymon-agent-instal.sh

  2. Follow further instructions in the terminal.

Installation location

By default, the agent is installed in the following directory: /opt/saymon-agent.

Agent registration

  1. Go to the conf folder of the agent installation directory and open the agent.properties file (agent configuration file).

  2. For the server.host parameter, specify the IP address of the SAYMON server to which the agent should connect. Close the file, saving the changes.

  3. Restart the agent service.

    sudo service saymon-agent restart

Once the agent is registered on the server, a new object of the Saymon Agent class is created. The ID of the created object (agentId) is passed to the agent. A registration.json file (/opt/saymon-agent/storage) containing this identifier is created on the host with the agent.

To repeat the procedure for obtaining agentId (for example, if you need to connect the agent to another server), delete registration.json and restart the agent service.

Agent configuration

To change settings you need to edit agent configuration file /opt/saymon-agent/conf/agent.properties.

Log files

By default, agent log files are saved to the /var/log/saymon directory.

If necessary, you can enable centralized agent logging with SYSLOG in the file /opt/saymon-agent/conf/logback-upstart.xml.

Agent service administration

You can get the status, start, restart and stop the agent service using the following commands:

sudo service saymon-agent status
sudo service saymon-agent start
sudo service saymon-agent restart
sudo service saymon-agent stop

Supported Linux versions

The agent works with the following versions of Linux OS:

  • Ubuntu Linux

  • Red Hat Enterprise Linux

  • CentOS Linux

  • Debian 8 "Jessie" (for Raspberry Pi users)