Upgrading an Atlassian application can be a scary undertaking. But, getting new features and better performance brings opportunity for growth and improvement. Face your fears with Jennifer van Leeuwen, Priority Support Engineer at Atlassian. Learn how to best prepare your organization and environment for a successful upgrade and walk away with a list of steps that will ensure your next upgrade goes off without a hitch.

1. JENNIFER VAN LEEUWEN | PRIORITY SUPPORT ENGINEER | ATLASSIAN
A little prep goes a long way
Planning your next Jira Server upgrade

2. The Æsop for Children, Library of Congress
The Ants & the Grasshopper

3. Grasshopper

4. AntGrasshopper

5. Research Practice Test Execute
Preparing for an upgrade

6. WHY UPGRADE?
“Faster
performance!”
“Updated Java!"
“New JQL options!”

7. WHY UPGRADE?
“Faster
performance!”
“Updated Java!"
“New JQL options!”

8. WHY UPGRADE?
“Faster
performance!”
“Updated Java!"
“New JQL options!”

9. Research Practice Test Execute
Preparing for an upgrade

10. Seek first to
understand

11. Seek first to
understand
“Goals?”

12. Seek first to
understand
“Stakeholders?”

13. Seek first to
understand
“Milestones?”

14. Seek first to
understand
“Road blocks?”

20. v7.x.x ??
v8.x.x ??

21. ENTERPRISE RELEASE
7.13.latest

22. Upgrade Matrix Release Notes Technical
Upgrade Notes
Supported
Platforms
Research resources

23. Upgrade Matrix Release Notes Technical
Upgrade Notes
Supported
Platforms
Research resources

24. JIRA.ATLASSIAN.COM IMPROVEMENTS - NEW DASHBOARDS

25. Apps
What Else?
CustomizationsInfrastructure

26. Apps
What Else?
CustomizationsInfrastructure

27. Apps
What Else?
CustomizationsInfrastructure

28. INSTALLER MANUAL
• in-place
• install wizard
• overwrites existing files
• migrates some
• migrate
• manual file modification
• original files retained
• migrates none

29. • migrate
• manual file modification
• original files retained
• migrates none
• in-place
• install wizard
• overwrites existing files
• migrates some
INSTALLER MANUAL

30. • in-place
• install wizard
• overwrites existing files
• migrates some
INSTALLER MANUAL
• in-place
• install wizard
• original files retained
• migrates none

31. INSTALLER MANUAL
• in-place
• install wizard
• overwrites existing files
• migrates some
• in-place
• install wizard
• original files retained
• migrates none

32. Cut over or quickly roll back
FALLBACK METHOD
PROD DB
PROD JIRA
PROXY

33. Cut over or quickly roll back
FALLBACK METHOD
PROD DB NEW DB
PROD JIRA NEW JIRA
PROXY

34. Data Center ZDU
Fall back method
Zero
Downtime?

35. Data Center ZDU
Fall back method
Zero
Downtime?

36. Research Practice Test Execute
Preparing for an upgrade

37. Create
staging
PRACTICE
Upgrade
Staging
Test
Run book
PLAN
UNDERSTANDCreate run book
Test
Staging
Modify
Run book

38. Infrastructure Database Apps Customizations
What should be replicated?

39. AWS VM Snapshots
Simplify with snapshots

40. Steps to create a staging server
Copy Database Modify Configuration Files
Copy Jira Installation
Directory
Copy Jira Home

41. COPY DATABASE XML IMPORT

42. <jdbc-datasource>
<url>jdbc:postgresql://
yourdbserver:port/dbname</url>
<username>yourdbuser</username>
<password>yourdbpassword</password>
</jdbc-datasource>
</jira-database-config>
Config
dbconfig.xml
jira-application
setenv.sh/.bat
server.xml

43. # Do not modify this file unless instructed.
It is here to store the location of the JIRA
home directory only and is typically written
to by the installer.
jira.home =<pathtostaginghome>
Config
dbconfig.xml
jira-application
setenv.sh/.bat
server.xml

44. -Datlassian.notifications.disabled=true
-Datlassian.mail.senddisabled=true
-Datlassian.mail.fetchdisabled=true
-Datlassian.mail.popdisabled=true
Config
dbconfig.xml
jira-application
setenv.sh/.bat
server.xml

45. <Connector port="8792" maxThreads=“150"
…
proxyName="<subdomain>.<domain>.com"
proxyPort="80"/>
Config
dbconfig.xml
jira-application
setenv.sh/.bat
server.xml

47. Upgrade staging

48. Research Practice Test Execute
Preparing for an upgrade

49. Get help
SupportDocumentation Community

50. Road blocks
Upgrade run book
SolutionsBlueprint

51. PRACTICE
Test
run book
PLAN
UNDERSTANDCreate run book
Modify
run book
PRACTICE

52. Research Practice Test Execute
Preparing for an upgrade

53. Whew, I'm glad that's
over; since it was long.
The test environment
setup was definitely key
to pulling it off within one
day.
- Anonymous Ant

54. JENNIFER VAN LEEUWEN | PRIORITY SUPPORT ENGINEER | ATLASSIAN
Thank you!