Getting Started with Pivotal CF

Welcome to Pivotal CF!

This guide is intended to walk you through deploying the installation virtual machine, setting up your PaaS, targeting Elastic Runtime, and pushing your first app. If at any time you experience a problem following the steps below, try checking the Known Issues, or refer to the Troubleshooting Guide for more tips. Once you have completed the steps in this guide, explore the documentation on docs.gopivotal.com to learn more about Pivotal CF and the Pivotal One product suite.

Step 1: Confirm System Requirements

Before you begin your Pivotal CF 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 topic for the complete list.

Step 2: Deploy Pivotal CF Installation Virtual Machine

Download the Pivotal CF .ova file and deploy it. The procedure you follow depends on the IaaS you use:

Step 3: Set Up Your PaaS

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

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

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

Import Products

  1. Download Elastic Runtime and Pivotal MySQL Dev from Pivotal Network.

  2. From the Available Products view, click Import a Product.

  3. Select the Elastic Runtime .zip file that you downloaded from Pivotal Network, then click Open.

    After the import completes, Elastic Runtime appears in the Available Products view.

  4. Repeat the previous step for Pivotal MySQL Dev.

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

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

  1. Click the Elastic Runtime tile.

  2. In the left column, select HAProxy if not already selected.

  3. The value you enter in the HAProxy IPs field depends on whether you are using your own load balancer or the HAProxy load balancer.

    Your own load balancer: Leave this field blank.

    HAProxy load balancer: Enter at least one HAProxy IP address. Point your DNS to this address.

    For more information, refer to the Understanding the SSL Termination Options topic. For help understanding the Elastic Runtime architecture, refer to the Architecture topic.

  4. If you are using a signed SSL Certificate from a known certificate authority (CA), copy and paste its values for Certificate PEM and Private Key PEM into the appropriate text fields. Alternatively, complete the following two steps to generate self-signed RSA certificates.

    1. Check the Trust Self-Signed Certificates checkbox, then click Generate Self-Signed RSA Certificate.

    2. Enter your system and app domains in wildcard format. Optionally, also add any custom domains in wildcard format. Click Generate.

  5. The Certificate Key PEM and Private Key PEM fields now contain certificate keys. Click Save.

  6. Select Cloud Controller and enter the system and application domains.

    • The system domain will be your target when you push apps to Elastic Runtime
    • The application domain is where Elastic Runtime should serve your apps

    Note: You configured wildcard DNS records for these domains in an earlier step.

  7. Leave the Cloud Controller DB encryption key field blank unless:

    • You deployed Elastic Runtime earlier
    • You then stopped Elastic Runtime, or it crashed
    • You are re-deploying Elastic Runtime with a backup of your Cloud Controller database

    Enter your Cloud Controller database encryption key only if these conditions apply. See Backing Up Pivotal CF for more information.

  8. Enter your intended maximum file upload size.

  9. (Optional) Check the Disable Custom Buildpacks checkbox.

    By default, the cf command line tool gives developers the option of using a custom buildpack when they deploy apps to Elastic Runtime. To do so, they use the -b option to provide a custom buildpack URL with the cf push command. The Disable Custom Buildpacks checkbox disables the -b option. For more information about custom buildpacks, refer to the buildpacks section of the Pivotal CF documentation.

  10. Click Save.

  11. Select Router IPs. The value you enter in the Router IPs field depends on whether you are using your own load balancer or the HAProxy load balancer.

    Your own load balancer: Enter the IP address(es) for Pivotal CF that you registered with your load balancer. Refer to the Using Your Own Load Balancer topic for help using your own load balancer with Pivotal CF.

    HAProxy load balancer: Leave this field blank.

  12. Click Save.

  13. (Optional - Advanced) If you are using the VMware SSO appliance for integration with Active Directory, complete this step. Select SSO Login, enter the URL of an SSO appliance to connect to Active Directory servers in your organization, and click Save.

  14. (Optional) Select Web Console, enter your reply-to and SMTP email information, and click Save. The console uses these settings to send invitations and confirmations to console users. These SMTP settings are required if you want to enable end-user self-registration.

    Note: If you do not configure the SMTP settings using this form, the administrator will need to create orgs and users using the cf CLI tool. See Creating and Managing Users with the cf CLI for more information.

  15. (Optional) Select Quota Settings, enter in-range quota values or accept the defaults, and click Save. The values you specify affect apps and service instances using the default quota plan. After the initial Elastic Runtime installation, use the cf CLI to manage quota plans.

  16. Select Lifecycle Errands. By default, Ops Manager will run the Run Smoke Tests and Push Console errands after installing Elastic Runtime. See Understanding Lifecycle Errands for more information.

  17. Select Resource Sizes, accept the defaults or make necessary changes, and click Save.

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

Configure mySQL

  1. Click the MySQL Dev tile.

  2. Configure the MySQL Service Plan, Lifecycle Errands, and resource sizes or keep the default values, then click Save.

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

Install Products

  1. Click Install.

  2. Your updated Pivotal CF installation begins deploying.

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

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

You now have a fully functional installation of Pivotal CF and Pivotal MySQL Service. The following sections will help you start using your PaaS.

Step 4: Create New User Accounts

Once you have successfully deployed Pivotal CF, 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 tool to target your Elastic Runtime installation. Make sure you have installed the cf tool. Refer to the Pivotal CF documentation for more information about using the cf command line tool.

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