diff options
| author | Fang Guo <fangguo@ncsa.uiuc.edu> | 2005-06-17 17:08:41 (GMT) |
|---|---|---|
| committer | Fang Guo <fangguo@ncsa.uiuc.edu> | 2005-06-17 17:08:41 (GMT) |
| commit | b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7 (patch) | |
| tree | 9992d6f33de825f2a0940eb40a48d4f48d378bac /release_docs | |
| parent | 8896b0239429757f52bc129dbc9d2755ab5b4ccc (diff) | |
| download | hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.zip hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.gz hdf5-b82f8b3adeb2c36ad3e6a31b60a4d94e5b046ed7.tar.bz2 | |
[svn-r10934] 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_Net.htm | 280 |
1 files changed, 280 insertions, 0 deletions
diff --git a/release_docs/INSTALL_Windows_Short_Net.htm b/release_docs/INSTALL_Windows_Short_Net.htm new file mode 100755 index 0000000..be766fc --- /dev/null +++ b/release_docs/INSTALL_Windows_Short_Net.htm @@ -0,0 +1,280 @@ +<HTML> +<HEAD> +<META NAME="GENERATOR" Content="Microsoft Visual Studio 6.0"> +<TITLE>HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003</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 MSVS .NET 2003</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 Microsoft Visual Studio .NET 2003 but do not want to know HDF5 + building and installation details on Windows XP.</p> + <P>2. For detailed HDF5 build and install information, or if you have + trouble following any steps in the instructions, please refer to + INSTALL_Windows.html for further information.</P> + <p>3. 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 class="note">Warnings: Please read CAREFULLY about HDF5 build and install preconditions and +notes in INSTALL_Windows.html before starting below procedures.</p> + +<hr class="second" > +<h2>Preconditions:</h2> +<hr class="second" > + +<h3>a. Setup path Visual Studio .Net 2003 Compiler. </h3> +<p> Open "System" in Control Panel.</p> +<p>On the "Advanced" tab, click "Environment Variables", click + "Path" in the "System variables" box, then click "Edit" and + add your Visual C++ .Net path (For example, + C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\IDE) + into "Variable Value" and click "OK". </p> + <h3>b. Set up path for external libraries and headers</h3> + <p>Skip this part if you don't want to use ANY compression features + provided by HDF5. Read <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#section5" target=_blank>Section V in INSTALL_WINDOWS.html</A>. + </p> + <p>You have to read this part even if you want to only use 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><p>Invoke Microsoft Visual C++ .Net and go to "Tools" and select + "Options". In the left pane of "Option" window poped up, + choose and extend "Projects", Click on "VC++ Directories". + In the right pane, Find the box "Show directories for", choose + "Include files", if you can not find your Zlib and Szip + header path + (for example, c:\zlib122\include, c:\szip\include) + from the directory list, add the header path + (c:\zlib122\include, c:\szip\include) to the + included directories. </p><p>Find the box "Show directories for", choose "Library files", + If you cannot find your Zlib and Szip library path + (for example, c:\zlib122\lib, c:\szip\dll) + from the directory list, add the library path + (c:\zlib122\lib, c:\szip\dll) to the library directories. </p> +<hr class="second" > +<h2>STEP 1: Building HDF5 Libraries and Tools</h2> +<hr class="second" > +<h3>1. Open all.dsw workspace</h3><p class="note">Notes:</p><p>Notes: all.sln is for command 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, + chooise "Yes To All" to convert all project files to Visual + C++ .Net project format.</p> + +<h3>2. Building HDF5 C and C++ Libraries </h3><p>Users can choose the desirable libraries to be built according + to the following describtion.</p> <ul class="intable"> <li><h4>2.1 If you don't want to build HDF5 C++ Libraries</h4> <p>Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration"</p> <p>Disable the following projects:</p> <ul class="normal"> + <li>dsets_cpp + <li>dsets_cppdll + <li>hdf5_cpp + <li>hdf5_cppdll + <li>testhdf5_cpp + <li>testhdf5_cppdll + <li>hdf5_hl_cpp + <li>hl_test_table_cpp</li> + </ul> <p>Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. </p> <li><h4>2.2 If you don't want to build HDF5 Fortran Libraries</h4> <p>Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration" </p> <p>Disable the following projects:</p> <ul class="normal"> + <li>flush1_fortran + <li>flush1_fortrandll + <li> flush2_fortran + <li>flush2_fortrandll + <li>hdf5_f90cstub + <li>hdf5_f90cstubdll + <li>hdf5_fortran + <li>hdf5_fortrandll + <li>hdf5_hl_fortran + <li>hl_test_image_fortran + <li>hl_test_lite_fortran + <li>hl_test_table_fortran + <li>libtest_cstubdll + <li>libtest_fortran + <li>libtest_fortrandll + <li>testhdf5_fortran + <li>testhdf5_fortrandll</li> + </ul> <p>Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. </p> <li><h4>2.3 If you don't want to build HDF5 High-Level Libraries</h4> <P>Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration" </P> <p>Disable the following projects:</p> <ul class="normal"> <li>hdf5_hl + <li>hl_test_image + <li>hl_test_lite + + <li>hl_test_table + <li>hl_test_ds + <li>hl_test_packet</li> + </ul> <p>Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. </p> <li><h4>2.4 If you don't want to build HDF5 C++ High-Level Libraries</h4> <p>Go to "Build" and select "Configuration Manager". + Choose "Release" or "Debug" under "Active Solution Configuration" </p> + + <p>Disable the following projects:</p> <ul class="normal"> <li>hdf5_hl_cpp + <li>hl_test_table_cpp</li> </ul> <p>Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. </p> <li><h4>2.5 If you don't want to build HDF5 Fortran High-Level Libraries</h4> <p>Go to "Build" and select "Configuration Manager". Choose "Release" or "Debug" under "Active Solution Configuration".</p> <p>Disable the following projects:</p> <ul class="normal"> <li>hdf5_hl_fortran + <li>hl_test_image_fortran + <li>hl_test_lite_fortran + <li>hl_test_table_fortran</li> </ul> <p>Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. </p> </li> </ul><hr class="second" > + +<h2> STEP 2: Testing HDF5 Libraries and Tools </h2><hr class="second" > + +<p>HDF5 libraries and tools should be tested to make sure that they were +built correctly.</p><p>HDF5 libraries and tools can be tested with hdf5check.bat batch file +in c:\MyHDFstuff\hdf5 directory.</p><p>hdf5check.bat has four options:</p> + + <div style="TEXT-ALIGN: center"> + <table border="1" style="BORDER-RIGHT: blue thin solid; BORDER-TOP: blue thin solid; BORDER-LEFT: blue thin solid; BORDER-BOTTOM: blue thin solid"> + <tr> + <th>Options</th> + <th>Illustration</th> + </tr> + <tr> + <td><p>hdf5check</p></td> + <td><p>test HDF5 C library and tools only</p></td> + </tr> + <tr> + <td><p>hdf5check enablecpp</p></td> + <td><p>test HDF5 C/C++ libraries and tools.</p> + </td> + </tr> + <tr> + <td><p>hdf5check enablefortran</p></td> + <td><p>test HDF5 C/FORTRAN libraries and tools</p> + </td> + </tr> + <tr> + <td><p>hdf5check enableall</p></td> + <td><p>test HDF5 C/C++/FORTRAN libraries and tools</p> + </td> + </tr> + </table> + </div> + + <p>Invoke a command prompt window and run hdf5check with appropriate + options.</p> + <p>Test results are saved into file:</p> + <ul class="normal"> + <li>c:\MyHDFstuff\hdf5\check_results.txt</li> + </ul> + <p>Check check_results.txt and there should be no failures at all.</p> + <p>If you want to test HDF5 libraries and tools one by one, please refer to + <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank>Section II, step 2 in INSTALL_Windows.html</A>.</p> +<hr class="second" > + +<p>Check check_results.txt and there should be no failures at all.</p> + <p>If you want to test HDF5 libraries and tools one by one, please refer to + <A href="http://hdf.ncsa.uiuc.edu/windows/INSTALL_Windows.html#step2_section2" target=_blank>Section II, step 2 in INSTALL_Windows.html</A>.</p> +<hr class="second" > +<h2>STEP 3: 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>STEP 4: 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> + +<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></h4> +<p> </p> +<p> </p> + + + + + +</BODY> +</HTML> |