This option will take you through disconnecting all Artifactory instances from your single Xray instance, except for one. Then, continuing to upgrade the disconnected Artifactory instances to version 7.x with newly installed Xray version 3.x instances.
This procedure will require re-indexing the additional Artifactory instances, and will cause some loss of Xray configuration data. You will need to:
Many to One Pairing | One to One Pairing | ||
|---|---|---|---|
Export user-defined configurations (Optional for Xray v 2.11 and up)
You can export Xray user-defined configurationsto be imported to other Xray instances using a set of dedicated REST APIs. The following settings include policies, watches, Ignore Rules, custom licenses, custom issues, webhooks, mail server, proxy configurations, and indexed resource settings.
Disconnect Artifactory Xray pairings, except one
Remove all Artifactory instances connected to Xray, except the one you would like to keep connected to this Xray instance. If you have an Artifactory instance that is configured as your authentication provider, keep this instance enabled with Xray.
In the Xray UI, go to Admin | A rtifactory, and delete the Artifactory instance(s) to remove.
Note: This operation will remove all data for the removed Artifactory instances.
Upgrade the remaining connected Xray Artifactory pairing
Upgrade the connected Artifactory instance to version 7.x, using this guide.
Upgrade the connected Xray instance to version 3.x, using this guide.
Note: Make sure to upgrade Artifactory before Xray.
Upgrade disconnected Artifactory instances to 7.x, using this guide.
Install a new Xray 3.x instance(s) for each Artifactory cluster, using this guide.
When installing the new Xray instances, make sure to provide the base URL and join key of the Artifactory instance you want to pair your Xray with.
Import user-defined configurations (Optional for Xray v 2.11 and up)
You can import Xray user-defined configurations, if you chose to export them in the first step.
Index all required resources for each one of the new Artifactory Xray pairs
In Classic Navigation, navigate to the Administration module, go to Xray Settings | General and click Indexed Resources.
In New Navigation, navigate to the Administration module, go to Xray Settings and click Indexed Resources.