• Get started
  • Documentation

Set up the Data Manager Clients for Assets

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.

Set up the Data Manager Clients for MacOS

Follow the instructions below to download and prepare the Data Manager Clients for MacOS:

  1. Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.

  2. Navigate to the Finder App on a Mac (Applications > Utilities > Terminal) to open a command-line interface.

  3. 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
  4. Within the directory, you should have the following child directories:
    linux-arm64

    linux-x64

    osx-arm64

    osx-x64

    win-x64

    win-x86

  5. From the Apple icon menu, select About This Mac.

  6. Look for the item Chip.

    1. 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
    2. 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
  7. 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.

  8. 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.

Set up the Data Manager Clients for Linux

Follow the instructions below to download and prepare the Data Manager Clients for Linux:

  1. Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.

  2. Open a command-line interface by navigating to the Terminal in Linux (Ctrl + Alt + T)

  3. 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
  4. 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
  5. 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
  1. Within the package you should have the following files:
    linux-arm64

    linux-x64

    osx-arm64

    osx-x64

    win-x64

    win-x86

  2. Open a Terminal in your applications menu or by searching for "Terminal".

  3. Type uname -m and press Enter.

  4. 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
  5. 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.

  6. 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.

Set up the Data Manager Clients for Windows/DOS

Follow the instructions below to download and prepare the Data Manager Clients for Windows/DOS:

  1. Go to the Atlassian Marketplace and download the Data Manager Clients. The file you download will be called data_manager_clients.zip.

  2. 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).

  3. 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
  4. 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
  5. 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
  6. 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.

  7. 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.

    1. If your system is x64-based, type:

      1 cd win-x64

      If your system is x86-based, type:

      1 cd win-x86

       

  8. 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.

  9. 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.

Updating the Data Manager Clients

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:

  1. Delete the existing version of your Data Manager Clients.

  2. Go to the Atlassian Marketplace and download the latest version of the Data Manager Clients.

  3. Copy the new version of the Data Manager Clients into your assets_data_manager directory and unzip the folder using your favourite unzipping utility.

  4. Test the Data Manager Clients the same way you did after your first install.

Still need help?

The Atlassian Community is here for you.