4.6. Archiving with Tessella Preservica

SoapGenerator

Preservica ingest is made up of three parts. The first two of these are performed by a program called SoapGenerator. First of all, the program copies all the data being ingested to the relevant folders so that Preservica can read them. The second step involves creating a configuration file soap.xml using database information about the process. The configuration file contains information that is required to generate the SOAP call. It is also used to store the account data and parameters (e.g. securityTag, CollectionName and schemaName) required for Preservica.

Starting the SOAP Generator

/usr/bin/java -jar /opt/digiverso/goobi/scripts/SoapGenerator.jar
-sd {tifpath}
-fn {processtitle}
-mp {importpath}
-p {processid}
-cf /opt/digiverso/goobi/scripts/soapGenerator.properties

Parameters

Parameter

Possible Goobi variable

Meaning

-sd, --sourceDirectory

{tifpath}

Source material to be ingested

-fn, --foldername

{processtitle}

Indicates names to be given to folders during SDB ingest. This is necessary for unambiguous allocation

-mp, --metadataPath

{importpath}

Path to which AMD metadata are to be copied back

-p, --processId

{processid}

ProcessID, required for the database search

-cf, --configFile

/opt/digiverso/goobi/scripts/soapGenerator.properties

Path to the SoapGenerator’s configuration file containing path data, database access data, etc.

TaskClient

Starting the TaskClient

Once the SoapGenerator has finished its work, the TaskClient is called using the following parameters:

/usr/bin/java -jar /opt/digiverso/taskmanager/bin/TaskClient.jar
-itm http://localhost:8080/itm/service
-d {processpath}
-s {tifpath}
-e -i {stepid}
-T {processtitle}
-t SDB
-n soap.xml
-gid {processid}

Parameters

The command parameters are explained in the following table:

Parameter

Possible Goobi variable

Meaning

-itm

http://localhost/itm/service

URL to intranda TaskManager interface

-e, --returnError

-

If entered, the TaskClient will end with an error code to prevent the workflow from continuing automatically.

-p

0 – 10

Priority to execute this job

-gid

{processid}

Goobi process ID

-i

{stepid}

ID for the workflow step that launches the call

-T, --title

{processtitle}

Goobi process title for which the call is launched

-t, --jobtype

SDB

Job type

-n, --templatename

soap.xml

Name of previously generated configuration file

-s, --source

{tifpath}

Path to media directory for the process

-d, --destination

{processpath}

Path to main process directory

Further operation

This call generates an Preservica job in the intranda TaskManager. This type is different from other job types. The upload consists of a SOAP call to the Preservica. The SOAP call is made up of values in the process-specific configuration file soap.xml.

The intranda TaskManager now monitors the AMD output folder for an XML file. If it finds this file, it is placed in the corresponding process folder.