Page tree
Skip to end of metadata
Go to start of metadata

The following describes the current infrastructure setup and the steps to upgrade the Nordix Jira.

Jira App Setup

The Nordix JIRA is installed and configured as a service on the Ubuntu operating system

Jira DB Setup

The PostgreSQL 10 database has been installed and configured as the back end for the Nordix JIRA

Jira Data Path

The /data is the filesystem where  Nordix JIRA application & database files are hosted

Jira Server Configuration

  • /data/atlassian/jira/conf/server.xml is the server configuration file for Nordix JIRA
  • /data/atlassian/application-data/jira/dbconfig.xml is the DB configuration file for Nordix JIRA

Jira SSL Certificate

The nginx reverse proxy has been configured with letsencrypt certificate to enable SSL based  Nordix JIRA access on port 443

Jira Apps

The following is the list of user installed Jira applications,

  • Atlassian Troubleshooting and Support Tools
  • Atlassian Universal Plugin Manager Plugin
  • JIRA iCalendar Plugin
  • Mobile Plugin for Jira
  • OAuth/OpenID Connect (OIDC) for Jira SSO
  • SSO for Atlassian Data Center
  • Advanced Roadmaps plans
  • Advanced Roadmaps Team Management
  • querydsl-4.0.7-provider-plugin

Currently the Nordix Wiki is the only application link has been configured in Nordix JIRA

Jira App Logs

The JIRA Server startup logs are located in /data/atlassian/jira/logs/catalina.out

Last Jira Upgrade

JIRA was successfully upgraded to version 8.11.1 on 19/Aug/20 at 8:32 PM.

Jira Upgrade Plan

The plan your upgrade option in the JIRA settings will check and recommend the latest available JIRA versions for upgrade. Its always better to go with longterm supported version.

JIRA UI Home -> Settings -> Applications -> Plan your Upgrade

Jira Upgrade to 8.13.4

