Upgrade xNIC on Windows

  • Updated on Nov 8, 2024
  • Published on Mar 29, 2023
  • 1 minute(s) read
Prev Next

WHAT TO EXPECT

When a cloudSwXtch has been updated, their xNIC should be upgraded as well. This is very simple since you will only need to reinstall the script. The installer will automatically remove the older version of xNIC.

In this article, users will learn to use the appropriate script to upgrade their xNIC. 

Make sure that you have the latest version of cloudSwXtch installed. You can find information about how to upgrade your cloudSwXtch by clicking here: Upgrading cloudSwXtch. You can also upgrade your cloudSwXtch by deleting and recreating the instance. 

Upgrading xNIC on Windows

  1. Open PowerShell. If you are using Windows 11, please use Windows Terminal.

  2. Download the installer script: 

    Invoke-WebRequest -Uri 'http://<swxtch-instance-name>/services/install/swxtch-xnic-win-install.ps1' -Outfile swxtch-xnic-win-install.ps1

  3. Run the script. Please use the appropriate command for your version. Note: xNIC Type 2 is the default. 

    ./swxtch-xnic-win-install.ps1

  4. The latest version of the Windows xNIC will be installed.

Remember to Reboot

Reboot the machine after the upgrade is complete. You must do this to be able to execute the cloudSwXtch tools properly from your user home directory. 

Additional Arguments

To see all the options available for the xNIC installation/update script, use the -h argument. 

Note that the ctrl- and data- interfaces are from the VM the xNIC is installed. These will be set automatically by the installer. There may be some instances where you will need to specify them. For example, if you have three network interfaces and you want to specify ctrl or data interfaces, you can manually select them using the -ctrl_interface <interface index> or -data_interface <interface index> arguments detailed below.

PS C:\Users\testadmin> .\swxtch-xnic-win-install.ps1 -h
Usage: C:\Users\testadmin\swxtch-xnic-win-install.ps1 [OPTIONS]
  -t <1|2>                              xNIC type to install (default: 2 if supported in this OS, 1 otherwise)
  -u                                    uninstall xcd xNIC only (no other options allowed)
  -unattended                           unattended installation (in case of reboot, the user will not be prompted)
  -ctrl_interface <interface index>     manual selection of the Control interface
  -data_interface <interface index>     manual selection of the Data interface
  -ptp <true|false>                     installing of Precision Time Protocol (default: true)
  -h                                    shows this help