summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
Diffstat (limited to 'release_docs')
-rwxr-xr-xrelease_docs/INSTALL_Windows_Short_Intel.htm391
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 &gt;&gt; "Your output file name" </li>
+ <li>testhdf5_fortran debug &gt;&gt; "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 &gt;&gt; "Your output file name" </li>
+
+ <li>test_hdf5_hl_fortran debug &gt;&gt; "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>&nbsp;</p>
+<p>&nbsp;</p>
+
+</BODY>
+</HTML>