浏览代码

Moved Jira Upgrade notes to here, where they belong

Fred Damstra [afs macbook] 3 年之前
父节点
当前提交
3b4df41a25
共有 1 个文件被更改,包括 36 次插入3 次删除
  1. 36 3
      Jira Notes.md

+ 36 - 3
Jira Notes.md

@@ -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: