Rally - On-premises: Requesting and updating the root password
search cancel

Rally - On-premises: Requesting and updating the root password


Article ID: 10888


Updated On:


CA Agile Central On Premise (Rally)


In the past, the ability to change the root password for the on-premises appliance was handled via an additional agreement.  We now include the ability to change the root password in all new license files, however if your license file is old, then you may not have this flag enabled in your license file.

This article describes how to request an updated license file as well how the steps to change the root password for your appliance.


Component: ACPREM


How can I acquire root password for my Agile Central On-premise Appliance?

Root access capability is built into the License key issued for your on-premise subscription and root access may or may not already be available to you.

How do I know if root access was built into my On-premise Subscription License?

From the Control Panel check the menu option located at the left side of the screen. If root access was included in the license key the “Update Password” Option will be listed at the bottom

How do I change my root password?

To change the root password for your subscription click “Update Password”, you will be prompted to enter the new password. Once the password has been reset you can now access root from the command prompt.

What if I don’t have the “Update Password” option available?

If the "Update Password" menu option is not displayed this means root access capability was not included with you on-premise license key but it can be obtained by contacting Agile Central support.

What will I need to provide Agile Central Support in order to obtain a new license that includes root access capability?

You will need to provide Support with your current license key file.  Open a support case with Agile Central Support and attach your existing license key along with your request for root access.  The support representative will use the existing license key provided to generate a new license key file and send it back. Once you have the new key you will need to install it.

How do I install the new license file?
  1. Log into the control panel
  2. Click on the “Licensing” menu option
  3. Click on the “Choose File” button
  4. Select the new license key provided to you by Support
  5. Click the “Upload File” button to complete the installation.

You should receive confirmation that the new license was successfully loaded if you receive an error please refer back to the support representative that supplied the new license key.
At this point, you will need to restart your Agile Central services.

Once the new license has been successfully loaded you will have the “Update Password” option available for you to reset the root password.   

What if I cannot locate my existing license key file?

In the event you are unable to locate your exiting license key file you will need to contact your CA Agile Central Account representative to obtain a new license key file.

How do I get root access in 2.0?

With 2.0, the ops user has been created to handle much of the administration.  Additionally, the ops user is able to perform sudo functions in order to acquire root level access, so preceding commands with sudo will cause those commands to be run in a root context.