Create new BucketFS service

Learn how to create a new BucketFS service.

Each configured data disk in Exasol has a preinstalled default BucketFS service named bfsdefault.

The default BucketFS service includes a bucket named default, which contains preinstalled script languages (Java, Python, and R). You can add any number of buckets within the default BucketFS service.

If you want to make files available on different ports, or if you want to store larger files in BucketFS, we recommend that you create a new BucketFS service instead of using the default service. This article shows how to create a new BucketFS service using ConfD.

Prerequisites

A self-managed Exasol deployment (as-application or AWS native)

Procedure

The following examples use ConfD through the command-line tool confd_client, which is available on all database nodes. You can also access ConfD through XML-RPC in your own Python programs. For more information, see ConfD.

  1. Use c4 ps to find the play ID of the Exasol deployment.

    Example:
    Copy 
    ./c4 ps
          N  PLAY_ID   NODE  MEDIUM  INSTANCE     DB_VERSION  EXTERNAL_IP     INTERNAL_IP  STAGE  STATE    UPTIME    TTL
      ┌─  1  c3275f84  11    host    -            2025.1.0    203.0.113.11    10.0.0.11    d      -        03:50:12  +∞
      │   1  c3275f84  12    host    -            2025.1.0    203.0.113.12    10.0.0.12    d      -        03:50:13  +∞
      │   1  c3275f84  13    host    -            2025.1.0    203.0.113.13    10.0.0.13    d      -        03:50:13  +∞
      └─  1  c3275f84  14    host    -            2025.1.0    203.0.113.14    10.0.0.14    d      -        03:50:13  +∞

  2. Connect to the cluster operating system (COS) using c4 connect -i PLAY_ID -s cos.

    Example:
    Copy 
    ./c4 connect -i c3275f84 -s cos

  3. To create a BucketFS service, use the ConfD job bucketfs_add with the following parameters:

    Parameter name Data type Description
    bucketfs_name string The name of the new BucketFS service.
    http_port string, integer

    The HTTP port that the BucketFS service should be accessible on.

    To disable HTTP, enter 0.

    This parameter is ignored If the value for https_port is anything else than 0.

    https_port string, integer

    The HTTPS port for the BucketFS service.

    To disable HTTPS, enter 0.
    owner tuple, list The database owner as an integer tuple (user id, group id) or list (user name, user group name).
    Example:
    Copy 
    confd_client bucketfs_add bucketfs_name: mybucketfs http_port: 0 https_port: 2582 owner: [500,500]

Verification

To verify that the BucketFS service was created, use the ConfD job bucketfs_list.

Example:
Copy 
confd_client bucketfs_list
- bfsdefault
- mybucketfs

Next steps

When the BucketFS service has been created, you can add buckets to store files or data. To learn more, see Create new bucket.