summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--release_docs/INSTALL_Windows.txt179
1 files changed, 81 insertions, 98 deletions
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt
index 60419dd..b3022ee 100644
--- a/release_docs/INSTALL_Windows.txt
+++ b/release_docs/INSTALL_Windows.txt
@@ -73,7 +73,7 @@ Preconditions
HDF5_EXT_SZIP
In this section, Zlib and Szip compression packages are assumed
- to be used. Please read section V as well as this section if you
+ to be used. Please read Section V as well as this section if you
do not want to use compression feature inside HDF5.
To define these environment variables:
@@ -105,10 +105,10 @@ Preconditions
6. Set up path for external libraries and headers
Skip this part if you don't want to use ANY compression features
- provided by HDF5. Please do read section V.
+ provided by HDF5. Please do read Section V.
You have to read this part even if you want to only use Zlib
- or Szip. You also need to read section V.
+ or Szip. You also need to read Section V.
Invoke Microsoft Visual C++ and go to "Tools" and select
"Options", find "Directories";
@@ -127,37 +127,40 @@ Preconditions
from the directory list, add the library path
(c:\zlib122\lib, c:\szip\dll) to the library directories.
-Notes
+Notes:
1. In release 1.8.0, all.zip is deprecated. Users should go to
hdf5/windows directory, run copy_hdf.bat first and then open
all.dsw under hdf5/windows/proj/all to start building process.
-
- 2. To build HDF5 C++ and FORTRAN libraries, please read through
+
+ 2. In release 1.8.0, all.sln was provided for command line use ONLY.
+ all.sln should never be opened to start building HDF5 using IDE.
+
+ 3. To build HDF5 C++ and FORTRAN libraries, please read through
this document.
- 3. For users who want to quickly build HDF5 library or do not
+ 4. For users who want to quickly build HDF5 library or do not
want to know HDF5 building and installation details, please
read INSATLL_Windows_Short.txt.
- 4. For users who would like to build and test HDF5 package from the
+ 5. For users who would like to build and test HDF5 package from the
command line, please read INSATLL_Windows_From_Command_Line.txt.
- 5. HDF4-related tools are not built and released with HDF5 library
- HD
+ 6. HDF4-related tools are not built and released with HDF5 library
+ packages any more. To obtain HDF4 related tools, please check
http://hdf.ncsa.uiuc.edu/h4toh5/ and
ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/
- 6. For DLL users, please do read and follow "DLL hints"
+ 7. For DLL users, please do read and follow "DLL hints"
at Section IV.
- 7. For .NET users, please read section VI.
+ 8. For .NET users, please read Section VI.
- 8. For users who would like to build, test and use HDF5 snapshot
+ 9. For users who would like to build, test and use HDF5 snapshot
release, please read Section VIII.
- 9. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
+ 10. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
Intel 8.1 only works with MSVS .net 2003 when you build
- HDF5-1.8.x.
+ HDF5-1.8.x, please read Section VII.
------------------------------------------------------------------------
@@ -312,7 +315,7 @@ STEP 1: Building HDF5 libraries and tools
hl_test_lite_fortran
hl_test_table_fortran
- 3.6 If you are using Intel compilers, please read section VII.
+ 3.6 If you are using Intel compilers, please read Section VII.
4. Select "Build", then Select "Set Active Configuration".
@@ -681,7 +684,7 @@ We provide 2 options for users to test HDF5 libraries and tools.
Skip this step UNLESS you have built HDF5 C++ libraries
and want to test them.
- DLLs listed below should be placed into to the Windows system
+ DLLs listed below should be placed into the Windows system
directory. A batch file named install_cppdll.bat is included in
c:\MyHDFstuff\hdf5 directory. Run this batch file and the
following HDF5 C++ DLLs will be copied to the system directory.
@@ -705,7 +708,7 @@ We provide 2 options for users to test HDF5 libraries and tools.
Skip this step UNLESS you have built HDF5 Fortran libraries
and want to test them.
- DLLs listed below should be placed into to the Windows system
+ DLLs listed below should be placed into the Windows system
directory. A batch file named install_f90dll.bat is included in
c:\MyHDFstuff\hdf5 directory. Run this batch file and the
following HDF5 Fortran DLLs will be copied to the system
@@ -1073,9 +1076,9 @@ To use HDF5 static library
7. (optional) to use HDF5 Fortran static library, the location of
Fortran module files should be specified by following
- Project->Settings->Fortran->Preprocessor,
- and in a test-area labeled with "INCLUDE and USE Paths:", add
- HDF5 Fortran module files directories. For example:
+ Project->Settings->Fortran->Preprocessor, and in a test-area
+ labeled with "INCLUDE and USE Paths:", add HDF5 Fortran module
+ files directories. For example:
c:\MyHDFstuff\hdf5\hdf5lib\release\include
@@ -1279,7 +1282,7 @@ Warning: When you modify the H5pubconf.h file as described below,
This message can be ignored.
- Note:
+ Notes:
To disable Gzip and Szip at the same time, just follow 1.1~1.2
and 2.1~2.2 and run-compile HDF5 library according to section II.
@@ -1306,26 +1309,25 @@ Warning: When you modify the H5pubconf.h file as described below,
Section VI: How to build HDF5 in Microsoft Visual Studio .Net 2003
========================================================================
-Preconditions:
-
- a. Setup Szip Library for Visual Studio .Net 2003 Compiler.
-
- Intel compilers use different Szip library from other compilers.
- Szip source codes or binaries for Intel compiler can be downloaded
- from the following address:
-
- ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows.
-
- The Szip library and header path should also be set up
- accordingly (refer to precondition 6).
-
+Preconditions:
+
+ a. Set up path for Microsoft Visual Studio .Net 2003 compiler
+
+ Open "System" in Control Panel.
+
+ On the "Advanced" tab, click "Environment Variables", click
+ "Path" in the "System variables" box, then click "Edit" and
+ add your Visual C++ .Net path (For example,
+ C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\IDE)
+ into "Variable Value" and click "OK".
+
b. Set up path for external libraries and headers
Skip this part if you don't want to use ANY compression features
- provided by HDF5. Please do read section V.
+ provided by HDF5. Please do read Section V.
You have to read this part even if you want to only use Zlib
- or Szip. You also need to read section V.
+ or Szip. You also need to read Section V.
Invoke Microsoft Visual C++ .Net and go to "Tools" and select
"Options". In the left pane of "Option" window poped up,
@@ -1461,24 +1463,27 @@ libraries and tools) to test HDF5 C and C++ Libraries.
there as in Microsoft Visual Studio 6.0.
NOTE: Please read section V if you do not want to use compression
- feature inside HDF5.
+ feature inside HDF5.
************************************************************************
Section VII: How to build HDF5 with INTEL Compiler
========================================================================
-Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
- Intel 8.1 only works with MSVS .net 2003 when you build
- HDF5-1.8.x.
+Notes: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
+ Intel 8.1 only works with MSVS .net 2003 when you build
+ HDF5-1.8.x.
- 2. HDF5 Fortran DLL Libraries is not supported with Intel Fortran
- 8.1 integration with Visual C++ .Net 2003 Environment.
+ 2. HDF5 Fortran DLL Libraries is not supported with Intel
+ Fortran 8.1 integration with Visual C++ .Net 2003
+ Environment. But Release version of HDF5 Fortran DLL
+ libraries works with Intel Fortran Compiler while Debug
+ version doesn't.
- 3. Szip library is different when using Intel compiler.
- You should build Szip source codes with Inter compiler or
- download binaries for Intel compiler from
- ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows.
+ 3. Szip library is different when using Intel compiler.
+ You should build Szip source codes with Inter compiler or
+ download binaries for Intel compiler from
+ ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.
1. INTEL compiler 7.1
@@ -1502,36 +1507,26 @@ Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
Szip source codes or binaries for Intel compiler can be downloaded
from the following address:
- ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows.
+ ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.
b. Set up path for external libraries and headers
Skip this part if you don't want to use ANY compression features
- provided by HDF5. Please do read section V.
+ provided by HDF5. Please do read Section V.
You have to read this part even if you want to only use Zlib
- or Szip. You also need to read section V.
-
- Invoke Microsoft Visual C++ and go to "Tools" and select
- "Options", find "Directories";
-
- Find the box "Show directories for", choose
- "Include files", if you can not find your Zlib and Szip
- header path
- (for example, c:\zlib122\include, c:\szip\include)
- from the directory list, add the header path
- (c:\zlib122\include, c:\szip\include) to the
- included directories.
+ or Szip. You also need to read Section V.
- Find the box "Show directories for", choose "Library files",
- If you cannot find your Zlib and Szip library path
- (for example, c:\zlib122\lib, c:\szip\dll)
- from the directory list, add the library path
- (c:\zlib122\lib, c:\szip\dll) to the library directories.
+ Invoke Microsoft Visual C++ .Net 2003. From the main
+ menu, Go to Tools > Options > Intel C++. In the left pane,
+ Click on "Intel C++ 8.1" to set the directories and default
+ options. In "Include", Add Zlib and Szip header path
+ (c:\zlib122\include c:\szip\include). In "Library", Add Zlib and
+ Szip Library Path (c:\zlib122\lib, c:\szip\dll). Then click "OK".
- 2.1 Intel C++ Compiler 8.1 under MSVS C++ .Net 2003 Environment
+ 2.1 Intel C++ Compiler 8.1 under MSVS C++ .Net 2003 Environment
- Note: This step will build ONLY HDF5 Static and DLL C and C++
+ Notes: This step will build ONLY HDF5 Static and DLL C and C++
Library using Intel C++ Compiler.
If you want to build HDF5 Static and DLL C and C++ Library
@@ -1557,22 +1552,11 @@ Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
"Convert to use Intel C++ Project System" to convert
all .Net project files to Intel C++ project files.
- 2.1.3 Choose Intel Compiler and Set up External Library and
- Header Path
+ 2.1.3 Choose Intel Compiler
- Go to Tools > Options > Intel C++. In the left pane,
- Click "General".
-
- a. In the right pane, under "Compiler selection",
- choose Intel C++ 8.1.
-
- b. Click on "Intel C++ 8.1" to set the directories
- and default options. In "Include", Add Zlib and Szip
- header path(c:\zlib122\include c:\szip\include).
- In "Library", Add Zlib and Szip Library Path
- (c:\zlib122\lib, c:\szip\dll).
-
- c. Then click "OK".
+ Go to Tools > Options, In the left pane, choose
+ "Intel C++", click "General". In the right pane, under
+ "Compiler selection", choose "Intel C++ 8.1", then click "OK".
2.1.4 Building HDF5 C and C++ Libraries and Tools
@@ -1598,8 +1582,7 @@ Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
hdf5_hl_fortran
hl_test_image_fortran
hl_test_lite_fortran
- hl_test_table_fortran
-
+ hl_test_table_fortran
Select "ok". Select "Build" -> "Build" or "Rebuild All" to
build debug version of project "all".
@@ -1655,7 +1638,7 @@ Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
2.2.3 Change project dependencies of "libtest_fortran"
- Highlight project "libtest_fortran", choose "Project"->
+ Highlight project "libtest_fortran", choose tab "Project"->
"Project Dependencies", uncheck "libtest".
2.2.4 Convert to Use Intel C++ Project System
@@ -1686,16 +1669,16 @@ Note: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and
2.2.6 Test HDF5 Static and High Level Fortran Library
- a. Test HDF5 Static Fortran Library
+ a. Test HDF5 Static Fortran Library
- Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file
- testhdf5_fortran.bat with the following two options to test
- fortran static library
+ Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file
+ testhdf5_fortran.bat with the following two options to test
+ fortran static library
testhdf5_fortran release >> "Your output file name"
testhdf5_fortran debug >> "Your output file name"
- Check your output files, there should be no "failures" at all.
+ Check your output files, there should be no "failures" at all.
b. Test HDF5 High Level Fortran Library
@@ -1718,11 +1701,11 @@ Note: This section is only for users who would like to build and test
Step I: Generate H5Tinit.c using Microsoft Visual C++ 6.0
-For users who would like to build and test HDF5 C and C++ library, it
-is necessary to manually generate H5Tinit.c before going to section II
-step 1(2). Follow the steps below to generate H5Tinit.c manually using
-Microsoft Visual C++ 6.0. We don't guarantee that H5Tinit.c can be
-sucesessfully created by other compilers.
+For users who would like to build and test HDF5 C and C++ library ONLY,
+it is necessary to manually generate H5Tinit.c before going to
+Section II step 1(2). Follow the steps below to generate H5Tinit.c
+manually using Microsoft Visual C++ 6.0. We don't guarantee that
+H5Tinit.c can be sucesessfully created by other compilers.
1. Previous step: section II, step 1(1).
@@ -1756,7 +1739,7 @@ Note: The users who don't want to build fortran library can skip
We don't guarantee that these three files can be created sucessfully
by other compilers.
- 1) Previous step: section II, step 1(1)
+ 1) Previous step: Section II, step 1(1)
2) Follow the steps in Section VIII, Step I to generate H5Tinit.c.
@@ -1794,7 +1777,7 @@ Note: The users who don't want to build fortran library can skip
This step will generate H5f90i_gen.h and H5fortran_types.f90 automatically.
- 9) Go back to section II to build and test HDF5 Libraries and Tools
+ 9) Go back to Section II, step 1(2) to build and test HDF5 Libraries and Tools
************************************************************************