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/software-gateway-replacement.md.
  • English

Replacing OVHgateway

View as Markdown
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.

 

Requirements

  • One Nutanix cluster provided by OVHcloud
  • Access to the OVHcloud Control Panel
  • Access to your clusters via Prism Central

 

Instructions

The OVHgateway uses two network cards by default:

  • One on VLAN 0 (base) connected to the internet with an additional OVHcloud IP address.
  • One on VLAN 1 (infra) connected to the local administration network with a range of IP addresses, in this example in 192.168.10.0/24.

In our guide, we will replace this gateway with the network operating system pfSense Community edition without software support.

Info

It is entirely possible to use this guide to install other network operating systems compatible with AHV.

 

Download sources for pfSense installation

Download an ISO image for the pfSense installation from this link: Downloading pfSense.

Using this documentation, add the pfSense ISO image to your Nutanix cluster.

 

Create the GW-PFSENSE virtual machine

In Prism Central, navigate to Infrastructure > Compute > VMs > Create VM.

Click here for the full VM specifications.

Create a virtual machine with these settings:

  • Name: GW-PFSENSE

  • vCPU(s): 2

  • Number Of Cores Per vCPU: 1

  • Memory: 4 GB

  • Boot Configuration: Legacy BIOS

  • Disk (1)

    • Type: CD-ROM
    • Operation: Clone from image
      • Image: Your pfSense ISO file
    • Bus Type: SATA
  • Disk (2)

    • Type: DISK
    • Operation: Allocate on Storage Container
    • Bus Type: SCSI
    • Storage Container: Select an Object Storage container with at least 100 GB of storage space.
  • Network: two network cards

    • VLAN 0 (base)
    • VLAN 1 (infra)

You can use our guide on virtual machine management to create this virtual machine.

Prism pfSense create VM

 

Shut down the OVHgateway virtual machine

To avoid duplicate IP addresses on the network, stop the OVHgateway virtual machine before starting the new virtual machine on pfSense.

Click here for full instructions.

In Prism Central, navigate to Infrastructure > Compute > VMs.

Click on the OVHgateway virtual machine.

Prism VMs overview hgateway

From the Power Operations menu, select Guest Shutdown.

Prism VMs overview hgateway shutdown

 

Retrieve the public address in the OVHcloud Control Panel

Retrieve information about the OVHcloud gateway network settings.

Log in to the OVHcloud Control Panel, select your Nutanix cluster, and find the information in the IPFO field.

Manager Nutanix general information tab - step 3

IPFO is a range of four addresses. The first and last are reserved, the third is on OVHcloud hardware and serves as an Internet gateway. The only usable IP address is the second address in the range.

During installation, we will reuse this information to assign it to the new GW-PFSENSE virtual machine.

XX.XX.XX.N Reserved network address that appears on the OVHcloud client site
XX.XX.XX.N+1 IP address to be assigned to the GW-PFSENSE virtual machine WAN interface
XX.XX.XX.N+2 Address to be used as a gateway on the GW-PFSENSE VM WAN interface
XX.XX.XX.N+3 Reserved broadcast IP address

For example, if the IPFO address displayed on the client site is 198.51.100.0/30, use:

  • 198.51.100.1 for the WAN interface address.
  • 198.51.100.2 for the gateway on the WAN interface.

 

Start the GW-PFSENSE virtual machine

Power on the GW-PFSENSE VM and launch the console.

Click here for full instructions.

Go back to virtual machine management in Prism Central and click on GW-PFSENSE.

Prism VMs gateway pfSense

From the Power Operations menu, select Power On.

Prism VMs gateway pfSense power

Once the VM is powered on, click Launch Console.

Prism VMs gateway pfSense menu bar

 

Install pfSense

Warning

NOTE: These images and instructions are specific to the pfSense ISO. See the pfSense official documentation for more information.

Click here for full installation instructions.

Accept the license information

Review the pfSense license information and press the Enter key to accept it.

 

Welcome

Choose Install, switch to OK with the Tab key, and press Enter.

pfSense installation - Software gateway replacement - step 1

 

Network Installation

Choose OK by pressing Enter.

pfSense installation - Software gateway replacement - step 2

 

WAN Interface Assignment and Configuration

Leave vtnet0 selected, and press OK.

pfSense installation - Software gateway replacement - step 3

 

WAN (vtnet0) Network Mode Setup

Change the Interface Mode to Static by pressing OK.

pfSense installation - Software gateway replacement - step 4

Modify the following areas with the correct configuration settings:

SectionInput
IP AddressEnter the IP address for the OVHgateway, which is the second address in the IP block identified above.
Default GatewayEnter the gateway IP, which is the third address in the IP block identified above.
DNS ServerEnter your DNS (e.g., 8.8.8.8).

Choose Continue and select OK.

pfSense installation - Software gateway replacement - step 9

 

LAN Interface Assignment and Configuration

Choose vtnet1 and select OK.

pfSense installation - Software gateway replacement - step 10

