/* 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.Collections.ObjectModel; using System.Xml; using XenAdmin.Network; namespace XenAdmin.Actions { /// /// Performs a scan of a CSLG server for storage systems. /// public class SrCslgStorageSystemScanAction : SrCslgScanAction { private static readonly log4net.ILog Log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); private ReadOnlyCollection _cslgSystemStorages; private string _adapterid; public SrCslgStorageSystemScanAction(IXenConnection connection, string adapterid, string target, string user, string password) : base(connection, target, user, password) { _adapterid = adapterid; } /// /// Gets the CSLG system storages. Returns null before the action has been run. /// /// The CSLG system storages. public ReadOnlyCollection CslgSystemStorages { get { return _cslgSystemStorages; } } /// /// Runs this instance. /// protected override void Run() { Dictionary dconf = GetAuthenticationDeviceConfig(); Log.DebugFormat("Attempting to find SRs on CSLG {0}.", dconf["target"]); dconf["adapterid"] = _adapterid; RunProbe(dconf); if (!string.IsNullOrEmpty(Result)) _cslgSystemStorages = new ReadOnlyCollection(ParseStorageSystemsXml(Util.GetContentsOfValueNode(Result))); } private List ParseStorageSystemsXml(String xml) { List output = new List(); XmlDocument doc = new XmlDocument(); doc.LoadXml(xml); foreach (XmlNode storageSystemInfo in doc.GetElementsByTagName("csl__storageSystemInfo")) { string displayName = GetXmlNodeInnerText(storageSystemInfo, "displayName"); string storageSystemId = GetXmlNodeInnerText(storageSystemInfo, "storageSystemId"); List protocols = new List(); protocols.Add(new CslgParameter(null, Messages.NEWSR_CSLG_AUTO)); List provisioningOptions = new List(); provisioningOptions.Add(new CslgParameter(null, Messages.NEWSR_CSLG_NONE)); bool supportsCHAP = false; foreach (string innerText in GetXmlChildNodeInnerTexts(storageSystemInfo, "systemCapabilities/capabilities")) { if (innerText == "DEDUPLICATION") { provisioningOptions.Add(new CslgParameter(innerText, Messages.NEWSR_CSLG_DEDUPLICATION)); } if (innerText == "SUPPORTS_CHAP") { supportsCHAP = true; } } foreach (string innerText in GetXmlChildNodeInnerTexts(storageSystemInfo, "protocolSupport/capabilities")) { if (innerText == "ISCSI") { protocols.Add(new CslgParameter(innerText, Messages.NEWSR_CSLG_ISCSI)); } else if (innerText == "FC") { protocols.Add(new CslgParameter(innerText, Messages.NEWSR_CSLG_FC)); } } output.Add(new CslgSystemStorage(displayName, storageSystemId, protocols, provisioningOptions, supportsCHAP)); } return output; } } #region CslgSystemStorage class /// /// Represents a System Storage from a CSLG server. /// public class CslgSystemStorage { private readonly string _displayName; private readonly string _storageSystemId; private readonly ReadOnlyCollection _protocols; private readonly ReadOnlyCollection _provisioningOptions; private readonly bool _supportsCHAP; /// /// Initializes a new instance of the class. /// /// The display name. /// The storage system id. /// The available protocols. /// The available provisioning options. /// Indicates whether CHAP is supported. public CslgSystemStorage(string displayName, string storageSystemId, IEnumerable protocols, IEnumerable provisioningOptions, bool supportsCHAP) { Util.ThrowIfStringParameterNullOrEmpty(displayName, "displayName"); Util.ThrowIfStringParameterNullOrEmpty(storageSystemId, "storageSystemId"); Util.ThrowIfParameterNull(protocols, "protocols"); Util.ThrowIfParameterNull(protocols, "provisioningOptions"); _displayName = displayName; _storageSystemId = storageSystemId; _protocols = new ReadOnlyCollection(new List(protocols)); _provisioningOptions = new ReadOnlyCollection(new List(provisioningOptions)); _supportsCHAP = supportsCHAP; } /// /// Gets the display name. /// /// The display name. public string DisplayName { get { return _displayName; } } /// /// Gets the available protocols. /// /// The available protocols. public ReadOnlyCollection Protocols { get { return _protocols; } } /// /// Gets the storage system id. /// /// The storage system id. public string StorageSystemId { get { return _storageSystemId; } } public override string ToString() { return DisplayName; } /// /// Gets the available provisioning options. /// /// The available provisioning options. public ReadOnlyCollection ProvisioningOptions { get { return _provisioningOptions; } } /// /// Gets supports CHAP value. /// /// Indicates whether CHAP is supported. public bool SupportsCHAP { get { return _supportsCHAP; } } public override bool Equals(object obj) { var other = obj as CslgSystemStorage; return other != null && other.StorageSystemId == StorageSystemId; } public override int GetHashCode() { return StorageSystemId.GetHashCode(); } } #endregion #region CslgParameter class /// /// Represents a parameter required to configure CSLG storage repository which has a string value and string display-name for that value. /// public class CslgParameter { private readonly string _name; private readonly string _displayName; /// /// Initializes a new instance of the class. /// /// The name. /// The display name. public CslgParameter(string name, string displayName) { Util.ThrowIfStringParameterNullOrEmpty(displayName, "displayName"); _name = name; _displayName = displayName; } /// /// Gets the name. /// /// The name. public string Name { get { return _name; } } /// /// Gets the display name. /// /// The display name. public string DisplayName { get { return _displayName; } } public override string ToString() { return _displayName; } } #endregion }