Skip to main content
BlueXP classification

Get started with BlueXP classification for Amazon FSx for ONTAP

Contributors netapp-tonacki netapp-bcammett

Complete a few steps to get started scanning Amazon FSx for ONTAP volume with BlueXP classification.

Before you begin

Quick start

Get started quickly by following these steps or scroll down for full details.

One Discover the FSx for ONTAP file systems you want to scan

Before you can scan FSx for ONTAP volumes, you must have an FSx working environment with volumes configured.

Two Deploy the BlueXP classification instance

Deploy BlueXP classification in BlueXP if there isn't already an instance deployed.

Three Enable BlueXP classification and select the volumes to scan

Select the Configuration tab and activate compliance scans for volumes in specific working environments.

Four Ensure access to volumes

Now that BlueXP classification is enabled, ensure that it can access all volumes.

  • The BlueXP classification instance needs a network connection to each FSx for ONTAP subnet.

  • Make sure the following ports are open to the BlueXP classification instance:

    • For NFS – ports 111 and 2049.

    • For CIFS – ports 139 and 445.

  • NFS volume export policies must allow access from the BlueXP classification instance.

  • BlueXP classification needs Active Directory credentials to scan CIFS volumes.

    Click Compliance > Configuration > Edit CIFS Credentials and provide the credentials.

Five Manage the volumes you want to scan

Select or deselect the volumes you want to scan and BlueXP classification will start or stop scanning them.

Discovering the FSx for ONTAP file system that you want to scan

If the FSx for ONTAP file system you want to scan is not already in BlueXP as a working environment, you can add it to the canvas at this time.

Deploying the BlueXP classification instance

Deploy BlueXP classification if there isn't already an instance deployed.

You should deploy BlueXP classification in the same AWS network as the Connector for AWS and the FSx volumes you wish to scan.

Note: Deploying BlueXP classification in an on-premises location is not currently supported when scanning FSx volumes.

Upgrades to BlueXP classification software is automated as long as the instance has internet connectivity.

Enabling BlueXP classification in your working environments

You can enable BlueXP classification for FSx for ONTAP volumes.

  1. From the BlueXP left navigation menu, click Governance > Classification and then select the Configuration tab.

    A screenshot of the Configuration tab immediately after deploying the BlueXP classification instance.

  2. Select how you want to scan the volumes in each working environment. Learn about mapping and classification scans:

    • To map all volumes, click Map all Volumes.

    • To map and classify all volumes, click Map & Classify all Volumes.

    • To customize scanning for each volume, click Or select scanning type for each volume, and then choose the volumes you want to map and/or classify.

  3. In the confirmation dialog box, click Approve to have BlueXP classification start scanning your volumes.

Result

BlueXP classification starts scanning the volumes you selected in the working environment. Results will be available in the Compliance dashboard as soon as BlueXP classification finishes the initial scans. The time that it takes depends on the amount of data—​it could be a few minutes or hours.

Note
  • By default, if BlueXP classification doesn't have write attributes permissions in CIFS, or write permissions in NFS, the system won't scan the files in your volumes because BlueXP classification can't revert the "last access time" to the original timestamp. If you don't care if the last access time is reset, click Or select scanning type for each volume. The resulting page has a setting you can enable so that BlueXP classification will scan the volumes regardless of permissions.

  • BlueXP classification scans only one file share under a volume. If you have multiple shares in your volumes, you'll need to scan those other shares separately as a shares group. See more details about this BlueXP classification limitation.

Verifying that BlueXP classification has access to volumes

Make sure BlueXP classification can access volumes by checking your networking, security groups, and export policies.

You'll need to provide BlueXP classification with CIFS credentials so it can access CIFS volumes.

