Date: Thu, 28 Mar 2024 18:41:54 +0000 (UTC) Message-ID: <297305982.813.1711651314598@c4e992b7d277> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_812_457186767.1711651314598" ------=_Part_812_457186767.1711651314598 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
The following describes th= e current infrastructure setup and the steps to upgrade the Nordix Jira.
The Nordix JIRA= is installed and configured as a service on the Ubuntu operating system
The PostgreSQL 10 database ha= s been installed and configured as the back end for the Nordix JIRA=
The /data <=
/code>is the filesystem where &n=
bsp;Nordix JIRA application & database files are hosted
/data/atlassian/jira/conf/server.xml
is the server co=
nfiguration file for Nordix J=
IRA/data/atlassian/application-data/jira/dbconfig.xml
is=
the DB configuration file for <=
a class=3D"external-link" href=3D"https://jira.nordix.org/" rel=3D"nofollow=
">Nordix JIRAThe nginx reverse proxy has b= een configured with letsencrypt certificate to enable SSL based = Nordix JIRA access on port 443
The following is the list of user = installed Jira applications,
Currently the Nordix Wiki is the only applicati= on link has been configured in Nordix JIRA
The JIRA Server startup logs are l=
ocated in /data/atlassian/jira/logs/catalina.out
=
p>
JIRA was successfully upgraded to version 8.11.1 on 19/Aug/20 at 8:32 PM= .
The plan your upgrade option in th=
e JIRA settings will check and recommend the latest available JIRA versions=
for upgrade. Its always better to go with longterm suppo=
rted
version.
JIRA UI Home -> Settings -> = Applications -> Plan your Upgrade
The Nordix Jira is currently runni=
ng with 8.11.1
version. As recommended by the Atlassian upgrade plan, Jira 8.13.4
is the lates=
t long term supported version
C= heck and Download the installer for the image JIRA-8.13.4
wget ht= tps://product-downloads.atlassian.com/software/jira/downloads/atlassian-jir= a-software-8.13.4-x64.bin -O /tmp/atlassian-jira-software-8.13.4-x64.bin
=
<= span style=3D"color: rgb(23,43,77);">= Run user-installed apps compatible check against the target Jira version 8.= 13.4
Jira UI Home -> Settings -> = ATLASSIAN MARKETPLACE -> Manage apps -> JIRA update ch= eck -> Select the target version "8.13.4" -> Check <= /p>
<= span style=3D"color: rgb(23,43,77);">= Stop Jira Service
sudo sy= stemctl 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 ex= ist from ps command output
<= span style=3D"color: rgb(23,43,77);">= Stop PostgreSQL DB service
sudo sy= stemctl stop postgresql.service sudo systemctl status postgresql.service
<= span style=3D"color: rgb(23,43,77);">= Backup data, including database, installation directory, and home directory=
cd /dat= a sudo tar -czvf jira-data-bkp-<DATE>.tar.gz atlassian downloads postgr= esql lost+found
<= span style=3D"color: rgb(23,43,77);">= 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= >
<= span style=3D"color: rgb(23,43,77);">= Start PostgreSQL DB service
sudo sy= stemctl start postgresql.service sudo systemctl status postgresql.service
<= span style=3D"color: rgb(23,43,77);">= Update installer permissions
sudo ch= mod a+x /tmp/atlassian-jira-software-8.13.4-x64.bin
<= span style=3D"color: rgb(23,43,77);">= 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 inst= allation 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 o= f 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: =09conf/server.xml Removed files: =09(none) Added files: =09(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 pro= ceed? 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) tha= t must be manually transferred. Refer to our documentation more information: http://docs.atlassian.com/jira/jadm-docs-0813/Upgrading+JIRA+applications+m= anually#UpgradingJIRAapplicationsmanually-configuringnewjiraasold3.4Migrate= yourexistingJIRAconfigurationsovertoyournewJIRAinstallation 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 ... $
<= span style=3D"color: rgb(23,43,77);">= Stop Jira Service
sudo sy= stemctl 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 ex= ist from ps command output
Update the Jira server configuration fi= le
Update the /data/atlassian/jira/conf/server.xml file as similar as the s= erver.xml file in the backup (taken before upgrade)
sudo di= ff $HOME/server.xml-bkp-<date> /data/atlassian/jira/conf/server.xml vi /data/atlassian/jira/conf/server.xml
Update the Jira environment setup scrip= t
Update the /data/atlassian/jira/bin/setenv.sh file as similar as the set= env.sh file in the backup (taken before upgrade)
sudo di= ff $HOME/setenv.sh-bkp-<date> /data/atlassian/jira/bin/setenv.sh vi /data/atlassian/jira/bin/setenv.sh
<= span style=3D"color: rgb(23,43,77);">= Start Jira Service
sudo sy= stemctl start jira.service sudo systemctl status jira.service ps -ef| grep -i jira
O= nce the Jira service started without any errors, please navigate to the Jir= a UI Nordix JIRA
NOTE: It might take 4-6 minutes fo= r the JIRA application to come online to get accessible via UI. Please be&n= bsp;patience!
O= nce you get the Nordix JIRAlogin prompt, use your google authentication method to login to th= e JIRA
O= nce logged in, you can view the last upgrade report
JIRA UI Home -> Settings -> = Latest Upgrade Report
Y= ou may face the JIRA error screen as shown below, once the upgrade complete= d and JIRA service started,
F= or DB connectivity errors,
ping &l= t;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 grant= ee=3D'<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.serv= ice ps -ef| grep -i jira kill -9 <JIRA_PID> sudo systemctl start jira.service
F= or Upgrade custom change erros,
# Updat= e server configuration file sudo diff $HOME/server.xml-bkp-<date> /data/atlassian/jira/conf/serve= r.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