AIP structure¶

AIP METS file¶

The AIP METS file, /data/METS.uuid.xml, lists all of the digital objects in the AIP (original files, preservation masters, license files, OCR text files, submission documentation, etc.), describes their relationships to each other, and links digital objects to their descriptive, technical, provenance, and rights metadata.

The AIP METS file name is composed from the prefix METS., the UUID of the AIP, and the extension .xml. Note that the presence of the UUID differentiates the AIP METS file from the transfer METS file, described in the Objects section below.

For more information about Archivematica’s METS implementation, see METS in Archivematica.

README file¶

The AIP README file, /data/README.html, is a human-readable file that describes the basic structure of an Archivematica AIP. It introduces Archivematica, OAIS, METS and PREMIS, and other concepts that future users may find helpful when they encounter an AIP.

Logs¶

The logs directory, /data/logs, contains log outputs for some of the tools and tasks that run inside of Archivematica.

This is an example of the contents of an AIP’s logs directory:

my-aip-d31cc44f-ce01-4e67-affe-513868d9cf3d
└── data
    └── logs
        ├── arrange.log
        ├── fileFormatIdentification.log
        ├── filenameChanges.log
        └── transfers
            ├── first-transfer-abbff451-f077-4f66-a6e0-d83f6ebbeebf
            │   └── logs
            │       ├── fileFormatIdentification.log
            │       └── filenameChanges.log
            └── second-transfer-52fd11fa-fca8-4bc7-9214-e6510863759a
                └── logs
                    ├── fileFormatIdentification.log
                    └── filenameChanges.log

The top-level logs (arrange.log, fileFormatIdentification.log, etc.) are outputs for tasks that took place either in the Appraisal tab or on the Ingest tab. For example, data/logs/fileFormatIdentification.log is the log that was created during the Identify file format job that takes place during the Normalize microservice on the Ingest tab.

The logs directory has a transfers subdirectory, /data/logs/transfers, which contains logs for tools that ran on the Transfer tab. Since it is possible to combine multiple transfers into one SIP (which becomes one AIP), the transfers subdirectory may contain multiple directories. Continuing to use the example above, two transfers (first-transfer and second-transfer) were combined to create one AIP (my-aip). Therefore, there are two more fileFormatIdentification.log files:

• data/logs/transfers/first-transfer-abbff451-f077-4f66-a6e0-d83f6ebbeebf/logs/fileFormatIdentification.log is the log that was created during Microservice: Identify file format on the Transfer tab when first-transfer was processed.
• data/logs/transfers/second-transfer-52fd11fa-fca8-4bc7-9214-e6510863759a/logs/fileFormatIdentification.log is the log that was created during Microservice: Identify file format on the Transfer tab when second-transfer was processed.

The example above does not show all possible logs. Depending on how you have set your Processing configuration, you may see a greater or lesser number of logs or logs of different types in your AIP.

Objects¶

The objects directory, /data/objects, contains original objects, preservation masters, and two folders: /metadata and /submissionDocumentation. If the SIP contained any lower-level directories, either from the original transfer or because it was arranged on the Appraisal tab, the lower-level directories will be present as well.

my-aip-d31cc44f-ce01-4e67-affe-513868d9cf3d
└── data
    └── objects
        ├── 799px-Euroleague-LE_Roma_vs_Toulouse_IC-27-3e2bcabd-f33f-485b-a566-ff71c141b930.tif
        ├── 799px-Euroleague-LE_Roma_vs_Toulouse_IC-27.bmp
        ├── BBhelmet.ai
        ├── G31DS-60559b5e-38a5-44f5-8c63-bb41bda5d2e8.tif
        ├── G31DS.TIF
        ├── metadata
        │   └── transfers
        │       ├── first-transfer-abbff451-f077-4f66-a6e0-d83f6ebbeebf
        │       │   ├── directory_tree.txt
        │       │   └── metadata.csv
        │       └── second-transfer-52fd11fa-fca8-4bc7-9214-e6510863759a
        │           └── directory_tree.txt
        └── submissionDocumentation
            ├── transfer-first-transfer-abbff451-f077-4f66-a6e0-d83f6ebbeebf
            │   └── METS.xml
            └── second-transfer-52fd11fa-fca8-4bc7-9214-e6510863759a
                └── METS.xml

The filenames of original objects will be unchanged. Preservation master copies have a UUID appended to the filename. In the example above, 799px-Euroleague-LE_Roma_vs_Toulouse_IC-27.bmp is the original object and 799px-Euroleague-LE_Roma_vs_Toulouse_IC-27-3e2bcabd-f33f-485b-a566-ff71c141b930.tif is the preservation master. The creation of preservation master copies is guided by the rules on the Preservation planning tab.

The /metadata directory contains metadata associated with the AIP. The metadata directory has a transfers subdirectory, /data/metadata/transfers, which separates the metadata files into folders specific to the transfer where they originated. Since it is possible to combine multiple transfers into one SIP (which becomes one AIP), the transfers subdirectory may contain multiple folders.

The /submissionDocumentation directory contains submission documentation for the AIP. Similar to the metadata directory, there is a transfers subdirectory, /data/submissionDocumentation/transfers, which separates the submission documentation files into folders specific to the transfer where they originated. Since it is possible to combine multiple transfers into one SIP (which becomes one AIP), the transfers subdirectory may contain multiple folders. Note that the transfer folders contain a METS.XML file - this is the transfer METS, which was generated for each transfer on the Transfer tab. When the transfer (or multiple transfers combined) become a SIP, the transfer METS files are combined into a new METS file which becomes the AIP METS file.

Thumbnails¶

The objects directory, /data/thumbnails, will contain thumbnail images if you chose to generate them during the Normalize for thumbnails job.

my-aip-d31cc44f-ce01-4e67-affe-513868d9cf3d
└── data
    └── thumbnails
        ├── 0e9fd6db-ac57-453c-ba0f-c9cff9d0ac56.jpg
        ├── 7d1c5e44-f1e1-4cf7-8b79-ca2284a6ce79.jpg
        └── dd1a6fb8-7e49-47ca-921b-87b234c939b9.jpg

The creation of thumbnails is optional and configurable in the processing configuration.

Back to the top