Cluster Launch Wizard

An introduction to the Cluster Wizard, used to create a new ClickHouse cluster. An overview of the settings is provided, with links to further details.

26 January 2023 · Read time 5 min

Overview - Cluster Launch Wizard (summary)

This section covers the Altinity Cloud Manager ClickHouse cluster creation feature called the Cluster Launch Wizard. This getting started guide walks you through the steps to create a new cluster from scratch.

  • The Detailed reference link takes you to section on the Wizard Settings Detail page that explains each setting.
  • Where indicated, additional settings and resources can be obtained upon request from Altinity Technical Support at: https://altinity.com/contact/

The following wizard screens are covered on this page:

  1. ClickHouse Setup | Detailed reference
  2. Resources Configuration | Detailed reference
  3. High Availability Configuration | Detailed reference
  4. Connection Configuration | Detailed reference
  5. Uptime Schedule | Detailed reference
  6. Review & Launch | Detailed reference

The following illustration shows a summary of the various screens available in the Cluster Wizard.

Restore Wizard summary

Figure 1 – Each of the Restore Wizard screens and the available settings.



Launch Cluster

The Altinity Cloud Manager (ACM) is where your existing clusters are shown. https://acm.altinity.cloud/clusters/ If this is the first time you have seen this page, or you have deleted all of your clusters, this page will be blank and show the text string: "You don’t have any clusters running at this moment."

Points of interest marked by the red pins include:

  • The your.environment name is what you signed up with. Note that a read-only demo environment is included.
  • The John Doe is an example of your logged-in name.
  • The left pane collapses or expands the text labels beside the icons.
  • The Launch Cluster text tag refers to the call-to-action LAUNCH CLUSTER button.

To begin the creation of a new ClickHouse cluster:

  1. Select the LAUNCH CLUSTER button.
Launch Cluster button

Figure 2 – The Altinity Cloud Manager (ACM) home page, selecting the LAUNCH CLUSTER button.


  1. Starting with the ClickHouse Setup screen, fill in the information required by each wizard screen clicking NEXT to navigate.
Launch Cluster wizard screens

Figure 3 – Each of the 6 Cluster Launch Wizard screens and the available settings.


1. ClickHouse Setup

After selecting the LAUNCH CLUSTER button, the first wizard setup screen appears ClickHouse Setup.

Enter the following then click NEXT:

Cluster Launch Wizard summary

Figure 4 – The wizard screen 1 of 6 ClickHouse Setup.


2. Resources Configuration

The second screen is Resources Configuration, where you choose the CPU and storage settings. If you need more resources that what is displayed, contact Altinity Support.

Enter the following then click NEXT:

Cluster Launch Wizard summary

Figure 5 – The wizard screen 2 of 6 Resources Configuration.


3. High Availability Configuration

This screen covers server redundancy and failover.

Enter the following then click NEXT:

Cluster Launch Wizard summary

Figure 6 – The wizard screen 3 of 6 High Availability Configuration.


4. Connection Configuration

This screen covers communication details such as port settings and endpoint information.

Enter the following then click NEXT:

Cluster Launch Wizard summary

Figure 7 – The wizard screen 4 of 6 Connection Configuration.


5. Uptime Schedule

This lets you choose the type of schedule for when the cluster is allowed run.

Set the Uptime Schedule so that the server never turns off, then click NEXT:

Cluster Launch Wizard summary

Figure 8 – The wizard screen 5 of 6 Uptime Schedule.


6. Review & Launch

There is nothing to add or change on this review screen.

This is last chance where you can use the BACK button and change previously entered settings, then return to this screen. If there are no changes, select the LAUNCH button to save the settings and start the cluster provisioning process.

The following information is presented:

Cluster Launch Wizard summary

Figure 9 – The last wizard screen 6 of 6 Review & Launch.


Cluster view after Wizard finishes

The example-cluster appears in your Altinity Cloud Manager (ACM). Any new cluster will appear as another panel or another row in a table listing.

Points of interest include:

example-environment - Menu name changes to the selected environment (aka namespace or domain). 2/2 nodes online - Green to indicate running status. Action > Stop to take offline. 0/2 nodes online - Red shows nodes are not running. Action > Resume to start. stopped - Cluster / node is not running. Action > Resume to start. 6/6 checks passed - Shows green when all 6 checks have completed successfully. 0/6 checks passed - Shows red until all checks have passed. Action > Resume to start. Shield green - TLS (Transport Layer Security) is enabled. Actions - Mouse hover shows this light blue shade. Blue outline - In cluster panel view, moving your mouse cursor over a cluster changes the grey outline to blue; click to view. Panel view icon - View clusters in panel format. List view icon - View cluster in a list format. Address of all clusters - https://acm.altinity.cloud/clusters/ Address of a specific cluster - https://acm.altinity.cloud/cluster/2887

Cluster Launch Wizard summary

Figure 10 – Points of interest from the newly created example-cluster.


Last modified 2023.01.26: Getting Started rewrite