mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
49448eeca1
Update documents about installing hdf5 on windows xp Description: Modified files: INSTALL_Windows.txt INSTALL_Windows_From_Command_Line.txt INSTALL_Windows_Short.txt Solution: Platforms tested: Misc. update:
184 lines
6.8 KiB
Plaintext
Executable File
184 lines
6.8 KiB
Plaintext
Executable File
Instructions for Building and Testing HDF5 on Command Line
|
|
for 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.
|
|
|
|
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 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)
|
|
|
|
To use WinZip command line utility, you have to install
|
|
WinZip 9.0 or higher version.
|
|
|
|
If you want to extract zip files 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 zip files from interactive WinZip
|
|
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.
|
|
|
|
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.
|