Prerequisites

Prerequisites needed before you can run the connector migration script.

To run the script you will require:
  1. Python 2.7.x version installed on a Windows or MAC machine. It does not work with python 3.x (3 or higher) version. Download it from the Python official URL. MAC machine have python installed. Check the version is 2.7.x. For windows, enable these customizations during installation:
    This customization allows
    • Environment variables to be setup in Windows environment, so that python command will work on command line in a shell. It also sets up the PYTHONPATH environment variable. With this customized installation, python path variable has been set to:
      On windows, you can check the setting of a variable, using the command, echo%PYTHONPATH%. For this setting, you see:
    • Python package manager - pip directly available with the python 2.7 installation, so that pip command will work on command line in a shell.
    Note: If you already have python 2.7.x installed and do not have pip, you can install it. Open a terminal window, login as administrator and type the command:
    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
    sudo python get-pip.py
  2. You should have OpenSSL which supports TLS 1.2 installed with python 2.7.x installation for the connector migration script to run. If you are using old versions of python 2.7.x, OpenSSL which might not be installed. In this case, you will see TLS error when you run the script:

    AttributeError: 'module' object has no attribute 'PROTOCOL_TLSv1_2'

    You should upgrade to the recent version of python 2.7.x releases.

  3. Download the latest version of Enterprise Application Access SDK (EAA-SDK) and install it.
  4. Install the connector migration tool. This downloads the connector migration files, connector_migration.py and apikeys.
  5. API credentials for the tenant. If you do not have the API credentials, you can create a new API key and secret credentials.
  6. If you already have an EAA-SDK API credentials, copy it in apikeys file.
  7. Create a new connector in EAA, for example Connector2019. For help, see Create and download a connector for EAA in EAA documentation.
  8. Verify that the connector has the latest Ubuntu 18.04 OS version.