ProData DBU RDi for IBM i

RPG Summit 2016: Presentation slides available here.

ProData DBU RDi for IBM i consists of 2 main components:
  1. DBU RDi Server
    • Runs on a network-accessible machine.
    • Required for RDi users to run the DBU RDi application.
  2. IBM Rational Developer DBU RDi Plugin
    • Download and install within IBM Rational Developer.
    • Adds an Open with DBU option upon right-click of a file in RDi.
    • Relies on a network installation of DBU RDi Server.

The programs/procedures below will install an instance of DBU RDi Server on your desired platform (IBM i or Windows). Upon successful installation of the server and RDi plugin (detailed below), DBU RDi Client users will be able to open files with DBU in RDi.

ProData DBU RDi for IBM i Server (IBM i)

System Requirements
  • IBM i V5R4 or later
  • 60MB free disk space
  • Java 1.5.x or later
  • Access to TCP port 8205 (must be open and unused)

    • To determine your Java version:

    1. From the command line, run QSH
    2. From the Q-shell prompt, type java -version and press enter
    3. Note the java version "[version number]" in quotes (1.6.0 in the example above)
Installation

IMPORTANT! All users must be logged out of DBU prior to running the following commands.

  1. From the command line, run DBUPTF
    • This will bring in the DBU RDi program files.
  2. Once the DBUPTF process is complete, run DBURDIPTF
    • This will bring in files required to run the DBU RDi Server.
    • The DBU RDi Server should start up automatically upon completion.
  3. Please Note: The DBU RDi Server currently runs under the QINTER subsystem. If this subsystem is shut down at any time (i.e. nightly backups, system reboot, etc.), the DBU RDi Server will also be shut down. You can avoid having to manually restart the DBU RDi Server in such instances by adding the DBURDIRST command to your startup procedures.
Updates

IMPORTANT! All users must be logged out of DBU prior to running the following commands.

  1. From the command line, simply run DBURDIPTF
    • This will bring in any updated DBU RDi program files.
    • The DBU RDi Server should restart automatically upon completion.
    • Should any issues arise, try restarting DBU RDi Server by running DBURDIRST from the command line.

ProData DBU RDi for IBM i Server (Windows) - Download

System Requirements
  • Windows XP SP3 or later
  • 60MB free disk space
  • Java 1.5.x or later
  • Access to TCP port 8205 (must be open and unused)

    • To determine your Java version:

    1. Click the Windows Start menu
    2. In the search box toward the bottom, type cmd and press Enter
    3. When the command prompt appears, type java -version and press Enter
    4. Note the java version "[version number]" in quotes (1.8.0_66 in the example above)
Installation
  1. Download the executable (DBURDi-Server_1.3.1.exe).
  2. Double-click on the DBURDi-Server.exe file.
  3. Follow the prompts to complete installation.
Updates
  • Coming soon...

Requires IBM Rational Developer 9.0 or later

To install the DBU RDi Plugin (assumes RDi is already installed):

(Also see instructions with screenshots)

  1. Open IBM Rational Developer
  2. From the menu bar, select Help > Install New Software...
  3. Enter (or copy & paste) the following into the Work with: field:
  4. Click the Add... button and ensure the Name: and Location: fields contain the following values, then click OK.
    • Name: ProData DBU RDi for IBM i
    • Location: http://www.dodbu.com/dbu-rdi/plugin
  5. IMPORTANT: Ensure the Group items by category checkbox below the Details section is unchecked.
  6. Select the checkbox next to ProData DBU RDi for IBM i, then click the Next > button.
  7. Follow the remaining prompts to complete installation and restart RDi.

If you have trouble installing from the ProData software site, please download the DBU RDi Plugin zip file and install manually.

Note: An instance of DBU RDi Server must be running on a network-accessible machine for the plugin to function properly.