Installing OpenSSL for the Mac Client

The LibreSSL version of OpenSSL that comes preinstalled on the macOS is not compatible with HPE Ezmeral Data Fabric. Before running configure.sh to configure the Mac client, you must install the OpenSSL package and add paths to the OpenSSL command and dynamic libraries.

NOTE
The following procedure installs OpenSSL version 1.1.1; however, Data Fabric also supports OpenSSL 3.3 and this version can be installed instead. To check your installed version of OpenSSL, issue the openssl version command.
To install OpenSSL on macOS:
  1. Run the following brew install command:
    brew install OpenSSL@1.1
  2. Add the paths to the OpenSSL binary and library:
    OPENSSL_INSTALLED_LOCATION=`brew --prefix openssl@1.1`
    OPENSSL_LIBRARY_PATH=${OPENSSL_INSTALLED_LOCATION}/lib
    OPENSSL_PATH=${OPENSSL_INSTALLED_LOCATION}/bin 
    export PATH=${OPENSSL_PATH}:${PATH}
    LD_LIBRARY_PATH=${OPENSSL_LIBRARY_PATH}:${LD_LIBRARY_PATH}
  3. Verify that the OpenSSL binary is used. Issuing the following command should return Open SSL 1.1.1x:
    openssl version 
    OpenSSL 1.1.1l 24 Aug 2021 
    If the openssl version command returns LibreSSL, your configuration settings are incorrect:
    openssl version 
    LibreSSL 2.8.3 
  4. Verify your OpenSSL dynamic library configuration by using the verify_ossl utility:
    % /opt/mapr/server/verify_ossl                          
    Verified that OpenSSL can be successfully loaded 
  5. If verify_ossl returns output like the following, then your LD_LIBRARY_PATH settings are incorrect:
    /opt/mapr/server/verify_ossl  
    Unable to load OpenSSL from specified locations. Error: 
    dlopen(libssl.1.1.dylib, 6): image not found 
    Cannot load libssl, file not found in common locations, Exiting... 
    Cannot Initialize OpenSSL 

After you have verified that OpenSSL is installed and that your OpenSSL configuration settings point to the OpenSSL library, you can configure the Mac client. See Installing the Data Fabric Client on Mac OS X (Non-FIPS).