The RipStation BR6-7604 will be used for shipments that include approximately 10 or more pieces of optical media; this wiki page outlines two workflows based upon the following categories:
- Compact Disc Digital Audio (CDDA): to be used with the RipStation software.
- Data CDs and/or DVDs and DVD-Video: to be used with the RipStation DataGrabber software.
If you are working with fewer than 10 discs of one of the above categories, it will be more time-efficient to simply use the BDPL Ingest Tool, following instructions in the Ingest User Manual and Workflow Guidelines.
The RipStation workflow requires that the barcodes for each optical disc are entered in a plain text file, which is then stored alongside the appropriate application (RipStation or RipStation DataGrabber). The discs themselves must be placed on the RipStation input spindles in the same order as on the plain text file.
After the RipStation completes the transfer of content off the discs, files must be copied to the Scandium file server and then moved to the appropriate shipment folder. The bdpl_ripstation_ingest.py will then be run to complete any file replication and content analysis so that RipStation content is identical to the Information Packages produced by the standard BDPL Ingest tool.
Once the ingest of RipStation content has completed, BDPL staff will then use the bdpl_ripstation_postprocess.py script to check in each disc to see if it all processes successfully completed or if there were any failures in the transfer and/or analysis of content. Failed items will be reviewed by the digital preservation librarian and will be run through the standard BDPL Ingest Tool workflow (or, if incorrectly categorized, the other RipStation workflow). During postprocessing, staff will also follow the BDPL guidelines to Scan the Physical Media (the disc, case with barcode, and any additional descriptive materials) using the desktop scanner.
Set Up for RipStation and RipStation DataGrabber Workflows
- To begin with, separate discs in the shipment into one of two groups:
To help determine the type of disc, use information on the disc (labels and manufacturers' information) as well as details in the shipment manifest. For assistance, see the guidelines for Identifying Different Types of Optical Media. Note that CDDA content cannot be burned to a DVD!
- On the RipStation, create a "userdata.txt" file for the current group of discs. Enter each item barcode in the file, one per line, making sure not to include extra spaces (see example below). Save periodically to prevent losing your information!
NOTE: the 'userdata.txt' filename is very important; do not use additional characters or capital letters or it won't be recognized by the software!
- Remove each disc from its case or enclosure and write the last four digits of the barcode on the inside of the disc (around the center hole). Depending on the barcode scheme, it may be necessary to use more than four digits to avoid confusion.
- Then place the discs in a stack on the work surface. Place them upside down so that the first disc (directly on the table) corresponds to the first barcode in userdata.txt file (and the final disc in the stack will be the final barcode in the file).
- Place the empty cases or enclosures in a place where they will not be in the way. Don't stack too high, or they may topple over and it will be more challenging to match the discs back up with the cases. (If there are multiple stacks of cases, it may help to include a post-it note on each to indicate the order.)
- When all barcodes are entered in userdata.txt, save the file alongside the appropriate application:
- RipStation (for CDDAs): C:\Program Files\MF Digital\Ripstation
- RipStation DataGrabber (for data discs and DVD-Video content): C:\Program Files\MF Digital\Ripstation DataGrabber
- Finally, load discs onto the RipStation input spindle(s), ensuring they are in the same order as they were entered on the userdata.txt file (i.e., first disc on the first spindle is the first barcode in the file).
NOTE: if loading discs into both input spindles, put the first stack in the spindle closest to the RipStation drives, as it will be checked first by the robotic arm.
RipStation Workflow for CDDAs
The RipStation application can be launched from a shortcut on the desktop of the dedicated workstation:
On start-up, the RipStation will check for another running instance, close it, and then initialize the software. A CMD.EXE window will open and inform the BDPL technician of these operations:
The RipStation application involves two configuration steps: general choices about logging and ripping are made in the 'Preferences' menu and then additional choices about formats and output folder/file naming are made when the batch is started.
To open the Preferences window, click on the gear icon in the top menu:
On the 'Logging' tab on the Preferences window, make sure the following boxes are checked:
- Log all metadata
- Log batch summary
In the 'Ripping' tab of the Preferences window, check the following two boxes:
- Rip sequentially
- Rip all tracks to one file
NOTE: these selections are essential for the RipStation to produce the correct output and match barcode values from userdata.txt with the correct discs.
Additional configuration of the software requires BDPL staff to launch the batch operation. Click the red circle on the left of the top menu in the main interface:
Start a New Batch
After clicking the launch button, a new window ('Start a new batch') will open with several key configuration options. Make sure the settings include:
- Client Name: enter current shipment ID in YYYYMMDD format
- Number of CDs: 0
- Output Formats: check box next to WAV v1 (NOTE: if WAV v1 is not listed among the options, click the 'Add' button and select it from the menu that opens.)
- Output path:
- Check the box next to 'Use this output path'
- Browse to 'D:\Local Audio' for the output path
- Check the box next to 'Do not connect to Internet for metadata' (NOTE: IU general counsel has ruled that no commercially-produced audio CDs should be replicated; as a result, no applicable metadata should be available for our content.)
- Check the box next to 'Audio files only'
Output Formats - Edit
To access additional configuration options, select the WAV v1 file format from the 'Output Formats' box and click the 'Edit' button; an additional 'Output Proprerties' window will then open. These settings should not require adjustment before each batch, but should be checked nonetheless.
Under the 'File Names' section, be sure that the 'Tracks' textbox includes the value: %C\%0\files\%0.wav
NOTE: This setting will ensure that files are saved to the appropriate folder structure (%C refers to the shipment ID and %0 refers to the barcode values from userdata.txt). No other options should be selected in this window.
After reviewing the settings, make sure the drives on the workstation are empty and closed; then click the 'Start Batch' button at the bottom of the 'Start a new batch' window:
While the RipStation should run through the entire stack of discs, BDPL staff should monitor the operation in case of an error (such as the robotic arm's failure to pick up a disc). See the Troubleshooting section of this page for more information on how to handle issues that arise.
Once all discs have addressed by the RipStation, proceed to copy the resulting files to Scandium for further data replication and/or content analysis.
RipStation DataGrabber Workflow for Data Discs and DVD-Video
The RipStation DataGrabber can be launched from a shortcut on the desktop of the RipStation computer. The software may be configured and operated via the user interface:
On start-up, RipStation DataGrabber will check for another running instance, close it, and then initialize the software. A CMD.EXE window will open and inform the BDPL technician of these operations:
The RipStation DataGrabber software should not require any adjustments except for updating the shipment ID in the 'Name Format' in the main interface. Information is thus included here for reference and in the event that settings have been changed inadvertently or for custom projects.
The main interface of RipStation Grabber includes a number of configuration options. Make sure the settings include:
- Loader type: MFD
- Ouput format: ISO/MDF Image
- Disc count: 0
- File type filter: leave blank
- Root path: D:\Local Data\
- Name format: [shipmentID]\%0\disk-image\%0
- This setting will ensure that files are saved to the appropriate folder structure (%0 refers to the barcode values from userdata.txt).
- Be sure to update the name format with the current shipment ID in YYYYMMDD format!
Additional settings in the DataGrabber 'Preferences' should not require adjustment between batches, but should be reviewed in case anything has changed. To access these options, click the 'Preferences' icon in the top menu:
An additional 'Preferences' window will then open.
Under the 'Rejects' tab of the Preferences window, make sure that the following boxes are checked:
- 'Reject discs which are not recognized' (time limit should be set to 2.5 minutes)
- 'Rip sequentially'
NOTE: RipStation DataGrabber will not correctly align barcode values from userdata.txt with content if 'Rip sequentially' is not selected.
Under the 'Reports' tab of the Preferences window, be sure to check the option to 'Log full batch log to file.'
Once the configuration is completed, the RipStation DataGrabber batch operation is ready to begin. Before starting, make sure that all drives on the workstation are empty and closed; then click the large green arrow in the top menu of the main interface:
While the RipStation Datagrabber should run through the entire stack of discs, BDPL staff should monitor the operation in case of an error (such as the robotic arm's failure to pick up a disc). See the Troubleshooting section of this page for more information on how to handle issues that arise.
Once all discs have addressed by the RipStation DataGrabber, proceed to copy the resulting files to Scandium for further data replication and/or content analysis.
Copying Files to Scandium
After batch processes with the RipStation or RipStation DataGrabber software have completed, it will be necessary to move the content to Scandium to complete data replication and/or content analysis. First, connect an Ethernet cable to the RipStation machine so that it is connected to the network. Next, use one of the two shortcuts on the desktop of the RipStation machine:
- Copy CDDAs to Scandium: for audio CD content extracted with the RipStation software.
- Copy Data and DVDs to Scandium: for data discs and DVD-Videos extracted with the RipStation DataGrabber software.
NOTE: copies of the batch files themselves are stored at C:\tools on the RipStation machine.
Click on the appropriate shortcut to start the copy process. A new CMD.EXE window will open and you will be prompted to enter the shipment ID:
The batch file will then use the Robocopy utility to copy the files to Scandium: Z:\Ripstation\[shipmentID]
NOTE: you will also need to manually copy the log file from the batch operation and a copy of the original userdata.txt file (renamed to "userdata.txt", if necessary).
After the files are on Scandium, move the barcode files (and log and userdata.txt files) to the appropriate unit and shipment folder.
Completing Ingest for RipStation Content
Once the barcode folders, log file, and userdata.txt file are in the appropriate shipment folder on Scandium, it is time to complete the ingest process, using the bdpl_ripstation_ingest.py script. Click the shortcut for BDPL_ripstation_launch.bat on the desktop of a BDPL workstation:
A new CMD.EXE window will open and you will be prompted to enter the abbreviated unit name and shipment ID and also indicate whether the job was for CDDAs or data discs/DVD-Video:
If both the log file and userdata.txt file are present, the script will proceed to complete any additional file replication/normalization as well as content analysis steps so that the RipStation materials are packaged identically to those produced by the standard BDPL Ingest Tool. The script will also note any failed steps so that additional troubleshooting can take place during the post-processing procedure. An example of a list of failed items from the RipStation Ingest is found below; alongside each barcode is a short message indicating where or why the item failed in the process:
Post-Processing RipStation Content
Once the BDPL RipStation Ingest process completes, the BDPL technician should proceed to post-process materials. This procedure will involve taking discs from the RipStation output spindle(s), checking the barcode for the succes/failure of the Ingest process, reuniting the disc with its case or enclosure, and then creating scanned images of the physical items.
To begin, click the bdpl_ripstation_postprocess.py shortcut on the desktop of the BDPL workstation:
A new CMD.EXE window will open and prompt the user for the unit abbreviation and shipment ID:
Retrieve a disc from the output spindle and reunite with the case/enclosure from the stack that was maintained nearby. Make sure that the barcode values on the disc and case match!
Type or scan the barcode value at the prompt:
The script will then check the BDPL RipStation Ingest logs; if both replication and analysis were successful, a message will indicate their completion:
Alternatively, the tool will report the failure of any step in the Ingest process (or if the RipStation failed to acquire content):
Reasons for failure will range from a content mismatch (i.e., a data disc was included in the CDDA batch process) to the failure of a specific step during the Ingest workflow. The digital preservation librarian will review any failures; in many cases, running the disc through the standard BDPL Ingest Tool workflow will result in success due to improved tool performance.
As a final step (aside from reviewing or re-ingesting discs), follow the BDPL guidelines to Scan the Physical Media (the disc, case with barcode, and any additional descriptive materials) using the desktop scanner.
Software is Not Responding
Occassionally, RipStation and RipStation DataGrabber will crash immediately after launch with a message that the software is not responding. Close the error message and relaunch; please note that it may take several attempts before the software correctly starts.
Robotic Arm Is Unable to Pick Up Disc
The robotic arm may have trouble grasping individual discs for no apparent reason. After several unsuccessful attempts, the software will display a dialogue box asking if you want to cancel the operation (no more discs), try again (discs remain), or keep going (additional discs have been added). Click the 'Try again' button to continue; it may be necessary to gently lift the disc up to meet the robotic arm or nudge it closer to the spindle frame so that it can be picked up.
The RipStation DataGrabber software may stop unexpectedly in the middle of a batch. If this happens, check the RipStation output window to see the last barcode that was successfully completed:
Remove any uncompleted discs that may have been left in the drives and return to the input spindle, making sure they are in the same order as in the 'userdata.txt' file. Be sure to delete any barcodes from userdata.txt that have been completed so that the next disc in the spindle is the first barcode in the file.
***If removing barcodes from userdata.txt, be sure to save a copy of the original file to be used in the BDPL RipStation Ingest process.***
"Unable to close the drive tray"
While using the RipStation or RipStation DataGrabber software to transfer content off of discs, BDPL staff have encountered a situation where a disc is loaded into a drive and the software produces an error message indicating it is 'Unable to close the drive tray' and that the batch has completed, even though other discs are remaining. An example of the DataGrabber output window is below:
This problem appears to be caused by optical media that are not correctly formatted or finalized. To confirm, remove the problematic disc from the RipStation and attempt to open on one of the BDPL workstations. If the disc cannot be read, skip it and restart the batch process. Be sure to delete any barcodes from userdata.txt that have been completed so that the next disc in the spindle is the first barcode in the file.
***If removing barcodes from userdata.txt, be sure to save a copy of the original file to be used in the BDPL RipStation Ingest process.***