This page describes the process of transferring content from original storage media or network location to the BDPL file server.
After you have successfully launched the BDPL Ingest Tool and the GUI has opened, scan or enter the item barcode and unit abbreviation (as identified by the BDPL manager) in the appropriate textboxes. Then select the appropriate shipment ID from the dropdown menu (if no selections are available or the correct date is not included, consult with the BDPL manager) and click the 'Load' button.
The Ingest Tool interface will now populate with information from the BDPL manifest completed by the collecting unit:
Check the 'Source' and 'Label transcription' fields (if relevant) to verify that the media is the correct item (if it appears to be incorrect, apply a Post-It note with a description of the problem to the item and proceed to the next item). Pay particular attention to any information in the 'Technician Notes' field, as the unit may have provided specific instructions about what content to transfer or other important information about the item (consult with the BDPL manager as needed).
Initial Error Messages
If any of the basic information is missing, the Ingest Tool will inform the user of the problem with an error in the CMD.EXE window. For example, if the shipment date is not entered, the tool notes "Error; please make sure you have entered a shipment date."
The Ingest Tool will also produce an error message if the barcode value is not found on the 'Inventory' worksheet of the BDPL manifest.
If you are sure the barcode has been entered correctly, then follow the file path indicated in the error message to open the BDPL manifest and check to see if the barcode was entered incorrectly in the 'Inventory' spreadsheet. (Non-barcode values may have been mis-keyed.) Notify the BDPL manager if the barcode is missing so that the collecting unit can add it to the Inventory.
Select a Job Type
As noted in the User Manual Overview, the Ingest Tool has four main job types ('Copy only', 'Disk images', 'DVD', and 'CDDA'), as determined by the type of media and its content. See part Identification and Handling of Legacy Storage Media for more information on identifying media (especially optical media).
The 'Copy only' job type will be used for:
- Items without any physical media, such as transfers that arrived via email, network transfer, FTP, download, etc. These items must be located in the collecting unit's 'Dropbox' folder on Scandium or in another location that can be mapped to the Windows workstations.
- External hard drives and USB drives, except in cases where the BDPL manager and collecting unit have determined that disk imaging is required.
The Copy operation can accept two targets:
- A single folder identified in the BDPL manifest (and associated with a unique barcode value).
- A plain text file containing a list of specific files or folders that will be copied to the item barcode folder. This option is used when only a portion of content in a directory or drive will be included with a particular barcode item. The file list should be created by the collecting unit and/or BDPL manager.
Copy a Folder
To Copy a single folder, check the 'Copy only' option and and then click the 'Browse' button next to the "Source / file list" text box:
A new File Manager window will open; browse to the folder you want to copy and then click the 'Select folder' button.
NOTE: the top-level folder (in addition to all of its contents) will also be moved into the item barcode folder. Use care in selecting the appropriate folder.
The path to the folder will now be displayed in the "Source / file list" text box; if correct, click the 'Transfer' button (if not, click the 'Browse' button again and select the appropriate one):
Copy a File List
If only a portion of a directory or drive will be included in a barcode item, all relevant content should be included in a file list that will be created by the collecting unit and/or BDPL manager. The file list should include the complete paths to the files and/or folders that will be included, one per line. Use Windows-compatible backslashes ('\') in the paths and do not enclose the paths in quotation marks.
NOTE: the file list must be
- Named with the barcode value of the item (for example: 30000152010272.txt)
- Saved to Z:\bdpl_transfer_lists
To start a Copy operation using a file list, select the 'Copy only' option and then click the 'Browse' button next to the "Source / file list" text box:
Browse to Z:\bdpl_transfer_lists in the File Manager and click 'Select folder'
The path to the bdpl_transfer_lists will now be displayed in the "Source / file list" text box; click 'Transfer' to initiate the process:
The BDPL "Copy only" process uses the TeraCopy application to copy files. TeraCopy preserves the timestamps of files and folders and calculates and verifies checksums to ensure that authenticate and accurate copies of content have been acquired.
Once TeraCopy has verified the checksums for all files, the CMD.EXE will display a message that the operation has completed and you may proceed to the next step (analysis).
The 'Disk images' operation will create a disk image and also create a logical copy of the files for further analysis. This job type will be used with:
- Data CDs / DVDs (as opposed to DVD-Video or Compact Disc Digital Audio)
- 3.5" floppy disks
- 5.25" floppy disks
- Zip disks
- Other (primarily internal hard drives, unless the drive is accessible via the Windows workstation's File Manager).
To begin the operation, select the 'Disk image' job type and select the appropriate media type. After you have ensured that the media is write-protected (see Identification and Handling of Legacy Storage Media), attach or insert the media and check the box next to 'Attached?':
Special Instructions for 5.25" Floppies
If you are creating a disk image for a 5.25" floppy disk, you must select the '5.25" fd' option and choose the appropriate disk type from the drop-down menu to the immediate right.
NOTE: see the information on Identifying Disk Types for 5.25" Floppies for detailed instructions on using the FC5025 software to review disks.
Special Instructions for Internal Hard Drives (Other)
If it is necessary to create a disk image of an internal hard drive (or a particular partition of a drive), it will be necessary to identify the device name of the drive and/or partition. Before you attach the internal drive to a write blocker (see Identification and Handling of Legacy Storage Media for more information), open a Windows CMD.EXE window and enter the following command:
This command will read the proc/partitions file, which contains a table listing partitioned devices and their respective names in /dev. Sample output will be something like:
Now attach the drive to the appropriate Tableau write blocker and rerun the above command. The /proc/partitions file will list the newly attached drive among the device names (see drive 'sdc' with three partitions, the last of which--sdc3–is the one we want):
NOTE: consult with the BDPL manager to identify the appropriate device name.
Once the appropriate target has been identified, select the 'Disk image' job type, select 'Other' as the media type, and then enter the device name in the 'Name' text box (in this example, 'sdc3'). You'll also check the box next to 'Attached?' after verifying that the drive is connected:
for moving image content stored as DVD-Video on optical media.
use cases where sound recordings are stored as Compact Disk Digital Audio on optical media.