How do I use my renewed license with the existing server?

Jason June 26, 2020

I've recently renewed my license, however, when I attempt to use the Jira server (already installed on my Mac), I'm directed to http://localhost:8080/secure/SetupMode!default.jspa

I don't want to uninstall and reinstall the program again as I ran into several issues the first time. So, how do I use my renewed license with the existing server? 

-Jason 

1 answer

0 votes
Daniel Eads
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
June 26, 2020

Hi Jason,

Jira will run its setup wizard if it doesn't find a dbconfig.xml file in its home directory. This file is created after the setup wizard runs the first time and contains the details necessary to let the Jira application know how to connect to the database.

Can you double-check that the home directory exists and contains the dbconfig.xml file?

If you're not sure what is currently set for Jira's home directory, there are a couple places it could be set:

  • The JIRA_HOME variable in the file <jira-install>/bin/setenv.sh
  • In the file <jira-install>/atlassian-jira/WEB-INF/classes/jira-application.properties

If the home directory variable is set to the right folder and there is a dbconfig.xml file there, it's possible you may need to change the permissions on the home directory (using chmod to ensure the user account running Jira can read the directory.

After making any changes, restart Jira so that it can read the dbconfig.xml file - once it's able to read the database connection information, it should not present the setup wizard.

 

Once you are able to log in to Jira, the new license can be applied in the web interface:

  1. Choose Administration (  ) > Applications
  2. Select Versions & licenses to view license details for your installed Jira applications.
  3. Locate the license you want to update, and click on the pencil icon to edit the license.
  4. Replace the existing license key with your new license key.
  5. Click the 'Update license' button to update the Jira application with the new license.

Details of a Jira Software license.

Cheers,
Daniel

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
SERVER
VERSION
8.1.0
TAGS
AUG Leaders

Atlassian Community Events