Connect to Domino server from your Notes client
About this procedure
This is only applicable when you install Volt MX Go to a development or test only environment.
The procedure guides you in connecting to the Domino server from your Notes client. If you installed Domino using the MXGO Domino Helm chart you should configure a Server Connection document to enable connecting to Domino from your Notes client. Follow the steps below.
Before you start
Make sure that your
/etc/hosts file has the preview hostnames. You will need these same entries on any machine you want to connect from, such as your dev laptop. For more information, check the details on hostnames.
The procedure is based on using HCL Notes v12.
Run the following command to copy the
admin.idfrom the domino-drapi pod:
kubectl cp -n mxgo -c restapi-log $POD_NAME:/local/notesdata/admin.id ./k8s-notes-admin.id
$POD_NAMEin the command represents the name of the Domino pod. To get the name of the Domino pod, run the command
kubectl get pods -n mxgo. In the following example result, the highlighted text corresponds to the Domino pod name.
So using the example result, the command above should look like:
kubectl cp -n mxgo -c restapi-log domino-drapi-6989796bdc-nnmdg:/local/notesdata/admin.id ./k8s-notes-admin.id
You may see a warning about "Removing leading '/' from member names" which is typical when specifying full paths in the copy command. Ignore the warning.
If necessary, copy the
k8s-notes-admin.idfile to your laptop.
Switch your ID within the Notes client.
- On your Notes client, select File → Security → Switch ID.
On the Choose User ID to Switch To dialog, search and select the
k8s-notes-admin.idfile, and then click Open.
The default password is
names.nsffile within the Notes client.
- On the Notes client, select File → Open → HCL Notes Application.
- On the Open Application dialog, search and select the
names.nsffile, and then click Open.
Create a new server connection.
- On the Notes client, select Advanced → New → Server Connection. The Server Connection page opens.
- On the Basics tab, enter
drapiin the Server name text box and then select the TCPIP checkbox for Use LAN port.
Click the Advanced tab, and then enter
drapi.mymxgo.comfor your server in the Destination server address text box.
(Optional) If you configured the value of the
exposeNRPCparameter to be
HostPortduring the DRAPI Helm installation, no further configuration is required and you can proceed to Save & Close. If instead you specified
Run the following
kubectlcommand to get the port number of the port picked by Kubernetes for the
kubectl get services domino-drapi-nrpc-external -n mxgo
The output should be similar to the following:
kubectl get services domino-drapi-nrpc-external -n mxgo NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) domino-drapi-nrpc-external NodePort 10.43.84.236 <none> 1352:31657/TCP
Get the port number from the output and append it to the host name in the Destination server address text box.
Using the output example, the PORT(S) column show that port 1352 is being exposed on port 31657. Append
:31657to the host name in the Destination server address text box making a final value of
Click Save & Close.
drapiis the abbreviation for Domino REST API.
In your Notes client, you should now be able to select File → Open → HCL Notes Application, specify
drapi as the server name, and connect to your new Domino server.