Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

...

When updating 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:

  1. rapidplan_{SOFTWARE_VERSION}.deb.run

  2. rapidplan_{SOFTWARE_VERSION}.deb.run.check.asc

Info

Each software release has a different name. As an example, the files for updating the software to 1.2.1 are

  • rapidplan_1.2.1-106-g6adf58687e-ubuntu18044lts_amd64.deb.run and

  • rapidplan_1.2.1-106-g6adf58687e-ubuntu18044lts_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.

...

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

...

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

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

Info

Each release of a robot models package has a different name. Different version names will have different robot models included with them. As an example, the files for installing the base 0.2.1 robot models package are

  • rtr-robot-models_0.2.1_amd64.deb.run and

  • rtr-robot-models_0.2.1_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.

...

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

  1. Open a terminal window using one of the following methods:

    1. From the favorites bar:

      1. Select the Terminal Icon from the favorites bar:

        Image Modified
    2. From an applications search:

      1. Select the icon to show applications, from the bottom left corner of the screen:

        Image Modified
      2. In the search bar, type “Terminal” and select the Terminal icon:

        Image Modified
Info

If a terminal is already open and you want another, right click on the icon using either method and then select ‘New Terminal’

Realtime Robotics Software Upgrade

  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
    Image Modified
  3. Enter the

...

  1. command below in 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}.deb.run
    Image Modified
  2. Enter the following command in the terminal to begin the update:

    Code Block
    $ sudo rtr-sigexec rapidplan_{SOFTWARE_VERSION}.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

...

    1. password (“Realtime123”) and press Enter to continue the update.

    Image Modified
  1. A successful upgrade will finish with the line:

    Code Block
    INFO: Success! The user initiated software installation has completed successfully.
    Image Modified
  2. After a successful installation, restart the Controller to complete the upgrade process.

Robot Model Package Installation

Note

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
    Image Modified
  3. Enter the following commands in the terminal to make each robot models file executable:

    Code Block
    $ chmod +x rtr-robot-models*
    Image Modified
  4. Enter the

...

  1. 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}_amd64.deb.run
    Image Modified
    1. Upon running the command, a prompt requiring the RTR-User password will appear in the terminal window.

    2. Enter the RTR-User

...

    1. password (“Realtime123”) and press Enter to continue the update.

  1. A successful upgrade will finish with the line:

    Code Block
    INFO: Success! The user initiated software installation has completed successfully.
    Image Modified
  2. 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}_amd64.deb.run
    Image Modified
  3. 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.