5.3.5 uploadClient

The Upload process provides a single API to upload new incoming archives. This query can take 4 parameters:

• descriptive meta-data to concatenate into the /etc/mediatex/mdtx-COLL/catalogXXX.txt (see catalog.txt) file.
• extraction rules to concatenate into the /etc/mediatex/mdtx-COLL/extractXXX.txt (see extract.txt) file, when the new incoming archive provided is a file container (TGZ…).
• a new incoming archive file
• a target path where to upload the file into the cache.

Checks are made to optimise the meta-data consistency so the provided meta-data files are first parsed into memory, using the same parsers as usual. Because we always assert that an archive description should be linked to an existing archive, we cannot upload here descriptions without a related archive or extraction rules. To do it, you will have to edit or concatenate yourself the /etc/mediatex/mdtx-COLL/catalogXXX.txt (see catalog.txt) file.

Process conceptual model:

• Events in

  $ mediatex upload[+] [file file [as target]]* [catalog file] [rules file] to coll coll

  from PUBLISHER (see Who), Syslog (see Syslog), conrHourly-cronDaily (see cronHourly-cronDaily) or audit (see audit): upload an incoming archive into the cache.

• Processing
  • parse the provided meta-data,
  • check archive is not already into the current extraction rules,
  • Add an entry to /etc/mediatex/mdtx-COLL/extractXXX.txt (see extract.txt) file, into the dedicated INC container and associated with current date,
  • ask daemon to upload the incoming archive files.
  • concatenate new meta-data into both /etc/mediatex/mdtx-COLL/catalogXXX.txt (see catalog.txt) and /etc/mediatex/mdtx-COLL/extractXXX.txt (see extract.txt) files,
  • ask daemon to reload,
• Events out

  <upload>

  to uploadServer (see uploadServer): ask SERVER to upload an incoming archive into its cache.

• Data in/out
  • /etc/mediatex/mdtx-COLL/extractXXX.txt (see extract.txt)
• Data out
  • /etc/mediatex/mdtx-COLL/catalogXXX.txt (see catalog.txt)

Examples:

• Adding new archives: see Scenario 4.

Code:

src/client/upload.c