Skip to content

Commit f517274

Browse files
committed
Duplication & index update
1 parent 1dda5c2 commit f517274

File tree

11 files changed

+1693
-1623
lines changed

11 files changed

+1693
-1623
lines changed
Lines changed: 169 additions & 162 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,7 @@
11
---
2-
title: "Node zu einem Nutanix-Cluster hinzufügen (EN)"
3-
excerpt: 'Add a node and confirm that it is working properly'
4-
hidden: true
5-
kb: Hosted Private Cloud
6-
category_l1: Nutanix on OVHcloud
7-
category_l2: Advanced usage
8-
updated: 2023-09-14
2+
title: "Hinzufügen oder Entfernen eines Nodes in einem Nutanix-Cluster (Scale In/Out) (EN)"
3+
excerpt: 'Scale your Nutanix on OVHcloud cluster by adding or removing nodes via the Control Panel or the API'
4+
updated: 2025-05-22
95
---
106

117
<style>
@@ -33,178 +29,189 @@ updated: 2023-09-14
3329

3430
## Objective
3531

36-
Nutanix clusters are scalable. You can add nodes to an existing cluster.
37-
38-
**This guide will show you how to add a node and ensure it works properly.**
32+
Nutanix clusters on OVHcloud are scalable. You can now **add (scale out)** or **remove (scale in)** nodes directly from the OVHcloud Control Panel or the OVHcloud API.
3933

