Product Distribution User Guide

Introduction

The Product Distribution Layer (PDL) is a USGS platform for exchanging information about seismic events such as earthquakes and landslides. It provides a standard method for bundling textual and multimedia data into a package called a product.

Products are created by USGS and non-USGS clients, distributed using PDL, and received by various USGS and non-USGS automated systems such as Real-time Earthquake Maps, the Comprehensive Catalog of seismic events (Comcat), ShakeMaps, the PAGER earthquake alert system and the Earthquake Notification Service. PDL is designed to support both existing and future needs for seismic information.

PDL focuses on distribution and triggering, and integrates with other systems for processing. After a product is created it is sent to a distribution hub. The distribution hub creates a notification that includes a URL where the full product can be downloaded. Clients connect to the distribution hub and receive notifications about available products. Based on configuration, a client may choose to download and process a product.

PDL provides two primary alternatives for processing products: a java API for direct integration, and a command line api for applications to be executed when products are received.

The Product Tracker is an external, opt-in system that tracks product activity, including product receipts, sends, downloads and notifications.

Documentation

• System Overview
• Installation Instructions
• Sending Products
• Receiving Products
• Tracking Products
• Configuration
• Command Line Arguments
• Product Reference
• Monitoring
• Troubleshooting
• Java API
• System Change Log

System Requirements

• OpenJDK or Oracle Java Runtime Environment (JRE) version 1.8 or newer. GNU Java (gij or GNU libgcj) should NOT be confused with Java.

  You can find your version of java by running

  java -version
  
  java version "10.0.2" 2018-07-17
  Java(TM) SE Runtime Environment 18.3 (build 10.0.2+13)
  Java HotSpot(TM) 64-Bit Server VM 18.3 (build 10.0.2+13, mixed mode)
  

  Download Java from http://www.java.com/

• An active Internet Connection

Downloads

Versions and Release Notes can be found on GitHub: https://github.com/usgs/pdl/releases

Download and unzip ProductClient.zip This includes shell scripts for unix and a batch file for windows. https://usgs.github.io/pdl/ProductClient.zip

You can upgrade to the latest version by replacing ProductClient.jar and restarting the process. https://usgs.github.io/pdl/ProductClient.jar

See the Installation Instructions for more details.