/**
   * Clean up the existing unmanaged protection set and its associated unmanaged volumes so that it
   * gets updated with latest info during rediscovery
   *
   * @param unManagedProtectionSet unmanaged protection set
   * @param unManagedVolumesToUpdateByWwn unmanaged volumes to update
   * @param dbClient db client
   */
  private void cleanUpUnManagedResources(
      UnManagedProtectionSet unManagedProtectionSet,
      Map<String, UnManagedVolume> unManagedVolumesToUpdateByWwn,
      DbClient dbClient) {
    // Clean up the volume wwns, managed volume and unmanaged volume lists of the unmanaged
    // protection set
    unManagedProtectionSet.getManagedVolumeIds().clear();
    unManagedProtectionSet.getVolumeWwns().clear();
    List<URI> unManagedVolsUris =
        new ArrayList<URI>(
            Collections2.transform(
                unManagedProtectionSet.getUnManagedVolumeIds(),
                CommonTransformerFunctions.FCTN_STRING_TO_URI));
    Iterator<UnManagedVolume> unManagedVolsOfProtectionSetIter =
        dbClient.queryIterativeObjects(UnManagedVolume.class, unManagedVolsUris);
    while (unManagedVolsOfProtectionSetIter.hasNext()) {
      UnManagedVolume rpUnManagedVolume = unManagedVolsOfProtectionSetIter.next();
      // Clear the RP related fields in the UnManagedVolume
      StringSet rpPersonality =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_PERSONALITY.toString());
      StringSet rpCopyName =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_COPY_NAME.toString());
      StringSet rpInternalSiteName =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_INTERNAL_SITENAME.toString());
      StringSet rpProtectionSystem =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_PROTECTIONSYSTEM.toString());
      StringSet rpSourceVol =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_UNMANAGED_SOURCE_VOLUME.toString());
      StringSet rpTargetVols =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_UNMANAGED_TARGET_VOLUMES.toString());
      StringSet rpAccessState =
          rpUnManagedVolume
              .getVolumeInformation()
              .get(SupportedVolumeInformation.RP_ACCESS_STATE.toString());

      if (rpPersonality != null) {
        rpPersonality.clear();
      }
      if (rpCopyName != null) {
        rpCopyName.clear();
      }
      if (rpInternalSiteName != null) {
        rpInternalSiteName.clear();
      }
      if (rpProtectionSystem != null) {
        rpProtectionSystem.clear();
      }
      if (rpSourceVol != null) {
        rpSourceVol.clear();
      }
      if (rpTargetVols != null) {
        rpTargetVols.clear();
      }
      if (rpAccessState != null) {
        rpAccessState.clear();
      }
      unManagedVolumesToUpdateByWwn.put(rpUnManagedVolume.getWwn(), rpUnManagedVolume);
    }

    unManagedProtectionSet.getUnManagedVolumeIds().clear();
  }
  /**
   * Update (if it exists) the source and target UnManagedVolume objects with RP information needed
   * for ingestion
   *
   * @param unManagedProtectionSet unmanaged protection set
   * @param cg CG response got back from RP system
   * @param rpCopyAccessStateMap Map to hold the access state of the replication sets
   * @param rpWwnToNativeWwn Map of RP volume WWN to native volume WWN - required for XIO but
   *     harmless otherwise
   * @param storageNativeIdPrefixes List of XIO systems discovered in ViPR
   * @param dbClient DB client instance
   */
  private void mapCgSourceAndTargets(
      UnManagedProtectionSet unManagedProtectionSet,
      GetCGsResponse cg,
      Map<String, String> rpCopyAccessStateMap,
      Map<String, String> rpWwnToNativeWwn,
      List<String> storageNativeIdPrefixes,
      DbClient dbClient) {
    for (GetRSetResponse rset : cg.getRsets()) {
      for (GetVolumeResponse volume : rset.getVolumes()) {
        // Find this volume in UnManagedVolumes based on wwn
        UnManagedVolume unManagedVolume =
            findUnManagedVolumeForWwn(volume.getWwn(), dbClient, storageNativeIdPrefixes);

        // Check if this volume is already managed, which would indicate it has already been
        // partially ingested
        Volume managedVolume =
            DiscoveryUtils.checkManagedVolumeExistsInDBByWwn(dbClient, volume.getWwn());

        // Add the WWN to the unmanaged protection set, regardless of whether this volume is
        // unmanaged or not.
        unManagedProtectionSet.getVolumeWwns().add(volume.getWwn());

        if (null == unManagedVolume && null == managedVolume) {
          log.info(
              "Protection Set {} contains unknown Replication Set volume: {}. Skipping.",
              unManagedProtectionSet.getNativeGuid(),
              volume.getWwn());
          continue;
        }

        if (null != managedVolume) {
          log.info(
              "Protection Set {} contains volume {} that is already managed",
              unManagedProtectionSet.getNativeGuid(),
              volume.getWwn());
          // make sure it's in the UnManagedProtectionSet's ManagedVolume ids
          if (!unManagedProtectionSet
              .getManagedVolumeIds()
              .contains(managedVolume.getId().toString())) {
            unManagedProtectionSet.getManagedVolumeIds().add(managedVolume.getId().toString());
          }

          if (!managedVolume.checkInternalFlags(Flag.INTERNAL_OBJECT) && null != unManagedVolume) {
            log.info(
                "Protection Set {} also has an orphaned UnManagedVolume {} that will be removed",
                unManagedProtectionSet.getNativeGuid(),
                unManagedVolume.getLabel());
            // remove the unManagedVolume from the UnManagedProtectionSet's UnManagedVolume ids
            unManagedProtectionSet
                .getUnManagedVolumeIds()
                .remove(unManagedVolume.getId().toString());
            unManagedVolumesToDelete.add(unManagedVolume);
            // because this volume is already managed, we can just continue to the next
            continue;
          }
        }

        // at this point, we have an legitimate UnManagedVolume whose RP properties should be
        // updated
        log.info("Processing Replication Set UnManagedVolume {}", unManagedVolume.forDisplay());

        // Add the unmanaged volume to the list (if it's not there already)
        if (!unManagedProtectionSet
            .getUnManagedVolumeIds()
            .contains(unManagedVolume.getId().toString())) {
          unManagedProtectionSet.getUnManagedVolumeIds().add(unManagedVolume.getId().toString());
        }

        // Update the fields in the UnManagedVolume to reflect RP characteristics
        String personality = Volume.PersonalityTypes.SOURCE.name();
        if (!volume.isProduction()) {
          personality = Volume.PersonalityTypes.TARGET.name();
        }

        updateCommonRPProperties(
            unManagedProtectionSet, unManagedVolume, personality, volume, dbClient);

        // Update other RP properties for source/targets
        // What Replication Set does this volume belong to? (so we can associate sources to
        // targets.)
        // What is the access state.
        StringSet rpAccessState = new StringSet();
        rpAccessState.add(rpCopyAccessStateMap.get(volume.getRpCopyName()));
        unManagedVolume.putVolumeInfo(
            SupportedVolumeInformation.RP_ACCESS_STATE.toString(), rpAccessState);
        StringSet rsetName = new StringSet();
        rsetName.add(rset.getName());
        unManagedVolume.putVolumeInfo(SupportedVolumeInformation.RP_RSET_NAME.toString(), rsetName);

        rpWwnToNativeWwn.put(volume.getWwn(), unManagedVolume.getWwn());

        unManagedVolumesToUpdateByWwn.put(unManagedVolume.getWwn(), unManagedVolume);
      }

      // Now that we've processed all of the sources and targets, we can mark all of the target
      // devices in the source devices.
      for (GetVolumeResponse volume : rset.getVolumes()) {
        // Only process source volumes here.
        if (!volume.isProduction()) {
          continue;
        }

        // Find this volume in UnManagedVolumes based on wwn
        // See if the unmanaged volume is in the list of volumes to update
        // (it should be, unless the backing array has not been discovered)

        UnManagedVolume unManagedVolume = null;
        String wwn = rpWwnToNativeWwn.get(volume.getWwn());
        if (wwn != null) {
          unManagedVolume = findUnManagedVolumeForWwn(wwn, dbClient, storageNativeIdPrefixes);
        }

        if (null == unManagedVolume) {
          log.info(
              "Protection Set {} contains unknown volume: {}. Skipping.",
              unManagedProtectionSet.getNativeGuid(),
              volume.getWwn());
          continue;
        }

        log.info("Linking target volumes to source volume {}", unManagedVolume.forDisplay());
        StringSet rpTargetVolumeIds =
            linkTargetVolumes(
                unManagedProtectionSet,
                unManagedVolume,
                rset,
                rpWwnToNativeWwn,
                storageNativeIdPrefixes,
                dbClient);

        // Add the unmanaged target IDs to the source unmanaged volume
        unManagedVolume.putVolumeInfo(
            SupportedVolumeInformation.RP_UNMANAGED_TARGET_VOLUMES.toString(), rpTargetVolumeIds);

        unManagedVolumesToUpdateByWwn.put(unManagedVolume.getWwn(), unManagedVolume);
      }
    }
  }