How to initialize a new cluster
GUI Method
To setup clustering you need to have a minimum of 2 nodes, 1 being your current OPC server, and a second server with a fresh install of the On-Premise-Controller.
You cannot add a server as a node if you already have a Deskpro Helpdesk instance running on it.
On the main menu navigate to the Cluster page and click the 'create cluster' button to initialize the cluster

This will setup the node as the main node for the cluster. Click 'continue' to access the cluster settings page

You will now see the cluster menu, with the current server listed as the main node

CLI Method
To setup clustering you need to have a minimum of 2 nodes, 1 being your current OPC server, and a second server with a fresh install of the On-Premise-controller.
You cannot add a server as a node if you already have a Deskpro Helpdesk instance running on it.
By default the cluster will initialize with the root user, if you want to specify a custom user you have to adjust the command.
root user
To setup a cluster with the system root user:
opc cluster init copy
custom user
To setup a cluster with a custom SSH user, in this example the user deskpro_admin is used:
opc cluster init --ssh-user deskpro_admin copy
If you are setting a custom user you will need to make sure that they are in the below user groups as well as adding the user to the /etc/sudoers
file on each node in the cluster: deskpro_admin
adm
sudo
If the user does not have these permissions, creating the cluster will fail
This will create the needed cluster configuration, setting itself as the first node.

Check the node details with:
opc cluster node list copy

Host - The IP / hostname associated with the node. The asterisk indicates the node that you are currently logged onto in the cluster.
User - The username the node was either initialized or added to the cluster with.
SSH port - The port that is used for an SSH connection to the node, this is specified at initialization or when adding a node to the cluster
Id - A unique identifier generated by the OPC for the node
Role - This indicates the current role of the node, i.e main, standby or web
Status - This indicates if the node is online or offline
Sync in Progress - This advises if a node sync is currently in progress.
Adding additional nodes
To add nodes to the cluster in either HA or load balancing please follow the guides linked below:
Please log in or register to submit a comment.