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

Products

• Rally On-Premise
• Rally SaaS

Issue/Introduction

Is it supported to change the hostname of my on-premise appliance?

Environment

Release:
Component: ACPREM

Resolution

While our documentation no longer warns against changing the hostname of your Rally 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 Rally 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