hdf5/release_docs/INSTALL_Windows_Short_INTEL.TXT

************************************************************************
*HDF5 Build and Install Instructions for Windows XP with INTEL Compiler*
*                          (Short Version)                             *
************************************************************************

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.
          
       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 reading this 
       instruction.

========================================================================
                      Extra Preconditions and 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. 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 be turned off always.
  
========================================================================
               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 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
      
      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 
      
      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 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
   	        
      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
       
      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
        
      Same as 2.1.1 and 2.1.2.

      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 .

       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 hdfhelp@ncsa.uiuc.edu for further assistance.