Skip to main content

How to initialize a new cluster

in Overview and setup
Authors list
Published: 2023년 1월 6일|Last updated: 2023년 8월 8일

How to initialize a new cluster Copy link to How to initialize a new cluster to clipboard

GUI Method Copy link to GUI Method to clipboard

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.

Note

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

image.png

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

image.png

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

image.png

CLI Method Copy link to CLI Method to clipboard

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.

Note

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
Warning

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.

image.png

Check the node details with:

opc cluster node list
copy

image.png

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 Copy link to Adding additional nodes to clipboard

To add nodes to the cluster in either HA or load balancing please follow the guides linked below:

High Availability

Load Balancing

도움이 되었습니다Unhelpful
next pageNode Management
previous pageOverview of clustering in Deskpro

Please log in or register to submit a comment.