Folders

Decompressing the distribution file creates a directory (\pdr\batcher) with five subdirectories, collectively called the local directories. One directory (\Lib) contains the application and the other three are working directories for the pdrBatcher:

  1. Holding: Where the pdrBatcher saves files being downloaded from the AEMO file server, then (when complete) the pdrBatcher moves each file to the local directory for subsequent access.
  2. Reports: Where the pdrBatcher puts files after completion of download, or is the source directory for uploads.
  3. Log: Contains log files associated with the transfer process.
  4. Performance: Where the pdrBatcher stores performance and logging data for ingestion into pdrMonitor.

The application files in the \Lib directory include:

  • The main application JAR file (AppPdrBatcher.jar), a range of third party JAR files upon which application depends, and one DLL file (NTEventLogAppender.dll), being the application files.
  • Three properties files (pdrBatcher.properties, pdr_log4j.xml and pdr_key.properties), to provide parameters for the running instance.
  • pdrBatcher.*, to run the application in Windows or Unix environments
  • pdrEnvironment.* containing the definitions of the environment variables required to run the application.
  • pdrConnectionTest.* to validate the connectivity to a data source defined in the properties configuration file.
  • pdrKeyManager.* to show and cycle the HMAC encryption keys used to secure the internal API services consumed by monitor
  • pdrCertificateManager.* to manage the certificate trust stores for consuming secured API services
  • pdrThreadExecute.* A sample wrapper to show how to initiate a batcher thread configured to be controlled by API invocation
  • pdrBatcherTransformTest.* A utility that allows for testing of transform configuration offline before applying these configuration to the properties file.
  • Three files (pdrServiceInstall.bat, pdrServiceUninstall.bat, WinRun4J.jar, WinRun4J.exe, WinRun4J64.exe and WinRun4J.ini) to support the running of the application as a Windows service.
  • pdrPasswordEncrypt.* to generate an encrypted password (see Folders).

For more information on the files within the Lib directory, see "Command line tools"

The only file in the directories other than \Lib is a placeholder file to cause the creation of required directories during the unzipping process, named delete.me. Remove these placeholder files.

Before attempting to run, edit the two properties files (pdrBatcher.properties and pdr_key.properties) to suit your situation.

When setting up the application, the directory structure does not have to be identical to the arrangement described above. By modifying the .properties file, the installer can distribute the directories over different locations.
For example, if setting up a pdrLoader instance, make the pdrBatcher output directory be the loader input directory.