Objective:

Get approval from Atlassain for submitting the Add-on as Data-center approved in the Atlassain marketplace. 

Introduction:

Atlassian has introduced new requirements for vendors who want to publish Data Center approved apps in Atlassian Marketplace. In order to get the Add-on approved on the Atlassain Marketplace, the below tasks has to be completed:

1. Complete a technical readiness checklist
2. Test your app and document the results
3. Provide support escalation details
4. Create your Marketplace submission

Test Implementation Steps:

Step1 : Complete a technical readiness checklist

The Data Center App Readiness Checklist is a comprehensive set of questions related to Data Center App design specifically for a multi-node environment.

Each app should have its own associated checklist. If app works with multiple products (e.g. both Jira and Confluence), there should be a checklist for each compatible product. The checklist covers an extensive range of questions about how your app utilizes certain features within the Data Center products.

The checklist has to be filled before and submitted as part of the approval process for the Add-on.

Technical readiness Checklist

Reference link for the checklist: https://developer.atlassian.com/platform/marketplace/dc-apps-submitting-your-app/

Step 2: Test your app and document the results

Completed the performance and scale testing of your add-on as listed below:

• Detail your application testing for the deployment of your application in multiple Data Center nodes,
• Detail the validation steps you take to ensure data is consistent in your application across multiple Data Center nodes,
• Detail your application testing for the installation and upgrade of your application in a mutli node Data Center deployment, and
• Detail any user testing steps you take to ensure features work in standard Data Center multi node deployment (such as our AWS deployments).

For Enhanced User profile the Testing was done on the AWS. The Jira data-center was deployed and tested with various nodes (1, 2 & 4) for the below actions. The test results are noted for the below scenarios

1. Performance and Scale test results without Add-on for 1 node.
2. Performance and Scale test results with Add-on for 1 node.
3. Performance and Scale test results with Add-on for 2 nodes.
4. Performance and Scale test results with Add-on for 4 nodes.

Step 3: Provide support escalation details

To facilitate quick resolution to any issues or impacts on the App, Atlassain recommends below activities (Service desk portal and responsible contact person).  

• a clear escalation process for your customers available to Data Center licensed apps,
• defining a single point of contact (which can be a mailing list) to raise escalations with,
• to maintain the owner of the app contact in the DCHELP ticket, and
• letting Atlassain know if you have an SLA with customers on Data Center licensed apps

Step 4: Create your Marketplace submission

Once steps 1-3 are completed and the approval on the technical review of your app is received, we can submit the app to Marketplace. Before uploading the Add-on in Marketplace we have the add the Data-Center compatibility descriptor in the Add-on as shown below.

Add Data Center compatibility to your add-on descriptor

<plugin-info>
    <description>${project.description}</description>
    <version>${project.version}</version>
    <vendor name="${project.organization.name}" url="${project.organization.url}" />
    <param name="atlassian-data-center-status">compatible</param>
    <param name="atlassian-data-center-compatible">true</param>
</plugin-info>
Note:If the app is an OBR artifact with bundled dependencies, the above parameters should be included in both the main app descriptor as well as the descriptors for any dependencies.

Tools used:

J-Meter tool is used in automating the performance and scaling tests. The scripts and the actions included in the tests are listed below.

AWS Jira data-center is used  as the infrastructure to carryout the testing of the Add-ons. The template used is attached. The template has been modified to work on N-Virginia AWS region.

Test-kit for testing and provisions Jira instance in AWS: https://developer.atlassian.com/platform/marketplace/dc-apps-performance-toolkit-user-guide-jira/

Timing Plan for Enhanced User profile Add-on Testing:

Reference links: 

• Data-Center Monitoring documentation
  • https://confluence.atlassian.com/enterprise/getting-started-with-data-center-monitoring-946040846.html
• JConsole Monitoring
  • https://confluence.atlassian.com/adminjiraserver/live-monitoring-using-the-jmx-interface-939707304.html
  • https://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html
• Monitoring Application & database connection usage in Jira
  
  • https://confluence.atlassian.com/adminjiraserver/monitoring-database-connection-usage-938847726.html
  • https://confluence.atlassian.com/adminjiraserver/viewing-jira-application-instrumentation-statistics-938847729.html
• Performance and Scale testing Sample
  • https://confluence.atlassian.com/adminjiraserver/performance-and-scale-testing-965568707.html#Performanceandscaletesting-methodology
• Jira Data generator
  • https://marketplace.atlassian.com/apps/1210725/data-generator-for-jira?hosting=server&tab=overview