Maintaining Jira Customizations

Hi,
We are using Jira 6.0 and we have done some customizations in the installed instance according to our needs, which have resulted in updates in some of the files in installation directory like .vm files etc.
In order to improve the maintenance, we are looking forward to maintain a history of changes in source control. We are using Perforce as our source code repository.
We need your advice in this. We want to know, how should proceed? 
Should we add the complete (actual) installation directory in Perforce as a workspace and maintain the changes from there? OR 
Should we add in Perforce only those original files and there updates which are changed?

Regards,
Zeeshan

2 answers

0 vote
Joe Pitt Community Champion Feb 13, 2015

I'm not familiar with Perforce. However, you need to keep track of what you changed in such a way that if Atlassian changes their directory structure you'll still be able to figure out where your changes will need to go. There is always the possibility you'll need to rewrite your modification.

Hey Zeeshan,

as Joe already stated, it can always happen that Atlassian changes not only the directory structure and the location of files but also the content and structure of it.
While I agree that it's very valuable to track and document the customizations, I think it should be done in a flexible way if it is supposed to be future-proof.
The downside of the Perforce way could be (depending on the approach) that it's hard to apply the customizations to files that changed significantly (e.g. Atlassian adding some more content to a .vm-file which didn't exist in the version you have in your Perforce).
Depending on how many changes you have and especially for UI changes it would make sense to document them extensively in Confluence or any other Knowledge base, giving as much information necessary for a human being to re-apply them after an update with least effort. This can include things like filename, path, code-snipped, position in the source-code.

Despite this, there are of course files that are usually safe to be stored in a VCS like JIRA's config folder with server.xml.

I hope I could provide some valuable input for your mission.

Regards,
Philipp

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,233 views 14 19
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot