summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFang Guo <fangguo@ncsa.uiuc.edu>2005-06-10 19:06:06 (GMT)
committerFang Guo <fangguo@ncsa.uiuc.edu>2005-06-10 19:06:06 (GMT)
commit4866e40e531e5d37d8e253042857dcea062a2bec (patch)
tree3cb12a497d1576ab3e0346abba42795ad7356420
parent147aa9ef46e6ae0a2b7bdb5f9f9e4205ad231c2e (diff)
downloadhdf5-4866e40e531e5d37d8e253042857dcea062a2bec.zip
hdf5-4866e40e531e5d37d8e253042857dcea062a2bec.tar.gz
hdf5-4866e40e531e5d37d8e253042857dcea062a2bec.tar.bz2
[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:
-rwxr-xr-xrelease_docs/INSTALL_Windows_From_Command_Line.txt359
1 files 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.