Note
You are viewing the legacy Cascade documentation, which only applies to some Rigado customers. To view the current Cascade documentation, click here.
4.1. Using SSH to Connect Directly to a Gateway¶
4.1.1. Prerequisites¶
- An Edge Direct account
- Access to the Edge Direct web-application (or the Rigado CLI tool)
- A Gateway - The system for running the snap in production
4.1.2. SSH security configuration¶
SSH provides a secure, encrypted means of directly logging into a remote device. This section outlines the steps necessary to configure your account for SSH access to a Cascade Gateway.
Note
Only “developer” or “EvalKit” Cascade Gateways have SSH enabled as it is a handy tool when debugging an app. Production Gateways intended for live deployments do not have SSH enabled, to prevent unauthorized access in the field.
During the Cascade Edge-as-a-Service evaluation period, Rigado is using the service “One Time Secret” to distribute SSH passwords. When Rigado provisions Cascade Gateways to your Edge Direct account, an SSH password is generated and shared through One Time Secret. You will receive an email with a one-time-use web address that will reveal the password. Be sure to check your junk or spam email folders. Should you not find the email, please contact Rigado through our support channel at support@rigado.com and we will re-send the password through One Time Secret.
4.1.3. Gateway Access¶
To SSH into the gateway, you need three pieces of information:
- The IP address of the gateway. You can get this from the gateway detail view in the Edge Direct web app (https://app.rigado.com), or the
rigado gateway info SERIAL
CLI command. - The username of the gateway is
admin
by default. - The password, as described above.
Note
In order to SSH into the gateway, you will need to be on the same subnet as the gateway unless it is assigned a routable IP address.
For example, if the gateway’s IP address is 10.0.1.18
:
$ ssh [email protected]
[email protected]'s password:
Welcome to Ubuntu Core 16 (GNU/Linux 4.4.117+ armv7l)
* Ubuntu Core: https://www.ubuntu.com/core
* Community: https://forum.snapcraft.io
* Snaps: https://snapcraft.io
This Ubuntu Core machine is a tiny, transactional edition of Ubuntu,
designed for appliances, firmware and fixed-function VMs.
If all the software you care about is available as snaps, you are in
the right place. If not, you will be more comfortable with classic
deb-based Ubuntu Server or Desktop, where you can mix snaps with
traditional debs. It's a brave new world here in Ubuntu Core!
Please see 'snap --help' for app installation and updates.
[email protected]:~$
The snap list
command is useful to see exactly which apps and versions are loaded:
[email protected]:~$ snap list
Name Version Rev Tracking Developer Notes
bluez 5.47-1-dev 146 edge canonical -
cascade 16-0.17 28 stable rigadobrandstore gadget
cascade-configuration 10 7 stable rigadobrandstore -
cascade-kernel 4.4-18 23 stable canonical kernel
core 16-2.32.8 4651 stable canonical core
modem-manager 1.6.12-2 129 stable canonical -
network-manager 1.2.2-15 265 stable canonical -
pivot-agent 0.8 31 stable ce-partners -
rigado-deviceops 1.0.15 50 stable rigadobrandstore -
rigado-edge-connect 1.0.4 13 stable rigadobrandstore -
rigado-fw-loader 0.1 1 stable rigadobrandstore -
rigado-network-config 1.0.0 39 stable rigadobrandstore -
wifi-ap 18 210 stable canonical -
Note
You are viewing the legacy Cascade documentation, which only applies to some Rigado customers. To view the current Cascade documentation, click here.