rmmagent-script

Originally Forked from https://github.com/netvolt/LinuxRMM-Script

If you don't mind running unsigned Linux agents, you can install them for Tactical RMM with this script.

Super Easy Way - If your already have TacticalRMM Agents Running

If you want to use TacticalRMM to use this script to deploy the new agents for you (using the older installed agent), upload the https://github.com/ZenDevMaster/LinuxRMM-Script/blob/main/tactical_rmm_update_linux_agents.sh file in this repository to Settings -> Script Manager in your TRMM console, and then instruct the system to run it on your Linux agents. Set a long timeout so the system will let it run for at least a few minutes.

Manual Usage

Download the script that matches your configuration

Tips

Download script with this url: https://raw.githubusercontent.com/ZenDevMaster/LinuxRMM-Script/main/rmmagent-linux.sh

For Ubuntu systems try: 'wget https://raw.githubusercontent.com/ZenDevMaster/LinuxRMM-Script/main/rmmagent-linux.sh' Make executable after downloading: 'sudo chmod +x rmmagent-linux.sh'

Fix Blank Screen for Ubuntu Workstations (Ubuntu 16+)

Ubuntu uses the wayland display manager instead of the regular x11 server. This causes MeshCentral to show a blank screen when trying to access the remote desktop feature. You can't login, view or control the client. There is a neat fix for this, so don't worry:

sudo sed -i '/WaylandEnable/s/^#//g' /etc/gdm3/custom.conf
sudo systemctl restart gdm

This will cause your screen to go blank for a second. You will be able to use remote desktop afterwards.

If you get an error like "file not found", you are probably still using Ubuntu 19 or below. On these machines, the config file will be located on /etc/gdm/custom.conf. Modify the command above accordingly. < Please note that remote desktop features are only installed when you used the workstation agent. You may need to reinstall your mesh agent.

Install

To install agent launch the script with this arguement:

./rmmagent-linux.sh install 'System type' 'Mesh agent' 'API URL' 'Client ID' 'Site ID' 'Auth Key' 'Agent Type'

The compiling can be quite long, don't panic and wait few minutes... USE THE 'SINGLE QUOTES' IN ALL FIELDS!

The argument are:

2. System type

System types can be 'amd64' 'x86' 'arm64' 'armv6'

3. Mesh agent

The url given by mesh for installing new agent. Go to mesh.fqdn.com > Add agent > Installation Executable Linux / BSD / macOS > Select the good system type Copy ONLY the URL with the quote. (note that mesh.fqdn.com is the mesh URL for your TacticalRMM server)

4. API URL

Your api URL for agent communication usually https://api.fqdn.com.

5. Client ID

The ID of the client in wich agent will be added. Can be view by hovering the name of the client in the dashboard.

6. Site ID

The ID of the site in wich agent will be added. Can be view by hovering the name of the site in the dashboard.

7. Auth Key

Authentification key given by dashboard by going to dashboard > Agents > Install agent (Windows) > Select manual and show Copy ONLY the key after --auth.

8. Agent Type

Can be server or workstation and define the type of agent.

Example

./rmmagent-linux.sh install 'amd64' 'https://mesh.fqdn.com/meshagents?id=XXXXX&installflags=X&meshinstall=X' 'https://api.fqdn.com' 3 1 'XXXXX' server

Update

Simply launch the script that match your system with update as argument and the system type.

./rmmagent-linux.sh update ('amd64' | 'x86' | 'arm64' | 'armv6')

Uninstall

To uninstall agent launch the script with this arguement:

./rmmagent-linux.sh uninstall 'Mesh FQDN' 'Mesh ID'

Note: Single quotes must be around the Mesh ID for it to uninstall the mesh agent properly

The argument are:

2. Mesh FQDN

Example of FQDN: mesh.fqdn.com

3. Mesh ID

The ID given by mesh for installing new agent. Go to mesh.fqdn.com > Add agent > Linux / BSD (Uninstall) > Copy ONLY the last value with the single quotes. You are looking for a 64 charaters long value of random letter case, numbers, and special characters.

Example

./rmmagent-linux.sh uninstall mesh.fqdn.com 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'

WARNING

• You should only attempt this if the agent removal feaure on TacticalRMM is not working.
• Running uninstall will not remove the connections from the TacticalRMM and MeshCentral Dashboard. You will need to manually remove them. It only forcefully removes the agents from your linux box.