Skip to main content

Reveal Processing

10.3 Processing Upgrade

One of the best features of Processing 10.3 is the streamlined data transfer and direct import from S3 storage. This will be the single method for importing data into the processing environment thus it requires some change to your standard processes and some quick setup to get started.

Data in previous msa-transfer buckets is being transferred to a new revealdata-S3staging-xxxxxx bucket which is the only one that will import data into Reveal Processing. This must be configured in your environment. Please use the instructions and links below to establish access to your S3 storage if this has not been done before, or just update by adding the new external bucket.

S3 Browser Usage

Amazon provides a Simple Storage Service ("S3") which Reveal utilizes heavily with a variety of our operations. A third-party client utility, S3 Browser, provides mechanisms to upload to and download content from S3 with a user-friendly interface. Due to its advanced functionality, including parallel uploads and downloads, hashed uploads, and filtering tools, Reveal recommends the use of the S3 Browser.

You can download S3 Browser at: https://s3browser.com/download.aspx.

To configure an S3 Browser account:

  1. Accounts -> New Account

  2. Account name can be whatever you like

  3. Account type is S3 storage

  4. Paste your access key and secret access key into the appropriate fields

  5. Ensure that Use secure transfer is selected

  6. Click Add New Account

You should see the following prompt:

image1.png

Answer "Yes", and then input the Bucket name below when prompted, where “XXXXXX” will be replaced by an MSA number provided by Reveal, and click the "Add External bucket" button:

image2.png

If you receive an error after adding the external bucket, close S3 browser and re-open.

In order to use advanced features such as parallel upload – the ability to set multiple threads for transfer -- you must purchase and register S3 Browser:

  1. Purchase a license at https://s3browser.com/buypro.aspx. This license costs $29.95 and can be activated on three workstations.

  2. Help -> Activate Pro Version.

  3. Paste your activation code into the box.

To configure advanced S3 Browser (version 10.3.x) options:

  1. From the S3 Browser menu, navigate to Tools → Server-Side Encryption.

  2. This will open a server-side encryption rule prompt.

    S3_Server_side_Encryption_Rules.png
  3. Click on the (+)Add button on the bottom left-hand side.

  4. Click on the folder at the end of Bucket name or Mask.

    S3_add_Bucket_name_or_mask.png
  5. This will display your bucket: MSA-US-######. Click on it and choose OK.

  6. This will auto-populate the bucket name and remote file name; click on the Add button.

  7. This will fill in the encryption rule. Now choose Save changes.

  8. From the S3 Browser menu, navigate to Tools → Options → General.

  9. Enable multi-part upload with a part size of: 100MB.

    S3_Enable_multi-part_uploads.png

    Note

    Change values to 512 when uploading more than 1 TB.

  10. Switch to Data Integrity tab.

  11. Ensure Perform data integrity check when uploading is unchecked.

    S3_perform_data_integrity_check.png
  12. Switch to Queueing tab.

    Note

    Changing the queuing values greater than 2 is for Pro version.

  13. Switch all options to 12. This may need to be adjusted based upon your bandwidth and load.

    S3_Queuing_options.png
  14. Click Save changes.

Adding an External Bucket

To create a additional buckets, go to S3 Browser's Buckets menu and select Add External Bucket.

S3_add_external_bucket_selection.png

Enter the name of the bucket that has been supplied by Reveal, and click Add External bucket.

S3_add_external_bucket_name_and_add.png

The new bucket and anything already in it will appear in your bucket list.

Q&A

Q: Do I need to upgrade to the Pro version?

A: Yes. The free version is limited to a maximum of two threads for upload or download, which is far too limited for even average discovery datasets. There are additional performance enhancements in the Pro version.

Q: I licensed the Pro version over a year ago. Do I need to renew?

A: Yes. License renewal is required to upgrade to the latest version.

Q: What version of S3 is required by Reveal?

A: Reveal requires S3 version 10.3.x or above.

Q: What are Reveal’s policies for S3 data retention?

A: There are different user-defined retention polices placed on the Persistent and Temporary object storage locations. These are governed by the S3 Object Lock retention modes to enforce retention policies, governance, and compliance regulations.  We also use this as a second layer of fall back should something get deleted on accident. Details are as follows:

  • Persistent Folder: There is a 7-day retention period placed on an object once you have executed a delete action. If you have the appropriate permissions you can delete, move, copy, these objects. The objects in this folder are tied to Reveal Processing and Reveal Review. If you were to delete an object from here, it will be retained for 7-days until the retention time period has been met.

  • Temporary Folder: There is a blanket 30-day retention policy set for objects in this folder. Any object moved into this folder is automatically deleted after the 30-day time period has been reached for the object.

Please contact with any additional questions you may have.

Importing Documents

Once configured, new import functionality outlined in the link provides what is needed to start ingesting new data directly from S3 improving processes and time to get projects started.

The Import Module creates, manages, and deletes imports for the project. Imports running on the current machine are represented in the Import Module Navigation pane with the icon. After an import has successfully been ingested into the project, the import is represented in the Module Navigation with the icon. All controls in the Imports Ribbon are based on the active or selected import. To select an import simply click on the import in the Import Module Navigation which will bring up the import's snapshot as well as highlight the import in blue.

image3.png

Importing Data into a Project from S3

  1. New Import – Click the New Import button in the Import Ribbon to launch the Import Data form.

  2. Import Path – The Import Path is set to default to the S3 data store bucket for your account. This location and the access keys required are configured during installation.

    image4.png

Clicking the green button to the right of this field opens the Staging Bucket Browser.

image5.png

There are two main stores within the S3 bucket:

  • Persistent - Data in this store is retained even after ingestion and processing. Unless removed within 30 days these data are charged as inactive storage.

  • Temporary - Data in this store is automatically deleted after 30 days so no reminder to remove is required after import and QC are complete.

image6.png

On-premise users may browse to the top level folder of the source data by clicking the button and choose the source folder.

If you need any assistance with this transition, please contact your Customer Success representative or Consultant to set up time to discuss.