Building pyOpenSSL on Windows¶
This document details the steps to build an pyOpenSSL egg with embedded OpenSSL library, for use by Tahoe-LAFS on Windows.
The instructions were tried on Windows 7 64-bit and Windows XP 32-bit. They should work on other versions of Windows, maybe with minor variations.
Download and install Microsoft Visual C++ compiler for Python 2.7¶
For reasons detailed in the Python documentation, Python extension modules need to be built using a compiler compatible with the same version of Visual C++ that was used to build Python itself. Until recently, this meant downloading Microsoft Visual Studio 2008 Express Edition and Windows SDK 3.5. The recent release of the Microsoft Visual C++ compiler for Python 2.7 made things a lot simpler.
So, the first step is to download and install the C++ compiler from Microsoft from this link.
Find the location where it installed the
vcvarsall.bat file; depending on
the version of Windows it could be either
"%USERPROFILE%\AppData\Local\Programs\Common\Microsoft\Visual C++ for Python\9.0"
"%CommonProgramFiles%\Microsoft\Visual C++ for Python\9.0", for example.
We’ll call this
Download and install Perl¶
Download and install ActiveState Perl:
- go to the ActiveState Perl download page.
- identify the correct link and manually change it from http to https.
Download and install the latest OpenSSL version¶
Download the latest OpenSSL from the OpenSSL source download page and untar it. At the time of writing, the latest version was OpenSSL 1.0.1m.
Set up the build environment. For 64-bit Windows:
or for 32-bit Windows:
Go to the untar’ed OpenSSL source base directory. For 64-bit Windows, run:
mkdir c:\dist perl Configure VC-WIN64A --prefix=c:\dist\openssl no-asm enable-tlsext ms\do_win64a.bat nmake -f ms\ntdll.mak nmake -f ms\ntdll.mak install
or for 32-bit Windows, run:
mkdir c:\dist perl Configure VC-WIN32 --prefix=c:\dist\openssl no-asm enable-tlsext ms\do_ms.bat nmake -f ms\ntdll.mak nmake -f ms\ntdll.mak install
To check that it is working, run
Download and untar pyOpenSSL 0.13.1 (see ticket #2221 for why we currently use this version). The MD5 hash of pyOpenSSL-0.13.1.tar.gz is e27a3b76734c39ea03952ca94cc56715.
Set up the build environment by running
vcvarsall.batas for building OpenSSL above.
set LIB=c:\dist\openssl\lib;%LIB% set INCLUDE=c:\dist\openssl\include;%INCLUDE% set PATH=c:\dist\openssl\bin;%PATH%
A workaround is needed to ensure that the setuptools
bdist_eggcommand is available. Edit pyOpenSSL’s
setup.pyaround line 13 as follows:
< from distutils.core import Extension, setup --- > from setuptools import setup > from distutils.core import Extension
python setup.py bdist_egg
The generated egg will be in the
dist directory. It is a good idea
to check that Tahoe-LAFS is able to use it before uploading the egg to
tahoe-lafs.org. This can be done by putting it in the
of a Tahoe-LAFS checkout or release, then running
python setup.py test.