Cloud provisioning marketplace

Cloud Provisioning includes a sample marketplace, which makes software services available to marketplace consumers, and also includes functions for marketplace administrators. The sample marketplace is created when you import the Cloud Portal application into z/OSMF. Doing so adds the Marketplace and Marketplace Administration tasks to the z/OSMF desktop interface.

The marketplace is provided as-is, and is intended as a sample for learning purposes only.

If you plan to configure the marketplace, you have system customization to perform, as described in the following topics:

Creating SAF authorizations for the marketplace tasks

To enable the marketplace on your system, ask your security administrator to create the authorizations that are shown in Table 1.
Table 1. User authorization requirements for the marketplace tasks
Resource class Resource name Who needs access? Type of access required Why
ZMFAPLA <SAF-prefix>.ZOSMF.IBM_CLOUDPORTAL .MARKETPLACE. CONSUMER Consumers and domain administrators READ Allows the user to use the marketplace to provision and manage software services.
ZMFAPLA <SAF-prefix>.ZOSMF.IBM_CLOUDPORTAL .MARKETPLACE. ADMIN Domain administrators READ Allows the user to control which services are published to the marketplace, and manage the services to which marketplace consumers have subscribed.
ZMFAPLA <SAF-prefix>.ZOSMF.PROVISIONING .SOFTWARE_SERVICES Consumers and domain administrators READ Allows the user to access the Software Services task.

Creating role-based authorizations for the marketplace tasks

To perform tasks in the marketplace, users require the following authorizations:
  • To associate a domain with the marketplace, the user must be defined to the domain as a domain administrator.
  • To publish services to the marketplace, the user must be defined as either a domain administrator or a consumer in the domain that is associated with the marketplace.
  • To subscribe to a published service, the user must be permitted to the template that is associated with the service.

Adding or removing the marketplace tasks

The Cloud Portal application is included with z/OSMF in the following location: 
/usr/lpp/zosmf/samples/cloudportal
To add the marketplace tasks to z/OSMF, follow these steps:
  1. Open the Import Manager task in z/OSMF.
  2. Specify the following properties file as input: 
    /usr/lpp/zosmf/samples/cloudportal/cloudportal.properties
  3. Click Import.

Later, if you want to remove the marketplace tasks from z/OSMF, you can do so by using a property file to remove the tasks.

Follow these steps:
  1. Open the Import Manager task in z/OSMF.
  2. Specify the following properties file as input: 
    /usr/lpp/zosmf/samples/cloudportal/cloudportaldelete.properties
  3. Click Import.

If the removal is successful, the tasks are removed from z/OSMF. If an error occurs, resolve the error and import the property file again.

For more information, see the online help for the Import Manager task.

Configuring the marketplace tasks

When you access the marketplace for the first time, you are prompted as a marketplace administrator to supply information about the marketplace domain and its published services.

Specifically, you must provide the following information:
  • On the Settings tab, specify the domain name for the marketplace. Specify one domain name only. Changing the domain name causes the deletion of any services that are published to the marketplace.

    Also, on the Settings tab, you can indicate whether instances that are provisioned outside of the marketplace can be displayed in the My Subscriptions tab and Manage Subscriptions tab for marketplace consumers. By default, only entries that are provisioned in the marketplace can be displayed to marketplace consumers.

  • On the All Services tab, select which services are to be published to the marketplace. You can add any of the templates that are listed in the Published Service Catalog to which you are permitted in the domain for the marketplace.

Creating and managing subscriptions

When a service is published, marketplace consumers can subscribe to it, which causes the service to be provisioned. In the Marketplace task, consumers can use the All Services tab to subscribe to any services to which they are permitted.

The marketplace provides the following functions for viewing and managing subscriptions:
  • On the My Subscriptions tab, marketplace consumers can view their subscriptions. The tab shows which services are provisioned both within and outside of the marketplace, and allows consumers to take actions on the services.
  • On the Manage Subscriptions tab, marketplace administrators can view all subscriptions in the marketplace domain to which they are permitted. The tab allows the administrator to manage the services to which marketplace consumers have subscribed.

The All Services tab has different functions, depending on whether you access the tab as a consumer (from the Marketplace task) or an administrator (from the Marketplace Administration task). In the Marketplace Administration task, the All Services tab allows the user (an administrator) to select which services are to be published to the marketplace.

Modifying the Cloud Portal application

The Cloud Portal application is provided as-is; you can modify it according to your needs. To modify the application, copy it to a local directory, and make changes to the copy.

To copy the application to another directory, you can use a command like the following, where /myuserdir is a local directory of your choice: 
cp –R /usr/lpp/zosmf/samples/cloudportal /myuserdir/
To add or remove the modified Cloud Portal application from z/OSMF, you can use the Import Manager task, as described in Adding or removing the marketplace tasks. As input, specify the following properties file: 
/myuserdir/cloudportal/cloudportal.properties