Installing Hyper MPI

Procedure

1. Use PuTTY to log in to the server as the root user.
2. Install the HUCX and XUCG source packages.

   wget -c https://github.com/kunpengcompute/hucx/archive/refs/heads/huawei.zip -O hucx-huawei.zip
   wget -c https://github.com/kunpengcompute/xucg/archive/refs/heads/huawei.zip -O xucg-huawei.zip

3. Decompress the HUCX and XUCG source packages.

   unzip hucx-huawei.zip
   unzip xucg-huawei.zip

4. Copy the content in the XUCG source package to the src/ucg directory of the HUCX source package.

   cp -r xucg-huawei/* hucx-huawei/src/ucg/

5. Go to the hucx-huawei directory.

   cd hucx-huawei

6. Set the environment variables.

   export SEC_CFLAGS="-Wno-error=deprecated-declarations -DHAVE___CLEAR_CACHE=1 -Wno-error=asm-operand-widths -Wno-error=implicit-int-float-conversion -Wno-error=format -Wno-error=tautological-pointer-compare"

7. Create an HUCX installation directory.

   mkdir -p /path/to/ucx

8. Install HUCX.

   ./autogen.sh
   ./contrib/configure-opt --prefix=/path/to/ucx CFLAGS="$SEC_CFLAGS" CXXFLAGS="$SEC_CFLAGS"
   make -j32
   make install

9. Obtain the Hyper MPI source package.

   wget -c https://github.com/kunpengcompute/hmpi/archive/refs/heads/huawei.zip -O hmpi-huawei.zip

10. Decompress the Hyper MPI source package.

    unzip hmpi-huawei.zip

11. Go to the hmpi-huawei directory.

    cd hmpi-huawei

12. Install Hyper MPI.

    ./autogen.pl
    ./configure --prefix=/path/to/ompi --with-platform=contrib/platform/mellanox/optimized --enable-mpi1-compatibility --with-ucx=/path/to/ucx
    make -j16
    make install

13. Set the environment variables.

    export PATH=/path/to/ompi/bin:/path/to/ucx/bin:$PATH
    export LD_LIBRARY_PATH=/path/to/ompi/lib:/path/to/ucx/lib:$LD_LIBRARY_PATH
    export OPAL_PREFIX=/path/to/ompi/
    export INCLUDE=/path/to/ompi:$INCLUDE