Set up the Data Manager Clients for Assets

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:

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.