Issue

After installing graid-mgr, the service fails to start.

When checking the service status, the following error is reported:

systemctl status graid-mgr

Error message:

error while loading shared libraries: librrd_graid.so.8:
cannot open shared object file: No such file or directory

However, the library does exist on the system:

ls -al /usr/lib/graid/librrd_graid.so

Example output:

lrwxrwxrwx 1 root root 21 Nov 30 02:50 /usr/lib/graid/librrd_graid.so -> librrd_graid.so.8.2.1

Root Cause

The shared library librrd_graid.so.8 is present on the system, but the directory
/usr/lib/graid is not included in the system dynamic linker search path.

As a result, the dynamic linker (ld.so) cannot locate the library at runtime, causing graid-mgr to fail during startup.

Resolution

Step 1 – Add the Graid library path to ldconfig

Create a new configuration file under /etc/ld.so.conf.d/ and add the GRAID library directory.

echo "/usr/lib/graid" | sudo tee /etc/ld.so.conf.d/graid.conf

Step 2 – Update the dynamic linker cache

Run ldconfig to rescan libraries and update the cache:

sudo ldconfig

Verification

After completing the steps above, verify that graid-mgr can correctly locate the library.

Method 1 – Use ldd

ldd /usr/bin/graid-mgr | grep librrd

Expected output example:

librrd_graid.so.8 => /usr/lib/graid/librrd_graid.so.8.2.1 (0x00007f...)

Method 2 – Restart the service

sudo systemctl restart graid-mgr
sudo systemctl status graid-mgr

The service should now start successfully without shared library errors.

Additional Notes