Get started with Jira Service Management for admins
Your first stop for learning how to get started with Jira Service Management.
Assets Data Manager for Jira Service Management Cloud is currently rolling out in Open Beta and will be available to all Premium + Enterprise sites by end of October 2024.
The Data Manager Clients are two on-prem apps that enable you to run Data Manager locally on your system, schedule automatic job runs, and cleanse and import your data.
The Adapters Client is required to use Data Manager, while the Cleanse and Import Client is highly recommended, as it enables Data Manager to also take Snapshots when cleansing and importing, and retaining historical information about objects.
Before you can select which version of the Data Manager Clients to use, you must first identify which Operating System you are currently running (MacOS, Linux, or Windows/DOS), as well as what type of processor you are currently using.
Follow the instructions below to download and prepare the Data Manager Clients for MacOS:
Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.
Navigate to the Finder App on a Mac (Applications > Utilities > Terminal) to open a command-line interface.
Create a new directory for your Data Manager Clients, copy and unzip the files by typing the following commands (only needed for the first install - not needed if upgrading):
1
2
3
4
mkdir /Users/Shared/assets_data_manager
cd /Users/Shared/assets_data_manager
cp ~/Downloads/data_manager_clients.zip assets_data_manager.zip
unzip data_manager_clients.zip
Within the directory, you should have the following child directories:
linux-arm64
linux-x64
osx-arm64
osx-x64
win-x64
win-x86
From the Apple icon menu, select About This Mac.
Look for the item Chip.
If that item says M1 or M2 or M3, then you have a Mac with Apple Silicon based on the ARM64 architecture. Change the directory to the ARM64 directory by typing the following:
1
cd osx-arm64
If that item says Intel, then you have the x64 chip architecture. Change the directory to the x64 directory by typing the following:
1
cd osx-x64
Test the Data Manager Adapters Client by typing the following (only needed for the first install - not needed if upgrading):
1
2
cd assets-adapters-client
./dm-adapters --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
Test the Data Manager Cleanse and Import Client by typing the following:
1
2
3
cd ..
cd assets-cleanse-and-import-client
./dm-cleanseimport --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
Follow the instructions below to download and prepare the Data Manager Clients for Linux:
Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.
Open a command-line interface by navigating to the Terminal in Linux (Ctrl + Alt + T)
Create a new directory for your Data Manager Clients by typing the following commands:
1
2
3
cd users/shared
mkdir assets_data_manager
cd assets_data_manager
Move the Data Manager Clients into your new directory by typing the following:
1
cp ~/Downloads/data_manager_clients.zip /Users/Shared/assets_data_manager
Unzip the package by typing the following:
1
unzip data_manager_clients.zip
Depending on which version of Linux you are using, you may or may not have the unzip utility installed on your system. You can install it by typing:
1
sudo apt-get install unzip
Within the package you should have the following files:
linux-arm64
linux-x64
osx-arm64
osx-x64
win-x64
win-x86
Open a Terminal in your applications menu or by searching for "Terminal".
Type uname -m and press Enter.
If the output is x86_64, your system is x64. Change the directory to the x64 directory by typing the following (only needed for the first install - not needed if upgrading):
1
cd linux-x64
If the output is aarch64 or similar, your system is ARM64. Change the directory to the ARM64 directory by typing the following:
1
cd linux-arm64
Test the Data Manager Adapters Client by typing the following:
1
2
cd assets-adapters-client
./dm-adapters --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
Test the Data Manager Cleanse and Import Client by typing the following:
1
2
3
cd ..
cd assets-cleanse-and-import-client
./dm-cleanseimport --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
Follow the instructions below to download and prepare the Data Manager Clients for Windows/DOS:
Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.
Open the Command Prompt by typing ⊞ Windows key + X and selecting Windows Terminal (Admin) (for Windows 11) or by typing Ctrl+Shift+P (Windows 10).
Create a new directory for your Data Manager Clients by typing the following commands (only needed for the first install - not needed if upgrading):
1
2
3
cd c:\users\public
mkdir assets_data_manager
cd assets_data_manager
Move the Data Manager Clients into your new directory by typing the following (replace <user_directory> with the appropriate directory where the clients were downloaded:
1
copy c:\users\<user_directory>\downloads\data_manager_clients.zip c:\users\public\assets_data_manager
Unzip the package by using your favorite unzipping utility or Windows Explorer. Within the package you should have the following folders:
1
2
3
4
5
6
linux-arm64
linux-x64
osx-arm64
osx-x64
win-x64
win-x86
Press Win and R to open the Run dialog, type msinfo32, and select OK. Alternatively, you can type system information into the search box and select the result to open this app.
Under the System Summary tab on the left side of the app, locate the System Type section and see if your system is x64 or x86-based.
If your system is x64-based, type:
1
cd win-x64
If your system is x86-based, type:
1
cd win-x86
Test the Data Manager Adapters Client by typing the following:
1
2
cd assets-adapters-client
dm-adapters --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
Test the Data Manager Cleanse and Import Client by typing the following:
1
2
3
cd ..
cd assets-cleanse-and-import-client
dm-cleanseimport --help
The client should run, displaying a list of the different arguments it can use and a picture of a happy train.
The Data Manager Clients in the Atlassian Marketplace are updated periodically to add new features, fix bugs or to better integrate with updated tools.
To update the Data Manager Clients:
Delete the existing version of your Data Manager Clients.
Go to the Atlassian Marketplace and download the latest version of the Data Manager Clients.
Copy the new version of the Data Manager Clients into your assets_data_manager directory and unzip the folder using your favourite unzipping utility.
Test the Data Manager Clients the same way you did after your first install.
Was this helpful?