Installation

This is a very short guide on how to get started with PDS4 Packager.

It has a dual purpose:

Requirements

PDS4 packager software is distributed as a standalone Java application. As such, it requires a 64-bit Java8 JRE.

To check whether an appropriate JRE is installed run the following command and check the java version string:

$ java -version
java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)

Installation

The installation of the tool is meant to be very simple:

As an example:

$ curl https://bepicolombo.esac.esa.int/bscs-pds4-packager/downloads/pds4-packager.tar.gz
$ tar xvfz pds4-packager.tar.gz

The tool bundle contains all the necessary components (including the NASA PDS4 validation tool) with the exception of the current approved configuration.

Initial configuration

In order to execute the PDS4 packager, it must first be configured. This can be achieved by executing the following tool:

$ pds4-packager/bin/pds4-packager-config-synchronizer

This script will download the latest approved configuration and set the tool up.

Verifying the installation

To check that the software is properly installed please execute:

$ pds4-packager/bin/pds4-packager -v

The output should not contain any errors and should display the versions of the different components. This is an example:

[INFO ] e.b.p.p.c.PackagerCli: pds4-packager modules: PDS4 packager: 1.4.4 - PDS4 classifiers: 1.4.4 - PDS4 validate: 1.4.4 - PDS4 dictionary bundle: 0.2 - NASA validate: 1.14.0

If any of the versions report as N/A it would imply that the initial configuration script was not executed:

[INFO ] e.b.p.p.c.PackagerCli: pds4-packager modules: PDS4 packager: 1.4.4 - PDS4 classifiers: N/A - PDS4 validate: 1.4.4 - PDS4 dictionary bundle: N/A - NASA validate: 1.14.0

Please note that version numbers may be different to those displayed in the examples above.

First Execution

To package PDS4 products, please execute the pds-packager script located under pds4-packager/bin with the following parameters