Getting Started with Pivotal Cloud Foundry

Welcome to Pivotal Cloud Foundry!

This guide is intended to walk you through deploying the installation virtual machine known as Ops Manager, configuring the IaaS settings, installing PCF Elastic Runtime, and pushing your first app.

If you experience a problem while following the steps below, check the Known Issues, or refer to the PCF Troubleshooting Guide. Once you have completed the steps in this guide, explore the documentation on docs.pivotal.io to learn more about Pivotal Cloud Foundry (PCF) and the Pivotal product suite.

Step 1: Confirm System Requirements

Before you begin your PCF deployment, ensure that your system meets the minimum requirements. The requirements include capacity for the virtual machines necessary for the deployment, a supported version of the cf command line interface tool, and certain user privileges. Refer to the Prerequisites to Deploying Operations Manager and Elastic Runtime topic for the complete list.

Step 2: Deploy PCF Installation Virtual Appliance

The PCF Installation Virtual Appliance is known as Ops Manager. Log in to Pivotal Network and download the Ops Manager virtual appliance file that matches your infrastructure.

Note: For AWS, the Ops Manager virtual appliance file is a PDF containing a reference to an Amazon Machine Identifier (AMI).

Deploy Ops Manager using the procedure that corresponds to the IaaS that you use:

Step 3: Configure and Install PCF

Goal: Configure and install Ops Manager Director (included), Elastic Runtime, and MySQL for PCF. Skip the import steps for Elastic Runtime or MySQL for PCF if you do not want to import these products.

  1. Browse to the interface IP address that you specified in Step 2.

  2. Create a User name and Password and log in to access the interface.

    Note: On your first login attempt, an error message that the connection is untrusted appears because you are attempting to connect securely to a website with a self-signed certificate. Add Ops Manager as an exception to bypass this message on subsequent logins.

Import Products

  1. Download Elastic Runtime and MySQL for PCF at Pivotal Network.

    • Elastic Runtime: Click the Pivotal Cloud Foundry banner to access the PCF product page. Use the drop-down menu to select an Elastic Runtime release.
    • MySQL for PCF: Select the All Products tab to view available products. Search for “MySQL for PCF” and select a release.
  2. From the Available Products view, click Import a Product.

  3. Select the Elastic Runtime .pivotal file that you downloaded from Pivotal Network and click Open. After the import completes, Elastic Runtime appears in the Available Products view.

  4. Repeat the previous step for MySQL for PCF.

  5. In the Available Products view, hover over Elastic Runtime and click Add. Repeat this step for MySQL for PCF.

Configure Ops Manager Director

Your Ops Manager download includes a tile for the version of Ops Manager Director that corresponds to your IaaS. Refer to one of the following topics for help configuring your Ops Manager Director product tile:

Configure Elastic Runtime

Refer to one of the following topics for help configuring Elastic Runtime:

Configure MySQL

  1. Click the MySQL Dev tile.

  2. Configure the MySQL Service Plan, Lifecycle Errands, and resource sizes. Assign Availability Zones and an Ops Manager network, then click Save.

  3. Click the Installation Dashboard link to return to the Installation Dashboard.

Install Products

  1. Click Install.

  2. Your updated PCF installation begins deploying.

  3. When the deployment is finished, a success message appears.

    Note: On the recommended hardware infrastructure, deployment should take less than one hour and require no user intervention.

You now have a fully functional installation of PCF and Pivotal MySQL Service.

Step 4: Create New User Accounts

Once you have successfully deployed PCF, add users to your account. Refer to the Creating New Elastic Runtime User Accounts topic for more information.

Step 5: Target Elastic Runtime

The next step is to use the cf CLI tool to target your Elastic Runtime installation. Make sure that you have installed the cf CLI tool. Refer to the PCF documentation for more information about using the cf command line tool.

Note: In Pivotal Ops Manager, refer to Elastic Runtime > Credentials for the UAA admin name and password. You can also use the user that you created in Apps Manager, or create another user with the create-user command.