From 49448eeca13cfd32e36f4ec74f5e69fa6c1f476d Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Tue, 5 Apr 2005 14:55:20 -0500 Subject: [svn-r10548] Purpose: Update documents about installing hdf5 on windows xp Description: Modified files: INSTALL_Windows.txt INSTALL_Windows_From_Command_Line.txt INSTALL_Windows_Short.txt Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows.txt | 156 ++++++++++----------- release_docs/INSTALL_Windows_From_Command_Line.txt | 38 ++--- release_docs/INSTALL_Windows_Short.txt | 44 +++--- 3 files changed, 109 insertions(+), 129 deletions(-) diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index 36c4f7f..607dfcf 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -1,4 +1,4 @@ -HDF5 Build and Install Instructions for Windows 2000/XP (Full Version) +HDF5 Build and Install Instructions for Windows XP (Full Version) ------------------------------------------------------------------------ The following instructions assume that the HDF5 source code package from @@ -12,7 +12,7 @@ Preconditions 1. Installed Microsoft Visual C++ 6.0 or Intel C compiler and WinZip. - 1.1 Installed DEC Visual Fortran compiler(6.0 or higher version), + 1.1 Installed Compaq Visual Fortran compiler(6.0 or higher version), or Intel Fortran compiler if you want to build HDF5 Fortran libraries. @@ -48,7 +48,7 @@ Preconditions 4.1 HDF5 uses Zlib version 1.2.2 for compression and Zlib is NOT distributed with HDF5 library in 1.6.x release. To use Zlib library, you have to install your own Zlib DLL library or go - to ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/bin/windows + to ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin to download the Zlib library. Note: Zlib 1.2.2 DLL library can also be downloaded from @@ -58,7 +58,7 @@ Preconditions compression software is provided with HDF5 products starting from 1.6.0 release. To use Szip 2.0 library, you can download Szip source codes and binaries from - ftp://hdf.ncsa.uiuc.edu/lib-external/szip/bin/windows + ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows Please note that Szip is not a totally open-source free software. For licensing issue of Szip, please check @@ -100,8 +100,7 @@ Preconditions b. c:\zlib122\zlib1.dll and c:\szip\dll\szlibdll.dll should be copied into the location that the application can find, - one suggestion is to use the c:\WINNT\system or - c:\WINDOWS\system + one suggestion is to use the c:\WINDOWS\system. 6. Set up path for external libraries and headers @@ -209,17 +208,17 @@ Section II: How to build and test HDF5 libraries and tools ======================================================================== STEP 1: Building HDF5 libraries and tools - 1. Unpack all.zip - - Unpack all.zip in c:\MyHDFstuff\hdf5\windows directory. Files in - all.zip has path hdf5\.... Make sure that you extract files into - the c:\MyHDFstuff directory. + 1. Run batch file copy_hdf.bat. + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process + will copy all the necessary batch files and text files saved under + c:\MyHDFstuff\hdf5\windows directory to the directories where they + will be used. 2. Invoke Microsoft Visual C++ compiler Invoke Microsoft Visual C++. From the main menu, go to "File" and select the "Open Workspace" option. Then open the - c:\MyHDFstuff\hdf5\proj\all\all.dsw workspace. + c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw workspace. You should find windows project files listed as "all files, big files etc." on the left. @@ -254,6 +253,10 @@ STEP 1: Building HDF5 libraries and tools hdf5_f90cstubdll hdf5_fortran hdf5_fortrandll + hdf5_hl_fortran + hl_test_image_fortran + hl_test_lite_fortran + hl_test_table_fortran libtest_cstubdll libtest_fortran libtest_fortrandll @@ -280,22 +283,20 @@ STEP 1: Building HDF5 libraries and tools set up accordingly (refer to precondition 6). 4. Select "Build", then Select "Set Active Configuration". - - In "Project configurations", select the active configuration - - "all -- Win32 Debug" to build debug versions of - single-threaded static libraries, Debug - multithreaded DLLs and tests. + 4.1 To build debug versions of single-threaded static libraries, + Debug multithreaded DLLs and tests + In "Project configurations", select "all -- Win32 Debug", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build debug version of project "all". + 4.2 To build release versions of single-threaded static libraries, + multithreaded DLLs and tests + In "Project configurations", select "all -- Win32 Release", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build release version of project "all". - or - - "all -- Win32 Release" to build release versions of - single-threaded static libraries, - multithreaded DLLs and tests. - - Then build project "all". + Both debug and release versions must be built. - Warning messages can be ignored. + Warning messages can be ignored. When the debug or release build is done the directories listed below will contain the following files: @@ -704,19 +705,17 @@ To build and test HDF5 C examples: the "Open Workspace" option. Then open the workspace - c:\MyHDFstuff\hdf5\examples\allexamples\allexamples.dsw. - - 2. Select "Build", then Select "Set Active Configuration". - - In "Project configurations", select the active configuration - - "allexamples -- Win32 Debug" to build debug versions of the - C examples. - - or - - "allexamples -- Win32 Release" to build release versions the - C examples. + c:\MyHDFstuff\hdf5\windows\examples\allexamples\allexamples.dsw. + + 2. Select "Build", then Select "Set Active Configuration". + 2.1 To build debug versions of C examples. + In "Project configurations", select "allexamples -- Win32 Debug", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build debug version of project "allexamples". + 2.2 To build release versions of C examples. + In "Project configurations", select "allexamples -- Win32 Release", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build release version of project "allexamples". When the debug build or release build is done, there should be the following subdirectories in c:\MyHDFstuff\hdf5\examples\ @@ -733,8 +732,8 @@ To build and test HDF5 C examples: grouptestdll readtest readtestdll - selecttest - selecttestdll + selectest + selectestdll writetest writetestdll @@ -773,20 +772,19 @@ To build and test HDF5 C++ examples: the "Open Workspace" option. Then open the workspace - c:\myHDFstuff\hdf5\c++\examples\allcppexamples\allcppexamples.dsw. + c:\myHDFstuff\hdf5\windows\c++\examples\allcppexamples\allcppexamples.dsw. 2. Select "Build", then Select "Set Active Configuration". - In "Project configurations", select the active configuration - - "allcppexamples -- Win32 Debug" to build debug versions of the - C++ examples. - - or - - "allcppexamples -- Win32 Release" to build release versions the - C++ examples. - + 2.1 To build debug versions of C++ examples. + In "Project configurations", select "allcppexamples -- Win32 Debug", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build debug version of project "allcppexamples". + 2.2 To build release versions of C++ examples. + In "Project configurations", select "allcppexamples -- Win32 Release", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build release version of project "allcppexamples". + When the debug build or release build is done, there should be the following subdirectories in c:\MyHDFstuff\hdf5\c++\examples\ @@ -836,25 +834,24 @@ To build and test HDF5 C++ examples: To build and test HDF5 Fortran example: - 1. Invoke Compaq visual Fortran or intel Fortran under Microsoft + 1. Invoke Compaq Visual Fortran or intel Fortran under Microsoft Visual studio development environment, go to "File" and select the "Open Workspace" option. Then open the workspace - c:\MyHDFstuff\hdf5\fortran\examples\allf90examples\allf90examples.dsw. + c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw. 2. Select "Build", then Select "Set Active Configuration". - - In "Project configurations", select the active configuration - - "allf90examples -- Win32 Debug" to build debug versions of the - Fortran examples. - - or - - "allf90examples -- Win32 Release" to build release versions the - Fortran examples. - + + 2.1 To build debug versions of Fortran examples. + In "Project configurations", select "allf90examples -- Win32 Debug", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build debug version of project "allf90examples". + 2.2 To build release versions of Fortran examples. + In "Project configurations", select "allf90examples -- Win32 Release", + select "ok". Select "Build">>"Build" or "Rebuild All" to + build release version of project "allf90examples". + When the debug build or release build is done, there should be the following subdirectories in c:\MyHDFstuff\hdf5\fortran\examples\ @@ -912,7 +909,7 @@ To use HDF5 static library following locations will need to be specified for locating header files and linking with the HDF static library, for example: - c:\MyHDFstuff\hdf5\hdf5lib\include + c:\MyHDFstuff\hdf5\hdf5lib\release\include c:\MyHDFstuff\hdf5\hdf5lib\release\lib if you have installed HDF5 library in Section II, step 3. @@ -943,7 +940,7 @@ To use HDF5 static library 6. In a text-area labeled with "Additional include directories:", add HDF5, Zlib, and Szip header files directories. For example: - c:\MyHDFstuff\hdf5\hdf5lib\include + c:\MyHDFstuff\hdf5\hdf5lib\release\include c:\zlib122\include c:\szip\include @@ -955,7 +952,7 @@ To use HDF5 static library and in a test-area labeled with "INCLUDE and USE Paths:", add HDF5 Fortran module files directories. For example: - c:\MyHDFstuff\hdf5\hdf5lib\include + c:\MyHDFstuff\hdf5\hdf5lib\release\include To link the HDF5 library with your application: @@ -987,8 +984,8 @@ To use HDF5 static library 2. Insert the correct HDF5, Zlib, Szip paths for both headers(include) and libraries. For example, - c:\MyHDFstuff\hdf5\hdf5lib\include - c:\MyHDFstuff\hdf5\hdf5lib\lib + c:\MyHDFstuff\hdf5\hdf5lib\release\include + c:\MyHDFstuff\hdf5\hdf5lib\release\lib c:\zlib122\include c:\zlib122\lib c:\szip\include @@ -1141,8 +1138,7 @@ Warning: When you modify the H5pubconf.h file as described below, #define H5_HAVE_SZLIB_H 1 #define H5_HAVE_FILTER_SZIP 1 - #define H5_SZIP_CAN_ENCODE 1 - + then save the file. 2.2 Delete HDF5_EXT_SZIP environment variable if you have @@ -1173,18 +1169,11 @@ Warning: When you modify the H5pubconf.h file as described below, Szip library is different if you want to disable Szip encoder. Download szip_noencoder binaries from - ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows. + ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows. The Szip library and header path should also be set up accordingly (refer to precondition 6). - 3.2 Open the H5pubconf.h file from the c:\MyHDFstuff\hdf5\src - directory and remove (or comment out) the following line: - - #define H5_SZIP_CAN_ENCODE 1 - - then save the file. - - 3.3 Run-compile HDF5 library according to section II. + 3.2 Run-compile HDF5 library according to section II. ************************************************************************ @@ -1225,8 +1214,7 @@ step 1(2). Previous step: section II, step 1(1). Extra steps: -1) After extracting all.zip to the correct path, open the - c:\myHDFstuff\hdf5\misc\typegen\typegen.dsw. +1) Open c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. 2) Build the project file. 3) Invoke command prompt and go to c:\myHDFstuff\hdf5\src. 4) type H5Tinit.exe >H5Tinit.c @@ -1243,7 +1231,7 @@ The default driver on windows we support is sec2 driver. However, stdio driver is also supported. If you want to use stdio driver in your application, you may set environment variable HDF5_DRIVER to "stdio". -On windows 2000/XP, the following steps should be followed to set the +On windows XP, the following steps should be followed to set the environment variable, a) Go to Control panel and find "system", diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index e7b0960..313bad4 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -1,5 +1,5 @@ - Instructions for Building and Testing HDF5 on Command Line - for Windows XP/2000 + Instructions for Building and Testing HDF5 on Command Line + for Windows XP ************************************************************************ Note: This instruction is written for users who would like to build HDF5 @@ -7,7 +7,7 @@ Note: This instruction is written for users who would like to build HDF5 line. Currently, we only support building and testing HDF5 on command - line with Microsoft Visual C++ 6.0 and DEC Fortran 6.0. + line with Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0. For all other Windows development tools, HDF5 should be built in the development environment. Please refer to INSTALL_Windows.txt @@ -24,7 +24,7 @@ notes in INSTALL_Windows.txt before starting below procedures. Extra Preconditions - 1. Set path for Microsoft Visual C++ 6.0 and DEC Fortran 6.0 + 1. Set path for Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0 Open "System" in Control Panel. @@ -32,7 +32,7 @@ Extra Preconditions "Path" in the "System variables" box, then click "Edit" and add your Visual C++ 6.0 path (For example, C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) - and DEC Fortran 6.0 path (For example, + and Compaq Visual Fortran 6.0 path (For example, C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) into "Variable Value" and click "OK". @@ -41,7 +41,7 @@ Extra Preconditions To use WinZip command line utility, you have to install WinZip 9.0 or higher version. - If you want to extract hdf5\windows\all.zip on the command line, + If you want to extract zip files on the command line, you should 2.1 Install WinZip command line support add-on 1.1 @@ -58,28 +58,18 @@ Extra Preconditions into "Variable Value" and click "OK". Note: - You can also extract all.zip from interactive WinZip interface - without the above two steps. + You can also extract zip files from interactive WinZip + interface without the above two steps. *********************************************************************** Step 1. Building and testing HDF5 libraries and tools - 1. Unpack all.zip - - Unpack all.zip in c:\MyHDFstuff\hdf5\windows into the - C:\myHDFstuff directory. - - This can be done with either of the following 2 options: - - Option A. Unpack from the interactive WinZip interface - - Option B. unpack on the command line - - cd into the c:\MyHDFstuff\hdf5\windows directory - - type: wzunzip -yO -d -o all.zip c:\MyHDFstuff + 1. Run batch file copy_hdf.bat. + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process + will copy all the necessary batch files and text files saved under + c:\MyHDFstuff\hdf5\windows directory to the directories where they + will be used. - 2. Build and Test We provide 2 options for users to build test HDF5 libraries @@ -190,4 +180,4 @@ Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory. -For further information, please refer to INSTALL_WINDOWS.txt. \ No newline at end of file +For further information, please refer to INSTALL_WINDOWS.txt. diff --git a/release_docs/INSTALL_Windows_Short.txt b/release_docs/INSTALL_Windows_Short.txt index 534e579..c46e28e 100755 --- a/release_docs/INSTALL_Windows_Short.txt +++ b/release_docs/INSTALL_Windows_Short.txt @@ -1,9 +1,9 @@ -HDF5 Build and Install Instructions for Windows 2000/XP (Short Version) +HDF5 Build and Install Instructions for Windows XP (Short Version) ------------------------------------------------------------------------ Note: This short instruction is written for users who want to quickly build HDF5 library and tools from the HDF5 source code package but do not want to know HDF5 building and installation details - on Windows 2000/XP. + on Windows XP. For detailed HDF5 build and install information, or if you have trouble following any steps in the instructions, please refer to @@ -20,14 +20,12 @@ notes in INSTALL_Windows.txt before starting below procedures. STEP 1: Building HDF5 Libraries and Tools -1. Unpack all.zip - - Unpack all.zip in c:\MyHDFstuff\hdf5\windows into the - c:\MyHDFstuff directory. +1. Run batch file copy_hdf.bat. + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. 2. Open all.dsw workspace - Open the c:\MyHDFstuff\hdf5\proj\all\all.dsw workspace. + Open the c:\MyHDFstuff\hdf5\windows\proj\all\all.dsw workspace. 3. (Optional) Add C++ and/or FORTRAN related projects @@ -44,20 +42,24 @@ STEP 1: Building HDF5 Libraries and Tools 3.2 Add the follwing projects to project "all" dependencies ONLY if you want to build HDF5 FORTRAN libraries - flush1_fortran - flush1_fortrandll - flush2_fortran - flush2_fortrandll - hdf5_f90cstub - hdf5_f90cstubdll - hdf5_fortran - hdf5_fortrandll - libtest_cstubdll - libtest_fortran - libtest_fortrandll - testhdf5_fortran - testhdf5_fortrandll - + flush1_fortran + flush1_fortrandll + flush2_fortran + flush2_fortrandll + hdf5_f90cstub + hdf5_f90cstubdll + hdf5_fortran + hdf5_fortrandll + hdf5_hl_fortran + hl_test_image_fortran + hl_test_lite_fortran + hl_test_table_fortran + libtest_cstubdll + libtest_fortran + libtest_fortrandll + testhdf5_fortran + testhdf5_fortrandll + 4. Select "Build", then Select "Set Active Configuration". In "Project configurations", select the active configuration -- cgit v0.12