Installation on DBFS (Legacy)

This article explains how Xonai can be installed on DBFS and activated on a cluster via an init script.

Warning

Installing Xonai JARs on a Unity Catalog volume is recommended in order to facilite sharing the solution across the organization. See Installation on Unity Catalog.

Create an Init Script

To create an init script that install Xonai Accelerator JAR in a Compute cluster:

  1. Navigate to Workspace > Home from the left navigation panel.

  2. Click Create > File at the top right corner.

  3. Enter the file name xonai-init.sh.

  4. Copy the following content and change the placeholders as described after:

    1
    2
    %sh
    cp /dbfs/xonai/xonai-spark-plugin-dbx-<release>-<version>-stable-linux-<arch>.jar /databricks/jars/
    
  5. Change <runtime>, <release> and <arch> placeholders with:

    1. The Databricks runtime version you are using (e.g. 14.3).

    2. The Xonai JAR release version you want to use.

    3. The Worker processor architecture: amd64 for Intel/AMD or arm64 for Graviton/ARM.

Info

You may want to create multiple configuration scripts with distinct names if you are using multiple Databricks runtime versions and processor architectures in your workspace.

For more information about cluster-scoped init scripts, please refer to the Databricks script documentation.

Next Steps

Please refer to our activation guides to learn how to activate the Xonai Accelerator for the different types of Databricks compute with the init script created in this page.