How To Install ucx on CentOS 8

ucx is UCX is a communication library implementing high-performance messaging

Introduction

In this tutorial we learn how to install ucx on CentOS 8.

What is `ucx`

UCX stands for Unified Communication X. UCX provides an optimized communication layer for Message Passing (MPI), PGAS/OpenSHMEM libraries and RPC/data-centric applications. UCX utilizes high-speed networks, such as RDMA (InfiniBand, RoCE, etc), Cray Gemini or Aries, for inter-node communication. If no such network is available, TCP is used instead. UCX supports efficient transfer of data in either main memory (RAM) or GPU memory (through CUDA and ROCm libraries). In addition, UCX provides efficient intra-node communication, by leveraging the following shared memory mechanisms This package was built from ’’ branch, commit 6b29558.

We can use yum or dnf to install ucx on CentOS 8. In this tutorial we discuss both methods but you only need to choose one of method to install ucx.

Install ucx on CentOS 8 Using dnf

Update yum database with dnf using the following command.

sudo dnf makecache --refresh

The output should look something like this:

CentOS Linux 8 - AppStream                                       43 kB/s | 4.3 kB     00:00    
CentOS Linux 8 - BaseOS                                          65 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - ContinuousRelease                               43 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - Extras                                          23 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - FastTrack                                       40 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - HighAvailability                                36 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - Plus                                            24 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - PowerTools                                      50 kB/s | 4.3 kB     00:00    
Extra Packages for Enterprise Linux Modular 8 - x86_64           13 kB/s | 9.2 kB     00:00    
Extra Packages for Enterprise Linux 8 - x86_64                   24 kB/s | 8.5 kB     00:00    
Metadata cache created.

After updating yum database, We can install ucx using dnf by running the following command:

sudo dnf -y install ucx

Install ucx on CentOS 8 Using yum

Update yum database with yum using the following command.

sudo yum makecache --refresh

The output should look something like this:

CentOS Linux 8 - AppStream                                       43 kB/s | 4.3 kB     00:00    
CentOS Linux 8 - BaseOS                                          65 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - ContinuousRelease                               43 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - Extras                                          23 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - FastTrack                                       40 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - HighAvailability                                36 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - Plus                                            24 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - PowerTools                                      50 kB/s | 4.3 kB     00:00    
Extra Packages for Enterprise Linux Modular 8 - x86_64           13 kB/s | 9.2 kB     00:00    
Extra Packages for Enterprise Linux 8 - x86_64                   24 kB/s | 8.5 kB     00:00    
Metadata cache created.

After updating yum database, We can install ucx using yum by running the following command:

sudo yum -y install ucx

How To Uninstall ucx on CentOS 8

To uninstall only the ucx package we can use the following command:

sudo dnf remove ucx

ucx Package Contents on CentOS 8

/usr/bin/ucp_client_server
/usr/bin/ucp_hello_world
/usr/bin/uct_hello_world
/usr/bin/ucx_info
/usr/bin/ucx_perftest
/usr/bin/ucx_read_profile
/usr/lib/.build-id
/usr/lib/.build-id/08
/usr/lib/.build-id/08/322a336738a923323e89b2a6891b90fd2347b5
/usr/lib/.build-id/08/88f729b62595f0ee6b74c8c264d815ae166fd6
/usr/lib/.build-id/35
/usr/lib/.build-id/35/b8dfa4cca9291af61d722d45e2648d21cd9c98
/usr/lib/.build-id/78
/usr/lib/.build-id/78/afa0ececc6e99a09830b5da0c35d408c706be4
/usr/lib/.build-id/79
/usr/lib/.build-id/79/fe9b958378e4dd591a6312fc713d3324ee4937
/usr/lib/.build-id/a7
/usr/lib/.build-id/a7/c12555a5d492145292c86529401ad3d6717f2a
/usr/lib/.build-id/c2
/usr/lib/.build-id/c2/2d080504cadf753853658cc2e55b9723894bfe
/usr/lib/.build-id/f6
/usr/lib/.build-id/f6/2848e3567382c32d1b1d1ae8e664b948a84ec6
/usr/lib/.build-id/fa
/usr/lib/.build-id/fa/4814de4dd3ef015f3fefacf01b93c733bcf3c4
/usr/lib/.build-id/fe
/usr/lib/.build-id/fe/87882ad3b4f318d88693b151dc95439be5ef98
/usr/lib64/libucm.so.0
/usr/lib64/libucm.so.0.0.0
/usr/lib64/libucp.so.0
/usr/lib64/libucp.so.0.0.0
/usr/lib64/libucs.so.0
/usr/lib64/libucs.so.0.0.0
/usr/lib64/libuct.so.0
/usr/lib64/libuct.so.0.0.0
/usr/share/doc/ucx
/usr/share/doc/ucx/AUTHORS
/usr/share/doc/ucx/NEWS
/usr/share/doc/ucx/README
/usr/share/licenses/ucx
/usr/share/licenses/ucx/LICENSE
/usr/share/ucx
/usr/share/ucx/perftest
/usr/share/ucx/perftest/README
/usr/share/ucx/perftest/msg_pow2
/usr/share/ucx/perftest/msg_pow2_large
/usr/share/ucx/perftest/test_types_ucp
/usr/share/ucx/perftest/test_types_uct
/usr/share/ucx/perftest/transports

References

ucx website

Summary

In this tutorial we learn how to install ucx on CentOS 8 using yum and dnf.