Set up the Data Manager clients for Assets

Note that you can use a cloud-enabled data source where neither of the Data Manager clients are required if only using cloud-enabled data sources.

The Data Manager clients are two middleware apps that enable you to:

• run Data Manager locally on your system

• schedule automatic job runs

• cleanse and merge your data

• The Adapters client is required to use Data Manager.

• The Cleanse and Import client is highly recommended, as it allows Data Manager to take snapshots when cleansing and merging, retaining historical information about objects.

Before choosing a client version, identify:

• your operating system (macOS, Linux, or Windows/DOS)

• your CPU architecture (x64 or ARM64)

Set up the Data Manager clients for macOS

1. Download the Data Manager clients from the Atlassian Marketplace (data_manager_clients.zip).

2. Open Terminal (Applications > Utilities > Terminal).

3. Create a directory, copy, and unzip:

   mkdir /Users/Shared/assets_data_manager cd /Users/Shared/assets_data_manager cp ~/Downloads/data_manager_clients.zip /Users/Shared/assets_data_manager unzip data_manager_clients.zip

4. You should now see:

   • linux-arm64

   • linux-x64

   • osx-arm64

   • osx-x64

   • win-x64

   • win-x86

5. From the Apple menu, select About This Mac and check Chip:

   • If it says M1, M2, or M3 → ARM64:

     cd osx-arm64

   • If it says Intel → x64:

     cd osx-x64

6. Test the Adapters client:

   cd assets-adapters-client ./dm-adapters --help

7. Test the Cleanse and Import client:

   cd .. cd assets-cleanse-and-import-client ./dm-cleanseimport --help

Both commands should show help text and usage options.

Set up the Data Manager clients for Linux

1. Download data_manager_clients.zip from the Atlassian Marketplace.

2. Open Terminal (for example, Ctrl + Alt + T).

3. Create a directory and move the ZIP:

   cd /users/shared mkdir assets_data_manager cd assets_data_manager cp ~/Downloads/data_manager_clients.zip /Users/Shared/assets_data_manager

4. Unzip:

   unzip data_manager_clients.zip

   If unzip is not installed:

   sudo apt-get install unzip

5. You should see:

   • linux-arm64

   • linux-x64

   • osx-arm64

   • osx-x64

   • win-x64

   • win-x86

6. Identify CPU type:

   uname -m

   • x86_64 → x64:

     cd linux-x64

   • aarch64 or similar → ARM64:

     cd linux-arm64

7. Test the Adapters client:

   cd assets-adapters-client ./dm-adapters --help

8. Test the Cleanse and Import client:

   cd .. cd assets-cleanse-and-import-client ./dm-cleanseimport --help

Set up the Data Manager clients for Windows/DOS

1. Download data_manager_clients.zip from the Atlassian Marketplace.

2. Open an elevated Windows Terminal or Command Prompt (for example, Windows key + X, choose Windows Terminal (Admin)).

3. Create a directory:

   cd c:\users\public mkdir assets_data_manager cd assets_data_manager

4. Copy the ZIP (replace <user_directory>):

   copy c:\users\<user_directory>\downloads\data_manager_clients.zip c:\users\public\assets_data_manager

5. Unzip using Windows Explorer or another utility. You should see:

   • linux-arm64

   • linux-x64

   • osx-arm64

   • osx-x64

   • win-x64

   • win-x86

6. Identify CPU type:

   • Press Win + R → msinfo32.

   • Under System Summary, check System Type:

     • x64‑based PC → x64: cd win-x64

     • x86‑based PC → x86: cd win-x86

7. Test the Adapters client:

   cd assets-adapters-client dm-adapters --help

8. Test the Cleanse and Import client:

   cd .. cd assets-cleanse-and-import-client dm-cleanseimport --help

Update the Data Manager clients

To update:

1. Delete the existing Data Manager client directories.

2. Download the latest data_manager_clients.zip from the Atlassian Marketplace.

3. Copy and unzip into your assets_data_manager directory.

4. Re‑run the --help commands above to confirm the new version.