From 1cd7d261aba9833479e568f67f24996e60fa9acf Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Tue, 21 May 2024 16:11:33 +0300 Subject: [PATCH] PSMDB-1455 Documented the steps to retrieve access token for Pro repo (#856) modified: docs/install/install-pro.md modified: docs/install/update-pro.md new file: snippets/token.md --- docs/install/install-pro.md | 9 +++------ docs/install/update-pro.md | 8 +++----- snippets/token.md | 12 ++++++++++++ 3 files changed, 18 insertions(+), 11 deletions(-) create mode 100644 snippets/token.md diff --git a/docs/install/install-pro.md b/docs/install/install-pro.md index d4e7063d..c80f5d9b 100644 --- a/docs/install/install-pro.md +++ b/docs/install/install-pro.md @@ -2,12 +2,9 @@ This document provides guidelines how to install Percona Server for MongoDB Pro from Percona repositories and from binary tarballs. [Learn more about Percona Server for MongoDB Pro](../psmdb-pro.md). - If you already run Percona Server for MongoDB and wish to upgrade to Percona Server for MongoDB Pro, see the [upgrade guide](update-pro.md). -## Before you start - -Request the access to the pro repository from Percona Support. You will receive the client ID and the access token. +--8<-- "token.md" ## Install from Percona repository @@ -16,7 +13,7 @@ Request the access to the pro repository from Percona Support. You will receive 1. Configure the repository. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents: ```ini title="/etc/apt/sources.list.d/psmdb-pro.list" - deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/apt/ OPERATING_SYSTEM main + deb http://repo.percona.com/private/[TOKENID]-[TOKEN]/psmdb-60-pro/apt/ OPERATING_SYSTEM main ``` 2. Update the local cache @@ -44,7 +41,7 @@ Request the access to the pro repository from Percona Support. You will receive ```ini title="/etc/yum.repos.d/psmdb-pro.repo" [psmdb-6.0-pro] name=PSMDB_6.0_PRO - baseurl=http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/yum/main/$releasever/RPMS/x86_64 + baseurl=http://repo.percona.com/private/[TOKENID]-[TOKEN]/psmdb-60-pro/yum/main/$releasever/RPMS/x86_64 enabled=1 gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY ``` diff --git a/docs/install/update-pro.md b/docs/install/update-pro.md index 905fd5fb..7c0f437e 100644 --- a/docs/install/update-pro.md +++ b/docs/install/update-pro.md @@ -4,9 +4,7 @@ Are you a Percona Customer already and are you ready to enjoy all the [benefits This document provides instructions how you can upgrade from Percona Server for MongoDB to Percona Server for MongoDB Pro. -## Preconditions - -Request the access to the Percona Server for MongoDB Pro repository from Percona Support. You will receive the client ID and the access token. +--8<-- "token.md" ## Procedure @@ -23,7 +21,7 @@ Request the access to the Percona Server for MongoDB Pro repository from Percona 1. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents ```ini title="/etc/apt/sources.list.d/psmdb-pro.list" - deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/apt/ OPERATING_SYSTEM main + deb http://repo.percona.com/private/[TOKENID]-[TOKEN]/psmdb-60-pro/apt/ OPERATING_SYSTEM main ``` 2. Update the local cache @@ -39,7 +37,7 @@ Request the access to the Percona Server for MongoDB Pro repository from Percona ```ini title="/etc/yum.repos.d/psmdb-pro.repo" [psmdb-6.0-pro] name=PSMDB_6.0_PRO - baseurl=http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/yum/main/$releasever/RPMS/x86_64 + baseurl=http://repo.percona.com/private/[TOKENID]-[TOKEN]/psmdb-60-pro/yum/main/$releasever/RPMS/x86_64 enabled=1 gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY ``` diff --git a/snippets/token.md b/snippets/token.md new file mode 100644 index 00000000..78cde3f5 --- /dev/null +++ b/snippets/token.md @@ -0,0 +1,12 @@ +## Get the access token to the Pro repository + +As a Percona Customer, you have the access to the ServiceNow portal. To request the access token, do the following: + +1. In **ServiceNow**, click **My Account** and select **Entitlements**. +2. Select your entitlement. +3. If you are entitled for Pro builds, you will see the **Token Management** widget. Click the **Get Percona Builds Token** button. + + If you don't see the widget, contact Percona Support. + +4. Click **Request Token** button in the **Request a Percona Pro Builds Token** dialog window. +5. A token will be generated for you. You will also see the Customer ID. Copy both the Customer ID and the token as you will use them to configure the Pro repository and install the software.