Agilicus Connector – Seeed reComputer R1000
Seeed reComputer R1000 Background
The Seeed reComputer R1000 is an Industrial Edge IoT Gateway Powered by Raspberry Pi CM4.
The R1000 will run several operating systems (Ubuntu, Armbian, OpenWRT). In this document we discuss using it with the default as shipped by Seed (Debian 12.7).
Agilicus Connector Install
Using the Agilicus administrative portal, create a new connector. Use the ‘Linux’ instructions, copy.
Ssh into the R1000 (the default user is ‘recomputer’ and the default password is ‘12345678’). Become root:
sudo su -Paste the command from the ‘copy’ above.
recomputer@reComputer-R100x:~ $ sudo su -
root@reComputer-R100x:~# url=https://www.agilicus.com/www/releases/secure-agent/stable/install.sh; (which curl >/dev/null && curl -sSL $url || wget -O - $url) > /tmp/i.sh && sh /tmp/i.sh -c XXXXR8k9cuWNLjzVDc -s XXXnnw -S "aunXE7u1XarsnaQ3EV6GsA"
OS: <Linux>, Machine: <aarch64>, END: <le>
Fetching https://www.agilicus.com/www/releases/secure-agent/stable/agilicus-agent-arm64 into /tmp/agilicus-agent-arm64
-rwxr-xr-x 1 root root 10547904 Dec 17 01:01 /tmp/agilicus-agent-arm64
+ [ challenge = explicit ]
+ /tmp/agilicus-agent-arm64 client --install --challenge-id VKcsaMQ5R8k9cuWNLjzVDc --challenge-code f6wkcnnw --session aunXE7u1XarsnaQ3EV6GsA
INFO[2024-12-17T01:01:28Z] Starting connector - version v0.284.8
INFO[2024-12-17T01:01:32Z] Check if the agilicus connector is already running as a service. If so stop it
INFO[2024-12-17T01:01:32Z] Create file /usr/bin/agilicus-agent-wrapper.sh
INFO[2024-12-17T01:01:32Z] Create file /etc/systemd/system/agilicus-agent.service
INFO[2024-12-17T01:01:32Z] Will install to /agilicus-agent-wrapper.sh -> {/usr/bin/agilicus-agent-wrapper.sh -rwxr-xr-x <nil>}
INFO[2024-12-17T01:01:32Z] Will install to /agilicus-agent.service -> {/etc/systemd/system/agilicus-agent.service -r--r--r-- 0xfa96d0}
INFO[2024-12-17T01:01:32Z] Create a directory at /opt/agilicus/agent/tufmetadata/latest
INFO[2024-12-17T01:01:32Z] Create a directory at /opt/agilicus/agent/tufmetadata/stable
INFO[2024-12-17T01:01:35Z] Create a user and group named Agilicus to run the agilicus-agent service
INFO[2024-12-17T01:01:35Z] Copy executable to /opt/agilicus/agent
INFO[2024-12-17T01:01:35Z] Set permissions to Agilicus on /opt/agilicus/agent
INFO[2024-12-17T01:01:35Z] Create symlink from /usr/bin/agilicus-agent to /opt/agilicus/agent/agilicus-agent-arm64
INFO[2024-12-17T01:01:35Z] creating connector instance
INFO[2024-12-17T01:01:36Z] Join a connector cluster
INFO[2024-12-17T01:01:36Z] Start agilicus-agent service
INFO[2024-12-17T01:01:39Z]
INFO[2024-12-17T01:01:39Z] Installation Complete
INFO[2024-12-17T01:01:39Z]
+ rm -f /tmp/agilicus-agent-arm64
+ echo
+ echo Please check the online status in the web interface under Resources/Connectors/Overview
Please check the online status in the web interface under Resources/Connectors/Overview
+ echo If you have questions, or errors were shown above, please email support@agilicus.com.
If you have questions, or errors were shown above, please email support@agilicus.com.
+ echoSample Configuration: Connect to Local SSH
This walk through shows an example of how, once the connector is installed (as per above), configuration of an SSH interface to this local device. Once these are configured you could use the firewall to disable all external access. The high level steps are:
- Create Connector (Agilicus Admin)
- Install Connector (R1000 ssh command line)
- Create SSH Resource (Agilicus Admin)
- SSH to R1000 from Agilicus Profile (Agilicus Profile)
OK, let’s get started. This will take approximately 2 minutes. First, install the connector as per above.
Create a new SSH resource. Select the connector we created above.
Create a new SSH resource. Select the connector we created above.
Give the SSH resource a name. We will see this later in the Web Interface and from the command line. The name must be valid as a hostname (e.g. no spaces).
Assign permissions. For this sample, we are assigning permissions to a single user. More commonly one would create a group (e.g. SSH Admins) to simplify.
At this stage, we have finished the SSH setup. We can use it from the Agilicus Profile (web-based, any device), from the Start menu on a desktop operating system, or via the command-line on our desktop. It will work with Putty and OpenSSH.
At this stage we are done. We have:
- created and installed a connector on this Seeed reComputer R1000
- created an SSH service (to the R1000 itself)
We can now test our work. Open https://profile.YOURDOMAIN/
We can test the SSH access. From profile, select the resource we created earlier.
We will see a ‘login’ dialog appear, enter the username (root) and password to the R1000.
At this stage, we should see an SSH terminal.
From here, consider using the ‘Launcher’ install feature of profile, add the Browser Extension. You will now see an entry on your start menu for this SSH, opening the native client (e.g. if you have Putty or OpenSSH installed).