Troubleshooting Guide: Error 102198 - Connection Issue with BDRSuite Portal

Troubleshooting Guide: Error 102198 - Connection Issue with BDRSuite Portal

Overview

Error 102198 indicates a failure in establishing a connection with the BDRSuite Portal due to an issue with the curl library initialization. This error typically occurs when the required shared dynamic link libraries (DLLs) for the curl library are missing or not found in the expected location.

Cause

The error is caused by the curl library not being properly initialized, often due to missing or misplaced DLL files such as libssh2.dll, libssl-1_1-x64.dll, and libcrypto-1_1-x64.dll.

Solution For Windows

Step 1: Verify DLL Files in Apache Directory

  1. Navigate to the apache/bin directory of your BDRSuite installation.
Example: C:/Vembu/VembuBDR/apache/bin.
  1. Check if the following DLL files are present:
  1. libssh2.dll
  2. libssl-1_1-x64.dll
  3. libcrypto-1_1-x64.dll

Step 2: Locate and Copy Missing DLL Files

  1. If the DLL files are missing, navigate to the PHP installation directory within your BDRSuite installation.
Example: C:/Vembu/VembuBDR/php.
  1. Copy the following DLL files:
  1. libssh2.dll
  2. libssl-1_1-x64.dll
  3. libcrypto-1_1-x64.dll

Step 3: Paste DLL Files into Apache Directory

  1. Paste the copied DLL files into the apache/bin directory.
Example: C:/Vembu/VembuBDR/apache/bin.

Step 4: Restart Apache

Restart the BDRSuite Webserver to ensure the changes take effect.

For Docker Containers:

Step 1: Access the Docker Container

Connect to the Docker container using the following command:
docker exec -it <container_id> /bin/bash
Verify if the curl command fails due to a missing or incompatible library by running:
curl --version
If the output shows errors related to missing libraries, proceed to the next step.

Step 2: Remove Conflicting Configuration

  1. Execute the following commands within the container to resolve library conflicts:
rm /etc/ld.so.conf.d/conflicting_config.conf
ldconfig
  1. Exit the Docker container by running:
exit

Step 3: Restart Services from Docker Host

  1. Stop the necessary services from the Docker host:
docker exec <container_id> service <service_name> stop
Example: docker exec bdr-container service vembu-bdr stop
  1. Restart the services using the following commands:
docker exec <container_id> service <service_name> start
Example: docker exec bdr-container service vembu-bdr start

Step 4: Re-register the Backup Server

  1. Attempt to re-register the backup server with the BDRSuite Portal.
  2. If successful, the backup server should now function normally.
Outcome
  1. After performing the above steps, the BDR Server should be able to successfully register with the BDRSuite Portal without encountering the connection error.
Additional Support
If the issue persists after following these steps, please reach out to the BDRSuite support team by emailing bdr-support@vembu.com. Mention "From Community Forum" in the subject line for priority assistance.