|
@@ -10,9 +10,6 @@
|
|
|
- DB Config in `/opt/jira-data/jira/dbconfig.xml`
|
|
|
- Attachments in `/opt/jira/data/jira/attachments`
|
|
|
|
|
|
-# Upgrading
|
|
|
-
|
|
|
-A salt state can be used for upgrading. See `msoc-infrastructure/salt/fileroots/jira/README.md` for details.
|
|
|
|
|
|
# TLS Setup for RDS
|
|
|
|
|
@@ -466,3 +463,39 @@ sudo mv jre-11.0.1+9 jre
|
|
|
sudo /etc/rc.d/init.d/jira start
|
|
|
```
|
|
|
|
|
|
+# Upgrading
|
|
|
+
|
|
|
+A salt state can be used for upgrading. See `msoc-infrastructure/salt/fileroots/jira/`.
|
|
|
+
|
|
|
+## Staging the Update
|
|
|
+
|
|
|
+The state will install the update into a new directory (/opt/atlassian/jira-{version}), but will not stop/start it. You should be able to safely run this at any time (still, follow best practices: make backups first, run salt with `test=true`).
|
|
|
+
|
|
|
+1. download the latest LTS from https://www.atlassian.com/software/jira/download-journey. Download in .tar.gz
|
|
|
+1. Copy to afsxdr-binaries:
|
|
|
+```
|
|
|
+aws --profile mdr-common-services-gov s3 cp atlassian-jira-software-8.13.10.tar.gz s3://afsxdr-binaries/jira/atlassian-jira-software-8.13.10.tar.gz
|
|
|
+```
|
|
|
+1. update init.sls with the latest version
|
|
|
+1. Optionally, update the `okta_jar` using the same steps as above (download from okta admin, downloads).
|
|
|
+1. Run the state.
|
|
|
+
|
|
|
+## Cutover
|
|
|
+
|
|
|
+This file does not change to the new version.
|
|
|
+
|
|
|
+To cut over:
|
|
|
+
|
|
|
+1. Judiciously remove older files in /opt/jira-data/jira/export
|
|
|
+1. Create backups of jira and jira-data
|
|
|
+1. Run `sudo systemctl stop jira`
|
|
|
+1. Edit `/etc/init.d/jira`
|
|
|
+1. Change the path to the updated jira version
|
|
|
+1. `sudo systemctl daemon-reload`
|
|
|
+1. Run `sudo systemctl start jira && sudo tail -F /opt/atlassian/jira-8.13.8/logs/catalina.out`
|
|
|
+
|
|
|
+You may have to restart jira a second time if it warns about files that weren't updated (they really were!).
|
|
|
+
|
|
|
+## Java Updates
|
|
|
+
|
|
|
+No support in this state yet for updating/installing the JRE. See `infrasstructure-notes/Jira\ Notes.md` for detailed steps, or quick reference:
|