All rapyuta.io docs are open source. See something that's wrong or unclear? Submit a pull request.Make a contribution
nslookup $(hostname), this should return a DNS record.
To register a new device on rapyuta.io:
|Device Name||Enter a name for the device.|
|Description||Enter a summary of the device.|
|Advanced||Expand this option to view additional configurations.|
|Docker||The primary runtime for managing applications through Docker. Select this option and specify the ROSBag mount path.
By default, docker runtime is enabled for a device.
|Preinstalled||The secondary runtime available for managing pre-installed software on the device. Select this option and specify the ROS Catkin Workspace.
Preinstalled devices can now be created even if ros distro is not available on the device, but the ros communication packages for preinstalled runtime will not be installed and you will not be able to create a network.
|Rosbag mount path|| Enter the path to store the ROS bag files on the device. The default path is /opt/rapyuta/volumes/rosbag.
After you onboard a device, you cannot change the mount path to store the ROS bag files. If you want to change the mount path after adding the device, you can re-onboard the device and change the mount path.
|ROS Catkin Workspace|| Enter the absolute path of your catkin workspace. If you are using a custom rapyuta.io image on the device, your catkin workspace will be /home/rapyuta/catkin_ws where catkin_ws is the name of the catkin workspace. Otherwise, you will have a different absolute path for your catkin workspace.
The ROS Catkin Workspace value can be empty, and you can provide this value on the device’s details page.
The copied script is valid only for 10 minutes.
To create a project:
rio device create <device_name> --runtime <device_runtime> --ros <ros_distro> --python <python_version>
If the ros distro variable is not set, communication over the network (native network or routed network) will not happen and deployments that depend on these networks will fail.
sudo systemctl restart rapyuta-agent. You can check the status on the device details page.
Set up your device to connect it to the rapyuta.io platform. To set up your device, open the command terminal and run the previously copied script. The token sets up the rapyuta.io device client on the device.
Once the device is set up successfully, you should see the following output on the command terminal:
Initializing the Rapyuta Platform ########(100%) Successfully installed! root@ubuntu:/home/ubuntu#
Following are the different stages involved in installing and onboarding the device onto rapyuta.io platform:
Not all devices go through all of the stages in the device initialization process. For example, devices with docker-compose option set will have ROS base image installed on them, those with preinstalled runtime will have monitoring package installed on them.
In case you face issues onboarding the device. Please refer to the section on failure codes to help you troubleshoot.
When the device is successfully registered, you will see a green dot beside the device’s name, this indicates that the device is online.
The rapyuta.io platform allows you to upgrade your python 2 devices to python 3. To upgrade your device:
After you upgrade your device to python 3, you must set up the device for the changes to reflect.