Managing S3 on-prem storage

Prev Next

You can add S3 on-prem storages in the appliance via the CLI.

Create an S3 on-prem storage

In S3 on-prem storage, each storage is specific to a single bucket.

To create an S3 on-prem storage on the File Protect appliance using the Web UI:
  1. Log in to the File Protect appliance Web UI.

  2. Go to the Storage page.

  3. Click Add Storage on the top-right of the table.

  4. Enter the following details in the form that appears on the left:

    • Storage Type as S3 On-Prem

    • Storage Name

    • App type as S3

    • Bucket name

    • Region

    • Quarantine Bucket

    • Good Bucket

    • Type of Share as Files

      FX_S3OnPrem3.png
  5. Click Configure Storage to save your storage settings.

To create an S3 on-prem storage on the File Protect appliance using the CLI:
  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Enter a unique name for the S3 on-prem storage along with the bucket name and region of the storage.

    hostname (config) # fmps storage create s3-onprem name <S3StorageName> apps3bucket <BucketName> region <RegionName>
  3. Save your changes.

    hostname (config) # write memory
  4. View all the S3 on-prem configured storages.

    hostname (config) # show fmps storage type s3-onprem
    Storage type: s3-onprem
     Name:                 test-dev-1
     Share Type:           Source
     App:                  s3
     Status:               On-prem S3 is connected
     Bucket Name:          dev-buck-1
     Region:               us-east-1
     Quarantine Bucket:    Not set
     Good Bucket:          Not set     

Configure file locations for S3 on-prem storage

To configure good and quarantine locations for the S3 on-prem storage using the CLI:

It is mandatory to configure the quarantine and good buckets before starting a scan.

Note

Unknown and whitelist target locations are not supported in S3 on-prem storages. The File Protect appliance will move the unknown and skipped files to the good bucket.

  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. Enter the name of the S3 on-prem storage and the locations for quarantine and good files.

    hostname (config) # fmps storage configure s3-onprem <S3StorageName> quarantine <LocationForQuarantinedFiles> good <LocationForGoodFiles>
  3. Save your changes.

    hostname (config) # write memory

Delete an S3 on-prem storage

To delete an S3 on-prem storage on the File Protect appliance using the CLI:
  1. Enable the CLI configuration mode.

    hostname > enable
    hostname # configure terminal
  2. View all the configured storages.

    hostname # show fmps storage all
    Storage type: aws
     Name:                 MyAWSStorage
     Share Type:           Source
     App:                  s3
     Status:               AWS configured and connect
     Bucket Name:          aws-bucket-name
     Queue Name:           aws-queue-name
     Region:               aws-region-name
    Storage type: s3
     Name:                 test-S3-1
     Share Type:           Source
     App:                  s3
     Status:               On-prem S3 is connected
     Bucket Name:          dev-buck-1
     Region:               us-east-1
     Quarantine Bucket:    qa-quar-buck
     Good Bucket:          qa-good-buck
          
    Storage type: o365
     Name:                 MySharePointStorage
     Share Type:           Source
     App:                  sharepoint
     Quarantine Site:      quarantine_site
     Status:               Office 365 configured and connected
    			
  3. Specify the storage to delete. In this example, test-S3-1 is deleted.

    hostname (config) # fmps storage delete name test-S3-1
    Storage operation completed successfully
    
  4. Verify that the former configured storage was deleted.

    hostname (config) # show fmps storage name test-S3-1
    hostname (config) # 
    hostname # show fmps storage all
    Storage type: aws
     Name:                 MyAWSStorage
     Share Type:           Source
     App:                  s3
     Status:               AWS configured and connect
     Bucket Name:          aws-bucket-name
     Queue Name:           aws-queue-name
     Region:               aws-region-name
    Storage type: o365
     Name:                 MySharePointStorage
     Share Type:           Source
     App:                  sharepoint
     Quarantine Site:      quarantine_site
     Status:               Office 365 configured and connected
  5. Save your changes.

    hostname (config) # write memory