Deploying Cloudera Migration Assistant locally or with Docker

Learn more about how to deploy Cloudera Migration Assistant locally and in docker with or without internet connection.

  1. Download the binaries of the Cloudera Migration Assistant tool from https://archive.cloudera.com/cma/3.4/tars/ with one of the following commands:
    • wget https://archive.cloudera.com/cma/3.4/tars/cma-3.4.1.0-12-bin.tar.gz
    • curl https://archive.cloudera.com/cma/3.4/tars/cma-3.4.1.0-12-bin.tar.gz
    • mkdir cma-3.4
      cd cma-3.4
      wget https://archive.cloudera.com/cma/3.4/tars/cma-3.4.1.0-12-bin.tar.gz
      wget https://archive.cloudera.com/cma/3.4/tars/cma-extras-gpl-3.4.1.0-12-bin.tar.gz-bin.tar.gz
    • mkdir cma-3.4
      cd cma-3.4
      curl https://archive.cloudera.com/cma/3.4/tars/cma-3.4.1.0-12-bin.tar.gz
      curl https://archive.cloudera.com/cma/3.4/tars/cma-extras-gpl-3.4.1.0-12-bin.tar.gz-bin.tar.gz
    When the required binaries are downloaded successfully, the directory structure should look like the following example:
    drwxr-xr-x 14 testuser testuser 4096 febr 27 13:21 cma-3.4.0.0-38/
    -rw-rw-r-- 1 testuser testuser 518140466 febr 27 13:28 cma-3.4.1.0-12-bin.tar.gz
    -rw-rw-r-- 1 testuser testuser 85089637 febr 27 13:28 cma-extras-gpl-3.4.0.0-38.tar.gz
    The supported version of Cloudera Migration Assistant is 2.8.0 and higher.
  2. Extract the downloaded file using the following command:
    tar xzf cma-3.4.1.0-12-bin.tar.gz
  3. Start the Cloudera Migration Assistant server locally or in a Docker container. The preferred method is the Docker mode.
    Ensure that Python 3.8.12 or a higher version is installed on the host. In case you do not define the python executable when running the script, you will be prompted to enter the python executable path.
    • Docker
      Run the cma-docker.sh script in the untarred top-level folder to launch the Cloudera Migration Assistant server in a Docker container. cma-[***VERSION NUMBER***]/bin/cma-docker.sh --start
      cd cma-[***VERSION NUMBER***]/
      bin/cma-docker.sh --start --airgapped --python-executable=python3
      Check that the local pypi repository is installed correctly.
      netstat -atnp | grep 9003
      (Not all processes could be identified, non-owned process info will not be shown, you would have to be root to see it all.)
      tcp        0      0 0.0.0.0:9003            0.0.0.0:*            LISTEN      201503/python3
    • Locally
      Run the cma-local.sh script in the untarred top-level folder and follow its instructions to launch the Cloudera Migration Assistant server locally. cma-[***VERSION NUMBER***]/bin/cma-local.sh --start
      cd cma-[***VERSION NUMBER***]/
      bin/cma-local.sh --start --airgapped --python-executable=python3
      Check that the local pypi repository is installed correctly.
      netstat -atnp | grep 9003
      (Not all processes could be identified, non-owned process info will not be shown, you would have to be root to see it all.)
      tcp        0      0 0.0.0.0:9003            0.0.0.0:*            LISTEN      201503/python3
  4. Access http://localhost:8090 in a browser to open the Cloudera Migration Assistant tool.

    This confirms that the Cloudera Migration Assistant server is successfully installed.