From 4866e40e531e5d37d8e253042857dcea062a2bec Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Fri, 10 Jun 2005 14:06:06 -0500 Subject: [svn-r10891] Purpose: Update document for windows. Description: Add support with visual c++ .Net and intel compiler on windows XP. Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows_From_Command_Line.txt | 359 +++++++++++++++++++-- 1 file changed, 325 insertions(+), 34 deletions(-) diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index 313bad4..3e82e38 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -1,20 +1,41 @@ - Instructions for Building and Testing HDF5 on Command Line - for Windows XP +Instructions for Building and Testing HDF5 +from Command Line on Windows XP ************************************************************************ Note: This instruction is written for users who would like to build HDF5 libraries and tools from the HDF5 source code package on command line. - Currently, we only support building and testing HDF5 on command - line with Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0. + Currently, we support + + 1. Building and testing HDF5 on command line with Microsoft Visual + C++ 6.0 and Compaq Visual Fortran 6.0. + + 2. Building and testing HDF5 C and C++ Library on command line with + Microsoft Visual C++ .Net (2003) + + 3. Building and testing HDF5 C and C++ Library on command line with + Intel C++ Compiler 8.1 integration with Microsoft Visual C++ .Net + 2003. For all other Windows development tools, HDF5 should be built in the development environment. Please refer to INSTALL_Windows.txt for detailed HDF5 building and installation information, or INSTALL_Windows_short.txt for quick HDF5 building and installation instructions. - + + 4. Different compiler is using different batch files on command line + to build HDF5 Libraries. + + Compiler Name Batch File to Be Used + + MSVS 6.0 hdf5bt.ba hdf5build.bat + MSVS .Net hdf5bt_net.bat hdf5build_net.bat + Intel C++ hdf5bt_intelc.bat hdf5build_intelc.bat + + Be careful to type in the corresponding command when you choose + a procedure below to build HDF5 Libraries. + *****************************WARNINGS*********************************** Please read CAREFULLY about HDF5 build and install preconditions and @@ -22,21 +43,9 @@ notes in INSTALL_Windows.txt before starting below procedures. ************************************************************************ -Extra Preconditions +Preconditions - 1. Set path for Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0 - - Open "System" in Control Panel. - - On the "Advanced" tab, click "Environment Variables", click - "Path" in the "System variables" box, then click "Edit" and - add your Visual C++ 6.0 path (For example, - C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) - and Compaq Visual Fortran 6.0 path (For example, - C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) - into "Variable Value" and click "OK". - - 2. Add WinZip command line support (Optional) + 1. Add WinZip command line support (Optional) To use WinZip command line utility, you have to install WinZip 9.0 or higher version. @@ -44,12 +53,12 @@ Extra Preconditions If you want to extract zip files on the command line, you should - 2.1 Install WinZip command line support add-on 1.1 + 1.1 Install WinZip command line support add-on 1.1 Download WinZip command line support add-on 1.1 from http://www.winzip.com and install it. - 2.2 Add WinZip into environment path + 1.2 Add WinZip into environment path Open "System" in Control Panel. On the "Advanced" tab, click "Environment Variables", click @@ -62,20 +71,36 @@ Extra Preconditions interface without the above two steps. *********************************************************************** -Step 1. Building and testing HDF5 libraries and tools - 1. Run batch file copy_hdf.bat. - Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process - will copy all the necessary batch files and text files saved under - c:\MyHDFstuff\hdf5\windows directory to the directories where they - will be used. +Section I: Building and testing HDF5 on command line with Microsoft + Visual C++ 6.0 and Compaq Visual Fortran 6.0. + +*********************************************************************** + +1. Extra Preconditions: + + 1.1 Set path for Visual C++ 6.0 and Compaq Visual Fortran 6.0 - 2. Build and Test + Open "System" in Control Panel. + + On the "Advanced" tab, click "Environment Variables", click + "Path" in the "System variables" box, then click "Edit" and + add your Visual C++ 6.0 path (For example, + C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) + and Compaq Visual Fortran 6.0 path (For example, + C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) + into "Variable Value" and click "OK". + + 1.2 Run batch file copy_hdf.bat. - We provide 2 options for users to build test HDF5 libraries - and tools. + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. - Options A: Build and test in one step +2. Building and testing HDF5 libraries and tools + + We provide 2 options for users to build test HDF5 libraries + and tools. + + 2.1 Options A: Build and test in one step A batch file named hdf5bt.bat in c:\MyHDFstuff\hdf5 directory is provided for users to build and test HDF5 library and tools @@ -108,7 +133,7 @@ Step 1. Building and testing HDF5 libraries and tools hdf5_results.txt. If some tests failed, check hdf5_results.txt can help you figure out what was wrong. - Options B: Build and test in two steps + 2.2 Options B: Build and test in two steps We also provide users with the option to build and test HDF5 libraries and tools seperately. @@ -173,11 +198,277 @@ Step 1. Building and testing HDF5 libraries and tools check_results.txt can help you figure out what was wrong. - -STEP 2: Installing HDF5 Libraries +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. +For further information, please refer to INSTALL_WINDOWS.txt. + +************************************************************************ + +SECTION II: Building and testing HDF5 C and C++ Library on command line + with Microsoft Visual C++ .Net 2003 + +*********************************************************************** + +1. Extra Preconditions: + + 1.1 Microsoft Visual C++ .Net 2003 Installed + + 1.2 Command-based script host (CScript.exe) installed + + Cscript.exe is a command-line version of the Windows Script Host. Users can + check windows system directory to make sure Cscript.exe installed. Cscript.exe + will be used during converting project files from MSVS 6.0 Format to Visual C++ + .Net 2003 format. + + 1.3 Set path for Microsoft Visual C++ .Net + + Open "System" in Control Panel. + + 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". + + 1.4 Run batch file copy_hdf.bat. + + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process + will copy all the necessary batch files and text files saved under + c:\MyHDFstuff\hdf5\windows directory to the directories where they + will be used. + + 1.5 Convert project files format from MSVS 6.0 to MSVS .Net + + Go to directory c:\MyHDFstuff\hdf5 and run convert_to_vcproj.bat + + convert_to_vcproj "Absolute path of directory hdf5" + + For example: + + convert_to_vcproj c:\MyHDFstuff\hdf5 + + The converting results will be saved into file convert.log under + the directory c:\MyHDFstuff\hdf5. The messages should look like + + Converting: c:\MyHDFstuff\hdf5\windows\proj\all\all.dsp + New Project Name: c:\MyHDFstuff\\hdf5\windows\proj\all\all.vcproj + + Note: all.sln was provided with HDF5-1.8.0 Release. Users don't need + to convert the workspace from MSVS 6.0 format to MSVS .Net + Format + +2. Building HDF5 C and C++ Libraries : + + We provide 2 options for users to build HDF5 libraries and tools. + 2.1 Options A: Build and test in one step + + A batch file named hdf5bt_net.bat in c:\MyHDFstuff\hdf5 directory + is provided for users to build and test HDF5 library and tools + together from command line. + + hdf5bt_net.bat has two options: + + hdf5bt_net build and test C library and tools + + hdf5bt_net enablecpp build and test C/C++ libraries + and tools + + Invoke a command prompt window and run hdf5bt_net with + appropriate options. + + Test results are saved in two files: + + c:\MyHDFstuff\hdf5\hdf5_results_net.txt + + c:\MyHDFstuff\hdf5\tests_results_net.txt. + + In general, you only need to check tests_results_net.txt. + If all the tests passed, then you do not have to check + hdf5_results_net.txt. If some tests failed, check + hdf5_results_net.txt can help you figure out what was wrong. + + 2.2 Options B: Build and test in two steps + + We also provide users with the option to build and test + HDF5 libraries and tools seperately. + + Step 1) Build HDF5 Libraries and Tools + + A batch file named hdf5build_net.bat in c:\MyHDFstuff\hdf5 + directory is provided for users to build HDF5 library and + tools from command line. + + hdf5build.bat has two options: + + hdf5build_net build HDF5 C library + and tools + + hdf5build_net enablecpp build HDF5 C/C++ libraries + and tools + + Invoke a command prompt window and run hdf5build_net with + appropriate options. building results will be saved in + c:\MyHDFstuff\hdf5\build_results_net.txt. You can check + the file to find out whether there are any compilation + errors. + + Step 2) Build HDF5 Libraries and Tools + + Go to directory, run batch file hdf5check with the following + options: + + hdf5check test HDF5 C library and tools + + hdf5check enablecpp test HDF5 C/C++ libraries + and tools + + Note: hdf5check.bat has ONLY TWO options listed above in this case. + + Testing results will be saved in c:\MyHDFstuff\hdf5\check_results_net.txt. + There should be no failures at all. + + 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. + +*********************************************************************** + +SECTION III: Building and testing HDF5 C and C++ Library on command +line with Intel C++ Compiler 8.1 integration with Microsoft +Visual C++ .Net 2003 + +************************************************************************ + +1. Extra Preconditions: + + 1.1 Set path for Microsoft Visual C++ .Net and Intel C++ 8.1 + + Open "System" in Control Panel. + + 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) + and Intel C++ 8.1 path (For example, + C:\Program Files\Intel\CPP\Compiler80\Ia32\Bin) + into "Variable Value" and click "OK". + + 1.2 Run batch file copy_hdf.bat. + + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process + will copy all the necessary batch files and text files saved under + c:\MyHDFstuff\hdf5\windows directory to the directories where they + will be used. + + 1.3 Convert project files format from MSVS 6.0 to MSVS .Net Format + + Go to directory c:\MyHDFstuff\hdf5 and run convert_to_vcproj.bat + in the following format: + + convert_to_vcproj "Absolute path of directory hdf5" + + For example: + + convert_to_vcproj c:\MyHDFstuff\hdf5 + + The converting results will be saved into file convert.log under + the directory c:\MyHDFstuff\hdf5. The messages should look like + + Converting: c:\MyHDFstuff\hdf5\windows\proj\all\all.dsp + New Project Name: c:\MyHDFstuff\\hdf5\windows\proj\all\all.vcproj + +2. Building HDF5 C and C++ Libraries : + + We provide 2 options for users to build HDF5 libraries and tools. + + 2.1 Options A: Build and test in one step + + A batch file named hdf5bt_intelc.bat in c:\MyHDFstuff\hdf5 directory + is provided for users to build and test HDF5 library and tools + together from command line. + + hdf5bt_intelc.bat has two options: + + hdf5bt_intelc build and test C library and tools + + hdf5bt_intelc enablecpp build and test C/C++ libraries + and tools + + Invoke a command prompt window and run hdf5bt_intelc with + appropriate options. + + Test results will be saved in two files: + + c:\MyHDFstuff\hdf5\hdf5_results_intelc.txt + + c:\MyHDFstuff\hdf5\tests_results_intelc.txt. + + Project conversion results from MSVS .Net format to Intel C++ fomat + + will be saved in + + c:\MyHDFstuff\hdf5\convert_intel.txt + + Check convert_intel.txt to see if all of the project files have been converted + successfully. Conversion messages should look like: + + + In general, you only need to check tests_results_intelc.txt. + If all the tests passed, then you do not have to check + hdf5_results_intelc.txt. If some tests failed, check + hdf5_results_intelc.txt can help you figure out what was wrong. + + 2.2 Options B: Build and test in two steps + + We also provide users with the option to build and test + HDF5 libraries and tools seperately. + + Step 1) Build HDF5 Libraries and Tools + + A batch file named hdf5build_intelc.bat in c:\MyHDFstuff\hdf5 + directory is provided for users to build HDF5 library and + tools from command line. + + hdf5build_intelc.bat has two options: + + hdf5build_intelc build HDF5 C library + and tools + + hdf5build_intelc enablecpp build HDF5 C/C++ libraries + and tools + + Invoke a command prompt window and run hdf5build_intelc with + appropriate options. Compiling outputs are saved in + c:\MyHDFstuff\hdf5\build_results_intelc.txt. You can check + the file to find out whether there are any compiling errors. + + Step 2) Testing HDF5 Libraries and Tools + + Go to directory, run batch file hdf5check with the following + options: + + hdf5check test HDF5 C library and tools + + hdf5check enablecpp test HDF5 C/C++ libraries + and tools + + Note: hdf5check.bat has ONLY TWO options listed above in this + case. + + Testing results will be saved in c:\MyHDFstuff\hdf5\check_results_intelc.txt. + There should be no failures at all. + + 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. + + For further information, please refer to INSTALL_WINDOWS.txt. + +Please send email to hdfhelp@ncsa.uiuc.edu for further assistance. -- cgit v0.12