From 170b3d463eb0bbe93515624b23a4d9505efc3704 Mon Sep 17 00:00:00 2001 From: Dipesh Dhameliya Date: Tue, 13 Jun 2023 13:59:11 +0530 Subject: [PATCH 1/2] Add instructions to build Babelfish with kerberos authentication enabled --- contrib/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/contrib/README.md b/contrib/README.md index 4f93d9d478..6d78a5c723 100644 --- a/contrib/README.md +++ b/contrib/README.md @@ -235,3 +235,11 @@ For detailed instructions on how to write, add, and run tests in JDBC test frame babelfish_db=> CREATE EXTENSION tds_fdw; CREATE EXTENSION ``` + + +# How to build the Babelfish server with Kerberos authentication enabled + +Please note that Kerberos authentication feature is available on Babelfish server with version 3.1.0 or higher. + +1. To build the Babelfish server with Kerberos authentication enabled, you will need to install `build-essential` and `libkrb5-dev` packages. +2. Build the Babelfish server according to the instructions mentioned [here](https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_3_X_DEV/contrib/README.md) and use --with-gssapi flag to configure Babelfish in order to enable the GSSAPI APIs. From 91b633f8d520121b63f0777bc0a66e800d916d90 Mon Sep 17 00:00:00 2001 From: Dipesh Dhameliya Date: Wed, 14 Jun 2023 13:26:08 +0530 Subject: [PATCH 2/2] Update installing intruction template --- INSTALLING.md.tmpl | 3 +++ contrib/README.md | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/INSTALLING.md.tmpl b/INSTALLING.md.tmpl index 24201b85e4..d7d7272820 100644 --- a/INSTALLING.md.tmpl +++ b/INSTALLING.md.tmpl @@ -35,6 +35,8 @@ sudo apt-get update && sudo apt install -y --no-install-recommends \ gnupg unixodbc-dev net-tools unzip ``` +If you would like to work with Kerberos authentication then additional dependency is required on `libkrb5-dev` package. + Many of the Babelfish prerequisites are part of a typical Linux distribution. You may find that the packages on your distribution use a similar (but not identical) name. To build Babelfish, you will need access to a user with root privileges, so you can convey privileges with `sudo`. You'll also need a non-root user to initialize the database; PostgreSQL does not allow a root user to own the `data` directory or start the server. @@ -108,6 +110,7 @@ make DESTDIR=${BABELFISH_HOME}/ -j $JOBS 2>error.txt sudo make install ``` +> NOTE: To build Babelfish with Kerberos authentication support, use the option `--with-gssapi` during configuration. > WARNING: Using the --with-extra-version option during the configuration phase can break the sys.get_host_os() output; we do not recommend including it. diff --git a/contrib/README.md b/contrib/README.md index 6d78a5c723..26f824b184 100644 --- a/contrib/README.md +++ b/contrib/README.md @@ -242,4 +242,4 @@ For detailed instructions on how to write, add, and run tests in JDBC test frame Please note that Kerberos authentication feature is available on Babelfish server with version 3.1.0 or higher. 1. To build the Babelfish server with Kerberos authentication enabled, you will need to install `build-essential` and `libkrb5-dev` packages. -2. Build the Babelfish server according to the instructions mentioned [here](https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_3_X_DEV/contrib/README.md) and use --with-gssapi flag to configure Babelfish in order to enable the GSSAPI APIs. +2. Build the Babelfish server according to the instructions mentioned [here](https://github.com/babelfish-for-postgresql/babelfish_extensions/blob/BABEL_3_X_DEV/contrib/README.md#build-the-postgres-engine) and use --with-gssapi flag to configure Babelfish in order to enable the GSSAPI APIs.