#!/usr/bin/env bash # Author : Nico Trost #set -x #echo on # ################################################# # helper functions # ################################################# function display_help() { echo "hipSPARSE build & installation helper script" echo "./install [-h|--help] " echo " [-h|--help] prints this help message" # echo " [--prefix] Specify an alternate CMAKE_INSTALL_PREFIX for cmake" echo " [-i|--install] install after build" echo " [-d|--dependencies] install build dependencies" echo " [-r]--relocatable] create a package to support relocatable ROCm" echo " [-c|--clients] build library clients too (combines with -i & -d)" echo " [-o|--clients-only] build clients only" echo " [-g|--debug] -DCMAKE_BUILD_TYPE=Debug (default is =Release)" echo " [-k|--relwithdebinfo] -DCMAKE_BUILD_TYPE=RelWithDebInfo" echo " [--codecoverage] build with code coverage profiling enabled" echo " [--compiler] specify host compiler" echo " [--cuda] build library for cuda backend" echo " [--static] build static library" echo " [--address-sanitizer] build with address sanitizer enabled. Uses hip-clang to compile" echo " [--matrices-dir] existing client matrices directory" echo " [--matrices-dir-install] install client matrices directory" } # This function is helpful for dockerfiles that do not have sudo installed, but the default user is root # true is a system command that completes successfully, function returns success # prereq: ${ID} must be defined before calling supported_distro( ) { if [ -z ${ID+foo} ]; then printf "supported_distro(): \$ID must be set\n" exit 2 fi case "${ID}" in ubuntu|debian|centos|rhel|fedora|sles|opensuse-leap|almalinux|rocky|ol) true ;; *) printf "This script is currently supported on Ubuntu, Debian, CentOS, RHEL, Fedora, SLES, OpenSUSE-Leap, Alma Linux, Rocky Linux (rocky), and Oracle Linux (ol) (detected: ${ID})\n" exit 2 ;; esac } # This function is helpful for dockerfiles that do not have sudo installed, but the default user is root check_exit_code( ) { if (( $1 != 0 )); then exit $1 fi } # This function is helpful for dockerfiles that do not have sudo installed, but the default user is root elevate_if_not_root( ) { local uid=$(id -u) if (( ${uid} )); then sudo $@ check_exit_code "$?" else $@ check_exit_code "$?" fi } # Take an array of packages as input, and install those packages with 'apt' if they are not already installed install_apt_packages( ) { package_dependencies=("$@") for package in "${package_dependencies[@]}"; do if [[ $(dpkg-query --show --showformat='${db:Status-Abbrev}\n' ${package} 2> /dev/null | grep -q "ii"; echo $?) -ne 0 ]]; then printf "\033[32mInstalling \033[33m${package}\033[32m from distro package manager\033[0m\n" elevate_if_not_root apt install -y --no-install-recommends ${package} fi done } # Take an array of packages as input, and install those packages with 'yum' if they are not already installed install_yum_packages( ) { package_dependencies=("$@") for package in "${package_dependencies[@]}"; do if [[ $(yum list installed ${package} &> /dev/null; echo $? ) -ne 0 ]]; then printf "\033[32mInstalling \033[33m${package}\033[32m from distro package manager\033[0m\n" elevate_if_not_root yum -y --nogpgcheck install ${package} fi done } # Take an array of packages as input, and install those packages with 'dnf' if they are not already installed install_dnf_packages( ) { package_dependencies=("$@") for package in "${package_dependencies[@]}"; do if [[ $(dnf list installed ${package} &> /dev/null; echo $? ) -ne 0 ]]; then printf "\033[32mInstalling \033[33m${package}\033[32m from distro package manager\033[0m\n" elevate_if_not_root dnf install -y ${package} fi done } # Take an array of packages as input, and install those packages with 'zypper' if they are not already installed install_zypper_packages( ) { package_dependencies=("$@") for package in "${package_dependencies[@]}"; do if [[ $(rpm -q ${package} &> /dev/null; echo $? ) -ne 0 ]]; then printf "\033[32mInstalling \033[33m${package}\033[32m from distro package manager\033[0m\n" elevate_if_not_root zypper -n --no-gpg-checks install ${package} fi done } # Take an array of packages as input, and delegate the work to the appropriate distro installer # prereq: ${ID} must be defined before calling # prereq: ${build_clients} must be defined before calling install_packages( ) { if [ -z ${ID+foo} ]; then printf "install_packages(): \$ID must be set\n" exit 2 fi if [ -z ${build_clients+foo} ]; then printf "install_packages(): \$build_clients must be set\n" exit 2 fi # dependencies needed for library and clients to build local library_dependencies_ubuntu=( "gfortran" "make" "pkg-config" "libnuma1" ) local library_dependencies_centos_6=( "epel-release" "make" "cmake3" "gcc-c++" "rpm-build" ) local library_dependencies_centos_7=( "epel-release" "make" "cmake3" "gcc-c++" "rpm-build" ) local library_dependencies_centos_8=( "epel-release" "make" "cmake3" "gcc-c++" "rpm-build" ) local library_dependencies_centos_9=( "epel-release" "make" "cmake3" "gcc-c++" "rpm-build" ) local library_dependencies_centos_10=( "epel-release" "make" "cmake" "gcc-c++" "rpm-build" ) local library_dependencies_fedora=( "make" "cmake" "gcc-c++" "libcxx-devel" "rpm-build" "numactl-libs" ) local library_dependencies_sles=( "make" "cmake" "gcc-c++" "rpm-build" "pkg-config" "dpkg" ) local client_dependencies_centos_6=( "gcc-gfortran" ) local client_dependencies_centos_7=( "devtoolset-7-gcc-gfortran" ) local client_dependencies_centos_8=( "gcc-gfortran" ) local client_dependencies_centos_9=( "gcc-gfortran" ) local client_dependencies_centos_10=( "gcc-gfortran" ) local client_dependencies_fedora=( "gcc-gfortran" ) local client_dependencies_sles=( "gcc-fortran" ) if [[ ( "${ID}" == "centos" ) || ( "${ID}" == "rhel" ) || ( "${ID}" == "almalinux" ) || ( "${ID}" == "rocky" ) || ( "${ID}" == "ol" ) ]]; then if [[ "${MAJORVERSION}" == "6" ]]; then library_dependencies_centos_6+=( "numactl" ) else library_dependencies_centos_7+=( "numactl-libs" ) library_dependencies_centos_8+=( "numactl-libs" ) library_dependencies_centos_9+=( "numactl-libs" ) library_dependencies_centos_10+=( "numactl-libs" ) fi fi if [[ ( "${ID}" == "sles" ) ]]; then if [[ -f /etc/os-release ]]; then . /etc/os-release function version { echo "$@" | awk -F. '{ printf("%d%03d%03d%03d\n", $1,$2,$3,$4); }'; } if [[ $(version $VERSION_ID) -ge $(version 15.4) ]]; then library_dependencies_sles+=( "libcxxtools10" ) else library_dependencies_sles+=( "libcxxtools9" ) fi fi fi case "${ID}" in ubuntu|debian) elevate_if_not_root apt update install_apt_packages "${library_dependencies_ubuntu[@]}" ;; centos|rhel|almalinux|rocky|ol) # yum -y update brings *all* installed packages up to date # without seeking user approval # elevate_if_not_root yum -y update if [[ "${MAJORVERSION}" -ge 10 ]]; then install_yum_packages "${library_dependencies_centos_10[@]}" if [[ "${build_clients}" == true ]]; then install_yum_packages "${client_dependencies_centos_10[@]}" fi elif [[ "${MAJORVERSION}" == 9 ]]; then install_yum_packages "${library_dependencies_centos_9[@]}" if [[ "${build_clients}" == true ]]; then install_yum_packages "${client_dependencies_centos_9[@]}" fi elif [[ "${MAJORVERSION}" == 8 ]]; then install_yum_packages "${library_dependencies_centos_8[@]}" if [[ "${build_clients}" == true ]]; then install_yum_packages "${client_dependencies_centos_8[@]}" fi elif [[ "${MAJORVERSION}" == 6 ]]; then install_yum_packages "${library_dependencies_centos_6[@]}" if [[ "${build_clients}" == true ]]; then install_yum_packages "${client_dependencies_centos_6[@]}" fi else install_yum_packages "${library_dependencies_centos_7[@]}" if [[ "${build_clients}" == true ]]; then install_yum_packages "${client_dependencies_centos_7[@]}" fi fi ;; fedora) # elevate_if_not_root dnf -y update install_dnf_packages "${library_dependencies_fedora[@]}" if [[ "${build_clients}" == true ]]; then install_dnf_packages "${client_dependencies_fedora[@]}" fi ;; sles|opensuse-leap) # elevate_if_not_root zypper -y update install_zypper_packages "${library_dependencies_sles[@]}" if [[ "${build_clients}" == true ]]; then install_zypper_packages "${client_dependencies_sles[@]}" fi ;; *) echo "This script is currently supported on Ubuntu, Debian, CentOS, RHEL and Fedora" exit 2 ;; esac } # ################################################# # Pre-requisites check # ################################################# # Exit code 0: alls well # Exit code 1: problems with getopt # Exit code 2: problems with supported platforms # check if getopt command is installed type getopt > /dev/null if [[ $? -ne 0 ]]; then echo "This script uses getopt to parse arguments; try installing the util-linux package"; exit 1 fi # /etc/*-release files describe the system if [[ -e "/etc/os-release" ]]; then source /etc/os-release elif [[ -e "/etc/centos-release" ]]; then ID=$(cat /etc/centos-release | awk '{print tolower($1)}') VERSION_ID=$(cat /etc/centos-release | grep -oP '(?<=release )[^ ]*' | cut -d "." -f1) else echo "This script depends on the /etc/*-release files" exit 2 fi MAJORVERSION=$(echo $VERSION_ID | cut -f1 -d.) # The following function exits script if an unsupported distro is detected supported_distro # ################################################# # global variables # ################################################# install_package=false install_dependencies=false build_clients=false build_clients_only=false build_cuda=false build_static=false build_release=true build_release_debug=false build_codecoverage=false install_prefix=hipsparse-install rocm_path=/opt/rocm build_relocatable=false build_address_sanitizer=false compiler=${CXX} c_compiler=${CC} # ################################################# # Parameter parsing # ################################################# # check if we have a modern version of getopt that can handle whitespace and long parameters getopt -T if [[ $? -eq 4 ]]; then GETOPT_PARSE=$(getopt --name "${0}" --longoptions help,install,clients,clients-only,dependencies,debug,compiler:,cuda,static,relocatable,codecoverage,relwithdebinfo,address-sanitizer,matrices-dir:,matrices-dir-install:,rm-legacy-include-dir --options hicodgrk -- "$@") else echo "Need a new version of getopt" exit 1 fi if [[ $? -ne 0 ]]; then echo "getopt invocation failed; could not parse the command line"; exit 1 fi eval set -- "${GETOPT_PARSE}" while true; do case "${1}" in -h|--help) display_help exit 0 ;; -i|--install) install_package=true shift ;; -d|--dependencies) install_dependencies=true shift ;; -c|--clients) build_clients=true shift ;; -o|--clients-only) build_clients_only=true shift ;; -r|--relocatable) build_relocatable=true shift ;; -g|--debug) build_release=false shift ;; --compiler) compiler=${2} shift 2 ;; --cuda) build_cuda=true shift ;; --static) build_static=true shift ;; -k|--relwithdebinfo) build_release=false build_release_debug=true shift ;; --codecoverage) build_codecoverage=true shift ;; --address-sanitizer) build_address_sanitizer=true compiler=amdclang++ c_compiler=amdclang shift ;; --matrices-dir) matrices_dir=${2} if [[ "${matrices_dir}" == "" ]];then echo "Missing argument from command line parameter --matrices-dir; aborting" exit 1 fi shift 2 ;; --matrices-dir-install) matrices_dir_install=${2} if [[ "${matrices_dir_install}" == "" ]];then echo "Missing argument from command line parameter --matrices-dir-install; aborting" exit 1 fi shift 2 ;; --prefix) install_prefix=${2} shift 2 ;; --) shift ; break ;; *) echo "Unexpected command line parameter received; aborting"; exit 1 ;; esac done # Note 'compiler' variable not changed after this point. This ensures that everything is built with the same compiler # provided by the user through either setting CXX externally (in which case compiler=${CXX} followed by CXX=${compiler}) # or through using --compiler option. This is important so that googletest and hipsparse are built with the same # compiler to ensure settings like position independent code is consistent when linking. CXX=${compiler} CC=${c_compiler} if [[ "${build_relocatable}" == true ]]; then if ! [ -z ${ROCM_PATH+x} ]; then rocm_path=${ROCM_PATH} fi rocm_rpath=" -Wl,--enable-new-dtags -Wl,--rpath,/opt/rocm/lib:/opt/rocm/lib64" if ! [ -z ${ROCM_RPATH+x} ]; then rocm_rpath=" -Wl,--enable-new-dtags -Wl,--rpath,${ROCM_RPATH}" fi fi # # If matrices_dir_install has been set up then install matrices dir and exit. # if ! [[ "${matrices_dir_install}" == "" ]];then cmake -DCMAKE_CXX_COMPILER="${rocm_path}/bin/amdclang++" -DCMAKE_C_COMPILER="${rocm_path}/bin/amdclang" -DPROJECT_BINARY_DIR=${matrices_dir_install} -DCMAKE_MATRICES_DIR=${matrices_dir_install} -P ./cmake/ClientMatrices.cmake exit 0 fi # # If matrices_dir has been set up then check if it exists and it contains expected files. # If it doesn't contain expected file, it will create them. # if ! [[ "${matrices_dir}" == "" ]];then if ! [ -e ${matrices_dir} ];then echo "Invalid dir from command line parameter --matrices-dir: ${matrices_dir}; aborting"; exit 1 fi # Let's 'reinstall' to the specified location to check if all good # Will be fast if everything already exists as expected. # This is to prevent any empty directory. cmake -DCMAKE_CXX_COMPILER="${rocm_path}/bin/amdclang++" -DCMAKE_C_COMPILER="${rocm_path}/bin/amdclang" -DPROJECT_BINARY_DIR=${matrices_dir} -DCMAKE_MATRICES_DIR=${matrices_dir} -P ./cmake/ClientMatrices.cmake fi build_dir=./build printf "\033[32mCreating project build directory in: \033[33m${build_dir}\033[0m\n" # ################################################# # prep # ################################################# # ensure a clean build environment if [[ "${build_release}" == true ]]; then rm -rf ${build_dir}/release elif [[ "${build_release_debug}" == true ]]; then rm -rf ${build_dir}/release-debug else rm -rf ${build_dir}/debug fi # Default cmake executable is called cmake cmake_executable=cmake case "${ID}" in centos|rhel|almalinux|rocky|ol) if [[ "${MAJORVERSION}" -ge 10 ]]; then cmake_executable=cmake else cmake_executable=cmake3 fi ;; esac # ################################################# # dependencies # ################################################# if [[ "${install_dependencies}" == true ]]; then install_packages # The following builds googletest from source, installs into cmake default /usr/local pushd . printf "\033[32mBuilding \033[33mgoogletest\033[32m from source; installing into \033[33m/usr/local\033[0m\n" mkdir -p ${build_dir}/deps && cd ${build_dir}/deps ${cmake_executable} ../../deps make -j$(nproc) elevate_if_not_root make install popd fi # We append customary rocm path; if user provides custom rocm path in ${path}, our # hard-coded path has lesser priority if [[ "${build_relocatable}" == true ]]; then export PATH=${rocm_path}/bin:${PATH} else export PATH=${PATH}:/opt/rocm/bin fi pushd . # ################################################# # configure & build # ################################################# cmake_common_options="" cmake_client_options="" cmake_build_static_options="" # build type if [[ "${build_release}" == true ]]; then mkdir -p ${build_dir}/release/clients && cd ${build_dir}/release cmake_common_options="${cmake_common_options} -DCMAKE_BUILD_TYPE=Release" elif [[ "${build_release_debug}" == true ]]; then mkdir -p ${build_dir}/release-debug/clients && cd ${build_dir}/release-debug cmake_common_options="${cmake_common_options} -DCMAKE_BUILD_TYPE=RelWithDebInfo" else mkdir -p ${build_dir}/debug/clients && cd ${build_dir}/debug cmake_common_options="${cmake_common_options} -DCMAKE_BUILD_TYPE=Debug" fi # code coverage if [[ "${build_codecoverage}" == true ]]; then if [[ "${build_release}" == true ]]; then echo "Code coverage is disabled in Release mode, to enable code coverage select either Debug mode (-g | --debug) or RelWithDebInfo mode (-k | --relwithdebinfo); aborting"; exit 1 fi cmake_common_options="${cmake_common_options} -DBUILD_CODE_COVERAGE=ON" fi # address sanitizer if [[ "${build_address_sanitizer}" == true ]]; then cmake_common_options="$cmake_common_options -DBUILD_ADDRESS_SANITIZER=ON" fi # library type if [[ "${build_static}" == true ]]; then cmake_common_options="${cmake_common_options} -DBUILD_SHARED_LIBS=OFF" cmake_build_static_options=" -no-pie" fi # clients if [[ "${build_clients}" == true ]]; then cmake_client_options="${cmake_client_options} -DBUILD_CLIENTS_SAMPLES=ON -DBUILD_CLIENTS_TESTS=ON -DBUILD_CLIENTS_BENCHMARKS=ON" # # Add matrices_dir if exists. # if ! [[ "${matrices_dir}" == "" ]];then cmake_client_options="${cmake_client_options} -DCMAKE_MATRICES_DIR=${matrices_dir}" fi fi # clients only if [[ "${build_clients_only}" == true ]]; then cmake_client_options="${cmake_client_options} -DBUILD_CLIENTS_ONLY=ON -DBUILD_CLIENTS_SAMPLES=ON -DBUILD_CLIENTS_TESTS=ON -DBUILD_CLIENTS_BENCHMARKS=ON" # # Add matrices_dir if exists. # if ! [[ "${matrices_dir}" == "" ]];then cmake_client_options="${cmake_client_options} -DCMAKE_MATRICES_DIR=${matrices_dir}" fi fi # cpack if [[ "${build_relocatable}" == true ]]; then cmake_common_options="${cmake_common_options} -DCPACK_SET_DESTDIR=OFF -DCPACK_PACKAGING_INSTALL_PREFIX=${rocm_path}" else cmake_common_options="${cmake_common_options} -DCPACK_SET_DESTDIR=OFF -DCPACK_PACKAGING_INSTALL_PREFIX=/opt/rocm" fi # cuda or hip if [[ "${build_cuda}" == false ]]; then cmake_common_options="${cmake_common_options} -DUSE_CUDA=OFF" else cmake_common_options="${cmake_common_options} -DUSE_CUDA=ON" fi # Build library if [[ "${build_relocatable}" == true ]]; then CXX=${compiler} CC=${c_compiler} ${cmake_executable} ${cmake_common_options} ${cmake_client_options} \ -DCMAKE_INSTALL_PREFIX="${install_prefix}" \ -DCMAKE_SHARED_LINKER_FLAGS="${rocm_rpath}" \ -DCMAKE_PREFIX_PATH="${rocm_path} ${rocm_path}/hip" \ -DCMAKE_MODULE_PATH="${rocm_path}/lib/cmake/hip ${rocm_path}/hip/cmake" \ -DCMAKE_EXE_LINKER_FLAGS=" -Wl,--enable-new-dtags -Wl,--rpath,${rocm_path}/lib:${rocm_path}/lib64 ${cmake_build_static_options}" \ -DROCM_DISABLE_LDCONFIG=ON \ -DROCM_PATH="${rocm_path}" ../.. else CXX=${compiler} CC=${c_compiler} ${cmake_executable} -DCMAKE_EXE_LINKER_FLAGS=" ${cmake_build_static_options}" ${cmake_common_options} ${cmake_client_options} -DCMAKE_INSTALL_PREFIX=hipsparse-install -DROCM_PATH=${rocm_path} ../.. fi check_exit_code "$?" make -j$(nproc) install check_exit_code "$?" # ################################################# # install # ################################################# # installing through package manager, which makes uninstalling easy if [[ "${install_package}" == true ]]; then make package check_exit_code "$?" case "${ID}" in ubuntu|debian) elevate_if_not_root dpkg -i hipsparse[-\_]*.deb ;; centos|rhel|almalinux|rocky|ol) elevate_if_not_root yum -y localinstall hipsparse-*.rpm ;; fedora) elevate_if_not_root dnf install hipsparse-*.rpm ;; sles|opensuse-leap) elevate_if_not_root zypper -n --no-gpg-checks install hipsparse-*.rpm ;; esac fi popd