Configuring Data Pumps

Before you begin

You need the following information to configure a new data pump:
  • OPC-UA server connection settings
  • Tags must be in a CSV file and include the following fields:
    • Identifier Type
    • Namespace Index
    • Node ID
    • Published Name

    Click Sample CSV to download an example CSV file with the required fields.

About this task

Procedure

  1. In Predix Edge Manager, select Device Manager in the left navigation pane.
  2. Select the device for which to configure the data pump.
    Note: The Data Pumps tab appears only for devices that are running on the Predix Edge platform.
  3. Click the Data Pumps tab.
  4. In the Data Pumps page click Create New to create a new data pump, or click Select Existing to edit an existing data pump.
  5. In the Setup page, enter the following information, then Click Next:
    • Name – Populated by default as <device_ID>_DataPump. You can change this—just be sure the name is unique and meaningful.
    • Version – Enter a version number. The format must be: <version>.x.x
    • Description – (Optional) Enter a description for the data pump.
    You can click Save at this point to save the data pump in the data base so you can finish configuring it later.

    Click Exit to exit the data pump designer. A confirmation dialog gives you the opportunity to save or discard the changes.

  6. In the Services page, enter the information for the protocol adapter and the egress point, then click Next.
    Note: Currently, only the OPC-UA protocol and the Predix Time Series service as an egress point are supported.
    Table 1. OPC-UA
    FieldDescription
    Server IP/HostnameEnter the hostname or IP address for the OPC-UA server.
    TCP PortEnter the TCP port for the OPC-UA server.
    Server Resource PathEnter the resource path for the OPC-UA server. The path name begins with a single forward slash.
    Update TypeChoose from the following update types:
    • Subscription – Select if the OPC-UA server is configured to use a subscription to read data.
    • Polling – Select if the OPC-UA server is configured to use polling to read data.
    Table 2. Time Series
    FieldDescription
    Time Series NameSelect the time series from the drop-down list.
    Time Series Zone IDEnter the Zone ID for the Predix Time Series service tenant.
    Time Series URLContains the API endpoint for communicating with the service, which varies according to the region where your Predix account is located. For example:

    wss://gsvc.aws-usw02.ice.gecis.io/v1/stream/messages

    You can click Save at this point to save the data pump in the data base so you can finish configuring it later.

    Click Exit to exit the data pump designer. A confirmation dialog gives you the opportunity to save or discard the changes.

  7. In the Tags window, click Choose File to upload a CSV file (or drag and drop the CSV file) containing the tags, then click Import.
  8. In the Deploy window, you can save and deploy the data pump, or save it now and deploy it later.
    OptionDescription
    SaveSaves the data pump in the database.
    Save and DeploySaves and deploys the data pump.
    ExitExits the data pump designer. A confirmation dialog gives you the opportunity to save or discard the changes.
    If tags already exist in the table, you get an error message with the duplicate node IDs (along with any other errors). If this happens, you need to update your CSV file offline and re-upload it.