/* Copyright (c) Citrix Systems, Inc.
* All rights reserved.
*
* Redistribution and use in source and binary forms,
* with or without modification, are permitted provided
* that the following conditions are met:
*
* * Redistributions of source code must retain the above
* copyright notice, this list of conditions and the
* following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the
* following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
using System;
using System.Collections.Generic;
using System.Threading;
using XenAPI;
using XenAdmin.Network;
namespace XenAdmin.Actions
{
class NetworkingActionHelpers
{
private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
internal static void ReconfigureSinglePrimaryManagement(AsyncAction action, PIF src, PIF dest, int hi)
{
PIF new_dest = NetworkingHelper.CopyIPConfig(src, dest);
// We put an IP address on the destination interface, then we reconfigure the management interface onto it.
int mid = (hi + action.PercentComplete) / 2;
BringUp(action, new_dest, new_dest.IP, dest, mid);
ReconfigureManagement(action, src, new_dest, true, false, hi, true);
}
internal static void ReconfigurePrimaryManagement(AsyncAction action, PIF src, PIF dest, int hi)
{
PIF new_dest = NetworkingHelper.CopyIPConfig(src, dest);
// We bring up the bond members on the supporter hosts, without plugging them.
// Then the bond members on the coordinator host.
// Then we reconfigure the bond interface on the supporters.
// Then the coordinator.
int lo = action.PercentComplete;
int inc = (hi - lo) / 4;
lo += inc;
BringUp(action, new_dest, false, lo);
lo += inc;
BringUp(action, new_dest, true, lo);
lo += inc;
ReconfigureManagement(action, src, new_dest, false, false, lo, true);
ReconfigureManagement(action, src, new_dest, true, false, hi, true);
}
private static void BringUp(AsyncAction action, PIF new_pif, bool this_host, int hi)
{
ForSomeHosts(action, new_pif, this_host, false, hi,
delegate(AsyncAction a, PIF p, int h)
{
BringUp(a, new_pif, new_pif.IP, p, h);
});
}
///
/// Configure an IP address, management purpose, and set the disallow_unplug flag on the given pif, then plug it.
///
internal static void BringUp(AsyncAction action, PIF new_pif, PIF existing_pif, int hi)
{
BringUp(action, new_pif, new_pif.IP, existing_pif, hi);
}
///
/// Configure an IP address, management purpose, and set the disallow_unplug flag on the given existing_pif.
///
/// The source of the new IP details
/// The PIF to configure
internal static void BringUp(AsyncAction action, PIF new_pif, string new_ip, PIF existing_pif, int hi)
{
bool primary = string.IsNullOrEmpty(new_pif.GetManagementPurpose());
int lo = action.PercentComplete;
int inc = (hi - lo) / (primary ? 2 : 3);
log.DebugFormat("Bringing PIF {0} {1} up as {2}/{3}, {4}, {5}...", existing_pif.Name(), existing_pif.uuid,
new_ip, new_pif.netmask, new_pif.gateway, new_pif.DNS);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_BRINGING_UP, existing_pif.Name());
PIF p = (PIF)existing_pif.Clone();
p.disallow_unplug = !primary;
p.SetManagementPurpose(new_pif.GetManagementPurpose());
p.SaveChanges(action.Session);
action.PercentComplete = lo + inc;
ReconfigureIP(action, new_pif, existing_pif, new_ip, action.PercentComplete + inc);
if (!primary)
Plug(action, existing_pif, hi);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_BRINGING_UP_DONE, existing_pif.Name());
log.DebugFormat("Brought PIF {0} {1} up.", existing_pif.Name(), existing_pif.uuid);
}
internal static void ReconfigureIP(AsyncAction action, PIF new_pif, PIF existing_pif, string ip, int hi)
{
log.DebugFormat("Reconfiguring IP on {0} {1} ...", existing_pif.Name(), existing_pif.uuid);
action.RelatedTask = PIF.async_reconfigure_ip(action.Session, existing_pif.opaque_ref,
new_pif.ip_configuration_mode, ip, new_pif.netmask, new_pif.gateway, new_pif.DNS);
action.PollToCompletion(action.PercentComplete, hi);
log.DebugFormat("Reconfiguring IP on {0} {1} done.", existing_pif.Name(), existing_pif.uuid);
}
internal static void Plug(AsyncAction action, PIF pif, int hi)
{
if (!PIF.get_currently_attached(action.Session, pif.opaque_ref))
{
log.DebugFormat("Plugging {0} {1} ...", pif.Name(), pif.uuid);
action.RelatedTask = PIF.async_plug(action.Session, pif.opaque_ref);
action.PollToCompletion(action.PercentComplete, hi);
log.DebugFormat("Plugging {0} {1} done.", pif.Name(), pif.uuid);
}
action.PercentComplete = hi;
}
///
/// Depurpose (set disallow_unplug=false) and remove the IP address from the given PIF.
///
internal static void BringDown(AsyncAction action, PIF pif, int hi)
{
int mid = (action.PercentComplete + hi) / 2;
Depurpose(action, pif, mid);
ClearIP(action, pif, hi);
}
internal static void ReconfigureManagement(AsyncAction action, PIF down_pif, PIF up_pif, bool this_host,
bool lock_pif, int hi, bool bring_down_down_pif)
{
System.Diagnostics.Trace.Assert(down_pif.host.opaque_ref == up_pif.host.opaque_ref);
// To change the management interface on a host, you need to:
// 1. Clear the disallow_unplug flag from the current management PIF (we clear ManagementPurpose at the same time);
// 2. Use Host.management_reconfigure to switch to the new PIF;
// 3. Clear the IP address from the old management PIF.
int lo = action.PercentComplete;
int inc = (hi - lo) / 3;
lo += inc;
if (bring_down_down_pif)
ForSomeHosts(action, down_pif, this_host, lock_pif, lo, Depurpose);
lo += inc;
ForSomeHosts(action, up_pif, this_host, lock_pif, lo, ReconfigureManagement_);
if (bring_down_down_pif)
ForSomeHosts(action, down_pif, this_host, lock_pif, hi, ClearIP);
}
///
/// If the "from" PIF is a secondary management interface,
/// move the management interface name to the "to" PIF instead.
///
internal static void MoveManagementInterfaceName(AsyncAction action, PIF from, PIF to)
{
string managementPurpose = from.GetManagementPurpose();
if (string.IsNullOrEmpty(managementPurpose))
return;
log.DebugFormat("Moving management interface name from {0} to {1}...", from.uuid, to.uuid);
PIF to_clone = (PIF)to.Clone();
to_clone.SetManagementPurpose(from.GetManagementPurpose());
to_clone.SaveChanges(action.Session);
PIF from_clone = (PIF)from.Clone();
from_clone.SetManagementPurpose(null);
from_clone.SaveChanges(action.Session);
log.DebugFormat("Moving management interface name from {0} to {1} done.", from.uuid, to.uuid);
}
///
/// Clear the disallow_unplug and ManagementPurpose on the given NIC.
///
private static void Depurpose(AsyncAction action, PIF pif, int hi)
{
log.DebugFormat("Depurposing PIF {0} {1}...", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_DEPURPOSING, pif.Name());
PIF p = (PIF)pif.Clone();
p.disallow_unplug = false;
p.SetManagementPurpose(null);
p.SaveChanges(action.Session);
action.PercentComplete = hi;
log.DebugFormat("Depurposed PIF {0} {1}.", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_DEPURPOSED, pif.Name());
}
///
/// Switch the host's management interface from its current setting over to the given PIF.
///
private static void ReconfigureManagement_(AsyncAction action, PIF pif, int hi)
{
log.DebugFormat("Switching to PIF {0} {1} for management...", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_MANAGEMENT_RECONFIGURING, pif.Name());
int mid = (hi + action.PercentComplete) / 2;
PIF p = (PIF)pif.Clone();
p.disallow_unplug = false;
p.SetManagementPurpose(null);
p.SaveChanges(action.Session);
action.PercentComplete = mid;
action.RelatedTask = XenAPI.Host.async_management_reconfigure(action.Session, pif.opaque_ref);
action.PollToCompletion(mid, hi);
log.DebugFormat("Switched to PIF {0} {1} for management.", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_MANAGEMENT_RECONFIGURED, pif.Name());
}
internal static void WaitForMembersToRecover(Pool pool)
{
int RetryLimit = 60, RetryAttempt = 0;
List deadHost = new List();
/* host count -1 is for excluding coordinator */
while (deadHost.Count < (pool.Connection.Cache.HostCount -1) && (RetryAttempt <= RetryLimit))
{
foreach (Host host in pool.Connection.Cache.Hosts)
{
if (host.IsCoordinator())
continue;
if (!host.IsLive() && !deadHost.Contains(host.uuid))
{
deadHost.Add(host.uuid);
}
}
RetryAttempt++;
Thread.Sleep(1000);
}
RetryAttempt = 0;
while (deadHost.Count != 0 && (RetryAttempt <= RetryLimit))
{
foreach (Host host in pool.Connection.Cache.Hosts)
{
if (host.IsCoordinator())
continue;
if (host.IsLive() && deadHost.Contains(host.uuid))
{
deadHost.Remove(host.uuid);
}
}
RetryAttempt++;
Thread.Sleep(1000);
}
}
internal static void PoolReconfigureManagement(AsyncAction action, Pool pool, PIF up_pif, PIF down_pif, int hi)
{
System.Diagnostics.Trace.Assert(down_pif.host.opaque_ref == up_pif.host.opaque_ref);
int lo = action.PercentComplete;
int inc = (hi - lo) / 3;
lo += inc;
PoolManagementReconfigure_( action, up_pif, lo);
/* pool_management_reconfigure triggers a pool_recover_slaves, which in turn spawns two tasks
* dbsync (update_env) and server_init on each supporters.
* Only after their completion coordinator will be able to run reconfigure_IPs.
* Hence, we check Host.IsLive metric of all supporters for a transition from true -> false -> true
*/
action.Description = string.Format(Messages.ACTION_WAIT_FOR_POOL_MEMBERS_TO_RECOVER);
WaitForMembersToRecover(pool);
/* Reconfigure IP for supporters and then coordinator */
lo += inc;
ForSomeHosts(action, down_pif, false, true, lo, ClearIP);
lo += inc;
ForSomeHosts(action, down_pif, true, true, hi, ClearIP);
}
///
/// Switch the Pool's management interface from its current setting over to the given PIF.
///
private static void PoolManagementReconfigure_(AsyncAction action, PIF pif, int hi)
{
log.DebugFormat("Switching to PIF {0} {1} for management...", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_MANAGEMENT_RECONFIGURING, pif.Name());
action.RelatedTask = Pool.async_management_reconfigure(action.Session, pif.network.opaque_ref);
action.PollToCompletion(action.PercentComplete, hi);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_MANAGEMENT_RECONFIGURED, pif.Name());
log.DebugFormat("Switched to PIF {0} {1} for management...", pif.Name(), pif.uuid);
}
///
/// Remove the IP address from the given PIF.
///
private static void ClearIP(AsyncAction action, PIF pif, int hi)
{
// if the network is used by clustering, then we don't remove the IP address
if (pif.IsUsedByClustering())
return;
log.DebugFormat("Removing IP address from {0} {1}...", pif.Name(), pif.uuid);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_BRINGING_DOWN, pif.Name());
action.RelatedTask = PIF.async_reconfigure_ip(action.Session, pif.opaque_ref, ip_configuration_mode.None, "", "", "", "");
action.PollToCompletion(action.PercentComplete, hi);
action.Description = string.Format(Messages.ACTION_CHANGE_NETWORKING_BRINGING_DOWN_DONE, pif.Name());
log.DebugFormat("Removed IP address from {0} {1}.", pif.Name(), pif.uuid);
}
internal delegate void PIFMethod(AsyncAction action, PIF pif, int hi);
internal static void ForSomeHosts(AsyncAction action, PIF pif, bool this_host, bool lock_pif, int hi, PIFMethod pif_method)
{
System.Diagnostics.Trace.Assert(pif != null);
XenAPI.Network network = action.Connection.Resolve(pif.network);
if (network == null)
{
log.Warn("Network has gone away");
return;
}
List to_reconfigure =
action.Connection.ResolveAll(network.PIFs).FindAll(
(Predicate)delegate(PIF p)
{
return this_host == (p.host.opaque_ref == pif.host.opaque_ref);
});
if (to_reconfigure.Count == 0)
return;
int lo = action.PercentComplete;
int inc = (hi - lo) / to_reconfigure.Count;
foreach (PIF p in to_reconfigure)
{
if (lock_pif)
p.Locked = true;
try
{
lo += inc;
pif_method(action, p, lo);
}
finally
{
if (lock_pif)
p.Locked = false;
}
}
}
}
}