[LIVY-736] Documentation update to mitigate livy-python-api build failure due OpenSSL version

• Type: Bug
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Fix Version/s: 0.9.0
• Component/s: Build
• Environment: macOS Mojave Version 10.14.5
• Assignee: Unassigned
• Reporter: Akshat Bordia
• Created: 25/Dec/19 11:16
• Updated: 12/Nov/22 22:10

Description

Steps to reproduce:

• Run mvn -DskipTests clean package either for the entire project or for python-api project

Expected Result:

• Build should be successful

Actual Result:

• Build fails while downloading dependencies from PIP.
• Error Log: Added below

Mitigation:

• The issue is due to TLS v1.0 and v1.1 deprecation for PIP. This can be fixed by upgrading pyOpenSSL to the latest version.

Error Logs:

Download error on https://pypi.python.org/simple/flake8/: [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:590) – Some packages may not be found!

Couldn't find index page for 'flake8' (maybe misspelled?)

Download error on https://pypi.python.org/simple/: [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:590) – Some packages may not be found!

No local packages or working download links found for flake8

Traceback (most recent call last):

  File "setup.py", line 57, in <module>

    tests_require=['pytest']

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/setuptools/_init_.py", line 128, in setup

    _install_setup_requires(attrs)

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/setuptools/_init_.py", line 123, in _install_setup_requires

    dist.fetch_build_eggs(dist.setup_requires)

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/setuptools/dist.py", line 461, in fetch_build_eggs

    replace_conflicting=True,

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pkg_resources/_init_.py", line 881, in resolve

    replace_conflicting=replace_conflicting

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pkg_resources/_init_.py", line 1164, in best_match

    return self.obtain(req, installer)

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pkg_resources/_init_.py", line 1176, in obtain

    return installer(requirement)

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/setuptools/dist.py", line 528, in fetch_build_egg

    return cmd.easy_install(req)

  File "/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/setuptools/command/easy_install.py", line 667, in easy_install

    raise DistutilsError(msg)

distutils.errors.DistutilsError: Could not find suitable distribution for Requirement.parse('flake8')