atlassian-tools

Atlassian tools and scripts for Confluence and Jira servers

INSTALL

Install onto the production server.

APP=confluence #set to one of 'confluence' or 'jira'
export QS_GIT_REPO=https://github.com/ncsa/atlassian-tools.git
#export QS_GIT_BRANCH=branch_name  #optional - specify a branch other than main
curl https://raw.githubusercontent.com/andylytical/quickstart/main/quickstart.sh | bash
mkdir -p ~/.config/atlassian-tools/
cp -n ~/atlassian-tools/conf/config.sh-${APP}-sample ~/.config/atlassian-tools/config.sh
ln -s ~/.config/atlassian-tools/config.sh ~/atlassian-tools/conf/

Create a test instance on a clone of prod

Create a copy of prod for testing

1. Prod server:
   1. Install this repo via the instructions above
   2. NOTE: Installer is idempotent (can run multiple times). It will only update old files and will make backups of any files to be replaced.
2. VMware:
   1. Clone the prod server to a test VM
   2. Disconnect the network on the test server
   3. Start the test server
   4. Login as root on the console of the test server
      1. /root/atlassian-tools/bin/go_mk_test_server.sh
      2. /root/atlassian-tools/bin/go_validate_test_server.sh
      3. shutdown -h now
   5. Ensure test VM is powered off
   6. Re-enable the network
   7. Power-on the test VM
3. root@aesculus (only if DB is still remote)
   1. bash /home/aloftus/mk-jira-test-db.sh
4. root@jira-test (or root@wiki-test)
   1. bash /root/atlassian-tools/bin/go_fix_web.sh
   2. /usr/services/jira-standalone/bin/start-jira.sh (OR /usr/services/confluence/bin/start-confluence.sh)
   3. tail -f /usr/services/jira-standalone/logs/catalina.out (OR /usr/services/confluence/logs/catalina.out)

Install / Upgrade Jira

This also works for Confluence, tested Feb 2024.

1. Follow the instructions above to create a test VM cloned from prod
2. Clone this repo to a local machine
3. cd atlassian-tools/install-upgrade
4. Download the latest atlassian installer into the appropriate directory (ie: 'confluence/' or 'jira/')
5. ./01_push_installer_files.sh <target-host> <APP>
   1. ... where <APP> is one of confluence or jira
6. SSH to the target host, escalate to root
   1. For Install: /home/<USER>/<APP>/02_installer.sh
      1. Note: 02_installer.sh will pick the latest installer version found in the directory unless a filename is specified on the cmdline.
      2. Note: The installer will read the install config from response.varfile
      3. Note: Use -h for more help
   2. For Upgrade:
      1. Run the installer file manually, choose option 3 (upgrade)
      2. Restore the server.xml file:
         1. /home/<USER>/<APP>/02_installer.sh -c