Jira (self-managed) Integration
Atlassian Server is in the process of being discontinued and the future of self-managed products is via the Atlassian Data Center.
Integration Prerequisites
To use the self-hosted Device42-Jira integration, users must have:
- A running Device42 virtual appliance, populated with configuration items (CIs) to sync to Jira.
- A properly configured self-hosted Jira instance with administrator access.
*If you are looking to integrate Device42 with Jira Service Management and/or Jira Cloud, see the Device42-Jira Service Management/Cloud integration page.
Device42-jira Self-hosted Integration Features
The Device42-Jira integration offers users the following functionality:
- Synchronize select Device42 data with Jira, automatically (and/or manually)
- Attach configuration items synced from Device42 to Jira issues
- Search for Jira issues relating to a Device42 CI(s) and/or CI data
- Create custom fields and apply them to specific projects, create custom field sets, and populate custom fields using built-in stackable filters to create a customized set of Device42 CIs.
- Store filter templates for the fast future usage
- Automate common IT workflow with validators and conditional functions, based on the Device42 custom field values
- Automatically request the next free IP address on a subnet, and acquire it when an issue transitions
Install the Device42-Jira App
The Device42 - CMDB with REST APIs for Jira app is the part of Atlassian Marketplace, so you can easily install it using the Universal Plugin Manager (UPM). The app's search capability is provided by Jira from the Jira search box.
If you have some specific environment that blocks Jira from accessing the internet, you can install Device42 plugin manually. Download the latest version of the app from this Atlassian Marketplace link. Or copy and paste the following URL into your browser:
https://marketplace.atlassian.com/apps/1213601/device42-cmdb-with-rest-apis-for-jira?tab=overviewhttps://marketplace.atlassian.com/apps/1213601/device42-cmdb-with-rest-apis-for-jira?tab=overviewhosting=datacenter
Please note that the app requires a stable connection between the server hosting your Jira application instance, and your Device42 application instance to operate properly.
Automatic Installation
To install the app from your Jira instance:
-
Log in as a user with the 'Jira System Administrators' global permission.
-
From the Jira administration console, select the Manage apps option and in the left panel, click on Find new apps.
-
Type device42 in the search bar and press Enter.
-
Find the Device42 - CMDB with REST APIs for Jira app and click its Install button.
-
A confirmation message appears when the app is successfully installed. You can now manage the app from the Manage apps tab.
Manual Installation
To manually install the app to your Jira instance:
-
Go to the Atlassian Marketplace and lick on the Get it now button to download the
.jar
file of the latest version of the app. If you don't have an internet connection available (i.e. a secured sandbox environment), you can download the.jar
file on a network with internet access, and transfer it via a USB thumb drive or other external media. -
Log in with Jira administrator access and click on the Manage Apps tab, and select the Manage apps from the left panel.
-
Click on the Upload app link at the top right side of the page. The following dialog appears:
-
Click on the Choose file button to open file browser and select the
.jar
file you downloaded from the Atlassian Marketplace. -
Click on the Upload button. When the app has been successfully installed, a confirmation notice will appear.
You can now manage the app from the user installed app list from the Manage apps tab.
Configure the Integration
A brand new installation of the app requires the following initial configuration steps from your Jira instance:
-
After the app has been successfully installed, click on the Configure link to setup connection to your Device42 instance.
-
Enter your Device42 Base URL, Username, and Password and click on the Save button.
-
If the connection is successful, you will see the saved details on the configuration view screen.
Edit the Connection Settings
To edit the connection settings:
-
Log in as a user with 'Jira Administrators' global permission.
-
Use the shortcut to navigate to the Device42 Connection page. Press g twice and type Device42 into the search bar. Select the Device42 Connection option. Alternatively, click on the Manage apps tab and select the Device42 Connection option from the left sidebar.
-
Click on the pencil icon to the right to open the connection information form for editing.
Manual Synchronization
The data from the Device42 instance is cached inside the internal Jira database. To ensure it is up-to-date, it should be periodically synchronized. Manually perform an immediate synchronization as follows:
-
On the configuration information page, click on the Update Data button.
-
A confirmation dialog will appear; click on the Update Data button to confirm.
-
You will see the initial collection statistics data. For a manual scan, you will see the warning message that scan is pending to be started that is shown for about 15 seconds.
-
Click on the Refresh button. Under Collection results you can see a progress bar for the entire scan and below that selection, under the Status column, you can view the sync progress of individual CIs.
-
If you wish to stop current scan you, click the Abort button, tick the I agree checkbox and select Abort to confirm. Please note, that the currently scanned Configuration Item list will be synchronized partially.
-
After the synchronization is complete, the warning message will disappear and the status of individual CIs will be listed as Done.