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 by typing the following commands (only needed for the first install - not needed if upgrading):

   1 2 3 cd users/shared mkdir assets_data_manager cd assets_data_manager

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

6. Within the directory, you should have the following child directories

   1 2 3 4 5 6 linux-arm64 linux-x64 osx-arm64 osx-x64 win-x64 win-x86

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

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

9. 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/1.1.0.6 ./dm-adapters --help

   The client should run, displaying a list of the different arguments it can use and a picture of a happy train.

10. Test the Data Manager Cleanse and Import Client by typing the following:

    1 2 3 4 cd .. cd .. cd assets-cleanse-and-import-client/1.0.0.1 ./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

1. Within the package you should have the following files:

   1 2 3 4 5 6 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/1.1.0.6 ./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 4 cd .. cd .. cd assets-cleanse-and-import-client/1.0.0.1 ./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 terminal 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 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 using your favorite unzipping utility or Windows Explorer. Within the package you should have the following files:

   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. If your system is x64-based, type:

   1 cd win-x64

8. If your system is x86-based, type:

   1 cd win-x86

9. Test the Data Manager Adapters Client by typing the following:

   1 2 cd assets-adapters-client/1.1.0.6 dm-adapters.app --help

   The client should run, displaying a list of the different arguments it can use and a picture of a happy train.

10. Test the Data Manager Cleanse and Import Client by typing the following:

    1 2 3 4 cd .. cd .. cd assets-cleanse-and-import-client/1.0.0.1 dm-cleanseimport.app --help

    The client should run, displaying a list of the different arguments it can use and a picture of a happy train.