mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-02-17 16:10:24 +08:00
[svn-r9503] Purpose:
Update windows installation document on 1.7 branch. Description: Solution: Platforms tested: Misc. update:
This commit is contained in:
MuQun Yang
parent
9268be2d0d
commit
70982501ef
File diff suppressed because it is too large
Load Diff
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 Preconditions
|
||||
|
||||
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 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 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.
|
||||
123
release_docs/INSTALL_Windows_Short.txt
Executable file
123
release_docs/INSTALL_Windows_Short.txt
Executable file
@ -0,0 +1,123 @@
|
||||
HDF5 Build and Install Instructions for Windows 2000/XP (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
|
||||
but do not want to know HDF5 building and installation details
|
||||
on Windows 2000/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.
|
||||
************************************************************************
|
||||
|
||||
STEP 1: Building HDF5 Libraries and Tools
|
||||
|
||||
1. Unpack all.zip
|
||||
|
||||
Unpack all.zip in c:\MyHDFstuff\hdf5\windows into the
|
||||
c:\MyHDFstuff directory.
|
||||
|
||||
2. Open all.dsw workspace
|
||||
|
||||
Open the c:\MyHDFstuff\hdf5\proj\all\all.dsw workspace.
|
||||
|
||||
3. (Optional) Add C++ and/or FORTRAN related projects
|
||||
|
||||
3.1 Add the following projects to project "all" dependencies
|
||||
ONLY if you want to build HDF5 C++ libraries
|
||||
|
||||
dsets_cpp
|
||||
dsets_cppdll
|
||||
hdf5_cpp
|
||||
hdf5_cppdll
|
||||
testhdf5_cpp
|
||||
testhdf5_cppdll
|
||||
|
||||
3.2 Add the follwing projects to project "all" dependencies
|
||||
ONLY if you want to build HDF5 FORTRAN libraries
|
||||
|
||||
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
|
||||
|
||||
4. Select "Build", then Select "Set Active Configuration".
|
||||
|
||||
In "Project configurations", select the active configuration
|
||||
|
||||
"all -- Win32 Debug"
|
||||
|
||||
or
|
||||
|
||||
"all -- Win32 Release"
|
||||
|
||||
Then build project "all".
|
||||
|
||||
|
||||
STEP 2: 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.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user