Installing the RdbmsNetwork driver and rdbDatabase device

The following procedures describe how to install, configure, and test the RdbmsNetwork driver:

    Install the RdbmsNetwork Driver

    To install the RdbmsNetwork Driver for use with rdbDb2, rdbHsqlDb, rdbMySQL, rdbOracle, or rdbSqlServer, do the following:

  1. Double-click the station’s Drivers container, to bring up the Driver Manager.
  2. Click on the New button to bring up the New network dialog. For more details see “Driver Manager New and Edit” in the Drivers Guide.
  3. Select Rdbms Network, number to add: 1 (or more if multiple networks) and click Ok. This brings up a dialog to name the network(s).
  4. Click Ok to add the Rdbms Network(s) to the station.

    You should have an Rdbms Network named “RdbmsNetwork” (or whatever you named it) under your Drivers folder showing a status of "{Ok}" and enabled as "true".

  5. Double-click the Rdbms Network you have just added and click the New button at the bottom of the Device Manager view to get the New device dialog. In Type to Add select the desired Rdbms Network Driver Device Database.
  6. Select number to add: 1 (or more if multiple devices) and click Ok. This brings up a dialog to name the database device(s).
  7. Click Ok to add the Database Device to the Rdbms Network.

    You should have an Rdbms Network Driver Device Database under your Rdbms Network Driver.

    Configure the RdbmsNetwork driver

    To configure the RdbmsNetwork driver in your NiagaraAX station, do the following:

  1. In WorkbenchAX, under the RdbmsNetwork node, right-click on the Database Device Component node Graphic in the nav tree and select Property Sheet from the popup menu. The Database Device Property Sheet view displays.
  2. In the Property Sheet view, set values for the all the properties applicable to the Database Device.

    A full list of all the properties in each of the RdbmsNetwork driver devices is shown in the table below.

    Those properties marked with a ‘-’ are not available in the driver device and some of the properties are provided only for information. Those properties marked with a ‘X’ should be considered for configuration.

    Refer to About the RdbmsNetwork device components and extensions for a full description of the properties.



    Table 1  RdbmsNetwork driver properties

    Property Db2 HsqlDb MySQL Oracle SqlServer
    Status (Information)          
    Enabled X X X X X
    Fault Cause (Information)          
    Health (Information)          
    Alarm Source Info X X X X X
    Host Address X - X X X
    User Name X X X X X
    Password X X X X X
    Worker X X X X X
    Export Mode X X X X X
    Use Unicode Encoding Scheme X X X X X
    Timestamp Storage X X - X X
    Points X X X X X
    Sql Scheme Enabled X X X X X
    Base Directory - X - - -
    Database Name X X X - -
    Instance Name - - - - X
    Service Name - - - X -
    Port X - X X X
    Histories X - X X X
    Extra Connection Properties - - X - X
    Version - - - - X
  3. Click the Save button to save all property settings.

    Test the RdbmsNetwork connection

    The following procedure applies to any type of rdbDatabase driver.

    To test the RdbmsNetwork Connection, do the following:

  1. Right-click on the RdbmsDatabase Device Extension Graphic in the Property Sheet view (or nav tree) and select Actions Ping from the popup menu, as shown below.

    Graphic

    If a valid connection to the database is made, the Health Graphic property displays an "Ok" value. If the Health property displays a "Fail" value, then a connection is not made and you should examine the Last Fail Cause property for details