For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/hosted-private-cloud/nutanix-on-ovhcloud/prism-central-expansion.md.
  • English

Replacing Prism Central from Small Mode to X-Large Mode

View as Markdown
Warning

NOTE:

  • This guide is only intended for customers who are in Bring Your Own License mode on their Nutanix cluster. If you are not in this configuration, contact the OVHcloud support teams to change the size of your Prism Central.
  • Before you make any changes, you must unregister your Prism Central license on your Nutanix portal.

 

Requirements

  • A Nutanix cluster in your OVHcloud account
  • Access to the OVHcloud Control Panel
  • You must be connected to the cluster via Prism Central
  • You need to know the Prism Element admin password (when deploying a Nutanix cluster by OVHcloud, this password is created in the same way as Prism Central, but can be changed later)

 

Overview

Warning

NOTE: OVHcloud provides services for which you are responsible for their configuration and management. You are therefore responsible for their proper functioning.

This tutorial is designed to help you as much as possible with common tasks. If you are having difficulty performing these actions, please contact a specialized service provider. OVHcloud cannot provide you with technical support in this regard.

You can deploy Prism Central in one of three custom sizes:

  • Small with 6 vCPU, 26GB of memory and 500GB of storage per virtual machine.
  • Large with 10 vCPU, 44 GB of memory and 2500GB of storage per virtual machine.
  • X-Large with 14 vCPU, 60GB of memory and 2500GB of storage per virtual machine.

By default, Prism Central is deployed on Nutanix by OVHcloud on a single virtual machine in Small mode.

When redeploying a cluster from the OVHcloud Control Panel, you can configure Prism Central with one or three virtual machines in small mode only.

 

Instructions

We will look at how to replace Prism Central in Small mode on a single virtual machine with a Prism Central in X-Large mode and then extend Prism Central on three virtual machines for more resilience.
The Nutanix cluster remains operational during this operation but the features that require Prism Central will be removed.

 

Configuring SSH access to Prism Element with the OVHcloud Load Balancer

Go to the OVHcloud Control Panel, choose the Hosted Private Cloud tab at the top, then click on your Cluster on the left in the Nutanix category, scroll down the window, and click on the Load Balancer associated with your cluster.

Nutanix custom sizes - Prism central expansion - step 1

In the configuration pages for your Load Balancer, go to the Server clusters tab and click Add a server cluster.

Nutanix custom sizes - Prism central expansion - step 2

Enter this information :

  • Name (optional): PE SSH.
  • Protocol: TCP.
  • Port: 22.
  • Datacenter: ALL.
  • Private network: nutanix.

Then click Add.

Nutanix custom sizes - Prism central expansion - step 3

Within the server cluster, click Add server.

Nutanix custom sizes - Prism central expansion - step 4

Fill in these values :

  • Name (Optional): PE SSH.
  • IPv4 address: Private IP address of Prism Element.
  • Port: 22.

And click Add.

Nutanix custom sizes - Prism central expansion - step 5

Click Apply configuration to the right of the warning message Your load balancer configuration has not been applied in all datacenters.

Nutanix custom sizes - Prism central expansion - step 6

Select your location and click on Apply configuration.

Select and apply - Prism central expansion

Select your location again and click Apply configuration.

Select and apply - Prism central expansion

Go to the Tasks tab to see the progress of the configuration change.

Nutanix custom sizes - Prism central expansion - step 9

When the task is finished, go to the Front-ends tab and click Add a Front-end.

Nutanix custom sizes - Prism central expansion - step 10

Enter the following information:

  • Name(Optional): PE-FRONTEND.
  • Protocol: TCP
  • Port: 22.
  • Datacenter: ALL.

Then click Show.

Nutanix custom sizes - Prism central expansion - step 11

In the Restrict access to IPs option, enter the network or IP address that will have access permission to Prism Element in SSH with this format XX.XX.XX.XX or XX.XX.XX.XX/XX.

Click Add.

Nutanix custom sizes - Prism central expansion - step 12

Click Apply configuration to the right of the warning message Your load balancer configuration has not been applied in all datacenters.

Nutanix custom sizes - Prism central expansion - step 13