Steps
  1. On the Configuration page, click View Details to review the status and correct any errors.

    For example, the following image shows a volume BlueXP classification can't scan due to network connectivity issues between the BlueXP classification instance and the volume.

    A screenshot of the View Details page in the scan configuration showing volume not being scanned because of network connectivity between BlueXP classification and the volume.

  2. Make sure there's a network connection between the BlueXP classification instance and each network that includes volumes for FSx for ONTAP.

    Note For FSx for ONTAP, BlueXP classification can scan volumes only in the same region as BlueXP.
  3. Ensure the following ports are open to the BlueXP classification instance.

    • For NFS – ports 111 and 2049.

    • For CIFS – ports 139 and 445.

  4. Ensure NFS volume export policies include the IP address of the BlueXP classification instance so it can access the data on each volume.

  5. If you use CIFS, provide BlueXP classification with Active Directory credentials so it can scan CIFS volumes.

    1. From the BlueXP left navigation menu, click Governance > Classification and then select the Configuration tab.

    2. For each working environment, click Edit CIFS Credentials and enter the user name and password that BlueXP classification needs to access CIFS volumes on the system.

      The credentials can be read-only, but providing admin credentials ensures that BlueXP classification can read any data that requires elevated permissions. The credentials are stored on the BlueXP classification instance.

      If you want to make sure your files "last accessed times" are unchanged by BlueXP classification scans, we recommend that the user has Write Attributes permissions in CIFS or write permissions in NFS. If possible, we recommend making the Active Directory configured user part of a parent group in the organization which has permissions to all files.

      After you enter the credentials, you should see a message that all CIFS volumes were authenticated successfully.

Enabling and disabling compliance scans on volumes

You can start or stop mapping-only scans, or mapping and classification scans, in a working environment at any time from the Configuration page. You can also change from mapping-only scans to mapping and classification scans, and vice-versa. We recommend that you scan all volumes.

The switch at the top of the page for Scan when missing "write attributes" permissions is disabled by default. This means that if BlueXP classification doesn't have write attributes permissions in CIFS, or write permissions in NFS, that the system won't scan the files because BlueXP classification can't revert the "last access time" to the original timestamp. If you don't care if the last access time is reset, turn the switch ON and all files are scanned regardless of the permissions. Learn more.

A screenshot of the Configuration page where you can enable or disable scanning of individual volumes.

To: Do this:

Enable mapping-only scans on a volume

In the volume area, click Map

Enable full scanning on a volume

In the volume area, click Map & Classify

Disable scanning on a volume

In the volume area, click Off

Enable mapping-only scans on all volumes

In the heading area, click Map

Enable full scanning on all volumes

In the heading area, click Map & Classify

Disable scanning on all volumes

In the heading area, click Off

Note New volumes added to the working environment are automatically scanned only when you have set the Map or Map & Classify setting in the heading area. When set to Custom or Off in the heading area, you'll need to activate mapping and/or full scanning on each new volume you add in the working environment.

Scanning data protection volumes

By default, data protection (DP) volumes are not scanned because they are not exposed externally and BlueXP classification cannot access them. These are the destination volumes for SnapMirror operations from an FSx for ONTAP file system.

Initially, the volume list identifies these volumes as Type DP with the Status Not Scanning and the Required Action Enable Access to DP volumes.

A screenshot showing the Enable Access to DP Volumes button that you can select to scan data protection volumes.

Steps

If you want to scan these data protection volumes:

  1. Click Enable Access to DP volumes at the top of the page.

  2. Review the confirmation message and click Enable Access to DP volumes again.

    • Volumes that were initially created as NFS volumes in the source FSx for ONTAP file system are enabled.

    • Volumes that were initially created as CIFS volumes in the source FSx for ONTAP file system require that you enter CIFS credentials to scan those DP volumes. If you already entered Active Directory credentials so that BlueXP classification can scan CIFS volumes you can use those credentials, or you can specify a different set of Admin credentials.

      A screenshot of the two options for enabling CIFS data protection volumes.

  3. Activate each DP volume that you want to scan the same way you enabled other volumes.

Result

Once enabled, BlueXP classification creates an NFS share from each DP volume that was activated for scanning. The share export policies only allow access from the BlueXP classification instance.

Note: If you had no CIFS data protection volumes when you initially enabled access to DP volumes, and later add some, the button Enable Access to CIFS DP appears at the top of the Configuration page. Click this button and add CIFS credentials to enable access to these CIFS DP volumes.

Note Active Directory credentials are only registered in the storage VM of the first CIFS DP volume, so all DP volumes on that SVM will be scanned. Any volumes that reside on other SVMs will not have the Active Directory credentials registered, so those DP volumes won't be scanned.