Skip to main content
Version: 9

Migrate User Workspace

Migrate from 8.x to 9.x​

Environment Variable Changes​

In version 9.0.0, we renamed the environment variables used by MoveIt Pro to better align with product naming. These included environment variables which were used in user workspaces such as:

  • STUDIO_USERNAME → MOVEIT_USERNAME
  • STUDIO_USER_UID → MOVEIT_USER_UID
  • STUDIO_USER_GID → MOVEIT_USER_GID
  • STUDIO_DOCKER_TAG → MOVEIT_DOCKER_TAG
  • STUDIO_LICENSE_KEY → MOVEIT_LICENSE_KEY

If you are using Linux, you can update your entire workspace with the following bash command inside your workspace:

sed -i 's/MOVEIT_STUDIO_BASE_IMAGE/MOVEIT_PRO_BASE_IMAGE/g' Dockerfile
for file in $(grep -r 'STUDIO_' -l); do
  sed -i 's/STUDIO_/MOVEIT_/g' $file;
done

Host Hardware Access​

We moved the responsibility for exposing host hardware from the MoveIt Pro Docker Compose file to the user workspace Docker Compose file. For any services which require host hardware access, you can map devices from the host into the container in your docker-compose.yaml file like the following example:

services:

  base: {}
  
  agent_bridge: {}

  drivers:  # most likely to need host hardware access
    volumes:
      - /dev/i2c-9:/dev/i2c-9
      - /dev/ttyACM0:/dev/ttyACM0

  web_ui: {}

  dev:
    volumes:
      - /dev/i2c-9:/dev/i2c-9
      - /dev/ttyACM0:/dev/ttyACM0

Package Naming​

The following packages were renamed and bash scripts are included below which will automatically apply the renames to your user workspace when run inside of it:

moveit_studio_behavior_interface -> moveit_pro_behavior_interface (do before moveit_studio_behavior)​

for file in $(grep -r -l 'moveit_studio_behavior_interface'); do
    sed -i 's/moveit_studio_behavior_interface/moveit_pro_behavior_interface/g' $file
done

moveit_studio_behavior -> moveit_pro_behavior​

for file in $(grep -r -l `moveit_studio_behavior'); do
    sed -i 's/moveit_studio_behavior/moveit_pro_behavior/g' $file
done