Skip to content

Install Domino REST API

Important

This is only applicable when you install Volt MX Go to a development or test only environment.

The procedure guides you in downloading the Domino REST API Helm chart and deploying Domino REST API.

1. Download the Domino REST API Helm chart

  1. Run the following command to make sure that the chart information for the repositories is up-to-date.

    helm repo update
    

    See Volt MX Go and Helm chart version compatibility to know the latest Helm chart version.

  2. Run the following command to download the chart:

    helm pull hclcr/drapi
    
    The file drapi-1.n.n.tgz is downloaded.

  3. Run the following commands to unpack the chart and make the DRAPI directory your current directory:

    tar -xzvf drapi-1.n.n.tgz
    cd drapi
    

    Note

    Ensure the version number specified here with tar matches the version you downloaded, such as drapi-1.0.7.tgz.

  4. Edit the values.yaml file using your preferred editor to update the file with your HCL Container Repository credentials, and the DNS name settings.

    1. Locate the following lines in the file and replace your-email and your-authentication-token with your email and authentication token used with the HCL Container Repository:

      imageCredentials:
          username: your-email
          password: your-authentication-token
      

      Note

      Use the CLI secret value you saved from obtaining authentication token from HCL Container Repository as your authentication token or password.

    2. Locate the following lines in the file and add your DNS hostname settings:

      ingress:
          drapiDnsName:
          drapiManagementDnsName:
      

      Whatever hostnames you specify here and later in the Volt MX Go Foundry install, you need to ensure that the hostnames are resolvable. There is no additional work if you have already registered the hostnames in DNS. However, if you haven't registered them, you must add the hostnames to the server's /etc/hosts file as described in Ensure Foundry Hostnames are resolvable, substituting your hostnames. Additionally, you must make the same updates in k3s's coredns config map as described in For K3s only again substituting your hostnames.

      Note

      The example names used are drapi.mymxgo.com and drapi-management.mymxgo.com respectively.

    3. Locate the following lines in the file for the Administrator's first name, last name, and password. Set values for each of these settings. In our example we're using "mxgo", "admin" and "password". However, if you use your own values, remember the values and use them when required such as when you Run First Touch, and Access Domino REST API. Remember that the values of dominoAdminFirstName and dominoAdminLastName are combined, but separated by a space, to form the username.

      dominoAdminFirstName: "mxgo"
      dominoAdminLastName: "admin"
      dominoAdminPassword: "password"
      

      The following fields may be of interest to you as well and may be customized to suite your deployment:

      dominoServerDomainName: "ocp"
      dominoOrgName: "ocp"
      dominoServerName: "drapi"
      dominoNetworkHostname: ""
      

      Consult the Table of variables in Run Domino REST API with a Docker image in the Domino REST API documentation to determine if you need to update these fields as well. The mapping of values.yaml settings to variables is as follows:

      • dominoServerDomainName = SERVERSETUP_SERVER_DOMAINNAME
      • dominoOrgName = SERVERSETUP_ORG_ORGNAME
      • dominoServerName = SERVERSETUP_SERVER_NAME
      • dominoNetworkHostname = SERVERSETUP_NETWORK_HOSTNAME
    4. Determine how you want to expose the Domino server to Notes clients by setting the value of the exposeNRPC parameter to any of the following options:

      • do-not-expose: Set this value to prevent exposure of TCP port 1352 to the network.
      • HostPort: Set this value to use TCP port 1352 on your machine for the Notes client to communicate with Domino using the Notes Remote Procedure Call (NRPC) protocol. This is only recommended when using Rancher Desktop for Kubernetes.

      • NodePort: Set this value if you want Kubernetes to allocate a random port in a specified range, by default 30000 to 32767, that's available on every worker node in the cluster. Kubernetes automatically routes traffic on this port from the Kubernetes node to the back-end Domino pod. This is the recommended option if you want to expose NRPC to your Notes Clients when deploying into a non Rancher Desktop cluster. See Create a new server connection under Procedure for instructions on how to obtain the random port number.

      • LoadBalancer: Set this value if you want an external load balancer to be provisioned by a cloud provider which supports external load balancers. Traffic from the external load balancer is directed at the Domino pod, and the cloud provider decides how it is load balanced. Kubernetes typically starts off by making the changes that are equivalent to you requesting NodePort. The cloud-controller-manager component then configures the external load balancer to forward traffic to that assigned node port.

      You can read more about these options in the Service topic in the Kubernetes documentation.

  5. (Optional) If you would like to configure Ingress for Domino REST API, proceed to Configure Kubernetes Ingress for Domino REST API.

  6. Save the file and exit.

2. Deploy Domino REST API

  1. Deploy Domino REST API by running the following Helm install command:

    helm install domino . -f values.yaml -n mxgo
    

    Note

    The images must be pulled. It might take awhile, 90 seconds or longer, for the pod to start.

  2. Run the following command to wait for the Domino pod to be running and in the ready state:

    kubectl get pods -o wide -w
    

    Note

    The -w flag tells the kubectl command to wait, and updates the output over time with any changes.

    Eventually you should see 3/3 in the READY column as shown below:

    NAME                           READY   STATUS              RESTARTS   AGE
    domino-drapi-68596f98fd-bkpdz  0/3     ContainerCreating   0          34s
    domino-drapi-68596f98fd-bkpdz  3/3     Running             0          72s
    
  3. Once you see the READY column showing 3/3, press Ctrl-c to cancel the command.

Additional information

Next step

Proceed to Install MySql for Volt MX Go Foundry.