Skip to main content
Version: 8

Upgrading Software & Changing License Keys

There are two ways to upgrade the software. For most release versions of MoveIt Pro, we recommend the Upgrade in Place approach. Alternatively, if needed you can choose the Full Re-Install approach.

note

Our versioning uses an X.Y.Z syntax where X is the major version, Y is the minor version, and Z indicates a patch release.

To leave MoveIt Pro workspace and robot config packages unchanged:

  • Run the latest install script from the Install MoveIt Pro guide.
  • Run moveit_pro build or moveit_pro run to upgrade and re-build your workspace.
  • If performing a major upgrade, reference the Migration Guides in the Release Notes to upgrade your robot config packages through each major release, as there may be breaking changes that require manual migration steps.

Full Re-Install​

If your upgrade is unsuccessful for any reason, you can do a full re-install. This option is ideal if you are only using our example workspace, without any additions or changes. The example workspace will be re-downloaded automatically when you run MoveIt Pro.

warning

This will delete your ~/moveit_pro folder, so if your custom workspace is located within the folder back it up to another location before proceeding!

Changing Licenses Keys​

To change your MoveIt Pro license key, perhaps because your previous one expired or was copied in incorrectly, there are two approaches:

  1. Run moveit_pro configure and it will re-step you through all the configuration steps, including entering your license key.
  2. Run gedit ~/.config/moveit_pro/moveit_pro_config.yaml and find the line called STUDIO_LICENSE_KEY