mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-21 01:04:10 +08:00
Minor fixes for CMake code and install docs (#2623)
This commit is contained in:
Allen Byrne
GitHub
parent
fa388e6ba4
commit
526f0769a3
10
bin/release
10
bin/release
@ -193,19 +193,19 @@ tar2cmakezip()
|
||||
fi
|
||||
|
||||
# step 2: add batch file for building CMake on window
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2013 -C Release -V -O hdf5.log" > build-VS2013-32.bat; chmod 755 build-VS2013-32.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201364 -C Release -V -O hdf5.log" > build-VS2013-64.bat; chmod 755 build-VS2013-64.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2015 -C Release -V -O hdf5.log" > build-VS2015-32.bat; chmod 755 build-VS2015-32.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201564 -C Release -V -O hdf5.log" > build-VS2015-64.bat; chmod 755 build-VS2015-64.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2017 -C Release -V -O hdf5.log" > build-VS2017-32.bat; chmod 755 build-VS2017-32.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201764 -C Release -V -O hdf5.log" > build-VS2017-64.bat; chmod 755 build-VS2017-64.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2019 -C Release -V -O hdf5.log" > build-VS2019-32.bat; chmod 755 build-VS2019-32.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201964 -C Release -V -O hdf5.log" > build-VS2019-64.bat; chmod 755 build-VS2019-64.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2022 -C Release -V -O hdf5.log" > build-VS2022-32.bat; chmod 755 build-VS2022-32.bat)
|
||||
(cd $cmziptmpsubdir; echo "ctest -S HDF5config.cmake,BUILD_GENERATOR=VS202264 -C Release -V -O hdf5.log" > build-VS2022-64.bat; chmod 755 build-VS2022-64.bat)
|
||||
|
||||
# step 3: add LIBAEC.tar.gz, ZLib.tar.gz and cmake files
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/LIBAEC.tar.gz $cmziptmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/ZLib.tar.gz $cmziptmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.2-Source.zip $cmziptmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.3-Source.zip $cmziptmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/hdf5_plugins-master.zip $cmziptmpsubdir
|
||||
cp $cmziptmpsubdir/$version/config/cmake/scripts/CTestScript.cmake $cmziptmpsubdir
|
||||
cp $cmziptmpsubdir/$version/config/cmake/scripts/HDF5config.cmake $cmziptmpsubdir
|
||||
@ -297,7 +297,7 @@ tar2cmaketgz()
|
||||
# step 3: add LIBAEC.tar.gz, ZLib.tar.gz and cmake files
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/LIBAEC.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/ZLib.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.2-Source.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.3-Source.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/hdf5_plugins-master.tar.gz $cmgztmpsubdir
|
||||
cp $cmgztmpsubdir/$version/config/cmake/scripts/CTestScript.cmake $cmgztmpsubdir
|
||||
cp $cmgztmpsubdir/$version/config/cmake/scripts/HDF5config.cmake $cmgztmpsubdir
|
||||
@ -376,7 +376,7 @@ tar2hpccmaketgz()
|
||||
# step 3: add LIBAEC.tar.gz, ZLib.tar.gz and cmake files
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/LIBAEC.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/ZLib.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.2-Source.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/HDF5Examples-2.0.3-Source.tar.gz $cmgztmpsubdir
|
||||
cp /mnt/scr1/pre-release/hdf5/CMake/hdf5_plugins-master.tar.gz $cmgztmpsubdir
|
||||
cp $cmgztmpsubdir/$version/config/cmake/scripts/CTestScript.cmake $cmgztmpsubdir
|
||||
cp $cmgztmpsubdir/$version/config/cmake/scripts/HDF5config.cmake $cmgztmpsubdir
|
||||
|
||||
@ -104,8 +104,8 @@ foreach (example ${tutr_examples})
|
||||
-D "TEST_ARGS:STRING="
|
||||
-D "TEST_EXPECT=0"
|
||||
-D "TEST_SKIP_COMPARE=TRUE"
|
||||
-D "TEST_OUTPUT=tutr_cpp_ex_${example}.txt"
|
||||
#-D "TEST_REFERENCE=cpp_ex_tutr_${example}.out"
|
||||
-D "TEST_OUTPUT=cpp_ex_${example}.txt"
|
||||
#-D "TEST_REFERENCE=cpp_ex_${example}.out"
|
||||
-D "TEST_FOLDER=${PROJECT_BINARY_DIR}"
|
||||
-P "${HDF_RESOURCES_DIR}/runTest.cmake"
|
||||
)
|
||||
|
||||
@ -11,7 +11,7 @@
|
||||
#
|
||||
#############################################################################################
|
||||
### ${CTEST_SCRIPT_ARG} is of the form OPTION=VALUE ###
|
||||
### BUILD_GENERATOR required [Unix, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564] ###
|
||||
### BUILD_GENERATOR required [Unix, VS2022, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564] ###
|
||||
### ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201764 -C Release -VV -O hdf5.log ###
|
||||
#############################################################################################
|
||||
|
||||
@ -23,14 +23,14 @@ cmake_minimum_required (VERSION 3.18)
|
||||
# BUILD_GENERATOR - The cmake build generator:
|
||||
# MinGW * MinGW Makefiles
|
||||
# Unix * Unix Makefiles
|
||||
# VS2022 * Visual Studio 17 2022
|
||||
# VS202264 * Visual Studio 17 2022
|
||||
# VS2019 * Visual Studio 16 2019
|
||||
# VS201964 * Visual Studio 16 2019
|
||||
# VS2017 * Visual Studio 15 2017
|
||||
# VS201764 * Visual Studio 15 2017 Win64
|
||||
# VS2015 * Visual Studio 14 2015
|
||||
# VS201564 * Visual Studio 14 2015 Win64
|
||||
# VS2013 * Visual Studio 12 2013
|
||||
# VS201364 * Visual Studio 12 2013 Win64
|
||||
#
|
||||
# INSTALLDIR - root folder where hdf5 is installed
|
||||
# CTEST_CONFIGURATION_TYPE - Release, Debug, etc
|
||||
@ -43,9 +43,9 @@ set (CTEST_SOURCE_VERSEXT "")
|
||||
##############################################################################
|
||||
# handle input parameters to script.
|
||||
#BUILD_GENERATOR - which CMake generator to use, required
|
||||
#INSTALLDIR - HDF5-1.13.x root folder
|
||||
#INSTALLDIR - HDF5-1.15.x root folder
|
||||
#CTEST_CONFIGURATION_TYPE - Release, Debug, RelWithDebInfo
|
||||
#CTEST_SOURCE_NAME - name of source folder; HDF5-1.13.x
|
||||
#CTEST_SOURCE_NAME - name of source folder; HDF5-1.15.x
|
||||
#MODEL - CDash group name
|
||||
#HPC - run alternate configurations for HPC machines; sbatch, bsub, raybsub, qsub
|
||||
#MPI - enable MPI
|
||||
@ -68,7 +68,7 @@ endif ()
|
||||
|
||||
# build generator must be defined
|
||||
if (NOT DEFINED BUILD_GENERATOR)
|
||||
message (FATAL_ERROR "BUILD_GENERATOR must be defined - Unix, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
message (FATAL_ERROR "BUILD_GENERATOR must be defined - Unix, VS2022, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
endif ()
|
||||
|
||||
###################################################################
|
||||
@ -105,12 +105,24 @@ endif ()
|
||||
######### Following describes compiler ############
|
||||
if (NOT DEFINED HPC)
|
||||
if (NOT DEFINED BUILD_GENERATOR)
|
||||
message (FATAL_ERROR "BUILD_GENERATOR must be defined - Unix, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
message (FATAL_ERROR "BUILD_GENERATOR must be defined - Unix, VS2022, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
endif ()
|
||||
if (WIN32 AND NOT MINGW)
|
||||
set (SITE_OS_NAME "Windows")
|
||||
set (SITE_OS_VERSION "WIN10")
|
||||
if (BUILD_GENERATOR STREQUAL "VS201964")
|
||||
if (BUILD_GENERATOR STREQUAL "VS202264")
|
||||
set (CTEST_CMAKE_GENERATOR "Visual Studio 17 2022")
|
||||
set (CMAKE_GENERATOR_ARCHITECTURE "x64")
|
||||
set (SITE_OS_BITS "64")
|
||||
set (SITE_COMPILER_NAME "vs2022")
|
||||
set (SITE_COMPILER_VERSION "17")
|
||||
elseif (BUILD_GENERATOR STREQUAL "VS2022")
|
||||
set (CTEST_CMAKE_GENERATOR "Visual Studio 17 2022")
|
||||
set (CMAKE_GENERATOR_ARCHITECTURE "Win32")
|
||||
set (SITE_OS_BITS "32")
|
||||
set (SITE_COMPILER_NAME "vs2022")
|
||||
set (SITE_COMPILER_VERSION "17")
|
||||
elseif (BUILD_GENERATOR STREQUAL "VS201964")
|
||||
set (CTEST_CMAKE_GENERATOR "Visual Studio 16 2019")
|
||||
set (CMAKE_GENERATOR_ARCHITECTURE "x64")
|
||||
set (SITE_OS_BITS "64")
|
||||
@ -163,7 +175,7 @@ if (NOT DEFINED HPC)
|
||||
set (SITE_COMPILER_NAME "vs2012")
|
||||
set (SITE_COMPILER_VERSION "11")
|
||||
else ()
|
||||
message (FATAL_ERROR "Invalid BUILD_GENERATOR must be - Unix, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
message (FATAL_ERROR "Invalid BUILD_GENERATOR must be - Unix, VS2022, VS2019, VS201964, VS2017, VS201764, VS2015, VS201564")
|
||||
endif ()
|
||||
## Set the following to unique id your computer ##
|
||||
set (CTEST_SITE "WIN7${BUILD_GENERATOR}.XXXX")
|
||||
|
||||
@ -74,7 +74,7 @@ set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DHDF5_ALLOW_EXTERNAL_SUPPORT:STRIN
|
||||
#set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DHDF5_ENABLE_SZIP_ENCODING:BOOL=OFF")
|
||||
|
||||
#### package examples ####
|
||||
#set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DHDF5_PACK_EXAMPLES:BOOL=ON -DHDF5_EXAMPLES_COMPRESSED:STRING=HDF5Examples-2.0.1-Source.tar.gz -DHDF5_EXAMPLES_COMPRESSED_DIR:PATH=${CTEST_SCRIPT_DIRECTORY}")
|
||||
#set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DHDF5_PACK_EXAMPLES:BOOL=ON -DHDF5_EXAMPLES_COMPRESSED:STRING=HDF5Examples-2.0.3-Source.tar.gz -DHDF5_EXAMPLES_COMPRESSED_DIR:PATH=${CTEST_SCRIPT_DIRECTORY}")
|
||||
|
||||
#############################################################################################
|
||||
### enable parallel builds
|
||||
|
||||
@ -86,7 +86,7 @@ add_custom_target(H5WATCH_files ALL COMMENT "Copying files needed by H5WATCH tes
|
||||
DEPENDS ${last_test}
|
||||
FIXTURES_REQUIRED gen_test_watch
|
||||
)
|
||||
set (last_test "H5WATCH_ARGS-h5watch-${resultfile}s")
|
||||
set (last_test "H5WATCH_ARGS-h5watch-${resultfile}")
|
||||
endif ()
|
||||
endmacro ()
|
||||
|
||||
|
||||
@ -417,7 +417,9 @@ CONTENTS
|
||||
|
||||
|
||||
4.3.11. Backward compatibility
|
||||
The 1.13 version of the HDF5 library can be configured to operate
|
||||
The 1.15 version of the HDF5 library can be configured to operate
|
||||
identically to the v1.14 library with the
|
||||
--with-default-api-version=v114
|
||||
identically to the v1.12 library with the
|
||||
--with-default-api-version=v112
|
||||
configure flag, or identically to the v1.10 library with the
|
||||
@ -427,7 +429,7 @@ CONTENTS
|
||||
configure flag, or identically to the v1.6 library with the
|
||||
--with-default-api-version=v16
|
||||
configure flag. This allows existing code to be compiled with the
|
||||
v1.13 library without requiring immediate changes to the application
|
||||
v1.15 library without requiring immediate changes to the application
|
||||
source code. For additional configuration options and other details,
|
||||
see "API Compatibility Macros":
|
||||
|
||||
|
||||
@ -27,11 +27,11 @@ Obtaining HDF5 source code
|
||||
2. Obtain compressed (*.tar or *.zip) HDF5 source from
|
||||
https://portal.hdfgroup.org/display/support/Building+HDF5+with+CMake
|
||||
and put it in "myhdfstuff".
|
||||
Uncompress the file. There should be a hdf5-1.13."X" folder.
|
||||
Uncompress the file. There should be a hdf5-1.15."X" folder.
|
||||
|
||||
CMake version
|
||||
1. We suggest you obtain the latest CMake from the Kitware web site.
|
||||
The HDF5 1.13."X" product requires a minimum CMake version 3.12,
|
||||
The HDF5 1.15."X" product requires a minimum CMake version 3.12,
|
||||
where "X" is the current HDF5 release version. If you are using
|
||||
VS2022, the minimum version is 3.21.
|
||||
|
||||
@ -54,7 +54,7 @@ The following files referenced below are available at the HDF web site:
|
||||
https://portal.hdfgroup.org/display/support/Building+HDF5+with+CMake
|
||||
|
||||
Single compressed file with all the files needed, including source:
|
||||
CMake-hdf5-1.13.X.zip or CMake-hdf5-1.13.X.tar.gz
|
||||
CMake-hdf5-1.15.X.zip or CMake-hdf5-1.15.X.tar.gz
|
||||
|
||||
Individual files included in the above mentioned compressed files
|
||||
-----------------------------------------------
|
||||
@ -83,10 +83,10 @@ To build HDF5 with the SZIP and ZLIB external libraries you will need to:
|
||||
|
||||
1. Change to the development directory "myhdfstuff".
|
||||
|
||||
2. Download the CMake-hdf5-1.13.X.zip(.tar.gz) file to "myhdfstuff".
|
||||
2. Download the CMake-hdf5-1.15.X.zip(.tar.gz) file to "myhdfstuff".
|
||||
Uncompress the file.
|
||||
|
||||
3. Change to the source directory "hdf5-1.13.x".
|
||||
3. Change to the source directory "hdf5-1.15.x".
|
||||
CTestScript.cmake file should not be modified.
|
||||
|
||||
4. Edit the platform configuration file, HDF5options.cmake, if you want to change
|
||||
@ -96,6 +96,10 @@ To build HDF5 with the SZIP and ZLIB external libraries you will need to:
|
||||
5. From the "myhdfstuff" directory execute the CTest Script with the
|
||||
following options:
|
||||
|
||||
On 32-bit Windows with Visual Studio 2022, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2022 -C Release -VV -O hdf5.log
|
||||
On 64-bit Windows with Visual Studio 2022, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS202264 -C Release -VV -O hdf5.log
|
||||
On 32-bit Windows with Visual Studio 2019, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2019 -C Release -VV -O hdf5.log
|
||||
On 64-bit Windows with Visual Studio 2019, execute:
|
||||
@ -104,17 +108,13 @@ To build HDF5 with the SZIP and ZLIB external libraries you will need to:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2017 -C Release -VV -O hdf5.log
|
||||
On 64-bit Windows with Visual Studio 2017, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201764 -C Release -VV -O hdf5.log
|
||||
On 32-bit Windows with Visual Studio 2015, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS2015 -C Release -VV -O hdf5.log
|
||||
On 64-bit Windows with Visual Studio 2015, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=VS201564 -C Release -VV -O hdf5.log
|
||||
On Linux and Mac, execute:
|
||||
ctest -S HDF5config.cmake,BUILD_GENERATOR=Unix -C Release -VV -O hdf5.log
|
||||
The supplied build scripts are versions of the above.
|
||||
|
||||
The command above will configure, build, test, and create an install
|
||||
package in the myhdfstuff folder. It will have the format:
|
||||
HDF5-1.13.NN-<platform>.<zip or tar.gz>
|
||||
HDF5-1.15.NN-<platform>.<zip or tar.gz>
|
||||
|
||||
On Unix, <platform> will be "Linux". A similar .sh file will also be created.
|
||||
On Windows, <platform> will be "win64" or "win32". If you have an
|
||||
@ -135,13 +135,13 @@ To build HDF5 with the SZIP and ZLIB external libraries you will need to:
|
||||
6. To install, "X" is the current release version
|
||||
|
||||
On Windows (with WiX installed), execute:
|
||||
HDF5-1.13."X"-win32.msi or HDF5-1.13."X"-win64.msi
|
||||
HDF5-1.15."X"-win32.msi or HDF5-1.15."X"-win64.msi
|
||||
By default this program will install the hdf5 library into the
|
||||
"C:\Program Files" directory and will create the following
|
||||
directory structure:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
@ -149,40 +149,40 @@ To build HDF5 with the SZIP and ZLIB external libraries you will need to:
|
||||
|
||||
On Linux, change to the install destination directory
|
||||
(create it if doesn't exist) and execute:
|
||||
<path-to>/myhdfstuff/HDF5-1.13."X"-Linux.sh
|
||||
<path-to>/myhdfstuff/HDF5-1.15."X"-Linux.sh
|
||||
After accepting the license, the script will prompt:
|
||||
By default the HDF5 will be installed in:
|
||||
"<current directory>/HDF5-1.13."X"-Linux"
|
||||
Do you want to include the subdirectory HDF5-1.13."X"-Linux?
|
||||
"<current directory>/HDF5-1.15."X"-Linux"
|
||||
Do you want to include the subdirectory HDF5-1.15."X"-Linux?
|
||||
Saying no will install in: "<current directory>" [Yn]:
|
||||
Note that the script will create the following directory structure
|
||||
relative to the install point:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
------share
|
||||
|
||||
On Mac you will find HDF5-1.13."X"-Darwin.dmg in the myhdfstuff folder. Click
|
||||
On Mac you will find HDF5-1.15."X"-Darwin.dmg in the myhdfstuff folder. Click
|
||||
on the dmg file to proceed with installation. After accepting the license,
|
||||
there will be a folder with the following structure:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
------share
|
||||
|
||||
By default the installation will create the bin, include, lib and cmake
|
||||
folders in the <install destination directory>/HDF_Group/HDF5/1.13."X"
|
||||
folders in the <install destination directory>/HDF_Group/HDF5/1.15."X"
|
||||
The <install destination directory> depends on the build platform;
|
||||
Windows will set the default to:
|
||||
C:/Program Files/HDF_Group/HDF5/1.13."X"
|
||||
C:/Program Files/HDF_Group/HDF5/1.15."X"
|
||||
Linux will set the default to:
|
||||
"myhdfstuff/HDF_Group/HDF5/1.13."X"
|
||||
"myhdfstuff/HDF_Group/HDF5/1.15."X"
|
||||
The default can be changed by adding ",INSTALLDIR=<my new dir>" to the
|
||||
"ctest -S HDF5config.cmake..." command. For example on linux:
|
||||
ctest -S HDF5config.cmake,INSTALLDIR=/usr/local/myhdf5,BUILD_GENERATOR=Unix -C Release -VV -O hdf5.log
|
||||
@ -209,13 +209,13 @@ Notes: This short set of instructions is written for users who want to
|
||||
5. Configure the C library, tools and tests with one of the following commands:
|
||||
|
||||
On Windows 32 bit
|
||||
cmake -G "Visual Studio 12 2013" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..\hdf5-1.13."X"
|
||||
cmake -G "Visual Studio 12 2013" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..\hdf5-1.15."X"
|
||||
|
||||
On Windows 64 bit
|
||||
cmake -G "Visual Studio 12 2013 Win64" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..\hdf5-1.13."X"
|
||||
cmake -G "Visual Studio 12 2013 Win64" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..\hdf5-1.15."X"
|
||||
|
||||
On Linux and Mac
|
||||
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ../hdf5-1.13."X"
|
||||
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_SHARED_LIBS:BOOL=OFF -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ../hdf5-1.15."X"
|
||||
|
||||
where "X" is the current release version.
|
||||
|
||||
@ -230,13 +230,13 @@ Notes: This short set of instructions is written for users who want to
|
||||
|
||||
9. To install
|
||||
On Windows (with WiX installed), execute:
|
||||
HDF5-1.13."X"-win32.msi or HDF5-1.13."X"-win64.msi
|
||||
HDF5-1.15."X"-win32.msi or HDF5-1.15."X"-win64.msi
|
||||
By default this program will install the hdf5 library into the
|
||||
"C:\Program Files" directory and will create the following
|
||||
directory structure:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
@ -244,28 +244,28 @@ Notes: This short set of instructions is written for users who want to
|
||||
|
||||
On Linux, change to the install destination directory
|
||||
(create if doesn't exist) and execute:
|
||||
<path-to>/myhdfstuff/build/HDF5-1.13."X"-Linux.sh
|
||||
<path-to>/myhdfstuff/build/HDF5-1.15."X"-Linux.sh
|
||||
After accepting the license, the script will prompt:
|
||||
By default the HDF5 will be installed in:
|
||||
"<current directory>/HDF5-1.13."X"-Linux"
|
||||
Do you want to include the subdirectory HDF5-1.13."X"-Linux?
|
||||
"<current directory>/HDF5-1.15."X"-Linux"
|
||||
Do you want to include the subdirectory HDF5-1.15."X"-Linux?
|
||||
Saying no will install in: "<current directory>" [Yn]:
|
||||
Note that the script will create the following directory structure
|
||||
relative to the install point:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
------share
|
||||
|
||||
On Mac you will find HDF5-1.13."X"-Darwin.dmg in the build folder. Click
|
||||
On Mac you will find HDF5-1.15."X"-Darwin.dmg in the build folder. Click
|
||||
on the dmg file to proceed with installation. After accepting the license,
|
||||
there will be a folder with the following structure:
|
||||
HDF_Group
|
||||
--HDF5
|
||||
----1.13."X"
|
||||
----1.15."X"
|
||||
------bin
|
||||
------include
|
||||
------lib
|
||||
@ -277,7 +277,7 @@ IV. Further considerations
|
||||
========================================================================
|
||||
|
||||
1. We suggest you obtain the latest CMake for windows from the Kitware
|
||||
web site. The HDF5 1.13."X" product requires a minimum CMake version 3.18.
|
||||
web site. The HDF5 1.15."X" product requires a minimum CMake version 3.18.
|
||||
|
||||
2. If you plan to use Zlib or Szip:
|
||||
A. Download the binary packages and install them in a central location.
|
||||
|
||||
@ -98,19 +98,19 @@ Build, Test and Install HDF5 on Cygwin
|
||||
|
||||
The HDF5 source code is distributed in a variety of formats which
|
||||
can be unpacked with the following commands, each of which creates
|
||||
an `hdf5-1.13.x' directory.
|
||||
an `hdf5-1.15.x' directory.
|
||||
|
||||
2.1 Non-compressed tar archive (*.tar)
|
||||
|
||||
$ tar xf hdf5-1.13.x.tar
|
||||
$ tar xf hdf5-1.15.x.tar
|
||||
|
||||
2.2 Gzip'd tar archive (*.tar.gz)
|
||||
|
||||
$ gunzip < hdf5-1.13.x.tar.gz | tar xf -
|
||||
$ gunzip < hdf5-1.15.x.tar.gz | tar xf -
|
||||
|
||||
2.3 Bzip'd tar archive (*.tar.bz2)
|
||||
|
||||
$ bunzip2 < hdf5-1.13.x.tar.bz2 | tar xf -
|
||||
$ bunzip2 < hdf5-1.15.x.tar.bz2 | tar xf -
|
||||
|
||||
2. Setup Environment
|
||||
|
||||
|
||||
@ -6,18 +6,18 @@ This tar file contains
|
||||
CTestScript.cmake
|
||||
HDF5config.cmake CMake scripts for building HDF5
|
||||
HDF5options.cmake
|
||||
hdf5-1.13.2 HDF5 1.13.2 source
|
||||
hdf5-1.15.0 HDF5 1.15.0 source
|
||||
LIBAEC.tar.gz source for building SZIP replacement
|
||||
ZLib.tar.gz source for building ZLIB
|
||||
hdf5_plugins.tar.gz source for building compression plugins
|
||||
HDF5Examples-2.0.1-Source.tar.gz source for building examples
|
||||
|
||||
For more information about building HDF5 with CMake, see USING_HDF5_CMake.txt in
|
||||
hdf5-1.13.2/release_docs, or
|
||||
hdf5-1.15.0/release_docs, or
|
||||
https://portal.hdfgroup.org/display/support/Building+HDF5+with+CMake.
|
||||
|
||||
For more information about building HDF5 with CMake on HPC machines, including
|
||||
cross compiling on Cray XC40, see README_HPC in hdf5-1.13.2/release_docs.
|
||||
cross compiling on Cray XC40, see README_HPC in hdf5-1.15.0/release_docs.
|
||||
|
||||
|
||||
|
||||
|
||||
@ -154,10 +154,10 @@ If using ctest is undesirable, one can create a build directory and run the cmak
|
||||
configure command, for example
|
||||
|
||||
"/projects/Mutrino/hpcsoft/cle6.0/common/cmake/3.18/bin/cmake"
|
||||
-C "<working directory>/hdf5-1.13.3/config/cmake/cacheinit.cmake"
|
||||
-C "<working directory>/hdf5-1.15.x/config/cmake/cacheinit.cmake"
|
||||
-DCMAKE_BUILD_TYPE:STRING=Release -DHDF5_BUILD_FORTRAN:BOOL=ON
|
||||
-DHDF5_BUILD_JAVA:BOOL=OFF
|
||||
-DCMAKE_INSTALL_PREFIX:PATH=<working directory>/HDF_Group/HDF5/1.13.3
|
||||
-DCMAKE_INSTALL_PREFIX:PATH=<working directory>/HDF_Group/HDF5/1.15.x
|
||||
-DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF -DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF
|
||||
-DHDF5_ENABLE_PARALLEL:BOOL=ON -DHDF5_BUILD_CPP_LIB:BOOL=OFF
|
||||
-DHDF5_BUILD_JAVA:BOOL=OFF -DHDF5_ENABLE_THREADSAFE:BOOL=OFF
|
||||
@ -168,7 +168,7 @@ configure command, for example
|
||||
-DLOCAL_BATCH_SCRIPT_NAME:STRING=knl_ctestS.sl
|
||||
-DLOCAL_BATCH_SCRIPT_PARALLEL_NAME:STRING=knl_ctestP.sl -DSITE:STRING=mutrino
|
||||
-DBUILDNAME:STRING=par-knl_GCC493-SHARED-Linux-4.4.156-94.61.1.16335.0.PTF.1107299-default-x86_64
|
||||
"-GUnix Makefiles" "" "<working directory>/hdf5-1.13.3"
|
||||
"-GUnix Makefiles" "" "<working directory>/hdf5-1.15.x"
|
||||
|
||||
followed by make and batch jobs to run tests.
|
||||
|
||||
|
||||
@ -21,7 +21,7 @@ I. Preconditions
|
||||
========================================================================
|
||||
|
||||
1. We suggest you obtain the latest CMake for your platform from the Kitware
|
||||
web site. The HDF5 1.13.x product requires a minimum CMake version
|
||||
web site. The HDF5 1.15.x product requires a minimum CMake version
|
||||
of 3.18. If you are using VS2022, the minimum version is 3.21.
|
||||
|
||||
2. You have installed the HDF5 library built with CMake, by executing
|
||||
|
||||
@ -38,7 +38,7 @@ I. Preconditions
|
||||
========================================================================
|
||||
|
||||
1. We suggest you obtain the latest CMake for your platform from the Kitware
|
||||
web site. The HDF5 1.13.x product requires a minimum CMake version
|
||||
web site. The HDF5 1.15.x product requires a minimum CMake version
|
||||
of 3.18. If you are using VS2022, the minimum version is 3.21.
|
||||
|
||||
2. You have installed the HDF5 library built with CMake, by executing
|
||||
@ -50,24 +50,24 @@ I. Preconditions
|
||||
or environment variable, set(ENV{HDF5_ROOT} "<install_path>")
|
||||
to the installed location of HDF5.
|
||||
On Windows:
|
||||
HDF5_ROOT=C:/Program Files/HDF_Group/HDF5/1.13.x/
|
||||
HDF5_ROOT=C:/Program Files/HDF_Group/HDF5/1.15.x/
|
||||
On unix:
|
||||
HDF5_ROOT=<install root folder>/HDF_Group/HDF5/1.13.x/
|
||||
HDF5_ROOT=<install root folder>/HDF_Group/HDF5/1.15.x/
|
||||
|
||||
If you are using shared libraries, you may need to add to the path
|
||||
environment variable. Set the path environment variable to the
|
||||
installed location of the library files for HDF5.
|
||||
On Windows (*.dll):
|
||||
PATH=%PATH%;C:/Program Files/HDF_Group/HDF5/1.13.x/bin
|
||||
PATH=%PATH%;C:/Program Files/HDF_Group/HDF5/1.15.x/bin
|
||||
On unix (*.so):
|
||||
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install root folder>/HDF_Group/HDF5/1.13.x/lib
|
||||
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<install root folder>/HDF_Group/HDF5/1.15.x/lib
|
||||
|
||||
If you are using filter plugin libraries, you will need to set the
|
||||
HDF5_PLUGIN_PATH environment variable.
|
||||
On Windows:
|
||||
HDF5_PLUGIN_PATH=C:/Program Files/HDF_Group/HDF5/1.13.x/lib/plugin
|
||||
HDF5_PLUGIN_PATH=C:/Program Files/HDF_Group/HDF5/1.15.x/lib/plugin
|
||||
On unix:
|
||||
HDF5_PLUGIN_PATH=<install root folder>/HDF_Group/HDF5/1.13.x/lib/plugin
|
||||
HDF5_PLUGIN_PATH=<install root folder>/HDF_Group/HDF5/1.15.x/lib/plugin
|
||||
|
||||
(Note there are no quote characters used on Windows and all platforms
|
||||
use forward slashes)
|
||||
@ -126,6 +126,9 @@ These steps are described in more detail below.
|
||||
* Visual Studio 16 2019
|
||||
* ... in addition VS2019 will need to set the "-A" option,
|
||||
* ... [Win32, x64, ARM, ARM64]
|
||||
* Visual Studio 17 2022
|
||||
* ... in addition VS2022 will need to set the "-A" option,
|
||||
* ... [Win32, x64, ARM, ARM64]
|
||||
|
||||
<options> is:
|
||||
* BUILD_TESTING:BOOL=ON
|
||||
|
||||
@ -54,11 +54,11 @@ Using Visual Studio 2008 with HDF5 Libraries built with Visual Studio 2008
|
||||
and select "x64".
|
||||
|
||||
2.2 Find the box "Show directories for", choose "Include files", add the
|
||||
header path (i.e. c:\Program Files\HDF_Group\HDF5\1.13.x\include)
|
||||
header path (i.e. c:\Program Files\HDF_Group\HDF5\1.15.x\include)
|
||||
to the included directories.
|
||||
|
||||
2.3 Find the box "Show directories for", choose "Library files", add the
|
||||
library path (i.e. c:\Program Files\HDF_Group\HDF5\1.13.x\lib)
|
||||
library path (i.e. c:\Program Files\HDF_Group\HDF5\1.15.x\lib)
|
||||
to the library directories.
|
||||
|
||||
2.4 If using Fortran libraries, you will also need to setup the path
|
||||
|
||||
Loading…
Reference in New Issue
Block a user