jCMDB Asset and Configuration Management Database Technical Guide


jCMDB is an Asset and Configuration Management plug-in which is fully ITIL (IT Infrastructure Library - IT Service Management best practice) compatible.

jCMDB is designed to work on the building blocks of Jira, so it is naturally integrated with Jira’s capabilities. We call it “jCMDB is born in Jira!” so it’s totally native.

Configuring jCMDB

Create a CMDB Project

Firstly, you need to create a JIRA Project to store your CIs (Configuration Items or Assets).

After clicking Create project button, you need to select jCMDB as your project blueprint.

In the next screen, you can click the select button.

This screen is used to give a name to your Asset Database, you can give it any name and key for your project.


Please be aware, creating a jCMDB project may take more than 1 minute and you may see a timeout message but please don't worry, your project will be created successfully in the background. You may just close the project creation dialog and open your project. Immediately you may start to create your CIs.

 Create Your CIs

When you click the Submit button, your asset project will be ready for creating your assets.

If you click Create button from header navigation, you will see issue create screen each Jira issue means a CI (Configuration Item) or Asset. Also, your CI type is an issue type. You can start by choosing your CI type.

There are lots of pre-configured fields for you if you like you may customize your fields from JIRA’s administration screens.

From Create Issue screen, you need to fill the required fields and then you can click Create button. JIRA will create your first CI or asset for you in your jCMDB project.

This is your first CI / Asset record, it’s a JIRA issue in practice. Then we created another CI record in our CMDB database. Now, we have 2 CI (Configuration Item) records.

Asset Relationship

From one of the issues, you may click the MORE button which is located next to Assign button. There will be a list, you will see an option named “Link”. By clicking the “Link” button, you may create relations between your CIs or assets.

There are different link type options on this screen. After selecting your CI (Issue in Jira world) and link type (labeled as This Issue), you can click the Link button to create any relation.

Now, you can see a relation graph at the right bottom of the screen and you can click the “Show bigger” link. That link will open up bigger version of the relation graph which is capable of showing second level relations.

Adding More Asset Types

You may add new issue types from Jira’s administration page if you need custom CI types; https://confluence.atlassian.com/adminjiracloud/adding-editing-and-deleting-an-issue-type-844500747.html

With the Add Issue Type button, you can create your new custom CI (Configuration Item) types.

Customizing Asset Statuses

You may also add new statuses to your workflow and add different workflows to your various types of CIs. https://confluence.atlassian.com/display/AdminJIRAServer072/Working+with+workflows

You can add new statuses for your CIs by clicking the “Add Status” button.

Adding New Attributes to CIs

As we showed in previous screenshots there are lots of preconfigured fields that are ready for use. Of course, you can add more fields to your CIs (Configuration Items) from Jira’s administration pages. https://confluence.atlassian.com/display/AdminJIRAServer071/Adding+a+custom+field

From Custom Fields administration page, you may create new fields with the “Add custom field” button.

In your CI view, there are different types that categorize your fields.

Export & Import CIs

From Issue search screen, you can export your CI’s in CSV format with all fields included.

You can open this CSV file with Microsoft Excel and do your data manipulations in Excel very easily.

If you already have a CSV version of your CI data from your previous tools, you may import them to your JIRA CI DB,

Firstly, you need to open the External System Import page from System Administration and then select CSV badge on this page.

In the next page, you need to select  your CSV Source File and use Advanced option to change your CSV file delimiter depending your CSV delimiter.

Then you need to select your jCMDB project to import your assets. After selecting your project you’ll map your fields to the project’s fields on the next screen.

After the mapping process, you can start to import your projects by clicking the Begin Import button on the next screen.

Then JIRA will import your CIs (Configuration Items) to your CMDB project.

Now you can explore your data on JIRA.