Citrix Systems 6 User Manual

84

The system hostname, also known as the domain or DNS name, is defined in the pool-wide database and modified
using the xe host-set-hostname-live CLI command as follows:

xe host-set-hostname-live host-uuid=

<host_uuid>

 host-name=

<host-name>

The underlying control domain hostname changes dynamically to reflect the new hostname.

To add or remove DNS servers in the IP addressing configuration of a XenServer host, use the pif-reconfigure-ip
command. For example, for a PIF with a static IP:

pif-reconfigure-ip uuid=

<pif_uuid>

 mode=static DNS=

<new_dns_ip>

Network interface configuration can be changed using the xe CLI. The underlying network configuration scripts
should not be modified directly.

To modify the IP address configuration of a PIF, use the pif-reconfigure-ip CLI command. See 

 for details on the parameters of the pif-reconfigure-ip command.

See 

 for details on

changing host IP addresses in resource pools.

XenServer  hosts  in  resource  pools  have  a  single  management  IP  address  used  for  management  and
communication to and from other hosts in the pool. The steps required to change the IP address of a host's
primary management interface are different for master and other hosts.

Caution  should  be  used  when  changing  the  IP  address  of  a  server,  and  other  networking
parameters. Depending upon the network topology and the change being made, connections
to network storage may be lost. If this happens the storage must be replugged using the
Repair  Storage  function  in  XenCenter,  or  the  pbd-plug  command  using  the  CLI.  For  this
reason,  it  may  be  advisable  to  migrate  VMs  away  from  the  server  before  changing  its  IP
configuration.

1.

Use the pif-reconfigure-ip CLI command to set the IP address as desired. See 

 for details on the parameters of the pif-reconfigure-ip command:

xe pif-reconfigure-ip uuid=

<pif_uuid>

 mode=DHCP

2.

Use the host-list CLI command to confirm that the member host has successfully reconnected to the master
host by checking that all the other XenServer hosts in the pool are visible:

xe host-list

Changing the IP address of the master XenServer host requires additional steps because each of the member
hosts uses the advertised IP address of the pool master for communication and will not know how to contact the
master when its IP address changes.

Whenever possible, use a dedicated IP address that is not likely to change for the lifetime of the pool for pool
masters.