diff options
| author | Fang Guo <fangguo@ncsa.uiuc.edu> | 2005-06-17 20:37:16 (GMT) |
|---|---|---|
| committer | Fang Guo <fangguo@ncsa.uiuc.edu> | 2005-06-17 20:37:16 (GMT) |
| commit | 714a71d08eaf09bf63673ca92ddac801911dd93d (patch) | |
| tree | 09926119fdc3183725e9e5dba36a459ab45f99d7 /release_docs | |
| parent | bd867cf9f6c14077357a7306e4a236a72c938ec9 (diff) | |
| download | hdf5-714a71d08eaf09bf63673ca92ddac801911dd93d.zip hdf5-714a71d08eaf09bf63673ca92ddac801911dd93d.tar.gz hdf5-714a71d08eaf09bf63673ca92ddac801911dd93d.tar.bz2 | |
[svn-r10945] Purpose:
Add html document for windows users
Description:
Solution:
Platforms tested:
Misc. update:
Diffstat (limited to 'release_docs')
| -rwxr-xr-x | release_docs/INSTALL_Windows_Short_Intel.htm | 391 |
1 files changed, 391 insertions, 0 deletions
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 @@ +<HTML> +<HEAD> +<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0"> +<TITLE>HDF5 Build and Install Instructions for Windows XP with +INTEL Compiler </TITLE> +<style type="text/css"> + +h1 { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 180%; + font-style:bold; + color:#0000FF; + text-align:center; + text-transform:capitalize; + } +h2 { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 160%; + font-style:bold; + color:#0000FF; + text-align:center; + text-transform:capitalize; + + } +h3 { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 140%; + font-style:bold; + color:#0000FF; + text-transform:capitalize; + } +h4 { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 120%; + font-style:bold; + color:#0000FF; + } +h5 { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 110%; + font-style:bold; + color:#0000FF; + } + +p.right{text-align:right;color:#A52A2A;} +p { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 110%; + text-align:left; + + } +p.note{ + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 110%; + text-align:left; + color:#FF0000 + } + +ul.normal +{ +margin-left:10%; +list-style-type:none; +margin-bottom:15px; +} +ul.intable +{ +text-align: left; +list-style-type:none; +} +td {font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 110%; + text-align:left; + padding:10; + } +a {text-decoration:none} +a:link {color:#0000FF;} +a:visited {color:purple;} +a:hover {background-color:#FAEBD7;} +table { + font-family:font-family:times, arial, 'lucida console', sans-serif; + font-size: 100%; + text-align:left; + border:thin solid blue; + } + +body { + margin-left:5%; + margin-right:5% + } +hr.first {color:#0000FF; height:4px;width:100%;magin-top:10px;margin-bottom:10px;border:thick double blue;} +hr.second{color:#0000FF;height:2px; width:100%;magin-top:5px;margin-bottom:5px;border:thin dotted;} + +</style> +</HEAD> +<BODY> + +<h1>HDF5 Build and Install Instructions for Windows XP with INTEL Compiler</h1> +<p style="TEXT-ALIGN: center">(Short Version)</p> +<hr class="first" > +<p class="note">Notes:</p> +<p> 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. +</p> +<p>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.</p> + +<p>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.</p> + +<p>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 <a href="ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows" target="_blank"> + ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.</a> </p> + +<p>5. Set up path for external libraries and headers + <ul class="intable"> + + + <li><p>Skip this part if you don't want to use ANY compression + features provided by HDF5. Please do read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_Windows.html.</a></p></li> + + <li><p>You have to read this part even if you want to use only Zlib + or Szip. You also need to read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target="_blank">Section V in INSTALL_Windows.html</a></p></li> + + <li><p>For users using Intel compiler 7.1 integration with MSVS 6.0, + please refer to<a href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#precondition6" target="_blank"> + "Preconditions 6" on INSTALL_Windows.html </a>to + set up path for external libraries and headers.</p></li> + + <li><p>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.</p></li> + </ul> +</p> + +<p>6. <a href="#part2_2.1" target="_blank">Part II, 2.1 </a>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 <a href="#part2_2.2" target="_blank">Part II, 2.2 </a>directly!</p> + +<p>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 + <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank> + INSTALL_Windows.html, Section II, STEP 2 Testing HDF5 libraries and tools.</a></p> + +<p class="note">Warnings:</p> +<p class="note">Please read CAREFULLY about <a href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#preconditions" target="_blank"> +HDF5 build and install preconditions and notes</a> in +INSTALL_Windows.txt before starting below procedures. </p> +<hr class="second" /> +<h2>Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0</h2> +<hr class="second" /> + + <ul class="intable"> + <li><h3>1.1. Intel C Compiler</h3> + <p>Go to Tools-->Select Compiler</p> + <p>Check Intel box and click OK button.</p> + </li> + <li><h3>1.2. Intel Fortran Compiler</h3> + <p>Go to Tools-->Select Compiler</p> + <p>Check Intel box and click OK button.</p> + <p>Go to Tools-->Customize-->Add-ins and Macro Files and check Intel Fortran Compiler Build Tool</p> + </li> + </ul> + +<hr class="second" /> +<h2>Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment</h2> +<hr class="second" /> + + <ul class="intable"> + <li><h3><a name="part2_2.1">2.1 Building HDF5 C and C++ Library with Intel C++ Compiler</a></h3> + <ul class="intable"> + <li><h4>2.1.1 Open all.dsw</h4> + <p class="note">Notes:</p> + <p>all.sln is for command line use only. please open all.dsw not all.sln.</p> + <p>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.</p> + </li> + <li><h4>2.1.2 Convert to Use Intel C++ Project System</h4> + + <p>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. </p> + </li> + <li><h4>2.1.3 Set up path for external libraries and headers</h4> + <p> Go to Tools > Options > Intel C++. In the left pane, Click "General".</p> + <ul class="intable"> + <li><p>a. In the right pane, under "Compiler selection", + choose Intel C++ 8.1.</p></li> + <li><p>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).</p></li> + <li><p>c. Then click "OK".</p></li> + </ul> + </li> + <li><h4>2.1.4 Building C and C++ Static and DLL Libraries and Tools</h4> + <p>Select "Build", then Select "Set Active Configuration".</p> + <p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p> + <p>Disable all Fortran project files listed below:</p> + + <ul class="normal"> + <li>flush1_fortran </li> + <li>flush1_fortrandll </li> + <li>flush2_fortran </li> + <li>flush2_fortrandll </li> + <li>hdf5_f90cstub </li> + <li>hdf5_f90cstubdll</li> + <li>hdf5_fortran </li> + <li>hdf5_fortrandll </li> + <li>hdf5_hl_fortran </li> + <li>hl_test_image_fortran</li> + <li>hl_test_lite_fortran</li> + <li>hl_test_table_fortran </li> + <li>libtest_cstubdll </li> + <li>libtest_fortran </li> + <li>libtest_fortrandll </li> + <li>testhdf5_fortran </li> + <li>testhdf5_fortrandll</li> + </ul> + <p>Select "ok". Select "Build" -> "Build" or "Rebuild All" to + build debug version of project "all".</p> + </li> + <li><h4>2.1.5 Testing HDF5 C and C++ Libraries and Tools</h4> + <p>Under directory "hdf5", a batch file hdf5check.bat was provided to + test HDF5 libraries and tools. + </p> + <p>Invoke command prompt, go to directory "hdf5", type in the following command to test HDF5 C and C++ Libraries.</p> + <ul class="normal"> + <li>hdf5check enablecpp</li> + </ul> + <p>Test results will be save into file check_results.txt under + directory "hdf5". Check check_results.txt, there should be no + "failures" at all. + </p> + </li> + </ul> + </li> + <li><h3><a name="part2_2.2">2.2 Building HDF5 C and C++ Library and Static Fortran Library with Intel Compiler 8.1</a></h3> + <p class="note">Notes:</p> + <p>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. + </p> + <p>Users who want to build ONLY HDF5 Static and DLL C and C++ + Library please go to <a href="#part2_2.1" target="_blank">Part II, 2.1.</a> + <ul class="intable"> + <li><h4>2.2.1 Open all.dsw</h4> + <p>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.</p> + </li> + + <li><h4> 2.2.2 Extract Compaq Visual Fortran Projects</h4> + <ul class="intable"> + <li><p> a. Select project "flush1_fortran" in the Solution + Explorer window. In the Project menu, select + "Extract Compaq Visual Fortran Project". </p> + <p>Do the same thing for the following project files:</p> + <ul class="normal"> + <li>flush2_fortran </li> + <li>hdf5_fortran </li> + <li>testhdf5_fortran </li> + <li>hdf5_hl_fortran </li> + <li>hl_test_image_fortran </li> + <li>hl_test_lite_fortran </li> + <li>hl_test_table_fortran</li> + </ul> + </li> + <li><p>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 .</p> + </li> + </ul> + </li> + <li><h4>2.2.3 Change project dependencies of "libtest_fortran"</h4> + <p>Highlight project "libtest_fortran", choose "Project"-> + "Project Dependencies", uncheck "libtest". + </p> + </li> + <li><h4>2.2.4 Convert all.sln to Use Intel C++ Project System</h4> + <p>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. + </p> + </li> + <li><h4>2.2.5 Building C and C++ Static and DLL Libraries and Static + Fortran Libraries and Tools</h4> + <p>Select "Build", then Select "Set Active Configuration".</p> + <p>Select "all -- Win32 Debug" or "all -- Win32 Release"</p> + <p>Disable all Fortran DLL project files listed below:</p> + <ul class="normal"> + <li>flush1_fortrandll </li> + <li>flush2_fortrandll </li> + <li>hdf5_fortrandll </li> + <li>libtest_fortrandll </li> + <li>testhdf5_fortrandll</li> + </ul> + <p>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. + </p> + </li> + </ul> + </li> + </ul> + <hr class="second" /> + <h2>Part III Build HDF5 C and C++ Library with Intel C++ Compiler</h2> + <hr class="second" /> + <ul class="intable"> + <li><h3>3.1 Test HDF5 C and C++ Libraries</h3> + <p>Invoke command prompt, go to directory "hdf5", type in the + following command to test HDF5 C and C++ Libraries.</p> + <p>hdf5check enablecpp</p> + <p>Test results will be save into file check_results.txt under + directory "hdf5". Check check_results.txt, there should be no + "failures" at all. + </p> + </li> + + <li><h3>3.2 Test HDF5 Static and High Level Fortran Library</h3> + <p>Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file + testhdf5_fortran.bat with the following two options to test + fortran static library + </p> + <ul class="normal"> + <li>testhdf5_fortran release >> "Your output file name" </li> + <li>testhdf5_fortran debug >> "Your output file name"</li> + </ul> + <p>Check your output files, there should be no "failures" at all.</p> + </li> + <li><h3>3.3 Test HDF5 High Level Fortran Library</h3> + <p>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 + </p> + <ul class="normal"> + <li>test_hdf5_hl_fortran release >> "Your output file name" </li> + + <li>test_hdf5_hl_fortran debug >> "Your output file name"</li> + </ul> + <p>Check your output files, there should be no "failures" at all.</p> + </li> + </ul> + +<hr class="second" > +<h2>Part IV: Installing HDF5 Libraries</h2> +<hr class="second" > + +<p>Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install +all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.</p> + +<hr class="second" > +<h2>Part V: Building HDF5 Examples (Optional)</h2> +<hr class="second" > +<p>Please read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step4_section2" target=_blank>section II, step 4 in INSTALL_Windows.html.</A></p> + +<hr class="first" /> + +<h4 style="COLOR: white; BACKGROUND-COLOR: green">Thank you for using Hierarchical Data Format (HDF). For users who need further assistance, please +send email to <A href="mailto:hdfhelp@ncsa.uiuc.edu">hdfhelp@ncsa.uiuc.edu</A></h3> +<p> </p> +<p> </p> + +</BODY> +</HTML> |