Select your site and click Apply configuration.

Select and apply - Prism central expansion

Select your site again and click on Apply configuration.

Select and apply - Prism central expansion

Go to the Tasks tab to see the progress of the configuration change.

Nutanix custom sizes - Prism central expansion - step 16

You have finished configuring the Load Balancer. You can now log in via SSH to the Prism Element console, with this information :

ssh admin@nutanix-cluster-ovhcloud-fqdn

or:

ssh nutanix@nutanix-cluster-ovhcloud-fqdn

 

Replacing the Prism Central virtual machine with an X-Large machine

Run these commands after you have modified the following information:

  • \<Prism-Central-Private-IP-address>: Private IP address of Prism Central
  • \<Prism-Element-Admin-Password>: Prism Element admin account password
  • \<Prism-Central-VM-Name>: Prism Central VM name
# Disconnect Prism Element in Prism Central
ncli multicluster remove-from-multicluster external-ip-address-or-svm-ips=<Prism-Central-Private-IP-address> username=admin password=<Prism-Element-Admin-Password> force=true
# Delete VM
acli vm.delete <Prism-Central-VM-Name>

Next, connect to an AHV host in the cluster with this command.

ssh root@private-ip-address-of-one-ahv-servers

Run this command to retrieve the UUID of your default storage, once you have modified the following information:

  • \<Prism-Element-Password>: Prism Element admin account password.
  • \<Prism-Element-IP>: Private IP address of Prism Element.
curl -k -H Accept:application/json -H Content-Type:application/json -u "admin:<Prism-Element-Password>" -X GET "https://<Prism-Element-Ip>:9440/PrismGateway/services/rest/v2.0/storage_containers/" | jq -r '[.entities[] | select( .name | contains("default-container")) | .storage_container_uuid][0]'

Next, run this other command to retrieve the UUID of your cluster’s administration network, with the same elements you modified for the previous command:

curl -s -k -H Accept:application/json -H Content-Type:application/json -u "admin:<Prism-Element-Password>" -X POST https://<prism6element-IP>:9440/api/nutanix/v3/subnets/list -d {} | jq -r "[.entities[] | select( .spec.name | contains(\"<subnet name>\")) | .metadata.uuid][0]"

Create a file named PrismCentralXlarge.json with the information below:

{
    "resources": {
        "version": "pc.2022.6.0.1",
        "should_auto_register": false,
        "initial_password": "<Prism-Central-Password>",
        "pc_vm_list": [
            {
                "vm_name": "prism-central",
                "container_uuid": "<Default-Container-UUID>",
                "num_sockets": 14,
                "data_disk_size_bytes": 2684354560000,
                "memory_size_bytes": 64424509440,
                "nic_list": [
                    {
                        "ip_list": [
                            "<Prism-Central-Private-IP-Address>"
                        ],
                        "network_configuration": {
                            "network_uuid": "<Nutanix-Network-Admin-UUID>",
                            "subnet_mask": "<Nutanix-Network-Admin-mask>",
                            "default_gateway": "<Nutanix-Network-Admin-Gateway>"
                        }
                    }
                ]
            }
        ]
    }
}

Replace these items in the file:

  • \<Prism-Central-Password>: Password for the future Prism Central virtual machine.
  • \<Default-Container-UUID>: UUID of the default storage retrieved earlier.
  • \<Prism-Central-Private-IP-Address>: Private IP address of Prism Central.
  • \<Nutanix-Network-Admin-UUID>: Nutanix Cluster Administration Network UUID.
  • \<Nutanix-Network-Admin-mask>: Nutanix cluster administration network subnet mask.
  • \<Nutanix-Network-Admin-Gateway>: Nutanix cluster administration network default gateway.

Run this command to deploy your Prism Central virtual machine in X-Large mode, once you changed these settings:

  • \<Prism-Element-Password>: Prism Element admin account password.
  • \<Prism-Element-Private-IP-Address>: Private IP address of Prism Element.
curl -k -H Accept:application/json -H Content-Type:application/json -u "<admin:Prism-Element-Password>" -X POST "https://<Prism-Element-Private-IP-Address>:9440/api/nutanix/v3/prism_central" -d @PrismCentralXlarge.json
Warning

