diff options
author | Scott Wegner <swegner@hdfgroup.org> | 2007-04-14 15:46:08 (GMT) |
---|---|---|
committer | Scott Wegner <swegner@hdfgroup.org> | 2007-04-14 15:46:08 (GMT) |
commit | 26f835b908dd8721b703752219127b34da077814 (patch) | |
tree | 345a48703068913c4c52eb051865fc160c922f2d /release_docs/INSTALL_Windows_Short_INTEL.TXT | |
parent | 0332285cfff86ebb5624ef949430830e91389cc6 (diff) | |
download | hdf5-26f835b908dd8721b703752219127b34da077814.zip hdf5-26f835b908dd8721b703752219127b34da077814.tar.gz hdf5-26f835b908dd8721b703752219127b34da077814.tar.bz2 |
[svn-r13662] Updated Windows documentation to reflect our Intel Fortran 9.1 Compiler support, as well as our depreciation of previous versions of the Intel Compiler.
No testing needed.
Diffstat (limited to 'release_docs/INSTALL_Windows_Short_INTEL.TXT')
-rwxr-xr-x | release_docs/INSTALL_Windows_Short_INTEL.TXT | 648 |
1 files changed, 383 insertions, 265 deletions
diff --git a/release_docs/INSTALL_Windows_Short_INTEL.TXT b/release_docs/INSTALL_Windows_Short_INTEL.TXT index df51873..ede5ea2 100755 --- a/release_docs/INSTALL_Windows_Short_INTEL.TXT +++ b/release_docs/INSTALL_Windows_Short_INTEL.TXT @@ -5,8 +5,9 @@ Notes: 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. + with Intel Fortran 9.1 Compiler with Microsoft Visual Studio .NET or 2005 + 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 @@ -15,6 +16,11 @@ Notes: This short instruction is written for users who want to quickly For users who would like to build and test HDF5 package from the command line, please refer to INSATLL_Windows_From_Command_Line.txt. + + We no longer support the Intel C compiler, Intel Fortran 7.x or 8.x. + However, if you would still like to use one of these compilers, + documentation is available online at + http://hdfgroup.org/windows/docs/hdf518/dep/Install_Windows_Dep_Intel.txt WARNINGS: Please read CAREFULLY about HDF5 build and install preconditions @@ -24,281 +30,393 @@ WARNINGS: ======================================================================== Extra Preconditions and Notes ======================================================================== + + a. Setup Szip Library for Intel Compiler. - 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. But - Release version of HDF5 Fortran DLL Libraries works with Intel - Fortran while Debug version doesn't. - - 3. 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. - - 4. 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. - - You have to read this part even if you want to use only Zlib - or Szip. You also need to read Section V on - INSTALL_Windows.txt - - For users using Intel compiler 7.1 integration with MSVS 6.0, - please refer to "Preconditions 6" on INSTALL_Windows.txt 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.4 in this - document. - - 5. Part II, 2.1 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! - - 6. 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.txt, - Section II, STEP 2 Testing HDF5 libraries and tools. - - 7. For .Net and Intel users, If you are not building HDF5 with - Thread-Safe Feature, ttsafedll.dsp should always be turned off. - -======================================================================== - Part I. INTEL compiler 7.1 with MSVS 6.0 -======================================================================== + 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.hdfgroup.org/lib-external/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. Instead, read Section V of Install_Windowx.txt. + + You have to read this part even if you want to use only Zlib + or Szip. You also need to read Section V of Install_Windowx.txt. + + Invoke Microsoft Visual C++ .Net 2003 or 2005. From the main + menu, Go to Tools > Options > Intel(R) Fortran. + In the right panel, make sure your "Selected Compiler" is Intel Fortran 9.1. + Click the right-most box for "Libraries", + Add Zlib and Szip Library Path (c:\zlib122\lib, c:\szip\dll for example) + Click rightmost box for "Includes", + Add Zlib and Szip header path (c:\zlib122\include c:\szip\include, for example). + Then click "OK". - 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. INTEL compiler 8.1 with Visual C++ .Net 2003 Environment + Part I. Build with Intel Fortran + Compiler 9.1 under MSVS C++ .Net 2003 / 2005 Environment ======================================================================== - - 2.1 Intel C++ Compiler - - 2.1.1 Run copy_hdf.bat - - Go to directory hdf5/windows/, run batch file copy_hdf.bat to - copy necessay files to the directory where they will be used. - - 2.1.2 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.3 Convert to Use Intel C++ Project System + + Note: This step will build HDF5 Static and DLL C and C++ + Library using .Net 2003 or Visual Studio 2005 Compiler as well as + HDF5 Static and High Level Fortran Library using Intel + Fortran 9.1 Compiler. + + + 1.1 Open all.dsw and Convert Project Files (.dsp) to Visual + C++ .Net Format (.vcproj) + + 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. + + 1.2 Extract Compaq Fortran Project Files + + 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, but for now, skip + the projects labelled "**SKIP**": + + flush1_fortrandll + flush2_fortran + flush2_fortrandll + hdf5_fortran + hdf5_fortrandll + **SKIP** libtest_fortran + libtest_fortrandll + testhdf5_fortran + testhdf5_fortrandll + **SKIP** hdf5_hl_fortran + hdf5_hl_fortrandll + hl_test_image_fortran + hl_test_image_fortrandll + hl_test_lite_fortran + hl_test_lite_fortrandll + hl_test_table_fortran + hl_test_table_fortrandll + + + b. Select project "libtest_fortran" in the Solution + Explorer window. In the Project menu, select + "Extract Compaq Visual Fortran Project". Since Project + file "libtest_fortran" contain both C and Fortran code, + you will be asked to specify which project, either + Fortran or C/C++, will serve as the main project for + this mixed language projects. Choose + "The Intel Fortran project" as the the main project and + click "OK". + + Do the same thing for hdf5_hl_fortran. + + 1.3 Change project dependencies + + + To check the project dependencies: - 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.4 Set up path for external libraries and headers + Right click the selected project, you should see "Project Dependencies" on the menu, + click "Project Dependencies", You should see a "Project Dependencies" panel, with + the selected project and the projects it depends on checked under "Depends on" list. + + Make sure all intel fortran projects have their corrsponding dependencies as follows: + + hdf5_fortran: hdf5, hdf5_f90cstub + + hdf5_fortrandll: hdf5dll, hdf5_f90cstubdll + + libtest_fortran: libtest, libtest_fotran_lib + + libtest_fortrandll: libtest_cstubdll, libtestD + + hdf5_hl_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, hdf5_hl, + hdf5_hl_fortran_lib + + hdf5_hl_fortrandll: hdf5dll, hdf5_hldll, + hdf5_hl_f90cstubdll, hdf5_fortrandll, + hdf5_f90cstubdll + + + flush1_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, libtest, + libtest_fortran, libtest_fortran_lib + + flush1_fortrandll: hdf5_f90cstubdll, hdf5_fortrandll, + hdf5dll, libtest_fortrandll + libtest_cstubdll, libtestD + + flush2_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, libtest, + libtest_fortran, libtest_fortran_lib + + flush2_fortrandll: hdf5_f90cstubdll, hdf5_fortrandll, + hdf5dll, libtest_fortrandll + libtest_cstubdll, libtestD + + testhdf5_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, libtest, + libtest_fortran, libtest_fortran_lib + + testhdf5_fortrandll: hdf5_f90cstubdll, hdf5_fortrandll, + hdf5dll, libtest_fortrandll + libtest_cstubdll, libtestD + + + + hl_test_image_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, hdf5_hl, + hdf5_hl_fortran, hdf5_hl_fortran_lib + + hl_test_image_fortrandll: hdf5dll, hdf5_hldll, + hdf5_f90cstubdll, hdf5_fortrandll, + hdf5_hl_f90cstubdll, hdf5_hl_fortrandll - 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 + hl_test_lite_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, hdf5_hl, + hdf5_hl_fortran, hdf5_hl_fortran_lib + + hl_test_lite_fortrandll: hdf5dll, hdf5_hldll, + hdf5_f90cstubdll, hdf5_fortrandll, + hdf5_hl_f90cstubdll, hdf5_hl_fortrandll + + hl_test_table_fortran: hdf5, hdf5_f90cstub, + hdf5_fortran, hdf5_hl, + hdf5_hl_fortran, hdf5_hl_fortran_lib - Select "Build", then Select "Set Active Configuration". - - Select "all -- Win32 Debug" or "all -- Win32 Release" - - Disable all Fortran project files listed below and ttsafedll - project file: - - 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 - hdf5_hl_fortran - hdf5_hl_fortrandll - hdf5_hl_f90cstubdll - hl_test_image_fortran - hl_test_image_fortrandll - hl_test_lite_fortran - hl_test_lite_fortrandll - hl_test_table_fortran - hl_test_table_fortrandll - ttsafedll - + hl_test_table_fortrandll:hdf5dll, hdf5_hldll, + hdf5_f90cstubdll, hdf5_fortrandll, + hdf5_hl_f90cstubdll, hdf5_hl_fortrandll + + + + 1.4 Building HDF5 C/C++/Fortran Libraries and Tools + + Select "Build", then Select "Configuration Manager". + + Select "Debug" or "Release" + + Disable ttsafedll + + 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. + build Debug or Release version of HDF5 C, C++, fortran + Library using Intel fortran 9.1 Compiler with .Net 2003 or .Net 2005. + +======================================================================== + Part II. Test HDF5 Static and High Level Fortran Library +======================================================================== + + We provide 2 options for users to test HDF5 libraries and tools. + + Option 1: Automatic testings + + HDF5 comes with various test suites, all of which can be tested + with hdf5check.bat batch file in c:\MyHDFstuff\hdf5 directory. + + hdf5check batch file can used to test HDF libraries with Fortran with + the following options: + + hdf5check enablefortran test HDF5 C/FORTRAN libraries and + tools + + + hdf5check enableall test HDF5 C/C++/FORTRAN libraries + and tools + To use this option, HDF5 C++ and + Fortran libraries must have been + built. + + Invoke a command prompt window and run hdf5check with appropriate + option. + + Test results are saved in two files: + + c:\MyHDFstuff\hdf5\check_results.txt + + c:\MyHDFstuff\hdf5\tests_results.txt. + + In general, you only need to check tests_results.txt. If all the + tests passed, then you do not have to check check_results.txt. + If some tests failed, check check_results.txt can help you + figure out what was wrong. + + + Option 2: Step-by-step HDF5 libraries and tools testings + + Note: This section provides step-by-step instructions for testing the + Fortran librariy and tools only. To test the rest of the HDF5 library + and tools, please see Section II, Step 2 of Install_Windowx.txt. - 2.2 Intel Fortran Compiler 8.1 under MSVS C++ .Net 2003 Environment - 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 run copy_hdf.bat and Open all.dsw + 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 + + 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. + + b. 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 III. (Optional) Build HDF5 Fortan and HL Fortran Examples +======================================================================== + + Note: This section only covers building Fortran and HL Fortran examples. + For other examples, please see Section III of Install_Windowx.txt. - Same as 2.1.1 and 2.1.2. + To build and test HDF5 Fortran example: + --------------------------------------- - 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 - 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 . + 1. Invoke the Intel Fortran Compiler 9.1 or above under Microsoft + Visual Studio development environment, go to "File" and select + the "Open Workspace" option. + + Then open the workspace + c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw. + + 2. Select "Build", then Select "Set Active Configuration". + + 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\ + + attreexampletest + attreexampletestdll + compoundtest + compoundtestdll + dsetexampletest + dsetexampletestdll + fileexampletest + fileexampletestdll + groupexampletest + groupexampletestdll + grpdsetexampletest + grpdsetexampletestdll + grpittest + grpittestdll + grpsexampletest + grpsexampletestdll + hyperslabtest + hyperslabtestdll + mountexampletest + mountexampletest + refobjexampletest + refobjexampletestdll + refregexampletest + refregexampletestdll + rwdsetexampletest + rwdsetexampletestdll + selecteletest + selecteletestdll + + 3. Invoke a command prompt window and run the batch file + Installf90Examples.bat which resides in the top level directory + (c:\MyHDFstuff\hdf5). This file creates 4 new directories, + f90examplesREL, f90examplesRELDLL, f90examplesDBG, and + f90examplesDBGDLL, in the c:\MyHDFstuff\fortran\examples directory + and places all the executables in it. Both the release and debug + versions of the examples should be built before this step is done. + + + To build and test HDF5 High Level Fortran examples: + --------------------------------------------------- + + 1. Invoke Compaq Visual Fortran 6.6c, open the workspace + + c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\ (continue next line) + allhlf90examples\allhlf90examples.dsw + + 2. Select "Build", then Select "Set Active Configuration". + + 2.1 To build debug versions of High Level Fortran examples. + In "Project configurations", select + "allhlf90examples -- Win32 Debug", select "ok". Select + "Build" -> "Build" or "Rebuild All" to build debug version + of project "allhlf90examples". + + 2.2 To build release versions of Fortran examples. + In "Project configurations", select + "allhlf90examples -- Win32 Release", select "ok". Select + "Build" -> "Build" or "Rebuild All" to build release version + of project "allhlf90examples". + + When the debug build or release build is done, there should be the + following subdirectories in c:\MyHDFstuff\hdf5\hl\fortran\examples + + ex_lite + ex_litedll + + 3. Invoke a command prompt window and run the batch file + Install_hlf90examples.bat which resides in the top level directory + (c:\MyHDFstuff\hdf5). This file creates 4 new directories, + HLf90examplesRELEASE, HLf90examplesRELEASEDLL, HLf90examplesDEBUG, + and HLf90examplesDEBUGDLL, in the + c:\MyHDFstuff\hdf5\hl\fortran\examples directory and places all + the executables in it. Both the release + and debug versions of the examples should be built before this + step is done. + + 4. We provide a batch file named test_hl_f90examples.bat in + c:\MyHDFstuff\hdf5\hl\fortran\examples directory for you to test + HDF5 high level fortran examples. + + test_hl_f90examples.bat batch file has 4 options: + + Options purpose + + test_hl_f90examples release -- for release version + + test_hl_f90examples release dll -- for release DLL version + + test_hl_f90examples debug -- for debug version + + test_hl_f90examples debug dll -- for debug DLL version + + Invoke a command prompt window and run test_hl_f90examples with + appropriate options. + + When you run "test_hl_f90examples release", the output will look + like: + + release version of High Level Fortran examples PASSED + + Similar messages should be generated with another three options + If the high level Fortran examples are built successfully. - Do the same thing for hdf5_hl_fortran. - - 2.2.3 Change project dependencies of "libtest_fortran" - - Highlight project "libtest_fortran", choose "Project"-> - "Project Dependencies", uncheck "libtest". - - Highlight project "hdf5_hl_fortran", choose tab "Project"-> - "Project Dependencies", uncheck "hdf5_fortran" and "hdf5_hl". - - 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 "all -- Win32 Debug" or "all -- Win32 Release" - - Disable all Fortran DLL project files listed below and ttsafedll - project file: - - flush1_fortrandll - flush2_fortrandll - hdf5_fortrandll - hdf5_hl_fortrandll - hdf5_hl_f90cstubdll - hl_test_image_fortrandll - hl_test_lite_fortrandll - hl_test_table_fortrandll - libtest_fortrandll - testhdf5_fortrandll - ttsafedll - - 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. - - 2.2.6 Test HDF5 C/C++ and Static Fortran Library - - a. 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 are saved in two files: - - c:\MyHDFstuff\hdf5\tests_results.txt - - c:\MyHDFstuff\hdf5\check_results.txt. - - In general, you only need to check tests_results.txt. If all the - tests passed, then you do not have to check check_results.txt. - If some tests failed, check check_results.txt can help you - figure out what was wrong. - - b. Test HDF5 Static Fortran Library - - Go to directory 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. - - c. Test HDF5 High Level Fortran Library - Go to directory hdf5\hl\fortran\test, run batch file - testhdf5_fortran.bat with the following two options to test - fortran high level 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. - - -*********************************************************************** -Please send email to help@hdfgroup.org for further assistance. + +*********************************************************************** +Please send email to help@hdfgroup.org for further assistance. |