Onboarding: Common issues and how to fix them
The following article addresses some of the common issues we see, and how to fix them. You may see one of the following screens: unexpected character orgissue This usually means one of a few issues: 1. Organization does not exist The organization you are trying to connect to doesnt exist. Be conscious of the orgPopularHow to register for Backrightup to ensure a successful onboarding
How to register for Backrightup Welcome to Backrightup. Using the below guide you can get registered and have your first backups running in under 1 minute. To complete the optimum registration for Backrightup, its preferable to have Google Chrome incognito window (or another browser with incognito facility) Dedicated Service account (eg backrightup@your-company.com) - note this is not MANDATORY, but preferable. it can always be changed later Logged into your Azure Devops account wPopularPossible incorrect permissions
This can happen for a few reasons. Let's narrow them down. Check which account you're authenticated as. Login to Backrightup and click here: https://backrightup.com/Identity/Account/Manage/IntegrationSettings Check which account you have authenticated with Now check that exact account is in the Project Collection Administrators group (under Organisation settings - if you cant see that link in your AFew readersWhat do we backup and restore?
Backrightup uses an oAuth-based Azure Devops app to connect into your organization. This is the ONLY way Microsoft will approve interacting with your Azure Devops organization. Backrightup started by backing up just repositories. Soon it grew and today we backup/restore the following entities for you: Repos TFVC Repos Work items Build Definitions Release Definitions Wikis Variable Groups Task groups Process Templates Teams/members Pull requests Deployment groups EnvirFew readersHow to revoke/remove the Backrightup App from Azure Devops
How does Backrightup backup data from Azure Devops Backrightup uses a very secure and safe oAuth App to pull data from your Azure Devops tenant. This is the best practice set by Microsoft themselves. As you can see from the diagram below, the authentication tokens expire every 1 hour. Image taken from Microsoft: Authorize access to REST APIs with OAuth 2.0 (https://storage.crisp.cFew readersAdding/Removing Team Members
Backrightup allows you to add additional team members. As of writing, these team members have the same role as the primary administrator, except for managing team members themselves. To add or remove a team member: 1) Login to Backrightup and click on the "Hi" link -Settings in the top right corner 2) Click on "Team settings" in the left-hand menu 3) Click on "Add a team member". Once completeFew readersHow to configure timezone and retention for your backups
1) Login to Backrightup and click on the "Hi" link -Settings in the top right corner 2) Under the "profile" area scroll down to "Backup Settings" 3) We recommend choosing a backup time which represents your midnight or when least activity is present in Azure Devops 4) Retention period should be setFew readersHow to reauthenticate your existing Azure Devops Backups
How to reauthenticate when you already have an account If you have arrived here as your first visit, its best to visit How to register for Backrightup to ensure a successful onboarding first to get setup correctly If you already have a connection to your Azure Devops organization, but you'd like to reauthenticate, the following prerequisities are required: Google Chrome incognito window (or anoFew readersUsing a Service Principal to authenticate to Azure DevOps (in-app)
The following article will help you to configure a service principal to use with your Azure DevOps instance. This article assumes you already have at least ONE Azure Devops organisation added. Before Microsoft supported Service Principals, Backrightup used a "service account" based model. Using Microsoft Service Principals over service accounts to connect to Azure services is now considered better practice because: Security: Service principals use secure methods like certificate-based auFew readersHow to add multiple Azure Devops Organisations for backup
The following article will help you to add a new Azure Devops organisation to your backups. This article assumes you already have at least ONE Azure Devops organisation added. 1. Login to your Backrightup dashboard and navigate to your settings: 2 Navigate to the "Integration settings" 3 Click tFew readers