Linux TAR SH

The Driverless AI software is available for use in pure user-mode environments as a self-extracting TAR SH archive. This form of installation does not require a privileged user to install or to run.

This artifact has the same compatibility matrix as the RPM and DEB packages (combined), it just comes packaged slightly differently. See those sections for a full list of supported environments.

The installation steps assume that you have a license key for Driverless AI. For information on how to obtain a license key for Driverless AI, visit https://www.h2o.ai/products/h2o-driverless-ai/. Once obtained, you will be prompted to paste the license key into the Driverless AI UI when you first log in.

Requirements

  • RedHat 7 or Ubuntu 16.04
  • CUDA 10 or later with NVIDIA drivers >= 410 (GPU only)
  • cuDNN >= 7.4.1 (Required only if using TensorFlow.)
  • OpenCL (Required for LightGBM support on GPUs.)
  • Driverless AI TAR SH, available from https://www.h2o.ai/download/

Installing Driverless AI

Run the following commands to install the Driverless AI RPM. Replace VERSION with your specific version.

# Install Driverless AI.
chmod 755 dai-VERSION.sh
./dai-VERSION.sh

You may now cd to the unpacked directory and optionally make changes to config.toml.

Starting Driverless AI

# Start Driverless AI.
./run-dai.sh

Starting NVIDIA Persistence Mode

If you have NVIDIA GPUs, you must run the following two NVIDIA commands. These commands need to be run every reboot. For more information: http://docs.nvidia.com/deploy/driver-persistence/index.html.

sudo nvidia-persistenced --user dai --persistence-mode

Install OpenCL

OpenCL is required in order to run LightGBM on GPUs. Run the following for Centos7/RH7 based systems using yum and x86.

yum -y clean all
yum -y makecache
yum -y update
wget http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/c/clinfo-2.1.17.02.09-1.el7.x86_64.rpm
wget http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/o/ocl-icd-2.2.12-1.el7.x86_64.rpm
rpm -if clinfo-2.1.17.02.09-1.el7.x86_64.rpm
rpm -if ocl-icd-2.2.12-1.el7.x86_64.rpm
clinfo

mkdir -p /etc/OpenCL/vendors && \
    echo "libnvidia-opencl.so.1" > /etc/OpenCL/vendors/nvidia.icd

Looking at Driverless AI log files

less log/dai.log
less log/h2o.log
less log/procsy.log
less log/vis-server.log

Stopping Driverless AI

# Stop Driverless AI.
./kill-dai.sh

Uninstalling Driverless AI

To uninstall Driverless AI, just remove the directory created by the unpacking process. By default, all files for Driverless AI are contained within this directory.

Upgrading Driverless AI

WARNINGS:

  • This release deprecates experiments and MLI models from 1.7.0 and earlier.
  • Experiments, MLIs, and MOJOs reside in the Driverless AI tmp directory and are not automatically upgraded when Driverless AI is upgraded. We recommend you take the following steps before upgrading.
    • Build MLI models before upgrading.
    • Build MOJO pipelines before upgrading.
    • Stop Driverless AI and make a backup of your Driverless AI tmp directory before upgrading.

If you did not build MLI on a model before upgrading Driverless AI, then you will not be able to view MLI on that model after upgrading. Before upgrading, be sure to run MLI jobs on models that you want to continue to interpret in future releases. If that MLI job appears in the list of Interpreted Models in your current version, then it will be retained after upgrading.

If you did not build a MOJO pipeline on a model before upgrading Driverless AI, then you will not be able to build a MOJO pipeline on that model after upgrading. Before upgrading, be sure to build MOJO pipelines on all desired models and then back up your Driverless AI tmp directory.

The upgrade process inherits the service user and group from /etc/dai/User.conf and /etc/dai/Group.conf. You do not need to manually specify the DAI_USER or DAI_GROUP environment variables during an upgrade.

Requirements

As of 1.7.0, CUDA 9 is no longer supported. Your host environment must have CUDA 10.0 or later with NVIDIA drivers >= 410 installed (GPU only). Driverless AI ships with its own CUDA libraries, but the driver must exist in the host environment. Go to https://www.nvidia.com/Download/index.aspx to get the latest NVIDIA Tesla V/P/K series driver.

Upgrade Steps

  1. Stop your previous version of Driverless AI.
  2. Run the self-extracting archive for the new version of Driverless AI.
  3. Port any previous changes you made to your config.toml file to the newly unpacked directory.
  4. Copy the tmp directory (which contains all the Driverless AI working state) from your previous Driverless AI installation into the newly upacked directory.
  5. Start your newly extracted version of Driverless AI.