Electricity GUI Installer Setup

Downloading the application

The latest version is Participant Data Replication Batcher GUI Installer 7.6. For download locations, see 1.14 Data Interchange resources Data Interchange resources.

Decompress the .ZIP file to a work folder to create a .JAR file. The .JAR file is the installation file referenced elsewhere in this document.

Environment prerequisites

The Participant Data Replication Batcher needs:

  • A set of local working directories, generally being the integration point with the Participant Data Replication Loader product.
  • Connectivity to a data source, either remote (FTP) or local (a directory). To read from an FTP server, the Participant Data Replication Batcher requires host, username, and password details.

AEMO’s file servers only support FTP. Instances of the Participant Data Replication Batcher connecting to AEMO’s file servers must use FTP.

Installation

The following section outlines the steps required to successfully install and configure the pdrBatcher application:

  1. Validate the jar file signature. From the command line prompt, run the following command:

    jarsigner -verify "Participant Data Replication Batcher GUI Installer v7.6.0.jar"

    For more information, see https://docs.oracle.com/en/java/javase/21/docs/specs/man/jarsigner.html

  2. To start the installer, double-click the installation file (.JAR) and click Next.

  3. Accept the terms of the licence agreement and click Next.

  4. Select the installation detail by clicking the required checkboxes and click Next.

    • pdrBatcher Core: Mandatory, being the standard software installation.
    • Electricity MMS: Enables replication of NEM data.
    • Gas Supply Hub: Enables replication of GSH data.
    • Gas Bulletin Board: Enables replication of GASBB data.
    • Windows Service: Select this option if the pdrBatcher software is to run as a Windows service. This option is unavailable for installations on unix-type operating systems.
    • pdrLoader Integration: Select this option if this installation of pdrBatcher is to connect with an existing pdrLoader installation.
    • Secured API services: The secured API services option allows the installation to be configured with a self signed certificate to encrypt API communications from PDR monitor to the pdrBatcher.

      AEMO recommends you to select this option for cyber security purposes.

      De-selecting this option results in plain text HTTP communications between PDR Monitor and the pdrBatcher.

      The self signed certificate has a 365 day expiry period. Participants need to re-generate a new certificate before the expiry date to allow monitor communications to continue.

      Participants may also choose to use a certificate issued by an external Certificate Authority, however AEMO does not support this as a part of the AEMO GUI installer.

      In this case, participants must register their certificate manually using command line tools.

      Please refer to the certificate management section of the user guide for further information on certificate management..

    • Advanced: Select this option only to override advanced configuration properties such as the Windows Server name or the location of the Java Runtime Environment used to run the application.
  5. Select the location to install the application and click Next.

    If you want to use an existing directory, click Browse and select the installation location.

  6. Enter the required configuration details and click Next.

  7. The required fields are:
    • Participant ID: Your participant identifier.
    • Password Encryption Key: A 16-digit hexadecimal code (A-F,0-9) to secure your password.
    • Instance ID: Instance identifier that uniquely identifies this pdrBatcher installation
    • MarketNet user account: The user account to access AEMO’s systems, generally of the form “NEMNET\your_account”.
    • MarketNet account password: the password associated with the MarketNet user account.
    • pdrLoader install directory: Required if the pdrLoader Integration installation option is selected. Choose the home directory of your local pdrLoader software installation.
    • Source environment: Select either EMMS production or EMMS Pre-production. Selecting Other environment allows you to enter a customised IP address.
    • Web server port: Choose a port number for the web services interface. This must be unique across all installations of pdrBatcher and pdrLoader on this server.
    • Windows service name: Required if the Advanced installation option is selected. The default Windows service name is pdrBatcher.
    • JRE install directory: required if the Advanced installation option is selected. The home directory of the Java Runtime environment used to run the pdrBatcher application.
  8. The processing form displays, configuring your software installation according to the selected option and settings. If an error occurs, click Previous and correct the required settings.

  9. Once the installation is complete, the finish form displays. Click Done to close the installer.

    The “Generate an automatic installation script” button is an advanced option used to generate a configuration file used for silent installs. It is recommended for advanced users running multiple installations.

Testing your installation

Once your installation is complete, you can test it is working correctly using the following steps:

  1. Start the application using the method most suitable for your installation and environment:
    • For a Windows service installation, start the service from the windows service panel.
    • For a Windows console installation, start the application by double-clicking the pdrBatcher.bat in the Lib subdirectory.
    • For a Unix installation, start the application by running the pdrBatcher.sh shell script in the Lib directory.
  2. Check the contents of the pdrLoader log file located in the Log folder and ensure that there are no messages with an ERROR status. In the event of ERROR messages, check all parameters, your environment, and repeat the installation if necessary.