Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
_de0daxo33k1c
_de0daxo33k1c
Instructions for QA Testing of Storage Class-Enabled BatchBuilder
8/5/2022 JW DRAFT

On Tuesday Thursday Aug 25, 2022, LTS plans to release storage class enhancements to production DRS along with a new version of Batch Builder (BB v2.3.0) that is storage class-enabled. With this release, use of older versions of Batch Builder will not be possible – batches generated in an older version will fail to load because they lack storage class assignments.

In the weeks before the August 23 25 release, LTS recommends that all depositors test their batch deposit workflows in QA DRS using BB v2.3.0.
Goals of QA testing:

...

To request help or report a problem, contact LTS Support.


1. Install Batch Builder 2.3.0
2. Create and Generate Your Test Batches
3. Verify Storage Class Assignment Before Deposit
4. Verify Storage Class Assignment After Deposit
5. Storage Class Assignment Criteria

...

Anchor
_ucmkoe7y8wwx
_ucmkoe7y8wwx
1. Install Batch Builder 2.3.0

  • Download Batch Builder 2.3.0 and follow the installation instructions.
  • Point Batch Builder at the QA instance of DRS:

    1. On your file system, open the BatchBuilder-2.3.0 folder and change to the \conf subfolder. Locate the bb.properties files: 

      Align
      alignleft

      Image Modified

    2. Rename the bb.properties file to bb.properties.orig. Click Yes if your system asks you to confirm.
    3. Rename the bb.properties.qa file to bb.properties. Click Yes if your system asks you to confirm. Your active bb.properties file is now configured for QA DRS. If Batch Builder is open when you do this, you'll need to close and restart it.
    4. To reverse this action and return to the original bb.properties file (which points to production DRS), just reverse these steps. Rename bb.properties to bb.properties.qa and remove the .orig extension to reactivate the original bb.properties file. Then restart Batch Builder.

...

  • Log into QA Web Admin: https://drs2-qa.hul.harvard.edu/drs2_webadmin/search .
  • Verify the storage class after deposit.
    1. Find the file metadata page for the same files you sampled in Step 3.
    2. Go to the Admin metadata section and look for the Storage class field.
    3. The value displayed in Web Admin should match the auto-assigned value in the descriptor you checked in Step 3. If values don't match, please report this to LTS.
  • Check deposited content that should be deliverable. Try the delivery URN. If delivery links don't work, please report this to LTS Support. Note: It can take up to 15 minutes for content to become deliverable. All newly-deposited files are immediately moved to their preservation storage locations but the deliverable copies are moved into delivery storage by an automated process that runs at every quarter hour.

Anchor
_kh244nxugxlv
_kh244nxugxlv
5. Storage Class Assignment Criteria

Highlight
color#F5F5F5
Highlighted rows

...

 indicate storage classes in active use.

Content class

Curatorial/administrative/operational criteria

BatchBuilder auto-assign criteria

Archival (AR)

Non-sensitive, non-external, non-deliverable/repurposable, non-data, non-basic, non-large file.

File is not deliverable (access flag is not 'P' (public) or 'R' (restricted), has no delivery URN assigned and is smaller than 5 GB in size.

All files are assumed to be AR unless file characteristics match the criteria for another Content Class.

Basic (BA)

Non-sensitive, non-external, non-deliverable/repurposable, non-data file designated for minimal sustaining management.

No files are eligible for this designation (used for content from the Harvard Google Books Project).

Data (DA)

Non-sensitive, non-external, deliverable file also designated for read-only access by computational processes.

Not yet implemented (no files are eligible for this designation).

Deliverable (DE)

Non-sensitive, non-external file designated for patron retrieval.

File is deliverable (access flag = 'P' (public) or 'R' (restricted)) and

  • has a file delivery URN for 'FDS', 'IDS', 'SDS', or 'SDS_VIDEO')
  • or is a component of a PDS object (has file role = 'PAGE_COORDINATES', 'PAGE_IMAGE', or 'PAGE_TEXT').

External (EX)

Non-sensitive file curatorially-designated for external management.

Not yet implemented (no files are eligible for this designation).

Large (LG)

Non-sensitive, non-external, non-deliverable/repurposable, non-data, non-basic file greater than or equal to 5 GB in size.

File size is ≥ 5 GB.

Repurposable (RE)

Non-sensitive, non-external, deliverable also designated with an additional archivable role

File is deliverable (has access flag = 'P' (public) or 'R' (restricted) and a delivery URN), but also has file role = 'Archival Master' or 'Production Master'.

Sensitive (SE)

File designated as containing level 4 high-risk confidential information (HRCI) under the University's security policy (Harvard University, 2019).

Secure storage is not yet implemented. Do not assign Secure Storage Rights metadata to objects in your batch or DRS deposit will fail.