From 714a71d08eaf09bf63673ca92ddac801911dd93d Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Fri, 17 Jun 2005 15:37:16 -0500 Subject: [svn-r10945] Purpose: Add html document for windows users Description: Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows_Short_Intel.htm | 391 +++++++++++++++++++++++++++ 1 file changed, 391 insertions(+) create mode 100755 release_docs/INSTALL_Windows_Short_Intel.htm diff --git a/release_docs/INSTALL_Windows_Short_Intel.htm b/release_docs/INSTALL_Windows_Short_Intel.htm new file mode 100755 index 0000000..b802250 --- /dev/null +++ b/release_docs/INSTALL_Windows_Short_Intel.htm @@ -0,0 +1,391 @@ + + + +HDF5 Build and Install Instructions for Windows XP with +INTEL Compiler + + + + +

HDF5 Build and Install Instructions for Windows XP with INTEL Compiler

(Short Version)

Notes:

1. This short instruction is written for users who want to quickly build HDF5 +library and tools from the HDF5 source code package with Intel Compiler but do +not want to know HDF5 building and installation details on Windows XP. For +detailed HDF5 build and install information, or if you have trouble following +any steps in the instructions, please refer to INSTALL_Windows.txt for further +information. For users who would like to build and test HDF5 package from the +command line, please refer to INSATLL_Windows_From_Command_Line.txt. +

2. 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.

+ +

3. 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 whilt Debug version doesn't.

+ +

4. Szip library is different when using Intel compiler. + You should build Szip source codes with Intel + compiler or download binaries for Intel compiler + from + ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.

+ +

5. 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 in INSTALL_Windows.html.
You have to read this part even if you want to use only Zlib + or Szip. You also need to read Section V in INSTALL_Windows.html
For users using Intel compiler 7.1 integration with MSVS 6.0, + please refer to + "Preconditions 6" on INSTALL_Windows.html to + set up path for external libraries and headers.
For users using Intel compiler 8.1 integration with Visual C++ + .Net 2003, detailed information about setting up external + libraries and header will be given in Part II, 2.1.3 in this + document.

+ +

6. Part II, 2.1 in this document 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 as well as HDF5 Static Fortran + Library, Please go to Part II, 2.2 directly!

+ +

7. Only short information was given on test HDF5 Libraries. Users + want to know detailed information about testing HDF5 Libraries + and tools, please refer to document + + INSTALL_Windows.html, Section II, STEP 2 Testing HDF5 libraries and tools.

+ +

Warnings:

Please read CAREFULLY about +HDF5 build and install preconditions and notes in +INSTALL_Windows.txt before starting below procedures.

Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0

+ +

1.1. Intel C Compiler
+
Go to Tools-->Select Compiler
+
Check Intel box and click OK button.
+
1.2. Intel Fortran Compiler
+
Go to Tools-->Select Compiler
+
Check Intel box and click OK button.
+
Go to Tools-->Customize-->Add-ins and Macro Files and check Intel Fortran Compiler Build Tool
+

+ +

Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment

+ +

2.1 Building HDF5 C and C++ Library with Intel C++ Compiler
+
- 2.1.1 Open all.dsw
  +
  Notes:
  +
  all.sln is for command line use only. please open all.dsw not all.sln.
  +
  Invoke Microsoft Visual C++ .Net 2003. From the main + menu, go to "File" and select "Open Solution". In + the "Open Solution" window, Change "Files of type" to + "All Project Files". Choose "all.dsw" under the directory + c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window, + choose "Yes To All" to convert all project files to Visual + C++ .Net project format.
  +
- 2.1.2 Convert to Use Intel C++ Project System
  + +
  Right click on the solution name "all.sln" in the + "Solution Explorer". From the pop-up menu select + "Convert to use Intel C++ Project System" to convert + all .Net project files to Intel C++ project files.
  +
- 2.1.3 Set up path for external libraries and headers
  +
  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".
  +
- 2.1.4 Building C and C++ Static and DLL Libraries and Tools
  +
  Select "Build", then Select "Set Active Configuration".
  +
  Select "all -- Win32 Debug" or "all -- Win32 Release"
  +
  Disable all Fortran project files listed below:
  + +
  - 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
  +
  Select "ok". Select "Build" -> "Build" or "Rebuild All" to + build debug version of project "all".
  +
- 2.1.5 Testing HDF5 C and C++ Libraries and Tools
  +
  Under directory "hdf5", a batch file hdf5check.bat was provided to + test HDF5 libraries and tools. +
  +
  Invoke command prompt, go to directory "hdf5", type in the following command to test HDF5 C and C++ Libraries.
  +
  - hdf5check enablecpp
  +
  Test results will be save into file check_results.txt under + directory "hdf5". Check check_results.txt, there should be no + "failures" at all. +
  +
