Installation Process

Docker images for Domino components

Helm charts

Log in to quay.io with the credentials described in the requirements previous section.

docker login quay.io

Find the image URI for the version of the fleetcommand-agent you want to use from the release notes.

Pull the image to your local machine.

docker pull quay.io/domino/fleetcommand-agent:v32

Connect to a workstation that meets the installation automation requirements listed previously. You do not have to use an account with root privileges to run the installer.

Log in to quay.io with the credentials described in the previous requirements section.

docker login quay.io

Retrieve the Domino installer image from quay.io.

docker pull quay.io/domino/fleetcommand-agent:v32

Initialize the installer application to generate a template configuration file named domino.yml.

docker run --rm -it -v $(pwd):/install quay.io/domino/fleetcommand-agent:v32 \
init --file /install/domino.yml

Edit the configuration file with the details about the target cluster, storage systems, and hosting domain. Read the configuration reference for more information about available keys, and consult the configuration examples for guidance about getting started.

Run this install script from the directory with the finalized configuration file to install Domino into the cluster. Fill in your $QUAY_USERNAME and $QUAY_PASSWORD where indicated, and also this script assumes your installer configuration file is in the same directory, and is named exactly domino.yml.

#!/bin/bash

set -ex

kubectl delete po --ignore-not-found=true fleetcommand-agent-install

kubectl create secret \
  docker-registry \
  -o yaml --dry-run \
  --docker-server=quay.io \
  --docker-username=$QUAY_USERNAME \
  --docker-password=$QUAY_PASSWORD \
  --docker-email=. domino-quay-repos | kubectl apply -f -

kubectl create configmap \
  fleetcommand-agent-config \
  -o yaml --dry-run \
  --from-file=domino.yml | kubectl apply -f -

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-default
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: admin
  namespace: default
---
apiVersion: v1
kind: Pod
metadata:
  name: fleetcommand-agent-install
spec:
  serviceAccountName: admin
  imagePullSecrets:
    - name: domino-quay-repos
  restartPolicy: Never
  containers:
  - name: fleetcommand-agent
    image: quay.io/domino/fleetcommand-agent:v32
    args: ["run", "-f", "/app/install/domino.yml", "-v"]
    imagePullPolicy: Always
    volumeMounts:
    - name: install-config
      mountPath: /app/install/
  volumes:
  - name: install-config
    configMap:
      name: fleetcommand-agent-config
EOF

set +e
while true; do
  sleep 5
  if kubectl logs -f fleetcommand-agent-install; then
    break
  fi
done

The installation process can take up to 30 minutes to fully complete. The installer will output verbose logs and surface any errors it encounters, but it can also be useful to follow along in another terminal tab by running:

kubectl get pods --all-namespaces

kubectl logs $POD_NAME --namespace $NAMESPACE_NAME

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

Retrieve the new Domino installer image from quay.io by filling in the version value in the following command.

docker pull quay.io/domino/fleetcommand-agent:v32

Create a copy of your existing domino.yml configuration file. Name it something like domino-orig-<date>.yaml, indicating it is the version of the configuration before modifications were made on a specific date.

Generate a new domino.yml configuration template by running the initialization command through the new version of the installer. This will ensure you have a configuration schema that conforms to the new version.

docker run --rm -it -v $(pwd):/install quay.io/domino/fleetcommand-agent:v32 \
  init --file /install/domino.yml

Copy custom values from your original configuration into the new file.

When complete, run the install script from the install process and change the spec.containers.image value to `quay.io/domino/fleetcommand-agent:v32 (with the appropriate version).

Sign in to Keycloak on your Domino instance.

In the Keycloak sidebar menu, select Realm Settings.

Select the Login tab, and toggle User registration to On.

Click Save to confirm your changes.