Installing and Configuring ECS Service Broker for PCF

This topic describes how to install and configure ECS Service Broker for Pivotal Cloud Foundry (PCF).

Install and Configure ECS Service Broker for PCF

The ECS Service Broker installs as a single PCF-deployed application, which makes API calls to an externally-hosted Dell EMC ECS installation. The broker uses a combination of both the ECS management API (which typically runs on port 4443 on ECS) and the S3 API (which runs on ports 9020/HTTP and 9021/HTTPS). If you do not yet have access to an ECS environment, you have two options:

To install the service broker, you must configure the broker application to connect to the ECS management API. If desired, you may also customize the services and plans offered in the PCF marketplace with additional pages in the Tile interface.

To start running the ECS broker, do the following:

  1. Download the product file from Pivotal Network.

  2. Navigate to the Ops Manager Installation Dashboard and click Import a Product to upload the product file.

  3. Under the Import a Product button, click + next to the version number of ECS Service Broker for PCF. This adds the tile to your staging area.

  4. Click the newly added ECS Service Broker for PCF tile.

Configure ECS Service Broker for PCF

  1. Navigate to Assign AZs and Networks and confirm that the default Availability Zones and Network fields are correct.

  2. Click Save if any changes have been made.

  3. Navigate to Dell EMC ECS Connectivity.

  4. For ECS Management Endpoint, enter the URI/endpoint for the ECS HTTPS management API. This typically runs on port 4443 of the ECS. For ECS Test Drive users, see the ECS Management page.

  5. For Replication Group, enter the name of the ECS replication group to be used for created buckets. For ECS Test Drive users, this should be ecstestdrivegeo.

  6. For Namespace, enter the name of the ECS namespace to be used for created buckets and users.

  7. For ECS Admin Username, enter the name of the ECS Management API user. In ECS terminology, this is a Management User (not an Object User), which should configured as either a Namespace Administrator or System Administrator.

  8. For ECS Admin Password, enter the ECS Management API password.

  9. (Optional) For ECS Base URL, enter the name of the ECS configured base URL that should be used with bucket credentials. If no value is entered, the broker will attempt to discover a default value. If this feature is enabled, ensure that the management user has System Monitor access on the ECS.

  10. Specify whether the ECS system has a certificate installed, which is signed by an available trust authority. This may not be available for development environments, and is not the case for self-signed certificates.

  11. If the installed ECS certificate is not signed by a trust authority, complete the ECS Management Certificate field by entering the ECS certificate.

  12. To overload a value determined from the Base URL, or if no Base URL was provided, complete the ECS Object Endpoint field by entering the URI/endpoint for the ECS S3 API.

  13. Click Save.

  14. Navigate to Service Broker Settings.

  15. (Optional) For Broker Prefix, enter a string used to prefix broker-created buckets and users. For ECS Test Drive users, use your Namespace value here to ensure that there are no username conflicts between public users.

  16. (Optional) For Repository Endpoint, enter the URI/endpoint for the ECS S3 API that should be used for persisting broker metadata. This defaults to the object endpoint or base URL.

  17. (Optional) For Repository User, enter the name of the user that should be created or used for managing broker metadata.

  18. (Optional) For Repository Bucket, enter the name of the bucket that should be created or used for managing broker metadata.

  19. Click Save.

  20. Navigate to Catalog Service 1.

  21. Review settings for catalog service and plans. These settings define the services available in the PCF marketplace. If any changes are made, click Save.

  22. Review the remaining catalog services. Services 4 and 5 are both disabled by default, but available for customization.

    Note: File-enabled buckets and Namespace services will not function on ECS Test Drive.

  23. For Enable Global access to all Services and Plans, navigate to Service Access and check the checkbox to open up access to all service plans across all orgs and spaces.

  24. Click Save

  25. Return to the Ops Manager Installation Dashboard and click Apply Changes.

Create a pull request or raise an issue on the source for this page in GitHub