+
2.2 Building HDF5 C and C++ Library and Static Fortran Library with Intel Compiler 8.1
+
Notes:
+
This step will build HDF5 Static and DLL C and C++ Library + using Intel C++ 8.1 Compiler as well as HDF5 Static Fortran + Library using Intel Fortran 8.1 Compiler. +
+
Users who want to build ONLY HDF5 Static and DLL C and C++ + Library please go to Part II, 2.1. +
- 2.2.1 Open all.dsw
  +
  Invoke Microsoft Visual C++ .Net 2003. From the main + menu, go to "File" and select "Open Solution". In + the "Open Solution" window, Change "Files of type" to + "All Project Files". Choose "all.dsw" under the directory + c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window, + choose "Yes To All" to convert all project files to Visual + C++ .Net project format.
  +
- 2.2.2 Extract Compaq Visual Fortran Projects
  +
  - a. Select project "flush1_fortran" in the Solution + Explorer window. In the Project menu, select + "Extract Compaq Visual Fortran Project".
    +
    Do the same thing for the following project files:
    +
    - flush2_fortran
    - hdf5_fortran
    - testhdf5_fortran
    - hdf5_hl_fortran
    - hl_test_image_fortran
    - hl_test_lite_fortran
    - hl_test_table_fortran
    +
  - b. Select project "libtest_fortran" in the Solution + Explorer window. In the Project menu, select + "Extract Compaq Visual Fortran Project". Choose + "The Intel Fortran project" as the the main project .
    +
  +
- 2.2.3 Change project dependencies of "libtest_fortran"
  +
  Highlight project "libtest_fortran", choose "Project"-> + "Project Dependencies", uncheck "libtest". +
  +
- 2.2.4 Convert all.sln to Use Intel C++ Project System
  +
  Right click on the solution name "all.sln" in the + "Solution Explorer". From the pop-up menu select + "Convert to use Intel C++ Project System" to convert + all .Net C++ project files to Intel C++ project formats. +
  +
- 2.2.5 Building C and C++ Static and DLL Libraries and Static + Fortran Libraries and Tools
  +
  Select "Build", then Select "Set Active Configuration".
  +
  Select "all -- Win32 Debug" or "all -- Win32 Release"
  +
  Disable all Fortran DLL project files listed below:
  +
  - flush1_fortrandll
  - flush2_fortrandll
  - hdf5_fortrandll
  - libtest_fortrandll
  - testhdf5_fortrandll
  +
  Select "ok". Select "Build" -> "Build" or "Rebuild All" to + build Debug or Release version of HDF5 C, C++ Static and DLL + Library using Intel C++ 8.1 Compiler and HDF5 Static and High + Level Fortran Library using Intel Fortran 8.1 compiler. +
  +
+

Part III Build HDF5 C and C++ Library with Intel C++ Compiler

3.1 Test HDF5 C and C++ Libraries
+
Invoke command prompt, go to directory "hdf5", type in the + following command to test HDF5 C and C++ Libraries.
+
hdf5check enablecpp
+
Test results will be save into file check_results.txt under + directory "hdf5". Check check_results.txt, there should be no + "failures" at all. +
+
3.2 Test HDF5 Static and High Level 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 +
+
- 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.
+
3.3 Test HDF5 High Level Fortran Library
+
Go to directory c:\myHDFstuff\hdf5\hl\fortran\test, Run batch file + testhdf5_fortran.bat with the following two options to test + fortran static library +
+
- test_hdf5_hl_fortran release >> "Your output file name"
- test_hdf5_hl_fortran debug >> "Your output file name"
+
Check your output files, there should be no "failures" at all.
+

+ +

Part IV: Installing HDF5 Libraries

+ +

Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install +all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.

+ +

Part V: Building HDF5 Examples (Optional)

Please read section II, step 4 in INSTALL_Windows.html.

+ +

Thank you for using Hierarchical Data Format (HDF). For users who need further assistance, please +send email to hdfhelp@ncsa.uiuc.edu

+ + + -- cgit v0.12

HDF5 Build and Install Instructions for Windows XP with INTEL Compiler

Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0

1.1. Intel C Compiler

1.2. Intel Fortran Compiler

Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment

2.1 Building HDF5 C and C++ Library with Intel C++ Compiler

2.1.1 Open all.dsw

2.1.2 Convert to Use Intel C++ Project System

2.1.3 Set up path for external libraries and headers

2.1.4 Building C and C++ Static and DLL Libraries and Tools

2.1.5 Testing HDF5 C and C++ Libraries and Tools

2.2 Building HDF5 C and C++ Library and Static Fortran Library with Intel Compiler 8.1

2.2.1 Open all.dsw

2.2.2 Extract Compaq Visual Fortran Projects

2.2.3 Change project dependencies of "libtest_fortran"

2.2.4 Convert all.sln to Use Intel C++ Project System

2.2.5 Building C and C++ Static and DLL Libraries and Static + Fortran Libraries and Tools

Part III Build HDF5 C and C++ Library with Intel C++ Compiler

3.1 Test HDF5 C and C++ Libraries

3.2 Test HDF5 Static and High Level Fortran Library

3.3 Test HDF5 High Level Fortran Library

Part IV: Installing HDF5 Libraries

Part V: Building HDF5 Examples (Optional)

Thank you for using Hierarchical Data Format (HDF). For users who need further assistance, please +send email to hdfhelp@ncsa.uiuc.edu