4034
> [!warning]
4135
> OVHcloud provides services for which you are responsible, with regard to their configuration and management. You are therefore responsible for ensuring they function correctly.
4236
>
43-
> This guide is designed to assist you in common tasks as much as possible. Nevertheless, we recommend that you contact the [OVHcloud Professional Services team](https://www.ovhcloud.com/de/professional-services/) or a [specialist service provider](https://partner.ovhcloud.com/de/directory/) if you have difficulties or doubts concerning the administration, usage or implementation of services on a server.
37+
> This guide is designed to assist you in common tasks as much as possible. Nevertheless, we recommend that you contact the [OVHcloud Professional Services team](/links/professional-services) or a [specialist service provider](/links/partner) if you have difficulties or doubts concerning the administration, usage or implementation of services on a server.
4438
4539
## Requirements
4640

47-
- A Nutanix cluster in your OVHcloud account
48-
- Access to the [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.de/&ovhSubsidiary=de)
49-
- Access to the [OVHcloud API](https://api.ovh.com/).
50-
- You must be connected to the cluster via Prism Central
51-
- A ready-to-configure physical server added to the OVHcloud Control Panel
52-
53-
## Technical information
54-
55-
The **Hosted Private Cloud solution powered by Nutanix** enables you to have between 3 and 18 nodes on the same cluster.
41+
- A Nutanix cluster hosted in your OVHcloud account
42+
- Access to the [OVHcloud Control Panel](/links/manager)
43+
- Access to the Prism Central administration interface
44+
- Access to the [OVHcloud API](/links/api).
5645

57-
It is possible to add several nodes when expanding the cluster.
46+
## Technical Information
5847

59-
The nodes to be added must have the same version of **AOS** as the existing cluster.
48+
- Your cluster must have between **3 and 15 nodes**
49+
- All new nodes must run the **same AOS version** as the existing cluster
6050

6151
## Instructions
6252

63-
### Checking node delivery.
64-
65-
Log in to your [OVHcloud Control Panel](https://www.ovh.com/auth/?action=gotomanager&from=https://www.ovh.de/&ovhSubsidiary=de) and check that an additional node appears in the Nutanix cluster.
66-
67-
![New Node](images/scaleup1.png){.thumbnail}
68-
69-
You can also check this via the OVHcloud API.
70-
71-
Use the following API call:
72-
73-
> [!api]
74-
>
75-
> @api {v1} /nutanix GET /nutanix/{serviceName}
76-
>
77-
78-
- `serviceName`: enter the cluster name
79-
80-
![New Node via APIV6](images/scaleup2.png){.thumbnail}
81-
82-
The new node appears with 0.0.0.0 IPs.
83-
84-
### Node installation.
85-
86-
To install the new node, you must change the cluster properties by making a `PUT` on the cluster.
87-
88-
To do this, use the following API call:
89-
90-
> [!api]
91-
>
92-
> @api {v1} /nutanix PUT /nutanix/{serviceName}
93-
>
94-
95-
> [!warning]
96-
> Make sure to untick the `redeployCluster` box.
97-
98-
Tick the `scaleUp` box.
99-
Enter the following information below **nodes**:
100-
101-
- **ahvip** : IP address of the hypervisor of the new node.
102-
- **cvmip** : IP address of the CVM of the new node.
103-
104-
> [!warning]
105-
> These IP addresses must not already be used and must match your addressing plan.
106-
107-
You must also complete the deployment version. It may not correspond to the current version of your cluster. This is not an issue as the node will be modified by the Nutanix installer when adding it to the cluster via Prism Element.
108-
109-
![PUT scaleUp via APIV6](images/scaleup3.png){.thumbnail}
110-
111-
Click `Execute`{.action} to send the request.
112-
113-
In the "Result" tab, the new node appears with the new IP address.
114-
115-
At the end of the installation, you will receive an email confirming that the node is ready.
116-
117-
<pre class="bgwhite"><code>
118-
Dear Customer,
119-
120-
Your server has just been installed.
121-
122-
You must now add it back to your Nutanix cluster by connecting to Prism Central: https://cluster-xxxx.nutanix.ovh.net:9440
123-
124-
We remain at your disposal for any further information.
125-
126-
The OVHcloud Team
127-
</code></pre>
53+
### Scale Out (add a node)
12854

129-
### Add a node to a Nutanix cluster.
55+
#### Add a node
13056

131-
Connect to **Prism Element** through **Prism Central**.
57+
1. From the [OVHcloud Control Panel](/links/manager), navigate to your Nutanix cluster via the `Hosted Private Cloud`{.action} and `Nutanix`{.action} menus.
13258

133-
For more information on connecting to the cluster, see the « [Go further](#gofurther) » section of this guide.
134-
135-
On the dashboard, the 3 nodes are visible in the `Hardware Summary`. Click on `View Details`{.action} in the middle left to bring up more details.
136-
137-
![Display dashboard before Expansion](images/DisplayDashboardBefore.PNG){.thumbnail}
138-
139-
A more detailed view is displayed with information such as total space and storage resilience capacity.<br>
140-
Click `Close`{.action} to close this window.
141-
142-
![Cluster detail before Expansion](images/ClusterDetailBFromDashboard.PNG){.thumbnail}
143-
144-
Open the `Home`{.action} menu and choose `Health`{.action} to perform a cluster analysis before adding the node.
145-
146-
![NCC check before Expansion 01](images/CheckBeforeAdd01.PNG){.thumbnail}
147-
148-
Click on `Actions`{.action} in the top right-hand corner and choose `Run NCC Check`{.action}.
149-
150-
![NCC check before Expansion 02](images/CheckBeforeAdd02.PNG){.thumbnail}
151-
152-
Click `Run`{.action} to launch a control and wait for the operation to complete.
153-
154-
![NCC check before Expansion 03](images/CheckBeforeAdd03.PNG){.thumbnail}
155-
156-
After the check, click the `cogwheel`{.action} icon at the top right to change the settings.
157-
158-
![Add Node 01](images/AddNode01.PNG){.thumbnail}
159-
160-
Click `Expand Cluster`{.action}.
161-
162-
![Add Node 02](images/AddNode02.PNG){.thumbnail}
163-
164-
Check the box next to the discovered host to display the node details.
165-
166-
![Add Node 03](images/AddNode03.PNG){.thumbnail}
167-
168-
Scroll to see the options.
169-
170-
![Add Node 04](images/AddNode04.PNG){.thumbnail}
171-
172-
Scroll down to the bottom of the window and click on `Next`{.action}.
173-
174-
![Add Node 05](images/AddNode05.PNG){.thumbnail}
175-
176-
Choose the Rack in `Assign to Rack` and click `Next`{.action}.
177-
178-
![Add Node 06](images/AddNode06.PNG){.thumbnail}
179-
180-
Click `Expand Cluster`{.action}.
181-
182-
![Add Node 07](images/AddNode07.PNG){.thumbnail}
183-
184-
Click `Open`{.action} to view the cluster expansion details.
185-
186-
![Add Node 08](images/AddNode08.PNG){.thumbnail}
187-
188-
![Add Node 09](images/AddNode09.PNG){.thumbnail}
189-
190-
The addition of the node is completed when the *Expanding Cluster* progress is 100%.
191-
192-
![Add Node 10](images/AddNode10.PNG){.thumbnail}
193-
194-
Four nodes are visible in `Hardware Summary`, click `View Details`{.action} for more information.
195-
196-
![Display dashbord after expansion](images/DisplayDashboardAfter.PNG){.thumbnail}
197-
198-
Click `Close`{.action} to return to the dashboard.
199-
200-
![Cluster detail after Expansion](images/ClusterDetailAfterFromDashboard.PNG){.thumbnail}
201-
202-
## Go further <a name="gofurther"></a>
59+
![Nutanix cluster overview](images/control-panel.png){.thumbnail}
60+
61+
2. In the **General information** tab, you can see the **Number of nodes**. Click `Manage my nodes`{.action}.
62+
63+
![Number of nodes](images/manage-nodes.png){.thumbnail}
64+
65+
3. In the **Nodes** tab, select `Add nodes`{.action}.
66+
67+
![Add nodes tab](images/adding-nodes-03.png){.thumbnail}
68+
69+
4. Review the configuration and pricing in the pop-up window, then click `Order`{.action} to add the node(s).
70+
71+
![Order popup](images/adding-nodes-04.png){.thumbnail}
72+
73+
Once the node is delivered, you can see the status in the **General information** tab.
74+
75+
The **Number of nodes** area will show a new node to install.
76+
77+
![New node to install](images/adding-nodes-05.png){.thumbnail}
78+
79+
#### Install an OS
80+
81+
> [!tabs]
82+
> OVHcloud Control Panel
83+
>> If you click `Manage my nodes`{.action} again, you will see a list of your nodes. For any node with an **OS not installed** status, click the *more options* `...`{.action} button and select `Install`{.action}.
84+
>>
85+
>> [Node status](images/install-os-01.png){.thumbnail}
86+
>>
87+
>> Enter the configuration details for your node. Be sure to install the same AOS version as your cluster.
88+
>>
89+
>> Click `Install`{.action}.
90+
>>
91+
>> ![Install option](images/install-os-02.png){.thumbnail}
92+
>>
93+
>> A confirmation banner will appear.
94+
>>
95+
>> ![Confirmation message](images/install-os-03.png){.thumbnail}
96+
>>
97+
> OVHcloud API
98+
>> To install your node via the [OVHcloud API](https://api.ovh.com/){.external}, use this call:
99+
>>
100+
>> > [!api]
101+
>> > @api {v1} PUT /nutanix/{serviceName}/nodes/{server}/deploy
102+
>> >
103+
>>
104+
105+
Once the node has been installed, you can connect to Prism Central/Element and expand your cluster.
106+
107+
Please refer to the documentation below:
108+
109+
- [Expanding a Cluster through Prism Central](https://portal.nutanix.com/page/documents/details?targetId=Prism-Central-Guide-vpc_2024_3_1:mul-node-add-pc-t.html)
110+
- [Expanding a Cluster](https://portal.nutanix.com/page/documents/details?targetId=Web-Console-Guide-Prism-v7_0:wc-cluster-expand-wc-t.html)
111+
112+
### Scale In (remove a node)
113+
114+
#### Power down a node
115+
116+
1. From the [OVHcloud Control Panel](/links/manager), navigate to your Nutanix cluster via the `Hosted Private Cloud`{.action} and `Nutanix`{.action} menus.
117+
118+
![Nutanix cluster overview](images/control-panel.png){.thumbnail}
119+
120+
2. In the **General information** tab, you can see the Number of nodes. Click `Manage my nodes`{.action}.
121+
122+
![Manage my nodes](images/manage-nodes.png){.thumbnail}
123+
124+
3. Here, you have 2 options:
125+
126+
> [!tabs]
127+
> OVHcloud Control Panel
128+
>> For the node you wish to remove, click the *more options* `...`{.action} button and select `Power down`{.action}.
129+
>>
130+
>> ![Power down](images/powerdown-nodes-01.png){.thumbnail}
131+
>>
132+
>> A warning pop-up will appear. Type the required term and click `Power down`{.action}.
133+
>>
134+
>> > [!primary]
135+
>> > Powering down a Nutanix node may impact your cluster. Please check the [requirements on the Nutanix portal](https://portal.nutanix.com/page/documents/list?type=software) to complete this action.
136+
>> >
137+
>>
138+
>> ![Power down warning](images/powerdown-nodes-02.png){.thumbnail}
139+
>>
140+
>> A confirmation banner will appear.
141+
>>
142+
>> ![Power down confirmation](images/powerdown-nodes-03.png){.thumbnail}
143+
>>
144+
> OVHcloud API
145+
>> You can also power down your node via the [OVHcloud API](/links/api).
146+
>>
147+
>> - Get the Boot ID (enter *power* as the **bootType**):
148+
>>
149+
>> > [!api]
150+
>> > @api {v1} GET /dedicated/server/{serviceName}/boot
151+
>> >
152+
>>
153+
>> - Set the Boot ID:
154+
>>
155+
>> > [!api]
156+
>> > @api {v1} PUT /dedicated/server/{serviceName}
157+
>> >
158+
>>
159+
>> - Power down the node:
160+
>>
161+
>> > [!api]
162+
>> > @api {v1} POST /dedicated/server/{serviceName}/reboot
163+
>> >
164+
>>
165+
166+
#### Uninstall the node
167+
168+
> [!tabs]
169+
> OVHcloud Control Panel
170+
>> Once the node is powered down, click the *more options* `...`{.action} button and select `Uninstall`{.action}.
171+
>>
172+
>> ![Uninstall button](images/remove-nodes-01.png){.thumbnail}
173+
>>
174+
>> A warning pop-up will appear. Type the required term and click `Uninstall`{.action}.
175+
>>
176+
>> > [!primary]
177+
>> > Uninstalling a Nutanix node may impact your cluster. Please check the [requirements on the Nutanix portal](https://portal.nutanix.com/page/documents/list?type=software) to complete this action.
178+
>> >
179+
>>
180+
>> ![Uninstall warning](images/remove-nodes-02.png){.thumbnail}
181+
>>
182+
>> A confirmation banner will appear.
183+
>>
184+
>> ![Uninstall confirmation](images/remove-nodes-03.png){.thumbnail}
185+
>>
186+
> OVHcloud API
187+
>> To uninstall your node via the [OVHcloud API](/links/api), use this call:
188+
>>
189+
>> > [!api]
190+
>> > @api {v1} POST /nutanix/{serviceName}/node/{server}/terminate
191+
>> >
192+
>>
193+
194+
#### Remove the node
195+
196+
Once the node is uninstalled, click the *more options* `...`{.action} button and select `Terminate`{.action}.
197+
198+
![Remove the node](images/remove-nodes-04.png){.thumbnail}
199+
200+
A warning pop-up will appear. Type the required term and click `Confirm`{.action}.
201+
202+
> [!primary]
203+
> Your suspended service will appear in your nodes list for approximately one week before being permanently deleted. This allows you to reactivate the service if you need to reverse the deletion.
204+
205+
## Go further
206+
207+
You can go even further by reading these guides:
203208

204209
[Nutanix Hyperconvergence](/pages/hosted_private_cloud/nutanix_on_ovhcloud/03-nutanix-hci)
205210

206-
[Nutanix Node Addition Guide](https://portal.nutanix.com/page/documents/details?targetId=Web-Console-Guide-Prism-v5_20:wc-cluster-expand-wc-t.html)
211+
[Nutanix Node Addition Guide](https://portal.nutanix.com/page/documents/details?targetId=Web-Console-Guide-Prism-v7_0:wc-cluster-expand-wc-t.html)
212+
213+
If you need training or technical assistance to implement our solutions, please contact your Technical Account Manager or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project.
207214

208-
If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/de/professional-services/) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project.
215+
Ask questions, give your feedback and interact directly with the team building our Hosted Private Cloud services on the dedicated [Discord](https://discord.gg/ovhcloud) channel.
209216

210-
Join our community of users on <https://community.ovh.com/en/>.
217+
Join our [community of users](/links/community).

0 commit comments

Comments
 (0)