diff options
Diffstat (limited to 'release_docs/INSTALL_Windows_From_Command_Line.txt')
-rwxr-xr-x | release_docs/INSTALL_Windows_From_Command_Line.txt | 193 |
1 files changed, 193 insertions, 0 deletions
diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt new file mode 100755 index 0000000..e7b0960 --- /dev/null +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -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.
\ No newline at end of file |