Administrator manual¶

Below you’ll find an outline of the chapters in the administrator manual, and a set of links to each chapter’s main sections.

Installing Archivematica
- Overview
- Technical requirements
- Instructions for new installations
- Instructions for upgrades
- Advanced installation options
Manually Installing Archivematica on Ubuntu
- Ubuntu 22.04 (Jammy) installation instructions
- Post-install configuration
Installing Archivematica on Rocky Linux 9
- Installation instructions
- Post-install configuration
Automated installation using Ansible
- Installation instructions
- Deploy development branches
Advanced installation options
- Install for development
- Scaling Archivematica
- Configure Archivematica with SSL
Upgrade from Archivematica 1.14.x to 1.15.1
- Clean up completed transfers watched directory
- Create a backup
- Upgrade on Ubuntu packages
- Upgrade on Rocky Linux/Red Hat packages
- Upgrade on Vagrant / Ansible
- Upgrade in indexless mode
- Upgrade with output capturing disabled
- Update search indices
  - Reindex the documents
  - Recreate the indices
- Review the processing configuration
- Migrate from MySQL 5.x to 8.x
Customization and automation
- Administration tab
- Automating microservice decisions using the dashboard
- Preservation planning configuration
- Antivirus configuration
- Email notification configuration
- Resources for development configuration
- Task output capturing configuration
- Customizing for scalability and performance
Dashboard Administration tab
- Processing configuration
  - Using a custom processing configuration file
- General
- Failures
- Transfer source location
- AIP storage locations
- Processing storage usage
- DIP upload
  - AtoM/Binder DIP upload
  - ArchivesSpace DIP upload
- PREMIS agent
- Rest API
- Users
- Handle server config
- Language
- Version
Antivirus administration
- Clamdscan or Clamscan
- Antivirus settings and their impacts
- Configuration of ClamAV values
  - Ansible
  - Docker Compose
- Impact of various configuration settings
- Virus definition updates
- Troubleshooting
Task output capturing configuration
Scaling Archivematica
- Overview
- Scaling up: optimising on one machine
- Scaling out: optimising across multiple machines
  - Distributing components on multiple machines
  - Optimising settings across machines
- Process configuration strategies
Performance instrumentation
- Overview
- Prometheus
- Grafana
- Available metrics
- Configuration
  - Configure Prometheus
  - Configure Grafana
Integrations
- AtoM integration
- ArchivesSpace integration
- Avalon Media System integration
- Binder integration
- Duracloud
- Swift
- Islandora
- Arkivum
- Handle.Net integration
- Dataverse
Using DuraCloud with Archivematica
- Configure DuraCloud
- Configure the Archivematica Storage Service
Using AtoM 2.x with Archivematica
- Install AtoM
- Configure DIP upload
- User instructions
Using Binder with Archivematica
- Install Binder
- Configure DIP upload to Binder
- User instructions
Using ArchivesSpace with Archivematica
- Connecting Archivematica and ArchivesSpace
- Sending material to ArchivesSpace
  - Matching objects to ArchivesSpace resources on the Appraisal tab
  - Uploading to ArchivesSpace using DIP upload
Using Handle System with Archivematica
- Connecting Archivematica and Handle.Net
- Binding PIDs to a Handle.Net registry
Maintenance
- Management commands
- Maintaining Elasticsearch
  - Rebuild the indexes
  - External access
- Data backup
- FAQ
Security
- Elasticsearch access control
- MySQL
- AtoM
- Gearman
- Authentication backends
- Password validation
- Cookie and session security
- Content Security Policy (CSP)
  - CSP configuration in Archivematica Dashboard
  - CSP backend configuration in Storage Service
- CA certificates
  - Upgrade the certifi package frequently
  - Use the environment string REQUESTS_CA_BUNDLE
    - Trusting additional CAs