Creating a Platform Service Instance

You are required to set up a trusted issuer (UAA) before creating a platform service instance.

About This Task

After you have an instance of a trusted issuer in place, you can create an instance of a platform service for your application development.

Procedure

  1. Sign into your Predix account at https://www.predix.io.
  2. Navigate to Catalog > Services tab, and click the Service tile.
  3. Click Subscribe on the required plan.
  4. Complete the fields on the New Service Instance.
    FieldDescription
    OrgSelect your organization.
    SpaceSelect the space for your application.
    User Account & Authentication (UAA)Select an existing UAA instance, or create a new one. For more information, see uaas-get-started.html#task_y1l_vms_2s.
    Service instance nameEnter a unique name for this service instance.
    Service planSelect a plan.
  5. Click Create Service.

Creating a Platform Service Instance Using Cloud Foundry Commands

You can use the Cloud Foundry CLI to create a platform service instance.

Procedure

  1. Use the Cloud Foundry CLI to log into Cloud Foundry. 
    cf login -a <API_Endpoint>
    Note: If you are a GE employee, you must use the cf login --sso command to log into Cloud Foundry. After you enter your SSO, you will receive a one-time passcode URL. Copy this URL and paste it in a browser to retrieve your one-time passcode. Use this code with the cf command to complete the CF login process.

    Depending on your Predix.io registration, the value of <API_Endpoint> is one of the following:

    • Predix US-West

      https://api.system.aws-usw02-pr.ice.predix.io

    • Predix Europe

      https://api.system.aws-eu-central-1-pr.ice.predix.io

    For example,

    cf login -a https://api.system.aws-usw02-pr.ice.predix.io
  2. List the services in the Cloud Foundry marketplace by entering the following command:
    cf marketplace
  3. Create a service instance by entering the following command:
    cf create-service <service_name> <plan> <my_instance> -c '{"trustedIssuerIds":["<uaa_instance1_issuerId>", "<uaa_instance2_issuerID>"]}'

    where:

    • <service_name> is the name of the service in the Cloud Foundry marketplace. For example, the Asset service is predix-asset.

    • <plan> is the plan associated with a service. For example, the predix-acs service can be associated with the basic plan.

    • <uaa_instance_issuerID> is the issuerID of your trusted issuer (UAA instance), such as https://13fa0384-9e2a-48e2-9d06-2c95a1f4f5ea.predix-uaa.grc-apps.svc.ice.ge.com/oauth/token. You can use a comma-separated list to specify multiple trusted issuers. You can retrieve this URL from the VCAP_SERVICES environment variable after binding your UAA instance to an application.

    Note: Cloud Foundry CLI syntax can differ between Windows and Linux operating systems. See the Cloud Foundry help for the appropriate syntax for your operating system. For example, to see help for the create service command, run cf cs.

    Cloud Foundry displays a message confirming that the service instance has been created. You can retrieve the URI of this instance from the VCAP_SERVICES environment variable after binding it to an application.