'Brings an existing backend storage object under Cinder management.
reference value is passed straight from the get_volume_list helper
function. it is up to the driver how this should be interpreted.
It should be sufficient to identify a storage object that the driver
should somehow associate with the newly-created cinder volume
structure.
There are two ways to do this:
1. Rename the backend storage object so that it matches the,
volume[\'name\'] which is how drivers traditionally map between a
cinder volume and the associated backend storage object.
2. Place some metadata on the volume, or somewhere in the backend, that
allows other driver requests (e.g. delete, clone, attach, detach...)
to locate the backend storage object when required.
If the reference doesn\'t make sense, or doesn\'t refer to an existing
backend storage object, raise a ManageExistingInvalidReference
exception.
The volume may have a volume_type, and the driver can inspect that and
compare against the properties of the referenced backend storage
object.  If they are incompatible, raise a
ManageExistingVolumeTypeMismatch, specifying a reason for the failure.'

@proxy._trace_time
def manage_volume(self, volume, reference):

    existing_volume = reference['source-name']
    LOG.debug('manage_volume:    %(volume)s', {'volume': existing_volume})
    try:
        volumes = self._call_xiv_xcli('vol_list', vol=existing_volume).as_list
    except errors.XCLIError as e:
        error = (MANAGE_VOLUME_BASE_ERROR % {'volume': existing_volume, 'error': self._get_code_and_status_or_message(e)})
        LOG.error(error)
        raise self._get_exception()(error)
    if (len(volumes) != 1):
        error = (MANAGE_VOLUME_BASE_ERROR % {'volume': existing_volume, 'error': 'Volume    does    not    exist'})
        LOG.error(error)
        raise self._get_exception()(error)
    volume['size'] = float(volumes[0]['size'])
    try:
        self._call_xiv_xcli('vol_rename', vol=existing_volume, new_name=volume['name'])
    except errors.XCLIError as e:
        error = (MANAGE_VOLUME_BASE_ERROR % {'volume': existing_volume, 'error': self._get_code_and_status_or_message(e)})
        LOG.error(error)
        raise self._get_exception()(error)
    return {}
