Configuring Predix Cloud Services

Use Edge Manager to configure edge device data rivers, with the service instance ID, URL, scopes, and so on, to point to the specified Predix cloud services.

Before you begin

You must set up the services before you can configure them in Edge Manager.

About this task

The Settings > Services tab In Edge Manager allows you to configure the details (service instance ID, scopes, URL, and so on) for Predix cloud services connected to edge devices. You can also view, reset, and update configured services.

Procedure

  1. In the left navigation pane, click Settings.
  2. Click the Services tab.
  3. Enter the information for the service to configure, and click Save.
    • Service Name – Name of the cloud service, for example, predix-time-series.
    • Service Instance Name – Name you specified when you created your service instance, for example: my-predix-time-series-service-instance.
    • Service Instance ID – Unique identifier (GUID) of the service instance. This is generated when the service instance is initially created.
    • Service URL – Contains the API endpoint for communicating with the service, which varies according to the region where your Predix account is located. For example, for a US West Predix account:

      wss://event-hub-pr.svc.aws-usw02.ice.gecis.io/v1/stream/messages/

    • Scopes – Each service requires specific scopes. For example, the Time Series service requires the following scopes:
      • For data ingestion:
        • timeseries.zones.<Predix-Zone-Id>.user (added by default)
        • timeseries.zones.<Predix-Zone-Id>.ingest
      • For data queries:
        • timeseries.zones.<Predix-Zone-Id>.user (added by default)
        • timeseries.zones.<Predix-Zone-Id>.query
    • (Optional) Service Attributes – Enter any additional attributes for the service as a key/value pair.
    • Associate by Default – Enable this checkbox to automatically assign the service to newly created devices. This attribute can be set for multiple services, which will all be assigned to new devices. At the time of device creation, if no default services have been defined, the system will assign one service with a name containing the string "timeseries" and one with a name containing the string "event hub" as follows:
      1. If there are no services matching these names, no service will be assigned.
      2. If there is a service with a name containing "timeseries", but no service with a name containing "event hub", the timeseries service will be assigned.
      3. If there is a service with a name containing "event hub", but no service with a name containing "timeseries", the event hub service will be assigned.
      4. If there is service with a name containing "timeseries" and a service with a name containing "event hub", both services will be assigned.