Skip to main content

Support

Installation of Tools

Tools provided by the National Digital Preservation Services (DPS) in Finland are packaged and distributed using a public RPM repository (RPM = Red Hat Package Manager). All DPS RPM packages are tested on AlmaLinux 9 (x86_64).

The publicly available tools are also found as git repositories in GitHub. The installation instructions below focus on the RPM installation.

DPS Tools Available as RPM Packages

The list below is updated when necessary.

Pre-Ingest Library

python3-dpres-siptools-ng - The Pre-Ingest Library creates submission information packages (SIP) according to the DPS specifications. The library creates a valid SIP from supplied descriptive metadata and content files. The library can create all mandatory technical and structural metadata and combine these with the supplied information to a METS document. The METS document is digitally signed and packaged together with the content files into a SIP archive file, ready to be submitted to the DPS for ingest.


Library for Creating METS Documents

python3-dpres-mets-builder – This library is used for creating METS documents according to the DPS metadata specifications. The library is used as a part of the Pre-Ingest Library, but it can also be used directly for customized needs. It can be used together with the Pre-Ingest Library.


Tool for Analysing Files

python3-file-scraper-full - This tool is for file and bit stream analysis and validation. The tool detects and identifies file formats, extracts technical metadata and performs well-formedness checks on files.


Client for Accessing DPS Interfaces

dpres-access-rest-api-client - This tool is a client for accessing the interfaces specified in the DPS interfaces specifications. The client tool automates many queries making the use of the interfaces more user friendly.


Information Package Tools

python3-dpres-ipt - This library contains tools for validating submission information packages (SIP) and dissemination information (DIP) packages.


Tool for Upgrading Information Packages

python3-dpres-specification-migrator - This tool is used for upgrading a METS document into a newer version of the DPS specifications.


Tool for Signing Information Packages

python3-dpres-signature - This tool is used for creating and validating digital signatures for submission information packages. Used e.g. by the Pre-Ingest Tool.


Metax Access

python3-metax-access - A command line tool for managing content in the Metax metadata repository. For users of the Digital Preservation Service for Research Data.


Tool for Tailored Packaging of Contents

python3-dpres-sip-compiler - This tool is used for tailored submission information package creation (SIP). The tool is built as a wrapper around the deprecated Pre-Ingest Tool, and further automates SIP creation in a customised and user-tailored process.


Pre-Ingest Tool (deprecated)

python3-dpres-siptools - The Pre-Ingest Tool creates submission information packages (SIP) according to the DPS specifications. The tool has been deprecated and is no longer maintained. We suggest using the Pre-Ingest Library instead.

Installation

Packages can be installed on AlmaLinux 9 from the address pas-jakelu.csc.fi as follows:

Installing the public RPM repository (run these only once)

  1. Download the public key for the RPM repository:

    sudo rpm --import https://pas-jakelu.csc.fi/RPM-GPG-KEY-pas-support-el9
  2. Install 'dnf config-manager', required to install the public RPM repository, from dnf core plugins :

    sudo dnf install dnf-plugins-core
  3. Download the RPM repository:

    sudo dnf config-manager --add-repo=https://pas-jakelu.csc.fi/pas-jakelu-csc-fi.repo
  4. Download repositories required by third party installations (epel and rpmfusion):

    sudo dnf config-manager --set-enabled crb
    sudo dnf install epel-release
    sudo dnf install --nogpgcheck https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm

These four steps are only run once, since the RPM repository doesn't need to be installed repeatedly on the same machine.

Installing the RPM packages

After the RPM repository has been installed, the RPM packages can be installed using this command:

sudo dnf install PACKAGE_NAME

PACKAGE_NAME is the name of the tool that is installed, for example python3-file-scraper-full. Installed packages can be updated with the command:

sudo dnf update PACKAGE_NAME