Creating an Intelligent Environments Service Instance

Before you begin

You must do the following:

Procedure

Create the UAA service instance.

  1. Locate any application you have running on Cloud Foundry. If you don't have one, you will need to push any app up to Cloud Foundry. See Platform Services Setup for VPC (Basic) users, or Platform Services Setup for ASV (Select) users.
  2. Follow these steps for Basic users, or follow these steps for Select users to bind your application to UAA.

Create an instance of Intelligent Environments.

  1. Enter the following command to list the services in the Cloud Foundry marketplace:

    cf marketplace

    The Intelligent Environment services, shown below, are listed as available services.

    Intelligent Cities services: ie-pedestrian, ie-parking, ie-traffic, ie-public-safety
    Intelligent Enterprises services: ie-positioning, ie-environmental
  2. Enter the following command to create a service instance for one of the available services:

    cf create-service <service instance name> <plan> <my ie instance name> -c '{"trustedIssuerIds":["<my_uaa_instance_issuerId>", "<my_uaa_instance2_issuerId>"]}'

    WHERE:

    <service instance name> The name of the available service in the Cloud Foundry marketplace. Use ie-pedestrian, ie-parking, ie-traffic, ie-public-safety, ie-positioning, or ie-environmental.
    <my ie instance name> The name of the Intelligent Environment instance that you create in your subscribed services.
    <plan> The plan associated with a service. In this case, use Beta.
    <my_uaa_instance_issuerId> The issuerID (base URL) of your trusted issuer (UAA instance). For example, https://13fa0384-9e2a-48e2-9d06-2c95a1f4f5ea.<production url>/oauth/token. After you have bound the UAA instance to your application, you can retrieve the URI from the VCAP_SERVICES environment variable. If applicable, you can use a comma-delimited format to specify multiple trusted issuers (UAA instances), such as ["<my_uaa_instance1_issuerId>", "<my_uaa_instance2_issuerId>"].

    Cloud Foundry displays a message confirming that the service instance has been created.

    Note: Cloud Foundry CLI syntax can differ between the Windows and Linux operating systems. See the Cloud Foundry help for the correct syntax for your OS.

What to do next

See Binding Your Application to the Intelligent Environment Service Instance.