Create New BucketFS Service

This section explains how to create a new BucketFS service.

Each configured data disk in Exasol has a preinstalled default BucketFS service. The default BucketFS service includes a default bucket that contains preinstalled script languages (Java, Python, R). You can create and configure 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.

Prerequisites

There are no prerequisites for this procedure.

Procedure

This procedure is carried out using ConfD.

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.

Placeholder values are indicated with UPPERCASE characters. Replace the placeholders with your own values.

  1. Connect to EXAClusterOS (COS) using c4 connect -t <DEPLOYMENT>[.<NODE>]/cos. For example:

    c4 connect -t 1/cos

    In most cases it does not matter on which node you access ConfD. If you do not specify a node, c4 will connect to the first active node in the deployment. If the cluster is configured with an access node, the first node is the access node (usually n10). The command prompt in COS indicates which node you are connected to: 

    [root@n10 ~]#

    For more information about how to use c4 connect, see How to use c4.

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

    Parameter name Data type Description
    bucketfs_name string BucketFS service name
    http_port string, integer

    The HTTP port of the bucketFS service.

    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).

    For example:

    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. For example:

confd_client bucketfs_list
- bfsdefault
- mybucketfs

Next steps

When the BucketFS service has been created, you can add buckets to store files or data. For more information, see Create New Bucket.