Configuration of XL Ingest

You can configure XL Ingest through the Web console. To access the console, enter the following URL in Chrome: http://localhost:8084.

The screen displays the following tabs:

Dashboard

Navigate to the Dashboard tab. The dashboard provides a summary of the data being managed and the work completed in the last 24 hours. It includes a pie chart showing task statuses and a bar chart indicating the amount of data transferred over the last 30 days.

Configuration

Navigate to the Configuration tab. Configure the source and destination database in Ingest. Navigate to http://localhost:8084. Although the setup is automatic, you must follow certain steps to transfer a large table to the desired destination. Set up XL Ingest by entering the following configuration details.

Location of CDC Installation

Enter the path for Ingest.

Web Port

Enter the port of XL Ingest (8084)

No. of source threads

Enter the number of source threads.

No. of destination threads

Enter the number of destination threads.

Product Id

By default, the product ID is the field.

Licence Key

Enter the license key.

Expiry

Displays the expiration date of your license.

Delete on Sync

Enable or disable as per your requirements.

Select Save to save the settings.

Table Setup

Table setup allows you to configure the tables.

  1. Navigate to the Table Setup tab.

  2. Select the tables from the list on the left to be processed in XL Ingest.

  3. In the Table Settings page, choose the slicing column (typically the primary key). For partitioned tables, slicing is automatically handled by XL Ingest.

  4. Select the Auto-slice button to automatically generate slices for large tables. Select the Schedule Count button to retrieve the number of records in the table, then enter the following auto-slice parameters:

    1. No. of Slices: Number of slices to split the table into.

    2. Round-off: Number of trailing significant digits to ignore when estimating the slice size. Simplifies the calculation by focusing only on the most significant digits of the total record count.

  5. The Schedule Slice button is enabled only after the count is determined.

Table Status

After selecting and configuring the tables, the tables appear in the Table Status page.

  1. Navigate to the Table Status tab.

    It displays the status of each table and a bar graph indicating the amount of data transferred.

  2. Select a table to view its slicing status and progress.

Table Slicing Status

The Table Slicing Status page displays the list of all slices or partitions of the table.

  1. The following are the buttons for each slice to schedule:

    1. Compare: Schedules a comparison of the slice between the source and destination database.

    2. Force Compare: If compared earlier, forces a comparison of the slice between the source and destination databases.

    3. Sync. Schedules the transfer of data between source and destination databases.

    4. Force Sync: If the data has been synced previously, forces the transfer of the data between the source and destination databases.

  2. The color of each button indicates the state of the respective task as follows:

    1. Dark blue: Task can be scheduled and is recommended.

    2. Light blue: Task can be scheduled but no urgent action is required.

    3. Red: Task is scheduled and can be canceled before it runs, as required.

    4. Grey: Task is in progress.

Schedule Tasks

XL Ingest tasks are long-running and cannot be executed immediately. They must be scheduled, and the progress is available after execution. Perform the following tasks:

  1. Select Schedule Compare for the slice to start the slice comparison between the source and destination databases.

  2. Select Schedule Sync for the slice to start the synchronization of data between the source and destination databases.

  3. View the status of scheduled tasks in the Task Status page.

Task Status

The Task Status page displays the list of the tasks in the last 24 hours.

  1. Navigate to the Task Status tab.

  2. Tasks are categorized as follows:

    1. Completed

    2. Scheduled

    3. Running

    4. Failed

  3. Tasks can be filtered and monitored for progress. You can cancel scheduled tasks before they start, as required.

Last modified: January 24, 2025

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK