This is an automated email from the ASF dual-hosted git repository.
lidavidm pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/arrow-adbc.git
The following commit(s) were added to refs/heads/main by this push:
new db0b9c11 docs: add APT/Yum repositories to installation pages (#992)
db0b9c11 is described below
commit db0b9c111ed8721db512ff2ac493b3f050610284
Author: Sutou Kouhei <[email protected]>
AuthorDate: Sun Aug 27 10:07:44 2023 +0900
docs: add APT/Yum repositories to installation pages (#992)
Fixes #991.
---
docs/source/cpp/driver_manager.rst | 64 ++++++++++++++++++++++++++++++++++++-
docs/source/driver/installation.rst | 64 +++++++++++++++++++++++++++++++++++--
2 files changed, 125 insertions(+), 3 deletions(-)
diff --git a/docs/source/cpp/driver_manager.rst
b/docs/source/cpp/driver_manager.rst
index 120e5dd5..d8db791d 100644
--- a/docs/source/cpp/driver_manager.rst
+++ b/docs/source/cpp/driver_manager.rst
@@ -27,7 +27,69 @@ specific driver.
Installation
============
-TODO
+Install the appropriate driver package. You can use conda-forge_, ``apt`` or
``dnf``.
+
+conda-forge:
+
+- ``mamba install adbc-driver-manager``
+
+You can use ``apt`` on the following platforms:
+
+- Debian GNU/Linux bookworm
+- Ubuntu 22.04
+
+Prepare the Apache Arrow APT repository:
+
+.. code-block:: bash
+
+ sudo apt update
+ sudo apt install -y -V ca-certificates lsb-release wget
+ sudo wget https://apache.jfrog.io/artifactory/arrow/$(lsb_release --id
--short | tr 'A-Z' 'a-z')/apache-arrow-apt-source-latest-$(lsb_release
--codename --short).deb
+ sudo apt install -y -V ./apache-arrow-apt-source-latest-$(lsb_release
--codename --short).deb
+ rm ./apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
+ sudo apt update
+
+Install:
+
+- ``sudo apt install libadbc-driver-manager-dev``
+
+You can use ``dnf`` on the following platforms:
+
+- AlmaLinux 8
+- Oracle Linux 8
+- Red Hat Enterprise Linux 8
+- AlmaLinux 9
+- Oracle Linux 9
+- Red Hat Enterprise Linux 9
+
+Prepare the Apache Arrow Yum repository:
+
+.. code-block:: bash
+
+ sudo dnf install -y epel-release || sudo dnf install -y
oracle-epel-release-el$(cut -d: -f5 /etc/system-release-cpe | cut -d. -f1) ||
sudo dnf install -y
https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1).noarch.rpm
+ sudo dnf install -y
https://apache.jfrog.io/artifactory/arrow/almalinux/$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1)/apache-arrow-release-latest.rpm
+ sudo dnf config-manager --set-enabled epel || :
+ sudo dnf config-manager --set-enabled powertools || :
+ sudo dnf config-manager --set-enabled crb || :
+ sudo dnf config-manager --set-enabled ol$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1)_codeready_builder || :
+ sudo dnf config-manager --set-enabled codeready-builder-for-rhel-$(cut -d:
-f5 /etc/system-release-cpe | cut -d. -f1)-rhui-rpms || :
+ sudo subscription-manager repos --enable codeready-builder-for-rhel-$(cut
-d: -f5 /etc/system-release-cpe | cut -d. -f1)-$(arch)-rpms || :
+
+Install:
+
+- ``sudo dnf install adbc-driver-manager-devel``
+
+Then they can be used via CMake, e.g.:
+
+.. code-block:: cmake
+
+ find_package(AdbcDriverPostgreSQL)
+
+ # ...
+
+ target_link_libraries(myapp PRIVATE
AdbcDriverPostgreSQL::adbc_driver_postgresql_shared)
+
+.. _conda-forge: https://conda-forge.org/
Usage
=====
diff --git a/docs/source/driver/installation.rst
b/docs/source/driver/installation.rst
index ffd3a8c9..75407477 100644
--- a/docs/source/driver/installation.rst
+++ b/docs/source/driver/installation.rst
@@ -26,12 +26,66 @@ Installation
C/C++
=====
-Install the appropriate driver package. These are currently only available
from conda-forge_:
+Install the appropriate driver package. You can use conda-forge_, ``apt`` or
``dnf``.
+
+conda-forge:
- ``mamba install libadbc-driver-flightsql``
- ``mamba install libadbc-driver-postgresql``
- ``mamba install libadbc-driver-sqlite``
+You can use ``apt`` on the following platforms:
+
+- Debian GNU/Linux bookworm
+- Ubuntu 22.04
+
+Prepare the Apache Arrow APT repository:
+
+.. code-block:: bash
+
+ sudo apt update
+ sudo apt install -y -V ca-certificates lsb-release wget
+ sudo wget https://apache.jfrog.io/artifactory/arrow/$(lsb_release --id
--short | tr 'A-Z' 'a-z')/apache-arrow-apt-source-latest-$(lsb_release
--codename --short).deb
+ sudo apt install -y -V ./apache-arrow-apt-source-latest-$(lsb_release
--codename --short).deb
+ rm ./apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
+ sudo apt update
+
+Install:
+
+- ``sudo apt install libadbc-driver-flightsql-dev``
+- ``sudo apt install libadbc-driver-postgresql-dev``
+- ``sudo apt install libadbc-driver-sqlite-dev``
+- ``sudo apt install libadbc-driver-snowflake-dev``
+
+You can use ``dnf`` on the following platforms:
+
+- AlmaLinux 8
+- Oracle Linux 8
+- Red Hat Enterprise Linux 8
+- AlmaLinux 9
+- Oracle Linux 9
+- Red Hat Enterprise Linux 9
+
+Prepare the Apache Arrow Yum repository:
+
+.. code-block:: bash
+
+ sudo dnf install -y epel-release || sudo dnf install -y
oracle-epel-release-el$(cut -d: -f5 /etc/system-release-cpe | cut -d. -f1) ||
sudo dnf install -y
https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1).noarch.rpm
+ sudo dnf install -y
https://apache.jfrog.io/artifactory/arrow/almalinux/$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1)/apache-arrow-release-latest.rpm
+ sudo dnf config-manager --set-enabled epel || :
+ sudo dnf config-manager --set-enabled powertools || :
+ sudo dnf config-manager --set-enabled crb || :
+ sudo dnf config-manager --set-enabled ol$(cut -d: -f5
/etc/system-release-cpe | cut -d. -f1)_codeready_builder || :
+ sudo dnf config-manager --set-enabled codeready-builder-for-rhel-$(cut -d:
-f5 /etc/system-release-cpe | cut -d. -f1)-rhui-rpms || :
+ sudo subscription-manager repos --enable codeready-builder-for-rhel-$(cut
-d: -f5 /etc/system-release-cpe | cut -d. -f1)-$(arch)-rpms || :
+
+Install:
+
+- ``sudo dnf install adbc-driver-flightsql-devel``
+- ``sudo dnf install adbc-driver-postgresql-devel``
+- ``sudo dnf install adbc-driver-sqlite-devel``
+- ``sudo dnf install adbc-driver-snowflake-devel``
+
Then they can be used via CMake, e.g.:
.. code-block:: cmake
@@ -80,7 +134,7 @@ From conda-forge_:
- ``mamba install adbc-driver-sqlite``
R
-======
+=
Install the appropriate driver package from GitHub:
@@ -94,3 +148,9 @@ Install the appropriate driver package from GitHub:
Installation of stable releases from CRAN is anticipated following the
release of ADBC Libraries 0.6.0.
+
+Ruby
+====
+
+Install the appropriate driver package for C/C++. You can use it from
+Ruby.
