XRAY: Troubleshooting connection issues when migrating Xray servers

AuthorFullName__c
David Kahan
articleNumber
000005710
FirstPublishedDate
2023-05-09T11:19:22Z
lastModifiedDate
2023-05-09

XRAY: Troubleshooting connection issues when migrating Xray servers

If you have migrated your Xray and Artifactory servers to new servers and are experiencing connection issues between Xray and Artifactory below are some common issues to troubleshoot.

Update configurations on Xray

Update the ‘shared.node.ip’ and ‘jfrog_url’ on Xray’s system.yaml file are pointing to the correct locations. Due to the server migrations these will now be different.

As Xray service has migrated to a new server the join key and passwords for the database and RabbitMQ need to be re-entered in an unencrypted format for the first time it’s run. 

To find the Join key navigate in the UI to the Admin tab -> User Management -> Settings-> Connection details
 

Check firewall and port availability

Check that your firewall is allowing traffic for Xray on port 8082 and it is not being used by another service. 

You should also make sure that the URLs mentioned in the documentation are whitelisted for your DB sync to complete and run.
 

Update configurations on Artifactory

Edit the Artifactory system.yaml shared.node.ip attribute. More detail regarding this step can be found here.

After following any of the troubleshooting steps listed above, ensure you run a restart on Xray and/or Artifactory where applicable.