Onboarding: "Authorization Failed" Error
The "Authorization Failed" Error is generally related to 3-4 root causes, and is usually easy to fix! Let's take a look at the most common causes of the "Authorization Failed" error.
- An Escape-Pod compatible version of the Vector software has not been installed onto the Robot.
- A License (you should have received this in a text file via email) was not applied in the "Licenses" screen.
- The License that was applied in the License screen does not match the serial number.
- Vector Robot:
- A Clear User Data reset was not completed during the Onboarding process.
- OSKR Units Only: The server_config.json file was not changed to point to the address of the Escape Pod.
- Check the Software version running on the robot:
- Place Vector on his Charger (make sure the Charger is plugged into the wall).
- Double tap Vector's Back button to enter Pairing Mode. A key will appear on his screen.
- Gently lift his arm and set it back down. A screen with diagnostic information will appear.
- After the text "OS" you should see "ep" on the end of the Software version. Example: "18.104.22.16816ep"
- If you do NOT see "ep" on the end of the Software, please retry loading the Software titled "PROD_(version number)" using the Onboarding process.
- If you are on an OSKR robot, this may not apply to you, as the server configuration file can be modified to accept the Escape Pod without loading new software. Please see the "OSKR Robots Only" section below.
- If you see "ep" on the end of the Software Version, then Escape Pod compatible software is already loaded. Lift Vector's arm and set it down again to exit the diagnostic screen. Move to Step 2.
- Check the License:
- With your web browser pointing to the Escape Pod, click "Menu" at the top right of the Escape Pod interface.
- Click "Licenses" in the menu.
- Verify that you have a License installed; you should see "vic:" followed by your robot's serial number in the screen, as shown, under the "Licensed Robots" section:
- If you do not have a License installed, please download your License from the "Escape Pod License" email that was sent to you:
- Click the "Add License" button on the "Licenses" screen of the Escape Pod.
- Open the text file that was sent to you (it should be titled with your robot's serial number).
- Copy the entire contents of the text file.
- Paste the text file into the "License Key"
- Verify that the serial number exactly matches the bottom of your robot (see this article with how to find your serial number). If your License does not match this format, or does not match your robot's serial number, please Contact Us at email@example.com for a new license (or you may reply to the email that your license was attached to). Please include a photo of the bottom of your robot for the fastest assistance.
- If the License looks good, it is possible that the robot was not reset prior to the Onboarding process. Perform a Clear User Data reset:
Resolutions (OSKR Robots Only):
Please ensure that you have covered the steps above in the Standard Robots section before moving into this section. Be aware that if your Vector has not been unlocked with a custom OSKR image and flashed with new firmware, then this section will not apply to you.
- Modify the server_config.json file on the Vector robot:
- Point the Vector robot to the Escape Pod by changing the destination of his voice command requests. Follow Step 3 only in this article.
- Reboot the robot after the server_config.json has been modified:
- Press Vector's Back button for 5 seconds until his screen shuts off completely.
- Wait for 10 seconds.
- Tap Vector's Back button once to begin the bootup process, which will take approximately 1 minute.
- Retry the Escape Pod Onboarding Process. If you update Vector or reload the current software to the robot you will need to re-complete the process of modifying the server_config.json file each time.
- If you still have trouble, please Contact Us: firstname.lastname@example.org.