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
    32 Bit
    $ sudo chmod +x
  4. Execute the script:

    64 Bit
    $ sudo ./
    32 Bit
    $ sudo ./
  5. Follow further instructions in the terminal.

Installation on a host with Internet access

  1. Execute the following command:

    64 Bit
    $ curl -o ; chmod +x ; sudo ./
    32 Bit
    $ curl -o ; chmod +x ; sudo ./
  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 file (agent configuration file).

  2. For the 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/

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)