Choose Continue and select OK.

pfSense installation - Software gateway replacement - step 11

Leave LAN selected, and press Continue.

pfSense installation - Software gateway replacement - step 12

A connectivity check will run.

pfSense installation - Software gateway replacement - step 13

 

Final installation steps

Choose Install CE.

pfSense installation - Software gateway replacement - step 14

Choose Continue and select OK.

pfSense installation - Software gateway replacement - step 15

Choose stripe and select OK.

pfSense installation - Software gateway replacement - step 16

Select NUTANIX VDISK and press OK.

pfSense installation - Software gateway replacement - step 17

Confirm by pressing Yes.

pfSense installation - Software gateway replacement - step 18

Select a version to install and press OK.

pfSense installation - Software gateway replacement - step 19

When the installation has finished, press OK.

pfSense installation - Software gateway replacement - step 20

Select Reboot.

pfSense installation - Software gateway replacement - step 21

 

Eject the pfSense CD-ROM from the GW-PFSENSE virtual machine

Eject the pfSense ISO image from the VM's storage disks.

Click here for full instructions.

From Prism Central, go back to the GW-PFSENSE virtual machine management interface.

Click the Power Operations menu and select Guest Shutdown.

Prism VMs gateway pfSense shutdown

Then, click the Update menu and select Storage.

Prism VMs gateway pfSense update

Select the CD-ROM disk, click the Actions menu, and select Eject.

Prism VMs gateway pfSense eject

Return to the Power Operations menu and select Power On.

Prism VMs gateway pfSense power

Click Launch Console to continue the installation after startup.

Prism VMs gateway pfSense menu bar

 

Configure some options through the web interface

Connect to the pfSense Web Console with the URL https://192.168.10.254 from a cluster virtual machine on the AHV LAN: Base.

Enter the following information:

  • User account: admin
  • Default password: pfsense

Then click SIGN IN.

pfSense login screen

 

Change the pfSense default password

From the System menu, choose User Manager.

pfSense home system menu

Click the Pen icon on the right-hand side.

pfSense users

On the following screen, choose a new password, retype it to confirm, then scroll to the bottom of the page and click Save.

Add a rule to allow remote administration from a public address

Go to the Firewall menu and choose Rules.

pfSense home firewall menu

Check that you are on the WAN tab, then click the ⬆️ Add button (at the bottom) to create a firewall rule.

pfSense wan rules

Set these options:

  • Edit Firewall Rule

    • Action: Pass
    • Interface: WAN
    • Address Family: IPv4
    • Protocol: TCP
  • Source

    • Select Address or alias from the drop-down menu.
    • Enter the public address that can connect to the pfSense firewall.
  • Destination

    • Destination: WAN address
    • Destination Port Range From: HTTPS
    • Destination Port Range To: HTTPS

Click Save at the bottom of the page.

pfSense create wan rule

Once you have returned to the rules list, click Apply Changes to activate the rule.

The pfSense administration interface is then accessible from the Internet, only from the authorized network in HTTPS, here https://198.51.100.1.

pfSense wan rules apply changes

 

Configuring Internet Access in a New VLAN

We will create a new subnet in VLAN 2 with an address range in 192.168.2.0/24 and a gateway in 192.168.2.254.

PfSense VM modification

Log in to Prism Central to make these changes:

Use the Isolating management machines from production guide to create a new VLAN on your Nutanix cluster with these settings:

  • VLAN name: Production
  • VLAN number: 2

Your new network must appear in Subnets.

Prism subnets list

Now that the new subnet has been created, we will add an adapter to the configuration of your GW-PFSENSE virtual machine.

Via the virtual machine management, click on your GW-PFSENSE virtual machine, go to the Update menu, and choose Network.

On the next page, click + Attach to Subnet.

Choose the Production subnet and click Save.

Prism VMs attach subnet mod

Enable and configure the new network adapter on pfSense

Log in to the pfSense interface in https, with the public address (for example, https://198.51.100.1) in your pfSense administration interface, and follow these instructions:

Go to the Interfaces menu and click Assignments.

pfSense home interfaces menu

Click + Add to the right of Available network ports.

pfSense interfaces assignments

Select the vtnet2 interface and click Save.

pfSense interface assignments add

In the Interfaces menu, click OPT1.

pfSense home interfaces menu - step 2

Check Enable Interfaces and modify these settings :

  • Description: VLAN2
  • IPv4 Address: 192.168.2.254/24

Click Save.

pfSense interfaces enable

Click Apply Changes.

pfSense interfaces apply changes

Go to the Firewall menu and click Rules.

pfSense home firewall menu

Go to the VLAN2 tab and click the ⬆️ Add button on the left.

pfSense firewall rules VLAN - step 2

Change these values:

  • Protocol: Any
  • Source : VLAN2 subnet
  • Destination: Any

Click Save.

pfSense firewall rules add rule

Click Apply Changes.

pfSense VLAN 2 rules apply changes

Your VLAN 2 is now connected to the Internet!

 

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.