Getint Jira Server / Jira Data Center App (native)

Introduction to Getint.io Native Apps for Jira Server and Jira Data Center

In December 2022, we proudly launched our first "native" applications for Jira Server and Jira Data Center. Developed using the Atlassian Plugins SDK, these apps integrate seamlessly within your Jira environment, alongside other applications. They are designed to facilitate comprehensive integration and synchronization between Jira and various collaboration software tools such as ServiceNow, Azure DevOps, Asana, Monday.com, GitLab, and more.

Installation Guide

1. Log in with Administrator credentials and navigate to the 'Manage Apps' section in your Jira instance.

1. Search for our integration apps, selecting the one that suits your needs (e.g., Azure DevOps Jira integration), and initiate the Free Trial.

1. After installation, access 'Manage Apps' from the left sidebar to ensure a valid license is active for the newly installed app.

2. Post-installation, a Getint section will appear on the left vertical menu. Clicking on this link will direct you to the app’s dedicated page, where you can begin creating your integrations.

You will be navigated to a dedicated page of the app.

You can start building your integrations!

Starting the synchronisation

Immediately after installation, the app initiates a scheduled job responsible for executing integrations and performing data cleanups.

Jira Data Center Consideration: For instances running on more than one node, a cluster lock ensures Getint operates on a single node at a time.

App Data and Database

Getint stores configuration details and synced item information within the database. It also generates detailed log files for each sync, aiding in error analysis and support. The app creates several tables for storing data, including configurations, syncs, runs, and error logs.

Database

Getint creates the following tables to store configuration details and data related to synchronization processes:

• getint_connections

• getint_integrations

• getint_runs

• getint_syncs

• getint_steps

• getint_artifacts

• getint_per_artifacts

• getint_syncs_errors

• getint_tenant_info

Log files

Logs capture valuable details on the actions undertaken to synchronize specific items. The directory for these logs is located at:

• If the JIRA_HOME directory includes a log directory, a 'getint' directory will be created within it.

• If the JIRA_HOME directory lacks a log directory, the 'getint' directory will be directly created within the JIRA_HOME directory.

Clean up

Each integration run is meticulously recorded in the database and accompanied by a log file. With numerous integrations potentially executing hundreds of times daily, this can lead to an accumulation of extensive files and database records. Getint.io offers a solution to manage this data efficiently by allowing users to specify a retention period for these records.

To set a data retention limit, follow these three steps:

1. Navigate to the Settings page via the main menu.

2. Enter the desired maximum number of days for data retention.

3. Confirm your settings by clicking 'Save'.

After defining the retention period, a scheduled cleanup task will automatically run every 8 hours to remove outdated data, ensuring your system remains efficient and clutter-free. Please note, the initiation of the first cleanup might be delayed following the setup.

Differences in features

The native apps for Jira Server/Data Center currently do not support a few features that are available in other versions. These include:

• Bulk Resynchronization

• Advanced Scripting Capabilities

• Preview of Background Job Status

• Notifications

Integration Interval Configuration

The integration interval for Server/Data Center apps, as specified in the settings, represents the intended frequency for integration executions. However, the actual scheduling of these integration jobs is managed by Jira's internal logic, which determines when the jobs are permitted to run. Consequently, the practical interval between integration runs may exceed the predefined settings.

Testing Recommendations

It's best practice to conduct testing in a development or local environment rather than directly in a production setting. To facilitate this, you have the option to download Jira and install it on a temporary machine or your personal computer. Alternatively, a dockerized version of Jira is available at https://hub.docker.com/r/atlassian/jira-software. For licensing during setup, Timebomb licenses can be utilized, accessible at https://developer.atlassian.com/platform/marketplace/timebomb-licenses-for-testing-server-apps, simplifying the entire setup process.

Uninstall

Upon uninstallation, Getint will halt all scheduled jobs, stopping further synchronizations. However, log files generated during the app's operation will remain intact.

This guide aims to streamline the installation, operation, and management of Getint native apps within your Jira Server or Data Center environment, ensuring a smooth integration process with other collaboration tools.