# Copyright 2017 Red Hat, Inc. # All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. import logging import pkg_resources from sushy import auth as sushy_auth from sushy import connector as sushy_connector from sushy import exceptions from sushy.resources import base from sushy.resources.chassis import chassis from sushy.resources.compositionservice import compositionservice from sushy.resources.fabric import fabric from sushy.resources.manager import manager from sushy.resources.registry import message_registry from sushy.resources.registry import message_registry_file from sushy.resources.sessionservice import session from sushy.resources.sessionservice import sessionservice from sushy.resources.system import system from sushy.resources.updateservice import updateservice LOG = logging.getLogger(__name__) STANDARD_REGISTRY_PATH = 'standard_registries/' class ProtocolFeaturesSupportedField(base.CompositeField): excerpt_query = base.Field('ExcerptQuery') """The excerpt query parameter is supported""" expand_query = base.Field('ExpandQuery') """The expand query parameter is supported""" filter_query = base.Field('FilterQuery') """The filter query parameter is supported""" only_member_query = base.Field('OnlyMemberQuery') """The only query parameter is supported""" select_query = base.Field('SelectQuery') """The select query parameter is supported""" class Sushy(base.ResourceBase): identity = base.Field('Id', required=True) """The Redfish root service identity""" name = base.Field('Name') """The Redfish root service name""" uuid = base.Field('UUID') """The Redfish root service UUID""" product = base.Field('Product') """The product associated with this Redfish service""" protocol_features_supported = ProtocolFeaturesSupportedField( 'ProtocolFeaturesSupported') """The information about protocol features supported by the service""" _composition_service_path = base.Field( ['CompositionService', '@odata.id']) """CompositionService path""" _systems_path = base.Field(['Systems', '@odata.id']) """SystemCollection path""" _managers_path = base.Field(['Managers', '@odata.id']) """ManagerCollection path""" _chassis_path = base.Field(['Chassis', '@odata.id']) """ChassisCollection path""" _fabrics_path = base.Field(['Fabrics', '@odata.id']) """FabricCollection path""" _session_service_path = base.Field(['SessionService', '@odata.id']) """SessionService path""" _registries_path = base.Field(['Registries', '@odata.id']) """Registries path""" _update_service_path = base.Field(['UpdateService', '@odata.id']) """UpdateService path""" def __init__(self, base_url, username=None, password=None, root_prefix='/redfish/v1/', verify=True, auth=None, connector=None): """A class representing a RootService :param base_url: The base URL to the Redfish controller. It should include scheme and authority portion of the URL. For example: https://mgmt.vendor.com :param username: User account with admin/server-profile access privilege :param password: User account password :param root_prefix: The default URL prefix. This part includes the root service and version. Defaults to /redfish/v1 :param verify: Either a boolean value, a path to a CA_BUNDLE file or directory with certificates of trusted CAs. If set to True the driver will verify the host certificates; if False the driver will ignore verifying the SSL certificate; if it's a path the driver will use the specified certificate or one of the certificates in the directory. Defaults to True. :param auth: An authentication mechanism to utilize. :param connector: A user-defined connector object. Defaults to None. """ self._root_prefix = root_prefix if (auth is not None and (password is not None or username is not None)): msg = ('Username or Password were provided to Sushy ' 'when an authentication mechanism was specified.') raise ValueError(msg) if auth is None: auth = sushy_auth.SessionOrBasicAuth(username=username, password=password) super(Sushy, self).__init__( connector or sushy_connector.Connector(base_url, verify=verify), path=self._root_prefix) self._base_url = base_url self._auth = auth self._auth.set_context(self, self._conn) self._auth.authenticate() def __del__(self): if self._auth: try: self._auth.close() except Exception as ex: LOG.warning('Ignoring error while closing Redfish session ' 'with %s: %s', self._base_url, ex) self._auth = None def _parse_attributes(self): super(Sushy, self)._parse_attributes() self.redfish_version = self.json.get('RedfishVersion') def get_system_collection(self): """Get the SystemCollection object :raises: MissingAttributeError, if the collection attribute is not found :returns: a SystemCollection object """ if not self._systems_path: raise exceptions.MissingAttributeError( attribute='Systems/@odata.id', resource=self._path) return system.SystemCollection(self._conn, self._systems_path, redfish_version=self.redfish_version) def get_system(self, identity): """Given the identity return a System object :param identity: The identity of the System resource :returns: The System object """ return system.System(self._conn, identity, redfish_version=self.redfish_version) def get_chassis_collection(self): """Get the ChassisCollection object :raises: MissingAttributeError, if the collection attribute is not found :returns: a ChassisCollection object """ if not self._chassis_path: raise exceptions.MissingAttributeError( attribute='Chassis/@odata.id', resource=self._path) return chassis.ChassisCollection(self._conn, self._chassis_path, redfish_version=self.redfish_version) def get_chassis(self, identity): """Given the identity return a Chassis object :param identity: The identity of the Chassis resource :returns: The Chassis object """ return chassis.Chassis(self._conn, identity, redfish_version=self.redfish_version) def get_fabric_collection(self): """Get the FabricCollection object :raises: MissingAttributeError, if the collection attribute is not found :returns: a FabricCollection object """ if not self._fabrics_path: raise exceptions.MissingAttributeError( attribute='Fabrics/@odata.id', resource=self._path) return fabric.FabricCollection(self._conn, self._fabrics_path, redfish_version=self.redfish_version) def get_fabric(self, identity): """Given the identity return a Fabric object :param identity: The identity of the Fabric resource :returns: The Fabric object """ return fabric.Fabric(self._conn, identity, redfish_version=self.redfish_version) def get_manager_collection(self): """Get the ManagerCollection object :raises: MissingAttributeError, if the collection attribute is not found :returns: a ManagerCollection object """ if not self._managers_path: raise exceptions.MissingAttributeError( attribute='Managers/@odata.id', resource=self._path) return manager.ManagerCollection(self._conn, self._managers_path, redfish_version=self.redfish_version) def get_manager(self, identity): """Given the identity return a Manager object :param identity: The identity of the Manager resource :returns: The Manager object """ return manager.Manager(self._conn, identity, redfish_version=self.redfish_version) def get_session_service(self): """Get the SessionService object :raises: MissingAttributeError, if the collection attribute is not found :returns: as SessionCollection object """ if not self._session_service_path: raise exceptions.MissingAttributeError( attribute='SessionService/@odata.id', resource=self._path) return sessionservice.SessionService( self._conn, self._session_service_path, redfish_version=self.redfish_version) def get_session(self, identity): """Given the identity return a Session object :param identity: The identity of the session resource :returns: The Session object """ return session.Session(self._conn, identity, redfish_version=self.redfish_version) def get_update_service(self): """Get the UpdateService object :returns: The UpdateService object """ if not self._update_service_path: raise exceptions.MissingAttributeError( attribute='UpdateService/@odata.id', resource=self._path) return updateservice.UpdateService( self._conn, self._update_service_path, redfish_version=self.redfish_version) def _get_registry_collection(self): """Get MessageRegistryFileCollection object This resource is optional and can be empty. :returns: MessageRegistryFileCollection object or None if Registries not provided """ if self._registries_path: return message_registry_file.MessageRegistryFileCollection( self._conn, self._registries_path, redfish_version=self.redfish_version) def get_composition_service(self): """Get the CompositionService object :raises: MissingAttributeError, if the composition service attribute is not found :returns: The CompositionService object """ if not self._composition_service_path: raise exceptions.MissingAttributeError( attribute='CompositionService/@odata.id', resource=self._path) return compositionservice.CompositionService( self._conn, self._composition_service_path, redfish_version=self.redfish_version) def _get_standard_message_registry_collection(self): """Load packaged standard message registries :returns: list of MessageRegistry """ message_registries = [] resource_package_name = __name__ for json_file in pkg_resources.resource_listdir( resource_package_name, STANDARD_REGISTRY_PATH): mes_reg = message_registry.MessageRegistry( None, STANDARD_REGISTRY_PATH + json_file, reader=base.JsonPackagedFileReader(resource_package_name)) message_registries.append(mes_reg) return message_registries