How To perform Emergency Network Reset on Citrix Hypervisor/XenServer

How To perform Emergency Network Reset on Citrix Hypervisor/XenServer

book

Article ID: CTX205717

calendar_today

Updated On:

Description

To configure (or restore) the management interface from either XSCONSOLE or from CLI (command-line interface).

Instructions

Using XSCONSOLE

If using the xsconsole to re-configure the management interface and does not succeed, it is best to use the Emergency Network Reset option within the xsconsole to establish the management interface on the XenServer host.  This will allow management via SSH or through XenCenter as so the host can be controlled and added back into a pool (or can be managed as such it is back up and attached to shared storage, etc).
 
  1. Gain access to the XSconsole via lights out technology or even directly: keyboard and monitor.
  2. Navigate to the Network and Management Interface option and press Enter
XSCONSOLE - Reset Networking Step 1
  1. Select the Emergency Network Reset option and press enter.
XSCONSOLE - Reset Networking Step 2
  1. The following warning will appear -- press enter to continue.
XSCONSOLE - Reset Networking Step 3
  1. Enter the primary interface (such as eth0) that needs to have the management IP address added/configured for temporary purposes > click Enter
  • Specifying the correct (physical) interface is important: regardless of previous configuration such as bond, LACP, etc.  A management interface needs to be defined for access to the host. 
XSCONSOLE - Reset Networking Step 4
 
  1. Select the Static option in the next step > click Enter 
XSCONSOLE - Reset Networking Step 5
  1. Specify the management IP address information and once complete, click Enter 
XSCONSOLE - Reset Networking Step 6
  1. Follow remaining windows to confirm that the hostname should remain the same and the prompt to reboot.
  1. After reboot, xsconsole should now appear with the IP address specified and should be accessible via XenCenter or SSH.



 

Using Command Line

The command-line utility, xe-reset-networking, is another method to reconfigure a XenServer host's management interface. 
  1. To view the options required, execute the following command:
    • xe-reset-networking --help
  2. The following output will be generated and is documented here for reference:
usage: xe-reset-networking [options]

options:
  -h, --help            show this help message and exit
  -m ADDRESS, --master=ADDRESS
                        Master's address
  --device=DEVICE       Device name of new management interface
  --mode=MODE           IP configuration mode for new management interface:
                        "dhcp" or "static" (default is dhcp)
  --ip=IP               IP address for new management interface
  --netmask=NETMASK     Netmask for new management interface
  --gateway=GATEWAY     Gateway for new management interface
  --dns=DNS             DNS server for new management interface
  1. The -m flag is optional, but if this host is a part of a pool it is recommended to use it.  With the IP information for the XenServer host, execute the following command (with all options cited and required):
    • xe-reset-networking -m IP_of_Master --device=eth0 --mode=static --ip=IP_of_Host --netmask=Netmask_for_Network --gateway=Gateway_Address --dns=Only_One_DNS_Server
  2. You will then be prompted to accept the changes and reboot.  This will require one to fully type out "yes".
  3. After reboot, the management interface should now be up and functional.

Issue/Introduction

The following document explains two ways to configure or re-configure a XenServer's management interface. To configure (or restore) the management interface from either XSCONSOLE or from CLI (command-line interface).
Powered by Wolken Software