The Nordix Jira is currently running with 8.11.1 version. As recommended by the Atlassian upgrade plan, Jira 8.13.4 is the latest long term supported version 

  1.  Login to the Nordix JIRA server
  2. Check and Download the installer for the image JIRA-8.13.4

    wget https://product-downloads.atlassian.com/software/jira/downloads/atlassian-jira-software-8.13.4-x64.bin -O /tmp/atlassian-jira-software-8.13.4-x64.bin
  3. Update all user installed applications (plugins)

  4. Run user-installed apps compatible check against the target Jira version 8.13.4

    Jira UI Home -> Settings -> ATLASSIAN MARKETPLACE -> Manage apps -> JIRA update check -> Select the target version "8.13.4" -> Check 

  5. Stop Jira Service

    sudo systemctl stop jira.service
    sudo systemctl status jira.service
    ps -ef| grep -i jira
    sudo kill -9 <JIRA_PID>

    NOTE: Please kill the Jira process to proceed with upgrade, Only If the status of Jira service is in failed state and the Jira process exist from ps command output

  6. Stop PostgreSQL DB service

    sudo systemctl stop postgresql.service
    sudo systemctl status postgresql.service
  7. Backup data, including database, installation directory, and home directory

    cd /data
    sudo tar -czvf jira-data-bkp-<DATE>.tar.gz atlassian downloads postgresql lost+found
  8. Take a copy of conf/server.xml & bin/setenv.sh file in user's home directory

    sudo cp -pr /data/atlassian/jira/conf/server.xml $HOME/server.xml-bkp-<date>
    sudo cp -pr /data/atlassian/jira/bin/setenv.sh $HOME/setenv.sh-bkp-<date>
  9. Start PostgreSQL DB service

    sudo systemctl start postgresql.service
    sudo systemctl status postgresql.service
  10. Update installer permissions

    sudo chmod a+x /tmp/atlassian-jira-software-8.13.4-x64.bin
  11. Run the installer & select the option "3" for JIRA upgrade

    $ /tmp/atlassian-jira-software-8.13.4-x64.bin
    Unpacking JRE ...
    Starting Installer ...
    You do not have administrator rights to this machine and as such, some installation options will not be available. Are you sure you want to continue?
    Yes [y, Enter], No [n]
    y
    
    This will install Jira Software 8.13.4 on your computer.
    OK [o, Enter], Cancel [c]
    o
    Click Next to continue, or Cancel to exit Setup.
    
    Choose the appropriate installation or upgrade option.
    Please choose one of the following:
    Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2], Upgrade an existing Jira installation [3, Enter]
    3
    Existing installation directory:
    [/data/atlassian/jira]
    
    Back up Jira home directory
    The upgrade process will automatically back up your Jira installation
    directory. You can also choose to back up your existing Jira home directory.
    Both directories are backed up as zip archive files in their respective
    parent directory locations.
    
    We strongly recommend choosing this option in the unlikely event that you
    experience problems with the upgrade and may require these backups to
    restore your existing Jira installation.
    
    If you have many attachments in your Jira home directory, the zip archive of
    this directory may consume a significant amount of disk space.
    Back up Jira home directory?
    Yes [y], No [n, Enter]
    n
    
    Checking for local modifications.
    
    List of modifications made within Jira directories.
    
    The following provides a list of file modifications within the
    atlassian-jira directory.
    
    Modified files:
    	conf/server.xml
    Removed files:
    	(none)
    Added files:
    	(none)
    
    [Enter]
    
    Checking if your instance of Jira Software is running
    
    Upgrade checklist
    Complete these steps to have a smooth upgrade experience. If you need more
    details, see
    https://docs.atlassian.com/jira/jadm-docs-0813/Preparing+for+the+upgrade.
    
    1. Run a Jira health check
    Run a Jira health check to verify that you're ready to upgrade. Make sure
    that checks related to the license and database have passed, but you can
    also fix other detected problems.
    
    2. Check app compatibility
    Make sure your apps are compatible with the Jira version you're upgrading
    to. Disable all incompatible apps, so they don't affect your upgrade.
    
    3. Back up the database
    Back up the Jira database using your database's native backup tools.
    
    Have you completed all these steps?
    Yes [y, Enter], No [n]
    y
    Your existing Jira installation is about to be upgraded! Do you want to proceed?
    Upgrade [u, Enter], Exit [e]
    u
    
    Your instance of Jira is currently being upgraded.
    Checking if Jira has been shutdown...
    Backing up the Jira installation directory
    
    Deleting the previous Jira installation directory...
    
    Extracting files ...
    
    Please wait a few moments while Jira Software is configured.
    
    Installation of Jira Software 8.13.4 is complete
    Start Jira Software 8.13.4 now?
    Yes [y, Enter], No [n]
    y
    
    Please wait a few moments while Jira Software starts up.
    Launching Jira Software ...
    
    Installation of Jira Software 8.13.4 is complete
    Your installation of Jira Software 8.13.4 is now ready and can be accessed
    via your browser.
    Custom modifications
    Your previous Jira installation contains customisations (eg server.xml) that
    must be manually transferred. Refer to our documentation more information:
    http://docs.atlassian.com/jira/jadm-docs-0813/Upgrading+JIRA+applications+manually#UpgradingJIRAapplicationsmanually-configuringnewjiraasold3.4MigrateyourexistingJIRAconfigurationsovertoyournewJIRAinstallation
    Jira Software 8.13.4 can be accessed at http://localhost:8080
    
    Jira Software may take several minutes to load on first start up.
    Finishing installation ...
    $ 
  12. Stop Jira Service

    sudo systemctl stop jira.service
    sudo systemctl status jira.service
    ps -ef| grep -i jira
    sudo kill -9 <JIRA_PID>

    NOTE: Please kill the Jira process to proceed with upgrade, Only If the status of Jira service is in failed state and the Jira process exist from ps command output

  13. Update the Jira server configuration file

    Update the /data/atlassian/jira/conf/server.xml file as similar as the server.xml file in the backup (taken before upgrade)

    sudo diff $HOME/server.xml-bkp-<date> /data/atlassian/jira/conf/server.xml
    vi /data/atlassian/jira/conf/server.xml
  14. Update the Jira environment setup script

    Update the /data/atlassian/jira/bin/setenv.sh file as similar as the setenv.sh file in the backup (taken before upgrade)

    sudo diff $HOME/setenv.sh-bkp-<date> /data/atlassian/jira/bin/setenv.sh
    vi /data/atlassian/jira/bin/setenv.sh
  15. Start Jira Service

    sudo systemctl start jira.service
    sudo systemctl status jira.service
    ps -ef| grep -i jira
  16. Once the Jira service started without any errors, please navigate to the Jira UI Nordix JIRA

    NOTE: It might take 4-6 minutes for the JIRA application to come online to get accessible via UI. Please be patience!

  17. Once you get the Nordix JIRAlogin prompt, use your google authentication method to login to the JIRA

  18. Once logged in, you can view the last upgrade report

    JIRA UI Home -> Settings -> Latest Upgrade Report

  19. That's it! The Nordix JIRA has been running with latest long term supported version of JIRA

Error Handling

  • You may face the JIRA error screen as shown below, once the upgrade completed and JIRA service started, 

  • For DB connectivity errors,

    ping <DB_HOST_IPv4_ADDRESS>
    netstat -anp| grep 5432
    psql -U <USERNAME> -d <DB_NAME> -h <DB_HOST_IPv4_ADDRESS> -p 5432 -c "select * from information_schema.role_table_grants where grantee='<USERNAME>';"
    psql -U <USERNAME> -d <DB_NAME> -h <DB_HOST_IPv4_ADDRESS> -p 5432
    
    If above commands looks fine, kill the jira process and start the jira.service
    ps -ef| grep -i jira
    kill -9 <JIRA_PID>
    sudo systemctl start jira.service
  • For Upgrade custom change erros,

    # Update server configuration file
    sudo diff $HOME/server.xml-bkp-<date> /data/atlassian/jira/conf/server.xml
    vi /data/atlassian/jira/conf/server.xml
    
    # Update JIRA environment setup file
    sudo diff $HOME/setenv.sh-bkp-<date> /data/atlassian/jira/bin/setenv.sh
    vi /data/atlassian/jira/bin/setenv.sh
    
    # Start the JIRA service
    ps -ef| grep -i jira
    kill -9 <JIRA_PID>
    sudo systemctl start jira.service