The downloaded archive contains several whl files, each of which corresponds to a specific combination of environmental factors. These factors include:
- The operating system that the python connector is used in, whether it is Windows, Mac, or Linux.
- The bitness of the operating system, whether it 32-bit or 64-bit. For Windows systems, this will correspond to the win32 or win_amd64 wheels. For Linux, this will correspond to the linux_i686 and linux_x86_64 wheels.
- The version of Python in use. The connectors are supported in either Python 3.6 or Python 3.7 for Windows and Linux, and Python 3.8 for Mac.
Once these factors are evaluated, the appropriate wheel is found in the directory following this format (starting from the base folder of the extracted archive). Bear in mind that the bitness folders do not apply to the Mac wheel:
./CData.Python.DB2/[win | mac | unix]/Python[36 | 37 | 38]/[32 | 64]
Once the appropriate whl file is identified, install the connector to your Python distribution with the "pip install" command via the command line. This will usually take the form of running the following commands in sequence. The 64-bit Windows wheel for Python 3.7 is used for the below example:
cd ./CData.Python.DB2/win/Python37/64 pip install cdata_DB2_connector-19.0.xxxx-cp37-cp37m-win_amd64.whl
Mac users using Python3.8 will instead use the "pip3 install" command to do the same:
cd ./CData.Python.DB2/mac/Python38 pip3 install cdata_DB2_connector-19.0.xxxx-cp38-cp38-macosx_10_9_x86_64.whl
You can confirm whether the connector is successfully installed by running the pip list command. If "cdata-DB2-connector" is present in the list output by the command, then the installation was successful.
Should the connector need to be uninstalled for any reason, you can do so by running the pip uninstall command, as in the example below:
pip uninstall cdata-DB2-connector