Page History

The Archives Transfer Tool is currently a web-Dropbox based tool transfer app for donors to transfer digital material (often for MIT community groups and members).

The system is a small collection of platforms/tools:

• a Dropbox Shared Folder into which files can saved by end users

• a folder on the NAS (Network Attached Storage) for preparation work on the files before ingest into preservation

• a Python script that moves files and metadata from Dropbox to the NAS

Setting up a transfer

This step is done synchronously with the collections team. Once they create a submission agreement with the group, take the follow steps:

1. Create a subfolder in the Dropbox shared folder that will receive content (including adding the authorized user as an editor of this subfolder)

2. Create a default metadata file with information from the submission agreement that will apply to all the files that will be uploaded to the subfolder

3. Create a subfolder within cdps-processing/ATT to receive the content copied by the Python script from Dropbox

4. Direct a user to follow the steps outlined here to transfer the files.

5. When DDC has been notified that an authorized group transferred a set of files, confirm all have been uploaded to the associated folder in Dropbox

6. Files will now need to be downloaded from Dropbox to the NAS using a Python script before accessioning or processing can begin. The next steps are where the process is handed over fully to the DDC processing team.
   

Getting situated with the ATT python app

1. Make sure that you are logged in to Dropbox in your default web browser

2. Download the latest version of the the ATT repository (which also means you need to have Python 3.x installed on your computer) to your workstation and followed the instructions in the README.

3. Mount the cdps-processing share on your workstation

Moving the files

1. Open Terminal / PowerShell and navigate to the root of the downloaded copy of the interim-att folder.

2. Make sure that your environment is properly configured

   1. you should have a .env file in the folder (see the README for details)

   2. you should have run make install (or make update) to get the rest of the environment configured

3. Run the “check” command to verify that the script can connect to Dropbox and connect to the NAS

   
   

   Code Block
   language bash linenumbers true collapse true
   interim-att % pipenv run att check Loading .env environment variables... 1. Go to: https://www.dropbox.com/oauth2/authorize?response_type=code&client_id=6pvw4x2047kxu4d&token_access_type=offline&code_challenge=<challenge_code>&code_challenge_method=S256 2. Click "Allow" (you might have to log in first). 3. Copy the authorization code. Enter the authorization code here: <auth_code_from_browser> 2025-06-06 12:04:46,793 INFO att.cli.check(): Successful Dropbox OAuth via PKCE 2025-06-06 12:04:47,775 INFO att.cli.check(): SUCCESS: Connected to MIT Dropbox 2025-06-06 12:04:47,777 INFO att.cli.check(): SUCCESS: NAS Folder is connected.

4. Run the “bulk-file-copy” command, passing in the name of the CSV file as the required argument. You will need to include the subfolder you are transferring from in the path to the CSV. For instance, AMITA/sample_csv.csv 

   Code Block
   language bash linenumbers true collapse true
   interim-att % pipenv run att bulk-file-copy --remote-csv "AMITA/sample_csv.csv" initial-application Loading .env environment variables...

5. Navigate to the ATT folder in the cdps-processing share to verify that the files were copied and that the metadata files and checksum manifest files were generated in the correct subfolder.

Packaging the files for further processing

The downloaded folder is not organized in a way that will allow for processing in Archivematica. To do this, you will need to use another tool for logical transfer such as SIPCreator or DART. You can follow the steps on those pages with specifics to content from ATT:

1. When packaging the files, select the files only
2. Once the content has been packaged, add the original metadata files and manifest files to the submissionDocumentation folder as outlined in the section of the tool you used (SIPCreator or DART)
3. When done packaging the files, follow the next steps outlined in those documents.
4. You should go back and clean out the subfolder in Dropbox. Make sure that when you are cleaning up the subfolder that you leave behind the default_metadata.json and sample_csv.csv files!

. A transfer will most likely have been set up by the Collections Team and the digital archivist and the files can be found in the "erst" folder of the submission drive. These instructions explain how to confirm the transfer and get it ready for processing.

...