BucketFS Setup

Learn how to set up BucketFS in Exasol.

BucketFS is a synchronous file system that stores data in buckets. When you install Exasol, a default BucketFS file system that contains pre-installed script languages (Java, Python, and R) is created. You can use this to quickly test how to use BucketFS using a sample bucket.

Creating new buckets to store data includes the following steps:

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 default bucket that contains preinstalled script languages (Java, Python, and 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.

To create a new BucketFS service, follow these steps:

  1. In EXAoperation, go to Services > EXABuckets. The EXABucketFS Services screen is displayed.

    2. The following table provides you with the description for each of the fields in the EXABucketFS Services screen: 

    Column Field Description
    ID Displays the ID of the bucket.
    Disk Displays the disk on which this bucket is located.
    HTTP

    Displays the port number, if configured.

    The default port for BucketFS service is 2580.
    HTTPS Displays the port number, if configured.
    Size per node Displays the overall size of the bucket across all nodes.
    Description Displays the description added for the bucket.

  2. Click Add to add a new BucketFS service.
  3. The Add EXABucketFS Service screen is displayed. Enter the following details: 
    • Data Disk: Select the data disk where you would like to store data of the bucket.
    • HTTP Port: The HTTP port number.
    • HTTPS Port: The HTTPS port number.
    • Description: Enter a description for the bucket.

  4. Click Add to add the BucketFS service.

You can view the created BucketFS service listed in the EXABucketFS Services screen. Some of the other operations you can perform on a BucketFS include editing it by selecting the radio button next to the BucketFS and then clicking the Edit button or delete a BucketFS by clicking the Delete button.

You can also create and configure any number buckets within a BucketFS Service. Follow these steps to create new buckets within a BucketFS Service.

  1. In EXAoperation, go to Services > EXABuckets.
  2. Click the BucketFS Service link where you would to create buckets. The EXABucketFS Service Buckets screen is displayed.

  3. Click Add to add new buckets.
  4. In the Add EXABucketFS Bucket screen, enter the following details: 
    • Name: Enter a name for the bucket.
    • Public readable: Select this checkbox if you like this bucket to be public accessible.
    • Read password: Enter the password to read this bucket.
    • Write password: Enter the password to write to this bucket.
    • Description: Enter a description for this bucket.

  5. Click Add. The new add bucket is listed in the EXABucketFS Service Buckets screen.

    6. The EXABucketFS Service Buckets screen provides you with an overview of all the buckets with the following information: 

    Column Description
    ID Displays the ID of the bucket.
    Name Displays the name of the bucket.
    Public Displays True if this bucket is public read. Else False is displayed.
    UDF path Displays the UDF path for the bucket. You need to use this path in order to access the data within the bucket via UDFs.
    Size Displays the overall size of the bucket.
    Description Displays the description added for the bucket.

Other Operations on Bucket

Some of the other operations you can perform on a bucket include

Edit Bucket

You can edit a bucket by select the desired bucket and clicking the Edit option in the EXABucketFS Service Buckets screen. The following Edit BucketFS Bucket screen is displayed.

Once you have made the changes to the bucket, click Apply to save the changes. Click Cancel to discard the changes.

Delete Bucket

You can edit a bucket by clicking the Delete option in the EXABucketFS Service Buckets screen. When you click the Delete option, you will be promoted to confirm the delete option.

Grant Permission

The Grant option in the EXABucketFS Service Buckets screen allows you to change or grant the logged in user with a different role.

Select the desired role you would like to assign to the user and click Apply to save the changes. Click Cancel to discard the changes.

Next Steps

For information on how to access buckets in Exasol and how to perform other operations such as adding or deleting files in the bucket, see Access Control.