extern/LinuxRMM-Script
1
0
Fork 0
mirror of https://github.com/netvolt/LinuxRMM-Script.git synced 2025-08-08 01:14:33 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source 
Fix typos and some formulations.
This commit is contained in:
enzo-g
2024-04-12 23:40:30 +09:00
committed by GitHub
parent 62b3dd71d6
commit 6a561c6cf6
1 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@ -1,41 +1,41 @@
# rmmagent-script
Script for one-line installing and update of tacticalRMM agent
Script for one-line installation and updating of the tacticalRMM agent
> Now x64, x86, arm64 and armv6 scripts are available but only x64 and i386 tested on Debian 11 and Debian 10 on baremetal, VM (Proxmox) and VPS(OVH)
> Scripts are now available for x64, x86, arm64, and armv6. However, only x64 and i386 have been tested on Debian 11 and Debian 10 on bare metal, VMs (Proxmox), and VPS (OVH).
> Tested on raspberry 2B+ with armv7l (chose armv6 on install)
Script for other platform will be available futher as I adapt script on other platform.
Feel free to adapt script and submit me !
Scripts for other platforms will be available later as I adapt the script to other platforms.
Feel free to adapt the script and submit changes to me!
# Usage
Download the script that match your configuration
### Tips
Download script with this url: `https://raw.githubusercontent.com/netvolt/LinuxRMM-Script/main/rmmagent-linux.sh`
For Ubuntu systems try: 'wget https://raw.githubusercontent.com/netvolt/LinuxRMM-Script/main/rmmagent-linux.sh'
Make executable after downloading: 'sudo chmod +x rmmagent-linux.sh'
Make executable after downloading with: '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:
Ubuntu uses the Wayland display manager instead of the regular X11 server. This causes MeshCentral to show a blank screen, preventing login, viewing, or controlling the client.
Using the command lines below should solve the problem:
```
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. <
> If you encounter a 'file not found' error, you are likely using Ubuntu 19 or earlier. 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:
To install the agent, launch the script with this argument:
```bash
./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:
The arguments are:
2. System type
@ -54,12 +54,12 @@ The argument are:
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.
Can be viewed by hovering over 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.
Can be viewed by hovering over the name of the site in the dashboard.
7. Auth Key
@ -77,14 +77,14 @@ The argument are:
## Update
Simply launch the script that match your system with *update* as argument.
Simply launch the script with *update* as argument.
```bash
./rmmagent-linux.sh update
```
## Uninstall
To uninstall agent launch the script with this arguement:
To uninstall the agent, launch the script with this argument:
```bash
./rmmagent-linux.sh uninstall 'Mesh FQDN' 'Mesh ID'
@ -101,7 +101,7 @@ The argument are:
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.
You are looking for a 64-character long value consisting of a random mix of letter cases, numbers, and special characters.
### Example
```bash
@ -109,5 +109,5 @@ The argument are:
```
### WARNING
- You should **only** attempt this if the agent removal feaure on TacticalRMM is not working.
- You should **only** attempt this if the agent removal feature 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.