[svn-r9166] Purpose:
New documentations for Windows support. Description: Three documentations: 1. INSTALL_Windows.txt has been largely modified to prepare for 1.6.3 release. 2. INSTALL_Windows_Short.txt has been added to provide for users a quick and easy building, testing, and installing HDF5 products on Windows. 3. INSTALL_Windows_From_Command_Line.txt has been added to provide for users who would like to build HDF5 through command line on Windows. Correspondingly, INSTALL_Windows_withcpp.txt and INSTALL_Windows_withf90.txt will be depreciated in the future since the new INSTALL_Windows.txt includes the instruction to build, test, and install HDF5 products with C++ and Fortran APIs. Solution: Platforms tested: No need. Misc. update:
This commit is contained in:
Xuan Bai
193
release_docs/INSTALL_Windows_From_Command_Line.txt
Executable file
193
release_docs/INSTALL_Windows_From_Command_Line.txt
Executable file
@@ -0,0 +1,193 @@
|
||||
Instructions for Building and Testing HDF5 on Command Line
|
||||
for Windows XP/2000
|
||||
|
||||
************************************************************************
|
||||
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 DEC Fortran 6.0.
|
||||
|
||||
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.
|
||||
|
||||
*****************************WARNINGS***********************************
|
||||
|
||||
Please read CAREFULLY about HDF5 build and install preconditions and
|
||||
notes in INSTALL_Windows.txt before starting below procedures.
|
||||
|
||||
************************************************************************
|
||||
|
||||
Extra Preconditons
|
||||
|
||||
1. Set path for Microsoft Visual C++ 6.0 and DEC 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 DEC Fotran 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)
|
||||
|
||||
To use WinZip command line utility, you have to install
|
||||
WinZip 9.0 or higher version.
|
||||
|
||||
If you want to extract hdf5\windows\all.zip on the command line,
|
||||
you should
|
||||
|
||||
2.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
|
||||
|
||||
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 winzip path (For example C:\Program Files\WinZip)
|
||||
into "Variable Value" and click "OK".
|
||||
|
||||
Note:
|
||||
You can also extract all.zip from interactive WinZip interface
|
||||
without the above two steps.
|
||||
|
||||
***********************************************************************
|
||||
Step 1. Building and testing HDF5 libraries and tools
|
||||
|
||||
1. Unpack all.zip
|
||||
|
||||
Unpack all.zip in c:\MyHDFstuff\hdf5\windows into the
|
||||
C:\myHDFstuff directory.
|
||||
|
||||
This can be done with either of the following 2 options:
|
||||
|
||||
Option A. Unpack from the interactive WinZip interface
|
||||
|
||||
Option B. unpack on the command line
|
||||
|
||||
cd into the c:\MyHDFstuff\hdf5\windows directory
|
||||
|
||||
type: wzunzip -yO -d -o all.zip c:\MyHDFstuff
|
||||
|
||||
|
||||
2. Build and Test
|
||||
|
||||
We provide 2 options for users to build test HDF5 libraries
|
||||
and tools.
|
||||
|
||||
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
|
||||
together from command line.
|
||||
|
||||
hdf5bt.bat has four options:
|
||||
|
||||
hdf5bt build and test C library and tools
|
||||
|
||||
hdf5bt enablecpp build and test C/C++ libraries
|
||||
and tools
|
||||
|
||||
hdf5bt enablefortran build and test C/Fortran libraries
|
||||
and tools
|
||||
|
||||
hdf5bt enableall build and test C/C++/Fortran
|
||||
libraries and tools
|
||||
|
||||
Invoke a command prompt window and run hdf5bt with
|
||||
appropriate options.
|
||||
|
||||
Test results are saved in two files:
|
||||
|
||||
c:\MyHDFstuff\hdf5\hdf5_results.txt
|
||||
|
||||
c:\MyHDFstuff\hdf5\tests_results.txt.
|
||||
|
||||
In general, you only need to check tests_results.txt.
|
||||
If all the tests passed, then you do not have to check
|
||||
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
|
||||
|
||||
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.bat in c:\MyHDFstuff\hdf5
|
||||
directory is provided for users to build HDF5 library and
|
||||
tools from command line.
|
||||
|
||||
hdf5build.bat has four options:
|
||||
|
||||
hdf5build build HDF5 C library
|
||||
and tools
|
||||
|
||||
hdf5build enablecpp build HDF5 C/C++ libraries
|
||||
and tools
|
||||
|
||||
hdf5build enablefortran build HDF5 C/Fortran libraries
|
||||
and tools
|
||||
|
||||
hdf5build enableall build HDF5 C/C++/Fortran
|
||||
libraries and tools
|
||||
|
||||
Invoke a command prompt window and run hdf5build with
|
||||
appropriate options. Compiling outputs are saved in
|
||||
c:\MyHDFstuff\hdf5\build_results.txt. You can check
|
||||
the file to find out whether there are any compilation
|
||||
errors.
|
||||
|
||||
Step 2) Test HDF5 Libraries and Tools
|
||||
|
||||
A batch file named hdf5check.bat in c:\MyHDFstuff\hdf5
|
||||
directory is provided for users to test HDF5 library
|
||||
and tools from command line.
|
||||
|
||||
hdf5check.bat has four options:
|
||||
|
||||
hdf5check test HDF5 C library and tools
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
STEP 2: 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.
|
||||
Reference in New Issue
Block a user