H2O AI Cloud (HAIC) workspace integration

Overview

H2O AI Cloud (HAIC) workspace integration connects Driverless AI to HAIC workspaces. Each HAIC workspace appears as a project in Driverless AI.

Note

Starting in Driverless AI 2.3.0, projects can integrate with the H2O AI Cloud workspace architecture.

Key terms

Workspace

Resource container in H2O AI Cloud that manages permissions, storage, and compute resources. For details, see the H2O AI Cloud documentation.

Project

The Driverless AI representation of a workspace. One workspace equals one project.

Deployment modes

Driverless AI can operate in three different modes:

Feature

Standalone Driverless AI

HAIC single-project

HAIC multi-project

Integration mode

No HAIC integration

Connected to a single workspace enable_multi_projects = false

Connected to multiple workspaces enable_multi_projects = true

Project storage

Local file system

H2O Storage (remote)

H2O Storage (remote)

Default projects

Multiple (local)

Single (current workspace)

Multiple (all accessible workspaces)

Create projects

Yes

No

Yes. Creates workspaces in HAIC

Delete projects

Yes

No. Use HAIC Workspace Management (DAI 2.3.0+)

No. Use HAIC Workspace Management (DAI 2.3.0+)

Share projects

No. Local only

No. Sharing managed through HAIC workspace permissions

No. Sharing managed through HAIC workspace permissions

Switch projects

Yes

No. Single workspace only

Yes

Prerequisites

Before you begin, make sure you have:

  • Driverless AI version 2.3.0 or later

  • Administrator access to modify the Driverless AI configuration

  • Information from HAIC about your:

    • Workspace server endpoint

    • Engine name containing your workspace ID

    • Authorization server endpoint

    • Storage backend address

Configuration

Standalone mode

For standalone deployments without HAIC integration:

  • Projects are stored on the local file system.

  • You can create and delete projects locally.

  • Multiple projects are available by default.

  • No additional configuration is required for basic project functionality.

Workspace integration configuration

Required settings

For HAIC deployments, AI Engine Manager (AIEM) automatically manages these settings in DAI profiles that require workspace integration:

Workspace server connection:

  • h2o_workspace_server_endpoint: Connects DAI to the workspace server

  • Automatically set by AIEM during deployment

Engine resource identifier:

  • haic_engine_name: Identifies the DAI engine within your workspace

  • Format: //engine-manager/workspaces/<workspace-id>/daiEngines/<engine-name>

  • Automatically configured based on your workspace context

Note

These values do not require manual configuration. All AIEM profiles that enable workspace access include these settings.

Optional settings (authentication and storage)

For HAIC deployments, the following settings are automatically managed by AIEM in the default DAI profile:

Authorization configuration:

  • h2o_authz_policy_server_endpoint: Connects DAI to the HAIC authorization service

  • Automatically configured during deployment

Storage configuration:

  • h2o_storage_address: Connects DAI to H2O Storage backend

  • Automatically configured to use workspace-specific storage locations

Note

These values are managed automatically and should not be manually configured for HAIC deployments.

Project mode configuration

# Single-project mode (default)
enable_multi_projects = false

# Multi-project mode
# enable_multi_projects = true

Single-project mode shows only the current workspace. Multi-project mode lets you switch between multiple workspaces.

Note

Users can configure enable_multi_projects themselves. However, if this setting is configured in the DAI profile’s DAI Configuration Override, the setting will override the user’s configuration.

Note

As of Driverless AI 2.3.0, when operating with workspace integration enabled, certain project management operations are intentionally restricted:

  • Deleting projects: Not supported in the Driverless AI UI. Use the HAIC Workspace Management interface instead.

  • Sharing projects: Not supported via the Driverless AI sharing mechanism. Use HAIC workspace permissions and access controls.

These restrictions ensure consistent project and permission management across the HAIC platform.

Verify your configuration

After you update the configuration and restart Driverless AI, verify the integration:

  • In single-project mode, the UI shows only the current workspace project. In multi-project mode, you can switch between accessible workspaces.

  • Project deletion and sharing are disabled in the Driverless AI UI when workspace integration is enabled.

  • In the Driverless AI logs, confirm successful connections to the workspace server, authorization server, and storage backend.

Version-specific features and limitations

Driverless AI 2.3.0 changes

Starting with Driverless AI 2.3.0, the following changes apply to workspace integration:

HAIC mode (workspace integration enabled):

  • Project deletion is disabled in the Driverless AI interface.

  • Project sharing is disabled in the Driverless AI interface.

  • Use the HAIC Workspace Management interface for these operations.

  • This ensures centralized workspace and permission management.

Standalone mode (no HAIC integration):

  • Multi-project support remains enabled by default.

  • Local project deletion is supported.

  • Sharing isn’t available (projects are local only).

Tip

To delete or share projects when using HAIC integration, use the H2O AI Cloud Workspace Management interface from your HAIC dashboard.