|Review||create new issue|
This document describes design details for the PR-1032 requirements.
The design consists of four parts:
Host.reset_networking, which removes all the PIFs, Bonds, VLANs and tunnels associated with the given host, and a call
PIF.scan_biosto bring back the PIFs with device names as defined in the BIOS.
xe-reset-networkingscript that can be executed on a XenServer host, which prepares the reset and causes the host to reboot.
Host.reset_networkingand re-creates the PIFs.
xe-reset-networking script takes the following parameters:
||The IP address of the master. Optional if the host is pool slave, ignored otherwise.|
||Device name of management interface. Optional. If not specified, it is taken from the firstboot data.|
||IP configuration mode for management interface. Optional. Either
||IP address for management interface. Required if
||Netmask for management interface. Required if
||Gateway for management interface. Optional; ignored if
||DNS server for management interface. Optional; ignored if
DNS server for management interface. Optional; ignored if
The script takes the following steps after processing the given parameters:
/etc/xensource/pool.confto determine whether the host is a pool master or pool slave.
pool.conffile to the one given in the
-mparameter, if present.
service network stop).
/tmp/network-resetto trigger XAPI to complete the network reset after the reboot. This file should contain the full configuration details of the management interface as key/value pairs (format:
<key>=<value>\n), and looks similar to the firstboot data files. The file contains at least the keys
A new hidden API call:
After reboot, in the XAPI start-up sequence trigged by the presence of
Host.reset_networkingwith a ref to the localhost.
PIF.scanwith a ref to the localhost to recreate the (physical) PIFs.
PIF.reconfigure_ipto configure the management interface.
Add an “Emergency Network Reset” option under the “Network and
Management Interface” menu. Selecting this option will show some
explanation in the pane on the right-hand side. Pressing <Enter> will
bring up a dialogue to select the interfaces to use as management
interface after the reset. After choosing a device, the dialogue
continues with configuration options like in the “Configure Management
Interface” dialogue. After completing the dialogue, the same steps as
xe-reset-networking are executed.
Host.management_reconfigure, pool slaves may also use the network reset functionality to reconnect to the master on its new IP.