Installing a Linux Agent

Warning

For the agent to work properly, disable SELLinux before installation.

  1. In the Staffcop control panel, go to Computers → Download agent and select the necessary Linux version. The control panel automatically adds your server IP to the script nameю

  2. On the target Linux computer, download the script:

wget http://10.10.0.1/agent-install-[10.10.0.1].sh

where 10.10.0.1 will be replaced with your server IP in the downloaded script.

  1. Start the installation script:

sudo bash /path/to/agent-install-[10.10.0.1].sh 10.10.0.1

Replace /path/to/agent-install-[10.10.0.1].sh with the full path to the downloaded script. The IP address (e.g., 10.10.0.1) should be replaced with your Staffcop server’s actual IP.

Note

By default, the agent connects to the server over port 443. If you’ve configured a custom port, run the following command to install the agent:

sudo bash /path/to/agent-install-[10.10.0.1].sh 10.10.0.1 new_port

where new_port is your port number.

After installing the agent, restart the computer.

Configuring a Backup Server

Starting from version 0.8.0-master, agents can use an additional server as a backup if the main server becomes unavailable.

To set up an additional server:

  1. Open the scela file:

    .. code::

    sudo nano /etc/scelarc

  2. Append the reserve server port and address after the server line:

server2 = 192.168.0.3
port2 = 4334

If a port is not set, port 443 will be used by default.

Updating a Linux Agent

Starting from version 0.7.46, Linux agents support remote updates via server command.

To update the agent:

  1. Go to Control panel → Computers.

  2. Select an agent.

  3. In the Run action menu, select Upgrade agents to actual version.

The agent will automatically update to the version hosted on the server.

Deleting a Linux Agent

You can remove the Linux agent:

  • from the agent computer, using utility software:

    sudo /usr/share/staff/agent uninstall

  • from the agent computer, using the installation script:

    sudo bash agent-install.sh uninstall

  • from the server, using the Staffcop web interface: Control panel → Computers.