From 77de06b38178abb8dc050699dd1526ac74579a95 Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Fri, 10 Jun 2005 14:10:50 -0500 Subject: [svn-r10894] Purpose: Add short version instruction for users using Intel Compiler Description: Add a short version instruction for building and testing HDF5 with Intel C and Fortan compiler on windows XP. Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows_Short_INTEL.TXT | 259 +++++++++++++++++++++++++++ 1 file changed, 259 insertions(+) create mode 100755 release_docs/INSTALL_Windows_Short_INTEL.TXT diff --git a/release_docs/INSTALL_Windows_Short_INTEL.TXT b/release_docs/INSTALL_Windows_Short_INTEL.TXT new file mode 100755 index 0000000..87dd457 --- /dev/null +++ b/release_docs/INSTALL_Windows_Short_INTEL.TXT @@ -0,0 +1,259 @@ +HDF5 Build and Install Instructions for Windows XP with INTEL Compiler + (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 + 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. + +***************************WARNINGS************************************* +Please read CAREFULLY about HDF5 build and install preconditions and +notes in INSTALL_Windows.txt before starting below procedures. +************************************************************************ + +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. + + 2. HDF5 Fortran DLL Libraries is not supported with Intel Fortran 8.1 + integration with Visual C++ .Net 2003 Environment. + + 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/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++ 7.0 2003, detailed + information about setting up external libraries and header will be given in + Part II, 2.1.3 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 + PartII, 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. + +Part I. 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. INTEL compiler 8.1 with Visual C++ .Net 2003 Environment + + 2.1 Intel C++ Compiler + + 2.1.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.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 + libtest_cstubdll + libtest_fortran + libtest_fortrandll + testhdf5_fortran + testhdf5_fortrandll + hdf5_hl_fortran + hl_test_image_fortran + hl_test_lite_fortran + hl_test_table_fortran + + + 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 Intel Fortran Compiler 8.1 under MSVS C++ .Net 2003 Environment + + Note: 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 Part2, 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. + + 2.2.6 Test HDF5 Static and High Level 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 will be save into file check_results.txt under directory "hdf5" + Check check_results.txt, there should be no "failures" at all. + + 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 hdfhelp@ncsa.uiuc.edu for further assistance. + -- cgit v0.12