Add New Host via SSH Command

The platform can add a new hardware host to the cluster through a generated SSH command. The supplied script gathers the required server information and registers the host automatically, reducing the amount of manual configuration needed.

In this article

Before You Begin
Open the Add Host Dialog
Select a Host Group
Copy the SSH Command
Run the Command
Expected Result
UI Wizard Alternative

Before You Begin

Confirm that the new server satisfies the platform hardware and access requirements before starting the host-registration process.

Cloud Storage hosts

Installing a platform Cloud Storage host requires additional preliminary configuration. Contact the support team when assistance is required for this host type.

Open the Add Host Dialog

Click Add in the top toolbar and choose SSH Command.

This option generates a command that can be executed directly on the target server. The script retrieves the required information and includes the host in the cluster automatically.

Select a Host Group

In the opened Add Host (SSH Command) window, use the Host Group drop-down list to select the group that should contain the new server.

✓

Single host group

The Host Group selector is hidden automatically when only one host group exists on the platform.

Copy the SSH Command

Click the copy button beside the generated command.

Add Host SSH Command dialog — Select the Host Group and copy the automatically generated command.

The generated command follows this type of structure:

curl -q –silent ‘https://<platform-domain>/scripts/add-hn.sh’ | bash -s ‘<temporary-access-token>’ ‘<platform-domain>’ vz7

Temporary access token

The platform inserts an account access token while generating the command. The token remains valid for two days, so execute the command before it expires.

Run the Command

Connect to the target server with an account that has sufficient administrative privileges.

Paste the copied command into the server terminal and execute it.

The installation script collects the necessary server information, communicates with the platform, and automatically registers the host in the selected host group.

Expected Result

Automatic discovery The script retrieves the hardware and system details needed by the platform.

Cluster registration The server is added automatically to the selected host group.

Reduced manual input The SSH workflow avoids entering every host property through the administration interface.

✓

Verification

After the script completes, return to Cluster > Hosts and verify that the new host appears in the list with the expected host group and installation state.

UI Wizard Alternative

Use the UI Wizard instead of the SSH Command option when host properties and installation settings need to be defined manually. The wizard provides controls for items such as credentials, status, virtualization type, load-rating offset, network settings, and additional installation options.