Infoblox recommends that you dedicate the minimum system requirements to the host the NIOS-X server you plan to deploy. The dedicated resources cannot be shared with or used for other non-Infoblox applications. Sharing resources will negatively affect the performance of your BloxOne Infoblox services. For information about the minimum system requirements and port usage, see the following:
- BloxOne NIOS-X Connectivity and Service Requirements
- Minimum System Requirements for HostsNIOS-X Servers
- Supported Platforms for HostsNIOS-X Servers
Prerequisites
Before deploying a host a NIOS-X server and enabling BloxOne Infoblox services, ensure that you prepare the deployment environment according to the requirements for the supported platforms and open all necessary ports for unrestricted outbound access. For details, see BloxOne NIOS-X Connectivity and Service RequirementsRequirements.
Before you start the deployment, consider the following:
- Set up Hyper-V on your Windows server. For information, refer to the Microsoft documentation.
- The recommended resources required for the VHD on Hyper-V deployment are 8 vCPU and 16GB of of memory. For details, see Minimum System Requirements for HostsNIOS-X Servers.
- Ensure that your Hyper-V environment meets the minimum deployment requirements.
Installing VHD Image on Hyper-V
- Log in to the Cloud Services the Infoblox Portal.
- Go to Administration > Downloads.
- On the Downloads page > Hosts NIOS-X (BloxOne) Servers section, select select Download Package for Azure/HyperV (60 GB Disk) for the regular image HyperV Gen 2 or Download Package for Azure/HyperV (750 GB Disk) for the high-capacity image Gen 1.
- Click Download Package.
- Create the following directory on your system: <WORK-DIR>/hyperv-images.
- Download the VHD image for Gen1 or VHDX for Gen2 to the <WORK-DIR>/hyperv-images work folder and rename the image file by entering the following:
cp <WORK-DIR>/hyperv-images/<bloxone vhd/vhdx image>.vhd[x] <WORK-DIR>/hyperv-images/bloxone.vhd[x]
Note: If you want to create multiple Hyper-V instances, you must repeat the process by downloading the VHD image and renaming the image file for each Hyper-V instance or create a separate copy of the VHD image downloaded from the Infoblox Portal for each Hyper-V instance.
The following is an example:
cp For example, if we want to deploy two Hyper-V instances for BloxOne, create two copies of the image for each instance and use the copied image respectively. Instance 1: copy C:/Users/Administrator/hyperv-images/BloxOne_OnPrem_Azure_v3.4.1.vhd C:/Users/Administrator/hyperv-images/bloxone-1.vhd. Instance 2: copy C:/Users/Administrator/hyperv-images/BloxOne_OnPrem_Azure_v3.4.1.vhd C:/Users/Administrator/hyperv-images/bloxone-2.vhd. - Complete the following to create the seed image metadata.iso for cloud-init:
- Create the following directory: <WORK-DIR>/cloud-init.
- Create the network-config file in the <WORK-DIR>/cloud-init directory based on your network requirements, such as <WORK-DIR>/cloud-init/"network-config". The following is a sample of the network-config file:
ethernets:
eth0:
addresses: [ 192.168.xxx.11/24 ]
dhcp4: False
gateway4: 192.168.xxx.1
nameservers:
addresses: [52.119.40.100]version: 2
Note: Ensure that you save the network-config file or any cloud-init files without an extension. You can use " " around the file name to define no extension for the file. - In the seed image for cloud-init, edit the <WORK-DIR>/cloud-init/user-data file to include information such as the join token for connecting the host the NIOS-X server to the Cloud Services Infoblox Portal. To obtain a join token,, see Creating Join Tokens. The following is a sample of For information on how to use the user-data file:#cloud-config
host_setup:
jointoken: "your BloxOne join token", see Appendix B: YML and JSON Templates. Create the <Work-Dir>/cloud-init/meta-data file to add the instance id to the HyperV instance
:
{
"instance-id": ""
}
Note: Ensure that the "instance-id" is blank, as shown in the above example.- Download the ADK tool from Microsoft support Oscdimg. For more information, refer to the Microsoft documentation.
- Generate the metadata.iso by running the following commands:
Set Oscdimg.exe path to environment variable or got to CD “C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\Oscdimg>” Path
Oscdimg <WORK-DIR>\cloud-init <WORK-DIR>\hyperv-images\metadata.iso -lCIDATA -d -n
- Create the following directory: <WORK-DIR>/cloud-init.
- On Hyper-V Manager, open your Hyper-V server:
- Create a new virtual machine:
- The New Virtual Machine Wizard appears. Click Next.
- Enter the name of the VM, and then click Next.
- Select Generation1 (for VHD image) or Generation 2 (for VHDX image), and then click Next.
- Increase memory size to 16384 (16 GB). Ideally, it should be 16GB, as described in Minimum System Requirements.
- Configure Configure network with proper adapter, and then click Next.
- Select Use an existing virtual hard disk and click Browse to locate the VHD image you downloaded from the Cloud Services Infoblox Portal.
- Review the Summary, and then click Finish.
- Once the virtual host the NIOS-X virtual server is deployed, go to the settings of the host server and select IDE Controller 1 > DVD Drive for Gen 1 or Add Hardware > SCSI Controller > DVD Drive for Gen 2.
- Select Image file and click Browse to locate the metadata.iso file (the cloudinit config file), and then click Apply.
- For Gen 2, select Security and deselect the Enable Secure Boot checkbox to disable secure boot;
- To increase the disk size of the VM, complete the following:
Select the virtual disk under Hard Disk, click Edit, and then click OK:
In the Edit Virtual Hard Disk Wizard, select Choose Action > Expand, and then click Next:
Select Configure Disk, and then enter the new disk size. Click Next.
In the Summary section , review the configuration, and then click Finish. You can also click Previous to go back some step to correct your configuration. - Start the NIOS-X virtual host server and wait a few minutes for the host server to become active.
You have now successfully deployed the host NIOS-X server. It might take a few minutes for the host server and the Cloud Services Infoblox Portal to connect. - To check the current status of the host NIOS-X server, go to Manage > Hoststo Configure > Servers in the Cloud Services Infoblox Portal. For more information about the host server status, seeViewing Host Server Information.
Deploying VHD on Hyper-V Using PowerShell Commands
- Create a virtual machine:
New-VM -Name "<VMName>" -NoVHD -Generation "1 or 2" -MemoryStartupBytes 16GB -SwitchName "<Virtual Switch Name>"
Configure memory and CPU:Set-VM -Name “VMName” -ProcessorCount 8
- Download the VHD image from the Cloud Services the Infoblox Portal and copy it to the local path:
$OsDiskInfo = Get-Item artefacts/<bloxone vhd image>.vhd
Copy-Item -Path $OsDiskInfo -Destination <WORK-DIR>/hyperv-images/bloxone.vh
d - Add the VHD image to the NIOS-X virtual hostserver:
Add-VMHardDiskDrive -VMName <VMName> -Path "<WORK-DIR>\hyperv-images\bloxone.vhd"
- Change the boot order:
Set-VMDvdDrive -VMName <VMName> -Path "<WORK-DIR>\hyperv-images\metadata.iso"
- Disable Secure Boot option and change the boot order for Gen 2:
Set-VMFirmware -VMName $VMName -EnableSecureBoot Of
ADD-VMDvdDrive -VMName $VMName -Path "<WORK-DIR>\hyperv-images\metadata.iso"
Configure VM Disk Size as required:
Resize-VHD -Path <VHD/VHDX> 750GB
- Start the NIOS-X virtual hostserver:
Start-VM -Name “$VMName”