Combined INSTALL_parallel and README_HPC content (#5952)

* Combined INSTALL_parallel and README_HPC into a single, README_HPC.md file.
* Removed all autotools references
* Updated All References

Author: brtnfld

CMakeInstallation.cmake

@@ -251,7 +251,7 @@ if (NOT HDF5_EXTERNALLY_CONFIGURED)
       if (HDF5_ENABLE_PARALLEL)
         set (release_files
             ${release_files}
-            ${HDF5_SOURCE_DIR}/release_docs/INSTALL_parallel
+            ${HDF5_SOURCE_DIR}/release_docs/README_HPC.md
         )
       endif ()
     endif ()

README.md

@@ -51,7 +51,7 @@ Several more files are located within the [release_docs/][u4] directory with spe
 details for several common platforms and configurations.
 - INSTALL - Start Here. General instructions for compiling and installing the library or using an installed library
 - INSTALL_CMAKE - instructions for building with CMake (Kitware.com)
-- INSTALL_parallel - instructions for building and configuring Parallel HDF5
+- README_HPC.md - instructions for building and configuring Parallel HDF5 on HPC systems
 - INSTALL_Windows and INSTALL_Cygwin - MS Windows installations.
 - USING_HDF5_CMake - Build and Install HDF5 Applications with CMake
 - USING_CMake_Examples - Build and Test HDF5 Examples with CMake

bin/batch/knl_ctestP.sl.in.cmake

@@ -264,15 +264,6 @@ set (ENV{CI_MODEL} ${MODEL})
     file (APPEND ${CTEST_SCRIPT_DIRECTORY}/FailedCTest.txt "Failed Configure: ${res}\n")
   endif ()
 
-  # On Cray XC40, configuring fails in the Fortran section when using the craype-mic-knl module.
-  # When the configure phase is done with the craype-haswell module and the build phase is done
-  # with the craype-mic-knl module, configure succeeds and tests pass on the knl compute nodes
-  # for Intel, Cray, GCC and Clang compilers.  If the variables aren't set or if not
-  # cross compiling, the module switch will not occur.
-  if (CMAKE_CROSSCOMPILING AND COMPILENODE_HWCOMPILE_MODULE AND COMPUTENODE_HWCOMPILE_MODULE)
-      execute_process (COMMAND module switch ${COMPILENODE_HWCOMPILE_MODULE} ${COMPUTENODE_HWCOMPILE_MODULE})
-  endif ()
-
   ctest_build (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND RETURN_VALUE res NUMBER_ERRORS errval)
   if (LOCAL_SUBMIT)
     ctest_submit (PARTS Build)
@@ -287,15 +278,11 @@ set (ENV{CI_MODEL} ${MODEL})
         ctest_test (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND ${ctest_test_args} RETURN_VALUE res)
       else ()
         file(STRINGS ${CTEST_BINARY_DIRECTORY}/Testing/TAG TAG_CONTENTS REGEX "^2([0-9]+)[-]([0-9]+)$")
-        if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "raybsub")
-          execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME})
+        if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "qsub")
+          execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME} ctestS.out)
         else ()
-          if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "qsub")
-            execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME} ctestS.out)
-          else ()
-            execute_process (COMMAND ${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME})
-          endif()
-        endif ()
+          execute_process (COMMAND ${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME})
+        endif()
         message(STATUS "Check for existence of ${CTEST_BINARY_DIRECTORY}/ctestS.done")
         execute_process(COMMAND ls ${CTEST_BINARY_DIRECTORY}/ctestS.done RESULT_VARIABLE result OUTPUT_QUIET ERROR_QUIET)
         while(result)
@@ -308,14 +295,10 @@ set (ENV{CI_MODEL} ${MODEL})
         endif ()
         if (LOCAL_BATCH_SCRIPT_PARALLEL_NAME)
           unset(result CACHE)
-          if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "raybsub")
-            execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_PARALLEL_NAME})
+          if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "qsub")
+            execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME} ctestP.out)
           else ()
-            if (LOCAL_BATCH_SCRIPT_COMMAND STREQUAL "qsub")
-              execute_process (COMMAND ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_NAME} ctestP.out)
-            else ()
-              execute_process (COMMAND ${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_PARALLEL_NAME})
-            endif ()
+            execute_process (COMMAND ${LOCAL_BATCH_SCRIPT_COMMAND} ${LOCAL_BATCH_SCRIPT_ARGS} ${CTEST_BINARY_DIRECTORY}/${LOCAL_BATCH_SCRIPT_PARALLEL_NAME})
           endif ()
           message(STATUS "Check for existence of ${CTEST_BINARY_DIRECTORY}/ctestP.done")
           execute_process(COMMAND ls ${CTEST_BINARY_DIRECTORY}/ctestP.done RESULT_VARIABLE result OUTPUT_QUIET ERROR_QUIET)

