Overview

This procedure describes the best practice of updating installing the RapidPlan and RapidSense software. The following update installation process does not require internet access on the Realtime Controller.

IMPORTANT: the update procedure requires a currently-installed RapidPlan software version of 1.2.0 or higher, on a Realtime Controller. Please contact Realtime Robotics Support at realtimesupport@rtr.ai, if the software or hardware differs from the requirements listed.

Requirements

• RapidPlan version 1.2 or higher

• Realtime Controller Hardware

Industrial PC.

Peripheral Equipment

To perform this procedure, the following items need to be connected to the controller:

• Keyboard

• Mouse

• Monitor

• External storage device

Create a Backup File

Backup the project files as described in the Back-Up and Restore Procedure document. Note that the updating process will not delete the project files.

Downloading Software Version Installer

Software Suite Installer

When updating installing the software, the first step is to download the software update files from files.rtr.ai. There are two files required to update the software:installation package.

• rapidplan_

...

rapidplan_{SOFTWARE_VERSION_ID}.deb.run.check.asc

...

• A.A.A-AAA-AAA+ubuntuBBBlts_amd64.lin.tar

  • A → RapidPlan version

  • b → Ubuntu OS version compatible with this installation package

Robot Models Installer

Realtime Robotics has a software package for each robot OEM. You will be provided with the files for whichever OEMs you work with. There are two base files required and then two files required for each OEM :

The base install files are:

• rtr-robot-models_{SOFTWARE_VERSION_ID}_amd64.deb.run

• rtr-robot-models_{SOFTWARE_VERSION_ID}_amd64.deb.run.check.asc

For each robot OEM , you will get :

• rtr-robot-models-{OEM}_{SOFTWARE_VERSION_ID}_amd64.deb.run

• rtr-robot-models-{OEM}_{SOFTWARE_VERSION_ID}_amd64.deb.run.check.asc

If the RTR Controller has access to the internet, download the files and move both of them to the ~/Documents folder. Otherwise, download them on another computer and transfer them to the ~/Documents folder in the Realtime Controller using an external storage device.

Updating the software

...

Updating the software

Opening a Terminal

The software upgrade and installation procedure is run from a terminal on the Realtime Controller. Use the following steps to open a terminal.

...

Realtime Robotics Software Upgrade

1. Follow the steps above to open a terminal

1. Enter the following command in the terminal to change the directory to the Documents folder, which contains the update files:

   Code Block
   $ cd ~/Documents

   

2. Enter Run the following command below in from the terminal to make the *.deb.run file executable:
   (Hint: Use the Tab key to auto-complete the filename to avoid typos. Type the command and the first part of the filename and then press Tab to auto-complete. If there are multiple files in the directory that share the initial part of the filename, Tab will auto-complete until there’s a difference in the filenames. Enter the next letter and press Tab again to continue.)

   Code Block
   $ chmod +x rapidplan_{SOFTWARE_VERSION_ID}.deb.run

   Image Removed

3. Enter the following command in the terminal to begin the update:

   Code Block
   $ sudo rtr-sigexec rapidplan_{SOFTWARE_VERSION_ID}.deb.run

   1. Upon running the command, a prompt requiring the RTR-User password will appear in the terminal window. Note: the text you enter will not be displayed as you type.

   2. Enter the RTR-User password (“Realtime123”) and press Enter to continue the update.

   Image Removed

4. A successful upgrade will finish with the line:

   Code Block
   INFO: Success! The user initiated software installation has completed successfully.

   Image Removed

5. :

   tar xf ./rapidplan...tar

   sudo ./install.sh

6. After a successful installation, restart the Controller to complete the upgrade process.

Robot Model Package Installation

...

...

If you are on a Realtime Controller with software version < 1.3.0 you must upgrade the software to 1.3.0 before installing the robot models.

1. Follow the steps above to open a terminal

2. Enter the following command in the terminal to change the directory to the Documents folder, which contains the update files:

   Code Block
   $ cd ~/Documents

   

3. Enter the following commands in the terminal to make each robot models file executable:

   Code Block
   $ chmod +x rtr-robot-models*

   

4. Enter the command below in the terminal to begin installing/updating the base robot models package:

   (Hint: Use the Tab key to auto-complete the filename to avoid typos. Type the command and the first part of the filename and then press Tab to auto-complete. If there are multiple files in the directory that share the initial part of the filename, Tab will auto-complete until there’s a difference in the filenames. Enter the next letter and press Tab again to continue.)

   Code Block
   $ sudo rtr-sigexec rtr-robot-models_{SOFTWARE_VERSION_ID}_amd64.deb.run

   Image Removed

   1. Upon running the command, a prompt requiring the RTR-User password will appear in the terminal window.

   2. Enter the RTR-User password (“Realtime123”) and press Enter to continue the update.

5. A successful upgrade will finish with the line:

   Code Block
   INFO: Success! The user initiated software installation has completed successfully.

   Image Removed

6. For every robot OEM package you have, enter the following command in the terminal to begin installing/updating the robot models package:

   Code Block
   $ sudo rtr-sigexec rtr-robot-models-{OEM}_{SOFTWARE_VERSION_ID}_amd64.deb.run

   

7. A successful upgrade will finish with the line:

   Code Block
   INFO: Success! The user initiated software installation has completed successfully.

Contacting Support

Please contact Realtime Robotics support team at realtimesupport@rtr.ai if you encounter any problems following this procedure.