328 lines
12 KiB
Python
328 lines
12 KiB
Python
# 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
|