Agile Central - On-premises: Can I change the hostname of my appliance?

Document ID : KB000115895
Last Modified Date : 10/10/2018
Show Technical Document Details
Question:
Is it supported to change the hostname of my on-premise appliance?
Answer:
While our documentation no longer warns against changing the hostname of your Agile Central on-premise appliance, it is not supported to change the name and can result in a number of systems failing to start if it has been changed.

Changing the name can cause failures in the following systems:
  • Solr
  • Analytics
  • Oracle
  • LDAP
If the analytics service fails to start, you will see errors when navigating to the reports page:
The Reporting Service is Currently Unavailable

If the Solr service fails to start, you may have troubles performing searches in your appliance

If the Oracle service fails to start, your primary Agile Central service will not start and you will not be able to log into the appliance at all.

If LDAP fails to work correctly, there may be issues with the on premise appliance creating new user accounts.
Performing a 'Run Report' will result in the following error:
LDAP TO RALLY USER REPORT
Date: 10/02/2018
Time: 10:40

There was an error connecting to Rally.
Please re-run report.
Additional Information:
To check and resolve the hostname of your appliance, please see the following article
How to restore the default hostname of the appliance