Editing Workflow:Flashback project - optical media imaging workflow

<!-- Fill out the infobox below with the main details of your workflow..>
<!-- The status entry has suggested fields - keep the one you want, delete the rest. Add a new one only if necessary -->
<!-- Separate each item in your list of tools with <br />. Link to COPTR entries where possible. 3 example tools are listed - delete and edit as appropriate -->
<!-- Input should be a brief statement on what data or content provides an input to the workflow -->
<!-- Output should describe the resulting data or content the workflow creates -->

{{Infobox_COW
|name=Flashback project - optical media imaging
|status=Production
|tools=[[BitCurator]]<br />[[CDRDAO (CDR Disk At Once)]]<br />Toc2Cue<br />BChunk<br />GenISOImage<br />Sophos AV Scan
|input=
|output=
|organisation=[https://www.bl.uk/digital-preservation British Library]
}}

==Workflow Description==
<!-- Use the line below to add an diagram image, or delete the line if you don't want one -->
[[File:Optical media workflow.png]]<br><br>
This workflow is used by the British Library's Digital Preservation team to capture, test and preserve the contents of hand-held optical media in the Library's collection. The workflow is largely automated, though command line arguments can be used to force particular run-time options. Please note that this workflow does not cover the imaging of magnetic media (i.e. floppy disks), nor does it include other parts of the pre-ingest workflow such as cataloguing and scanning of printed materials.<br><br>
The workflow is performed within a dedicated and customised BitCurator environment, including a number of additional tools which will be listed below.<br>
===Main Workflow - Start===
* Check the number of sessions and tracks on the disc using CD-INFO.
** If there is only one session and one track on the disc, then proceed on the '''DD branch'''.
** If there is only one session on the disc but multiple tracks, then check what runtime arguments have been provided:
*** If the user has selected 'PlayStation mode' then proceed on the '''DD branch'''.<br>''Playstation discs imaged using CDRDAO are left with 'holes' in the data which cannot be read''
*** If the user has not selected 'PlayStation mode' then proceed on the '''CDRDAO branch'''.<br>''Multi-track discs are generally mixed-mode discs from which audio content needs to be extracted separately''
** If there is more than one session on the disc, then proceed on the '''CDRDAO branch'''.<br>''Each session on the disc needs to be captured separately''
===DD Branch===
* Use MD5SUM to create an MD5 checksum hash directly from the source media by addressing the device directly (e.g. as /dev/sr0 rather than /media/<user>/mountpoint)
* Create a bitwise image of the source media using DD (including SYNC and NOTRUNC options)
* Use MD5SUM to create an MD5 checksum hash from the bitwise image. Check that this hash value matches that created from the source media.
* Proceed to '''Main Workflow - End'''
===CDRDAO Branch===
* Use CDRDAO (CD Read-At-Once) to create BIN (binary image) and TOC (table of contents) files for each session on the disc.<br>
* Use TOC2CUE to convert each TOC file to a CUE (cue sheet) file.<br>''The BinChunker tool requires a CUE rather than a TOC file for each session''
* Use BCHUNK (BinChunker) to extract the audio and data content from each BIN file, using its CUE file as a guide.
** Any Audio content on the disc is extracted in WAV format
** Any file system on the disc is extracted in ISO format
* Depending on where any file system was located on the disc - i.e. whether it was before or after any audio tracks - the resulting ISO files may or may not be navigable. For each ISO file extracted:
** Create a temporary image file zero-padded with the appropriate byte offset (obtained using the data produced by CDRDAO).
** Use DD to copy the bytes of the ISO file directly to the new temporary file.<br>''This file is regarded as temporary as it is not usable within an emulator or VM''
** Mount the temporary ISO file as a read-only file system.
** Use GENISOIMAGE to create a new ISO9660 image containing the files in the temporary ISO image.<br>''This file can be viewed in an emulator or VM and is effectively an access copy''
** Umount the temporary ISO file.
** Proceed to '''Main Workflow - End'''
===Main Workflow - End===
* Attempt to mount the image file as read-only.
* List and perform shallow identification of all files contained in the mounted disc image.<br>''The standard Linux commands LS and FILE are used for this purpose, but other tools such as DROID and Siegfried could be substituted''
* Virus scan all files contained in the mounted disc image.
* Unmount the image.
* Move files to temporary storage area, optionally to a quarantine location depending on whether viruses or potentially unwanted applications (PUAs) were detected in the image.

==Tools Used==
* BitCurator
** dd (standard Unix copy & convert tool)
** md5sum (standard Unix MD5 checksum calculation tool)
** mount (standard Unix filesystem mount tool)
** ls (standard Unix file list tool)
** file (standard Unix file identification tool) 
* [https://www.gnu.org/software/libcdio/ libcdio]
** cd-info (get session & track information for optical media)
** iso-info (get information for an ISO9660 filesystem)
* [http://cdrdao.sourceforge.net/ cdrdao]
** cdrdao (CD authoring & ripping tool)
** toc2cue (convert TOC files to CUE files)
* [http://he.fi/bchunk/ BinChunker for Unix/Linux]
** bchunk (convert raw BIN images to ISO data tracks and CDR/WAV audio tracks)
* [https://wiki.debian.org/genisoimage genisoimage]
** genisoimage (create ISO9660 file system as ISO file)
* [https://community.sophos.com/kb/en-us/14378 Sophos Antivirus]
** savscan (sophos antivirus scan) 
<!-- Describe your workflow here. Provide a list of each tool or component in your workflow if it expands on the basic list of tools and links in the infobox above, but don't duplicate for the sake of it-->

==Purpose, Context and Content==
The British Library has thousands of CDs, DVDs and floppy disks in its collection, and practices for managing them vary throughout the organisation. Known disks date back to the early 1980s. The age of these media means that preservation action is now overdue. The Library must image these media and ensure that the content is preserved properly so that it can ultimately be accessed and used by readers. To this end, we have developed an adaptable workflow that allows the capture of images from both magnetic and optical media. This section of the workflow deals specifically with optical media - CDs and DVDs - and aims to capture the contents of such discs, in a useable format, reliably, and with minimal operator intervention.
<!-- Describe what your workflow is for - i.e. what it is designed to achieve, what the organisational context of the workflow is, and what content it is designed to work with -->

==Evaluation/Review==
This workflow has undergone a number of changes since it was initially developed in 2016 - the imaging of multi-session and multi-track discs presented a challenge which required the workflow to 'branch' at an early stage depending on the properties of the disc.
<!-- How effective was the workflow? Was it replaced with a better workflow? Did it work well with some content but not others? What is the current status of the workflow? Does it relate to another workflow already described on the wiki? Link, explain and elaborate -->

==Further Information==
<!-- Provide any further information or links to additional documentation here -->
Johan van der Knijff's excellent blog post [http://openpreservation.org/blog/2017/04/25/imaging-cd-extra-blue-book-discs/ Imaging CD-Extra / BlueBook discs] goes through each step of the process to create an image of a mixed audio/data CD - though the specific tools used at each stage may differ, he provides detailed output for each step and clearly explains the challenges encountered along the way.

<!-- Add four tildes below ("~~~~") to create an automatic signature, including your wiki username. Ensure your user page (click on your username to create it) includes an up to date contact email address so that people can contact you if they want to discuss your workflow -->

<!-- Note that your workflow will be marked with a CC3.0 licence -->
[[Category:COW Workflows]]