NOTE: Wait thirty minutes for this virtual machine to deploy.

Enter the following command by editing these options to create a pcregister.json file:

  • \<Prism-Central-Password>: Prism Central Password.
  • \<Prism-Central-Private-IP-Address>: Private IP address of Prism Central.
echo "{\"username\":\"admin\",\"password\":\"<Prism-Central-Password>\",\"port\":9440,\"ipAddresses\":[\"<Prism-Central-Private-IP-Address>\"]}" > pcregister.json

Run this command to save Prism Element into your new Prism Central virtual machine, after changing these settings:

  • \<Prism-Element-Password>: Prism Element admin account password.
  • \<Prism-Element-Private-IP-Address>: Private IP address of Prism Element.
curl -k -H Accept:application/json -H Content-Type:application/json -u "<admin:Prism-Element-Password>" -X POST "https://<Prism-Element-Private-IP-Address>:9440/PrismGateway/services/rest/v1/multicluster/prism_central/register" -d @pcregister.json

Prism Element is now saved in the new Prism Central.

 

Migration of Prism Central to three virtual machines

Now that Prism Element is attached to your Prism Central virtual machine, you will connect to Prism Central and extend Prism Central to three virtual machines.

Log in to Prism Central with the URL provided during deployment.

Enter your Personal Information, check the box I have read and agree to the terms and conditions and click Accept.

Nutanix custom sizes - Prism central expansion - step 17

Click Continue when prompted to activate Pulse.

Nutanix custom sizes - Prism central expansion - step 18

Click the Prism Central configuration gear icon.

Nutanix custom sizes - Prism central expansion - step 19

Click Prism Central Management to the left and click Scale Out PC.

Nutanix custom sizes - Prism central expansion - step 20

Click Confirm.

Nutanix custom sizes - Prism central expansion - step 21

 

The expansion of Prism Central requires three additional private IP addresses, one for the virtual IP address and two for the new virtual machines.

Scroll through the window and enter this information:

  • Virtual IP: Prism Central virtual private IP address.
  • VM Name: Name of the second Prism Central virtual machine.
  • IP: Private IP address of the second virtual machine.
  • VM Name: Name of the third Prism Central virtual machine.
  • IP: Private IP address of the third virtual machine.

Click Expand.

Nutanix custom sizes - Prism central expansion - step 22

Warning

NOTE: Please wait while the expansion is in progress; it may take around thirty minutes.

Nutanix custom sizes - Prism central expansion - step 23

 

When the expansion is complete, the configuration appears in Prism Central with one virtual IP address and three IP addresses for each virtual machine.

Nutanix custom sizes - Prism central expansion - step 24

 

Modifying the Load Balancer to point to the Prism Central virtual IP address

We will replace the IP address of the Prism Central URL with the new virtual IP address through the OVHcloud Load Balancer configuration.

Go to the Server clusters tab, go to NutaClusterAll, and click on the down arrow icon to view the servers.

Nutanix custom sizes - Prism central expansion - step 25

Click Add Server.

Nutanix custom sizes - Prism central expansion - step 26

Enter this information :

  • Name (Optional): PC VIP as Prism Central Virtual IP address.
  • IPv4 address: Virtual Private IP address
  • Port: 9440.

Click Add.

Nutanix custom sizes - Prism central expansion - step 27

Click the ... configuration icon to the right of the prismCentral server and choose Remove from the menu.

Nutanix custom sizes - Prism central expansion - step 28

Click delete.

Nutanix custom sizes - Prism central expansion - step 29

Click Apply Configuration.

Nutanix custom sizes - Prism central expansion - step 30

Select your location and click Apply Configuration.

Select and apply - Prism central expansion

Select your location again and click Apply Configuration.

Select and apply - Prism central expansion

Go to the Tasks tab to see the progress of the changes. The task will be completed when its status is done.

Nutanix custom sizes - Prism central expansion - step 33

You now have Prism Central in X-Large mode with three virtual machines.

 

Go further

Browse all the Nutanix guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Nutanix on OVHcloud on the OVHcloud US website.