domino logo
Latest (5.5)
  • About Domino
  • Architecture
  • Security and Compliance
  • Domino Infrastructure
  • Kubernetes Infrastructure
  • Installation
  • Data Planes
  • Execution Resources
  • Users
  • Keycloak Authentication Service
  • Data
  • Projects
  • Environments
  • Model Monitoring
  • Control Center
  • Logs and Monitoring
  • Backup and Restore
  • Disaster Recovery
  • Configuration Reference
  • Run the Admin Toolkit
  • MongoDB Console
  • Get Help
domino logo
About Domino
Domino Data LabKnowledge BaseData Science BlogTraining
Admin Guide
>
Installation
>
Install with Token and Fleetcommand CLI

Install with Token and Fleetcommand CLI

Note

Use the Fleetcommand CLI to install Domino if you have an installation token from your Solutions Architect.

Installation with the Fleetcommand CLI is similar to the steps in the Installation Overview. However, you don’t need quay.io credentials, and you don’t need to install fleetcommand-agent, Helm, or Docker. Instead, to authenticate, you use an installation token from your Solutions Architect. To issue installation commands, use the Fleetcommand CLI. To learn more about the telemetry being sent back to Domino, see Deployments Telemetry.

Prerequisites

To follow these instructions, you must have:

  1. Fleetcommand CLI installed. You can download the binary from the following links:

    • Linux version.

    • Mac version.

    • Windows version.

  2. An installation token from your Domino Solutions Architect.

You must install Domino from a workstation with the following:

  1. Access to the Kubernetes API.

    If you have kubectl installed, kubectl access to the cluster where you’ll deploy Domino.

  2. Acess to quay.io (you don’t need credentials).

  3. Access to Docker images for Domino components.

  4. Access to Helm charts.

  5. Access to Fleetcommand, hosted at update.domino.tech.

Installation process

Important
  1. Connect to a workstation that meets the installation requirements listed previously. You don’t have to use an account with root privileges to run the installer.

  2. To generate a template configuration file named domino.yml, initialize the installer:

    fctl init --version <domino-version-number>
  3. Edit the configuration file with details about the target cluster, storage systems, and host domain. See the configuration reference for more information about available keys.

    Update name from domino-deployment to something that identifies the purpose of your installation and contains the name of your organization.

  4. If you have custom install requirements, perform a dry installation run before you complete installation. A dry run outputs the full configuration without altering the cluster.

  5. To install Domino, run the following code from the same directory as the configuration file.

    fctl install --token <installation-token>
  6. Installation can take up to 30 minutes to complete. The installer will output verbose logs and surface errors.

    Upon successful installation, the terminal outputs the following:

    <timestamp> INFO - fleetcommand_agent.Application - Deployment complete.
    Domino is accessible at $YOUR_FQDN

You can access the application through HTTPS if you configure DNS for your fully-qualified domain name (FQDN) to point to an Ingress load balancer with the appropriate SSL certificates. The load balancer forwards traffic to your platform nodes.

Enable user registration

Use Keycloak to enable user registration, so users can access your fresh Domino install. Keycloak is a user authentication service that runs on a pod in your cluster.

Domino Data LabKnowledge BaseData Science BlogTraining
Copyright © 2022 Domino Data Lab. All rights reserved.