bin/batch/knl_ctestS.sl.in.cmake

@@ -48,7 +48,7 @@ set (CTEST_SOURCE_VERSEXT "-4")
 #CTEST_CONFIGURATION_TYPE - Release, Debug, RelWithDebInfo
 #CTEST_SOURCE_NAME - name of source folder; HDF5-2.0.x
 #MODEL - CDash group name
-#HPC - run alternate configurations for HPC machines; sbatch, bsub, raybsub, qsub
+#HPC - run alternate configurations for HPC machines; sbatch, bsub, qsub
 #MPI - enable MPI
 if (DEFINED CTEST_SCRIPT_ARG)
     # transform ctest script arguments of the form

config/cmake/scripts/CTestScript.cmake

@@ -21,11 +21,6 @@ endif()
 ### options to run test scripts in batch commands
 set (LOCAL_BATCH_SCRIPT_NAME "ctest.qsub")
 set (LOCAL_BATCH_SCRIPT_PARALLEL_NAME "ctest.qsub")
-if (DEFINED KNL)
-  ### some additions and alternatives to cross compile on haswell for knl
-  set (COMPUTENODE_HWCOMPILE_MODULE "craype-mic-knl")
-  set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DCMAKE_TOOLCHAIN_FILE:STRING=config/toolchain/crayle.cmake")
-endif ()
 set (LOCAL_BATCH_SCRIPT_COMMAND "qsub")
 set (LOCAL_BATCH_TEST "TRUE")
 set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DLOCAL_BATCH_TEST:BOOL=ON")

config/cmake/scripts/HDF5config.cmake

@@ -19,17 +19,8 @@ if (DEFINED MPI)
 endif()
 #############################################################################################
 ### options to run test scripts in batch commands
-if (DEFINED KNL)
-  ### some additions and alternatives to cross compile on haswell for knl
-  set (COMPILENODE_HWCOMPILE_MODULE "craype-haswell")
-  set (COMPUTENODE_HWCOMPILE_MODULE "craype-mic-knl")
-  set (LOCAL_BATCH_SCRIPT_NAME "knl_ctestS.sl")
-  set (LOCAL_BATCH_SCRIPT_PARALLEL_NAME "knl_ctestP.sl")
-  set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DCMAKE_TOOLCHAIN_FILE:STRING=config/toolchain/crayle.cmake")
-else ()
-  set (LOCAL_BATCH_SCRIPT_NAME "ctestS.sl")
-  set (LOCAL_BATCH_SCRIPT_PARALLEL_NAME "ctestP.sl")
-endif ()
+set (LOCAL_BATCH_SCRIPT_NAME "ctestS.sl")
+set (LOCAL_BATCH_SCRIPT_PARALLEL_NAME "ctestP.sl")
 set (LOCAL_BATCH_SCRIPT_COMMAND "sbatch")
 set (LOCAL_BATCH_TEST "TRUE")
 set (ADD_BUILD_OPTIONS "${ADD_BUILD_OPTIONS} -DLOCAL_BATCH_TEST:BOOL=ON")

config/cmake/scripts/HPC/qsub-HDF5options.cmake

@@ -65,9 +65,9 @@ from the HDF5 source code package using the CMake tools. This procedure
 will use the default settings in the config/cmake/cacheinit.cmake file.
 The HDF Group recommends using the presets process to build HDF5.
 
-NOTE: if you are using CMake 3.25 or later, you can use the presets process.
-    The CMakePresets.json file in the source directory will configure, build, test,
-    and package HDF5 with the same options that are set in the cacheinit.cmake file.
+NOTE: When using the presets process, the CMakePresets.json file in the source
+    directory will configure, build, test, and package HDF5 with the same options
+    that are set in the cacheinit.cmake file.
     In addition, it will get the optional files listed below that are needed, from
     the appropriate repositories.
     See Section X: Using CMakePresets.json for compiling
@@ -299,9 +299,7 @@ IV. Further Considerations
 ========================================================================
 
    1. We suggest you obtain the latest CMake from the Kitware
-      web site. The HDF5 2."X"."Y" product requires a minimum CMake version 3.18.
-      If you are using VS2022, the CMake minimum version is 3.21. CMakePresets
-      requires CMake 3.25.
+      web site. The HDF5 2."X"."Y" product requires a minimum CMake version 3.26.
 
    2. If you plan to use Zlib or Szip (aka libaec):
       A. Download the binary packages and install them in a central location.
@@ -766,7 +764,7 @@ These five steps are described in detail below.
    12. Parallel versus serial library
         The HDF5 library can be configured to use MPI and MPI-IO for
         parallelism on a distributed multi-processor system.  Read the
-        file INSTALL_parallel for detailed information.
+        file README_HPC.md for detailed information.
             HDF5_ENABLE_PARALLEL:BOOL=ON
 
         The threadsafe, C++ and Java interfaces are not compatible