diff options
author | Quincey Koziol <koziol@hdfgroup.org> | 2010-03-25 03:51:41 (GMT) |
---|---|---|
committer | Quincey Koziol <koziol@hdfgroup.org> | 2010-03-25 03:51:41 (GMT) |
commit | 42efc1c2b591e4cd45ec6cb3bdf32044343118d2 (patch) | |
tree | 0ab542871c32246199479e8933ff26286aaf629a /release_docs/INSTALL_Windows.txt | |
parent | 3360c3af0c100ac4d3a2fe2865f34661da862ec5 (diff) | |
download | hdf5-42efc1c2b591e4cd45ec6cb3bdf32044343118d2.zip hdf5-42efc1c2b591e4cd45ec6cb3bdf32044343118d2.tar.gz hdf5-42efc1c2b591e4cd45ec6cb3bdf32044343118d2.tar.bz2 |
[svn-r18451] Description:
Bring r18172:18446 from trunk to revise_chunks branch.
Tested on:
FreeBSD/32 6.3 (duty) in debug mode
FreeBSD/64 6.3 (liberty) w/C++ & FORTRAN, in debug mode
Linux/32 2.6 (jam) w/PGI compilers, w/default API=1.8.x,
w/C++ & FORTRAN, w/threadsafe, in debug mode
Linux/64-amd64 2.6 (amani) w/Intel compilers, w/default API=1.6.x,
w/C++ & FORTRAN, in production mode
Solaris/32 2.10 (linew) w/deprecated symbols disabled, w/C++ & FORTRAN,
w/szip filter, in production mode
Linux/64-ia64 2.6 (cobalt) w/Intel compilers, w/C++ & FORTRAN,
in production mode
Linux/64-ia64 2.4 (tg-login3) w/parallel, w/FORTRAN, in debug mode
Linux/64-amd64 2.6 (abe) w/parallel, w/FORTRAN, in production mode
Diffstat (limited to 'release_docs/INSTALL_Windows.txt')
-rw-r--r-- | release_docs/INSTALL_Windows.txt | 74 |
1 files changed, 34 insertions, 40 deletions
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index a24e1d5..de31747 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -35,11 +35,10 @@ Contents: Preconditions: 1. Installed Microsoft Visual Studio. This document is written for Visual - Studio 2005, although we also support Visual Studio 2008 as well. Most - of the instructions are the same. We no longer support building HDF5 - using Microsoft Visual Studio .NET 2003. + Studio 2008. We no longer support building HDF5 + using Microsoft Visual Studio .NET 2003, or Visual Studio 2005. - 2. (Optional) Installed Intel Compiler 9.1 or 10.1 if you want to build HDF5 + 2. (Optional) Installed Intel Compiler 10.1 or 11.1 if you want to build HDF5 Fortran libraries. 3. Install Winzip or 7-zip for extracting source tarball. @@ -67,24 +66,24 @@ Preconditions: c:\ (any drive) MyHDFstuff\ (any folder name) - 5. Download the hdf5-1.8.x source code package and use 7zip or WinZip to + 5. Download the hdf5-1.9.x source code package and use 7zip or WinZip to extract the HDF5 package into c:\MyHDFstuff. This creates a directory - called 'hdf5-1.8.x' under MyHDFstuff which contains several files and - directories. Rename "hdf5-1.8.x" to "hdf5". + called 'hdf5-1.9.x' under MyHDFstuff which contains several files and + directories. Rename "hdf5-1.9.x" to "hdf5". 6. HDF5 provide options to do in-memory compression within HDF5 library. Currently, two external compression libraries Zlib and Szip can be used with HDF5. 6.1 HDF5 uses Zlib version 1.2.3 for compression and Zlib is NOT - distributed with HDF5 library in 1.8.x release. To use Zlib library, + distributed with HDF5 library in 1.9.x release. To use Zlib library, you have to install your own Zlib DLL library or go to ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/windows to download the Zlib library. 6.2 HDF5 uses Szip version 2.1 for compression and Szip compression - software is provided with HDF5 products in 1.8.1 release. To use + software is provided with HDF5 products in 1.9.x release. To use Szip 2.1 library, you can download Szip source codes and binaries from ftp://ftp.hdfgroup.org/lib-external/szip/2.1/bin/windows @@ -159,12 +158,12 @@ Preconditions: Notes: - 1. As of 1.8.0, all.zip is deprecated. Users should go to hdf5/windows - directory, run copy_hdf.bat first and then open all.sln under - hdf5/windows/proj/all to start building process. + 1. Users should go to hdf5/windows directory, run copy_hdf.bat first and then + open all.sln under hdf5/windows/proj/all to start building process. 2. Visual Studio 6.0 is no longer supported in HDF5 1.8 or later releases. Visual Studio .NET is no longer support in HDF5 1.8.4 or later releases. + Visual Studio 2005 is no longer support in HDF5 1.8.5 or later releases. 3. For users who want to quickly build HDF5 library or do not want to know HDF5 building and installation details, please read the @@ -177,14 +176,14 @@ Notes: any more. To obtain HDF4 related tools, please check http://hdfgroup.org/h4toh5/ and ftp://ftp.hdfgroup.org/HDF5/h4toh5 - 6. For Fortran users, Intel fortran Compiler 9.1 and 10.1 is currently - supported-- please see Section VI. Intel Compiler verion 7.x and 8.x are + 6. For Fortran users, Intel fortran Compiler 10.1 and 11.1 is currently + supported-- please see Section VI. Intel Compiler verion 9.x or earlier are no longer supported. 7. For users who would like to build Muti-threaded version of HDF5 library, please read Section VII. - 8. To build HDF5 in Visual Studio 2008, be sure to read the instructions in + 8. To build HDF5 in Visual Studio 2010, be sure to read the instructions in Section XI. @@ -255,7 +254,7 @@ STEP 1: Building HDF5 Libraries and Tools 3. (Optional) Disable HDF5 C++ and High level C++ - In HDF5 1.8, C++ and HL C++ libraries are built by default. To opt-out, + In HDF5 1.9, C++ and HL C++ libraries are built by default. To opt-out, you must explicitly disable them. 3.1 Skip this step if you do want to build HDF5 High-Level C++ libraries @@ -1112,16 +1111,13 @@ Warning: When you modify the H5pubconf.h file as described below, DO NOT just Section VI: How to build HDF5 with Fortran Support ======================================================================== -Notes: 1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are - currently supported-- please see below. Intel Compiler verion 7.x and - 8.x are no longer supported. +Notes: 1. For Intel Compiler users, Intel fortran Compiler 10.1 and 11.1 are + currently supported-- please see below. Intel Compiler verion 9.x and + earlier are no longer supported. - 2. The Compaq Fortran Compiler is no longer supported for HDF5 1.8. + 2. The Compaq Fortran Compiler is no longer supported for HDF5 1.9. - 3. Intel Fortran 9.1 works only under Visual Studio 2005 environments. - Visual Studio 2008 is supported only with Intel Fortran 10.1. - - 4. Parallel builds should be disabled. To do so: Go to Tools > + 3. Parallel builds should be disabled. To do so: Go to Tools > Options > Projects and Solutions > Build and Run. Set "Maximum Number of Parallel Project Builds" to 1. @@ -1143,7 +1139,7 @@ Notes: 1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are You have to read this part even if you want to use only Zlib or Szip. You also need to read Section V. - 1) Invoke Microsoft Visual Studio 2005 or 2008. + 1) Invoke Microsoft Visual Studio. 2) From the main menu, Go to Tools > Options > Intel(R) Fortran. In the right panel, make sure your "Selected Compiler" is Intel Fortran. @@ -1157,11 +1153,11 @@ Notes: 1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are 5) Then click "OK". -1. Build with Intel Fortran Compiler 9.1 or 10.1 under Visual Studio 2005 or 2008 +1. Build with Intel Fortran Compiler 10.1 or 11.1 under Visual Studio 2008 Note: This step will build HDF5 Static and DLL C and C++ Library using Visual Studio compiler as well as HDF5 Static and High Level - Fortran Library using Intel Fortran 9.1 or 10.1 Compiler. + Fortran Library using Intel Fortran Compiler. 1.1 Open all_fortran.sln @@ -1385,10 +1381,9 @@ Notes: 1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are Section VII : How to build Multi-threaded version of HDF5 library ======================================================================== -Notes: In Visual Studio 2005, the Single-threaded runtime libraries have been - depreciated, and Multi-threaded is built by default. Therefore, no extra +Notes: In Visual Studio 2008 Multi-threaded is built by default. Therefore, no extra work needs to be done to build Multi-threaded libraries in Visual Studio - 2005. + 2008. ======================================================================== @@ -1571,7 +1566,7 @@ Notes: In Visual Studio 2005, the Single-threaded runtime libraries have been Section IX: How to build HDF5 for 64-bit Windows ======================================================================== -HDF5 can be built for 64-bit Windows in Visual Studio 2005 or 2008. +HDF5 can be built for 64-bit Windows in Visual Studio 2008. Notes: @@ -1584,7 +1579,7 @@ Prerequisites: 1. A 64-bit Windows machine. Either AMD64 and Itanium is supported. - 2. Microsoft Visual Studio 2005 or 2008 installed with x64 Extensions. + 2. Microsoft Visual Studio 2008 installed with x64 Extensions. Building: @@ -1627,8 +1622,7 @@ Building on Windows Vista is very similar to building on Windows XP, with some minor changes. Therefore, follow the build instructions above, with the following considerations: - 1. Only Visual Studio 2005 and 2008 is currently supported on Windows Vista. - This is because Microsoft has ended their support for .NET. + 1. Only Visual Studio 2008 is currently supported on Windows Vista. 2. Elevated security permissions are required to test the HDF5 libraries. This is because DLLs are installed in the system directory. To enable @@ -1644,17 +1638,17 @@ following considerations: ======================================================================== - Section XI: How to build HDF5 using Visual Studio 2008 + Section XI: How to build HDF5 using Visual Studio 2010 ======================================================================== -Building with Visual Studio 2008 is very similar to building with Visual Studio -2005, with some minor changes. Therefore, follow the build instructions above, +Building with Visual Studio 2010 is very similar to building with Visual Studio +2008, with some minor changes. Therefore, follow the build instructions above, with the following considerations: - 1. Visual Studio 2008 uses a new format for project files, but Visual Studio - 2005 project files can be easily converted. The HDF5 project files + 1. Visual Studio 2010 uses a new format for project files, but Visual Studio + 2008 project files can be easily converted. The HDF5 project files will need to be converted on first use. To do so: - 1.1. Open the HDF5 Visual Studio 2005 solution file as in Section II + 1.1. Open the HDF5 Visual Studio 2008 solution file as in Section II (either all.sln or all_fortran.sln if building Fortran.) 1.2. You will be prompted with an automatic conversion wizard. Click |