Please note: weavedconnectd is not recommended for new designs. This information is made available to support users who have already deployed weavedconnectd.
Check the OS Version
First, you will need to determine which version of the OS is installed on your Pi.
pi@raspberrypi:~ $ cat /etc/os-release
PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
This example shows that the release is at the "Jessie" level which as of April 2017 is current. The weavedconnectd installer is up to date at the Raspbian repository, so you can use the "apt-get" command to get the latest version.
If you are using the Wheezy version of Raspbian, or to support other ARM boards using Debian (such as BeagleBone Black and Wandboard), please follow the installation directions here.
Install the weavedconnectd package
First, get the latest repositories:
sudo apt-get update
Next, download the remot3.it weavedconnectd package:
sudo apt-get install weavedconnectd
If you are using Jessie, and you have not installed the weavedconnectd package previously, you will see:
If you had previously installed weavedconnectd, the following output shows that you are already up to date.
Run weavedinstaller to configure remot3.it service attachments
to launch the interactive installer.
After some initialization info, you will see this menu:
If you have not already created an account, select 2 then press Enter. Then follow the on-screen instructions to enter your e-mail. We will send you an e-mail with a verification code that you must enter by selecting 3 from this menu. After that, your account is active and you can add devices and services.
If you already created an account, select option 1, then log in. Note that the password is not displayed as you type.
Next, as there are no services yet installed, you will be asked to enter the Device Name. Valid characters include numbers, letters, space, underscore, and dash.
This is the initial view of the Installed remot3.it Services Menu. All that you have at this point is the Device Name.
Press 1 to attach remot3.it to one of your services.
Select the type of service you are connecting to. Options 1 through 3 are predefined for the most common use cases. You can choose a different port during installation of options 1 through 3. Select option 4 to configure remote.it for other use cases.
Installing a remote.it attachment for SSH
We recommend having a remot3.it enabled SSH connection even if your primary use case is something else. That way, you can easily get to a console for troubleshooting if needed.
Note: recent versions of the Raspbian Jessie OS do not enable SSH by default as a security measure. You will need to run the raspi-config program on your Raspberry Pi to enable the SSH daemon.
Select 1 at the Protocol Selection Menu to configure an attachment for SSH.
For options 1, 2, and 3, a default port has been chosen. Sometimes this needs to be changed to another value, so you have that option here. Unless you know otherwise, select the default value. After taking a few seconds to create the attachment, you will be asked to enter a name for this service. After you enter the name, a few more seconds passes while it is registered to your account.
Next, you will be returned to the Installed remot3.it Services menu. Now your attachment to the ssh service is shown.
We have successfully installed the remote.it service connection for SSH. In the "Service" column you will see the name of the tcp listener program (usually called a "server") which was found on the specified port.
Learn more about using remote.it and SSH here.
Installing a remote.it service for a web (http) server
Follow the instructions for SSH above, except choose option 2, "Web (http)" from the Protocol Selection Menu. You will need to install and configure your own web server.
Installing a remote.it service for a VNC server
Follow the instructions for SSH above, except choose option 3, "VNC" from the Protocol Selection Menu. Learn more about using remote.it with VNC here. Port 5901 is the default used by tightvncserver. It may be different for other VNC programs.
If you see "WARNING-NONE" in the Services column, it means that no tcp listener was found on that port. This could mean:
- The desired program is not installed. Note that while the weavedconnectd installer has options for configuration with VNC and web servers, these programs are not installed by default.
- The program is installed, but it's not running. Check to make sure the program is running and works over the LAN.
- The program is installed and running, but it's on a different port than you have specified. To see all tcp listeners running on your device along with the ports they are using, run the command
sudo netstat -apn | grep tcp | grep LISTEN
Lines beginning with "tcp" represent TCP v4 sockets. Lines beginning with "tcp6" represent TCP v6 sockets.
An entry such as 0.0.0.0:5901 means "listen on all interfaces for traffic on port 5901". This corresponds above to 11419/Xtightvnc. This indicates that process ID 11419 is the Xtightvnc server.
An entry such as 127.0.0.1:3350 means "listen on interface 127.0.0.1 (localhost) for traffic on port 3350".
The output shown is just one possibility and depends on how you have your device configured. Check the documentation for netstat to learn more about this very powerful utility.