From ae41553de2f8dcafd94dc7fff1c0755898af229e Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Fri, 10 Jun 2005 14:09:26 -0500 Subject: [svn-r10893] Purpose: Add short version instruction for Visual C++ .net 2003 Description: Short version instruction for building and testing HDF5 with Visual C++ .Net was added. Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows_Short_NET.TXT | 212 +++++++++++++++++++++++++++++ 1 file changed, 212 insertions(+) create mode 100755 release_docs/INSTALL_Windows_Short_NET.TXT diff --git a/release_docs/INSTALL_Windows_Short_NET.TXT b/release_docs/INSTALL_Windows_Short_NET.TXT new file mode 100755 index 0000000..359cf4f --- /dev/null +++ b/release_docs/INSTALL_Windows_Short_NET.TXT @@ -0,0 +1,212 @@ +HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003 + (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 Microsoft Visual Studio .NET 2003 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. +************************************************************************ + +Preconditions: + + a. Setup Szip Library for Visual Studio .Net 2003 Compiler. + + Szip source codes or binaries can be downloaded + from the following address: + + ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows. + + b. 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 only use Zlib + or Szip. You also need to read section V. + + 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. + + 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. + +1. Open all.dsw workspace + + 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. + +2. Building HDF5 C and C++ Libraries + + Users can choose the desirable libraries to be built according + to the following describtion. + + 2.1 If you don't want to build HDF5 C++ Libraries, + Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration" + + Disable the following projects: + + dsets_cpp + dsets_cppdll + hdf5_cpp + hdf5_cppdll + testhdf5_cpp + testhdf5_cppdll + hdf5_hl_cpp + hl_test_table_cpp + + Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. + + 2.2 If you don't want to build HDF5 Fortran Libraries, + Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration" + + Disable the following projects: + + 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 + + Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. + + 2.3 If you don't want to build HDF5 High-Level Libraries, + Go to "Build" and select "Configuration Manager". Choose "Release" + or "Debug" under "Active Solution Configuration" + + Disable the following projects: + + hdf5_hl + hl_test_image + hl_test_lite + hl_test_table + hl_test_ds + hl_test_packet + + Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. + + 2.4 If you don't want to build HDF5 C++ High-Level C++ Libraries, + Go to "Build" and select "Configuration Manager". + Choose "Release" or "Debug" under "Active Solution Configuration" + + Disable the following projects: + + hdf5_hl_cpp + hl_test_table_cpp + + Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. + + 2.5 If you don't want to build HDF5 Fortran High-Level Libraries, + Go to "Build" and select "Configuration Manager". + Choose "Release" or "Debug" under "Active Solution Configuration". + + Disable the following projects: + + hdf5_hl_fortran + hl_test_image_fortran + hl_test_lite_fortran + hl_test_table_fortran + + Click on "OK", From the main menu, choose "Build"-> "Build" or + "Rebuild ALL" to build both release and debug version of HDF5 + Libraries. + +3. Testing HDF5 Libraries and Tools. + +HDF5 libraries and tools should be tested to make sure that they were +built correctly. + +HDF5 libraries and tools can be tested with hdf5check.bat batch file +in c:\MyHDFstuff\hdf5 directory. + +hdf5check.bat has four options: + + hdf5check test HDF5 C library and tools only + + hdf5check enablecpp test HDF5 C/C++ libraries and tools + + hdf5check enablefortran test HDF5 C/Fortran libraries + and tools + + hdf5check enableall test HDF5 C/C++/Fortran libraries + and tools + + +Invoke a command prompt window and run hdf5check with appropriate +options. + +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. + +If you want to test HDF5 libraries and tools one by one, please refer to +section II, step 2 in INSTALL_Windows.txt. + + +STEP 3: Installing HDF5 Libraries + +Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install +all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory. + + +STEP 4: Building HDF5 Examples (Optional) + +Please read section II, step 4 in INSTALL_Windows.txt. + + -- cgit v0.12