Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

documentation with troubleshooting steps updated #6701

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,3 +11,24 @@ CMake Failures

For development, if you simply want to disable HTTPS support entirely,
pass the `-DUSE_HTTPS=OFF` argument to `cmake` when configuring it.

* **`-- Could NOT find PkgConfig (missing: PKG_CONFIG_EXECUTABLE)`**
Make sure that PkgConfig is installed on your system. It is a tool
used to retrieve information about installed libraries. If PkgConfig
is not installed, you can usually install it using your package manager.
(sudo apt-get install pkg-config).

* **`-- Could NOT find GSSAPI (missing: GSSAPI_LIBRARIES GSSAPI_INCLUDE_DIR)`**
GSSAPI is the Generic Security Services API, and it seems the build system
cannot find the necessary libraries and include files. Install the GSSAPI
development package using your package manager. The package names may vary
depending on your operating system. For example, on Debian-based systems, you
can use: (sudo apt-get install libgssapi-dev) or (sudo apt install libgssglue-dev).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Which?



* **'-- Could NOT find OpenSSL(missing: OPENSSL_CRYPTO_LIBRARY OPENSSL_INCLUDE_DIR) logo`**
Build system is unable to find OpenSSL. Make sure OpenSSL is installed on your system.
If OpenSSL is installed, it's possible that the build system needs information about the
location of the OpenSSL libraries and include files. You can set the OPENSSL_ROOT_DIR
environment variable to the root folder of your OpenSSL installation. For example:
(export OPENSSL_ROOT_DIR=/path/to/your/openssl)