diff options
Diffstat (limited to 'win32utils/build.txt')
| -rw-r--r-- | win32utils/build.txt | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/win32utils/build.txt b/win32utils/build.txt new file mode 100644 index 00000000..ff3208e7 --- /dev/null +++ b/win32utils/build.txt @@ -0,0 +1,181 @@ +Copyright (C) 2013 Internet Systems Consortium, Inc. ("ISC")
+See COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
+
+ BIND 9.10 for Win32 Source Build Instructions. 11-Jul-2013
+
+Building BIND 9.10 on Windows XP/Vista/7/8 or server 2003/2008/2008R2
+has the following prerequisites:
+
+1) You need to install Perl for Windows. ActivePerl
+(http://www.activestate.com/) and Strawberry Perl
+(http://www.strawberryperl.com) have both been tested and found
+to work.
+
+2) OpenSSL (http://www.openssl.org) must be downloaded and built on
+the system on which you are building BIND.
+
+3) If you wish to use the statistics channel, LibXML2
+(ftp://xmlsoft.org/libxml2) must be downloaded and built on
+the system on which you are building BIND.
+
+4) Optional external packages (not used by default)
+
+If you wish to use IP geolocation, GeoIP API and database must be
+downloaded, patched and built on the system on which you are building
+BIND.
+
+If you wish to use readline, the readline library must be downloaded
+and built on the system on which you are building BIND.
+
+5) The BIND Installer (BINDInstall) includes a copy of the
+redistributable runtime object vcredist_x86.exe (or vcredist_x64.exe),
+which is included with Visual Studio and can be downloaded from
+Microsoft. This file must be in place prior to running the build
+setup script.
+
+Step 1: Download and build OpenSSL
+
+ OpenSSL is required for DNSSEC. If you wish to build BIND 9 without
+ DNSSEC support, skip to step 2.
+
+ Download and untar the OpenSSL sources from http://www.openssl.org/.
+ Extract them at in the same directory in which you extracted the BIND 9
+ source: If BIND 9 is in \build\bind-9.10.0, for instance, OpenSSL should
+ be in \build\openssl-1.0.1e (subject to version number changes).
+
+ Note: Building OpenSSL requires that you install Perl as it uses it
+ during its build process. The following commands work as of
+ openssl-1.0.1e, but you should check the OpenSSL distribution to see
+ if the build instructions in the INSTALL.W32 (or INSTALL.W64) file
+ have changed, in particular for the assembler options:
+
+ cd openssl-1.0.1e
+ perl Configure --prefix=c:/openssl enable-static-engine VC-WIN32
+ ms\do_ms
+ nmake /f ms\ntdll.mak
+
+ For 64 bit build, replace VC-WIN32 by VC-WIN64A.
+ The enable-static-engine is needed when an OpenSSL engine will be
+ used, so with GOST support (configured by default) and/or PKCS #11
+ support.
+
+ If you wish to use PKCS #11 to control a cryptographic hardware
+ service module, please see "PKCS #11 (Cryptoki) support" in chapter 4
+ of the BIND 9 Administrator Reference Guide. You will need to apply
+ the patch in bind9\bin\pkcs11\openssl-1.0.1e-patch (this can be done
+ using the Cygwin 'patch' utility) and add --pk11-libname and
+ --pk11-flavor to the Configure command above.
+
+Step 2: Download and build LibXML2
+
+ LibXML2 is required to use the statistics channel. If you wish to
+ build BIND 9 without support for this feature, skip to step 3.
+
+ Download and untar the libxml2 sources from ftp://xmlsoft.org/libxml2.
+ Extract them in the same directory in which you extracted the BIND 9
+ source: If BIND 9 is in \build\bind-9.10.0, for instance, libxml2 should
+ be in \build\libxml2-2.7.7 (subject to version number changes).
+
+ Now build libxml2, and copy the resulting files into the include and lib
+ directories:
+
+ cd libxml2-2.7.7\win32
+ cscript configure.js compiler=msvc vcmanifest=yes static=yes \
+ debug=no iconv=no
+ nmake /f Makefile.msvc libxml
+
+Step 3: Download and build optional external packages (GeoIP, readline)
+
+ 3a) GeoIP is required to use IP geolocation. If you wish to build
+ BIND 9 without support for this feature, skip to step 3b. The URL is:
+ http://geolite.maxmind.com/download/geoip/api/c/GeoIP-1.5.1.tar.gz
+
+ The current (version 1.5.1) GeoIP does not build a suitable
+ DLL with safe threading. The GeoIP.diff file:
+ - fixes WIN32 building support
+ - makes pread() safe in a multi-threaded system
+ - changes the Makefile.vc to build a DLL in place of a static
+ library (BTW this is required by the previous point)
+
+ 3b) The readline library adds command-line editing in nslookup and
+ nsupdate. If you wish to build BIND 9 without support for this feature,
+ skip to step 4.
+
+ Because the original GNU source for the readline library has no WIN32
+ support, it will be necessary to download a version of the static
+ readline library source that is ready to be built by Visual Studio.
+ One such version is available at:
+ http://gpsim.sourceforge.net/gpsimWin32/packages/readline-5.2-20061112-src.zip
+
+Step 4: Make the redistributable runtime object available
+
+ Check that the Microsoft redistributable object (vcredist_x86.exe or
+ vcredist_x64.exe) is available to the build. The file may be placed
+ in the directory in which the BIND 9 source was extracted (for
+ instance, if BIND 9 is in \build\bind-9.10.0, the redistributable
+ may be placed in \build\vcredist_x86.exe). Or, the path to the file
+ can be specified via the VCREDIST_PATH environment variable, or via
+ the "with-vcredist=PATH" option to the configuration script (see
+ step 4).
+
+Step 5: Configuring the BIND build
+
+ From the command prompt, cd to the win32utils directory under
+ the BIND 9 root:
+
+ cd bind-9.10.0\win32utils
+
+ In this directory, you can prepare the Windows build by running:
+
+ perl Configure <options> win32
+
+ For 64 bit:
+
+ perl Configure <options> x64
+
+ This will set up all the files needed for building BIND 9 according
+ to the given options. To see the available options, run:
+
+ perl Configure help
+
+ To remove all files generated by Configure, run:
+
+ perl Configure clean
+
+Step 5: Building BIND
+
+ To build using 'nmake' or older versions of Visual Studio (e.g.
+ VS 2005 and 2008), go to the legacy subdirectory:
+
+ cd legacy
+
+ and follow the instructions in win32-build.txt. Note that
+ only 32 bit builds are supported in this mode.
+
+ To build using the Visual Studio GUI (VS 2010 and 2012): open the bind9.sln
+ solution file; this will load the project files for all of the BIND 9
+ libraries and applications. Select "Build->Batch Build", click "Select
+ All", then click "Build".
+
+ To build using MSBuild (VS 2010 and 2012): call MSBuild on the
+ bind9.sln solution file:
+
+ msbuild /t:Build /p:Configuration=Release && \
+ msbuild /t:Build /p:Configuration=Debug
+
+Step 6: Install
+
+ Installation is accomplished by running the BINDInstall program. All
+ DLL's are copied to the system32 area and all applications (including
+ BINDInstall which may be necessary for uninstalling BIND 9) to the
+ dns/bin directory. If BIND 8 has previously been installed on the system
+ it must be uninstalled first by running it's own BINDInstall program.
+ The BIND 9 installer does not yet do this.
+
+ Note: BINDInstall.exe requires the MFC (Microsoft Foundation Class).
+ This is only distributed with non-free (i.e., not "Express") versions of
+ Visual Studio. The other BIND 9 libraries and applications do not have
+ this dependency.
+
+Please report bugs, whether in the process of building the application
+or in BIND 9 itself, to bind9-bugs@isc.org.
|