Installing Pivotal Platform Dev on Mac OS X

Page last updated:

This topic describes how to install Pivotal Platform Dev on Mac OS X.

Prerequisites

This section describes the prerequisites you must have before installing Pivotal Platform Dev on Mac OS X.

Cloud Foundry Command Line Interface

Pivotal Platform Dev uses the Cloud Foundry Command Line Interface (cf CLI) to push and scale apps.

To install the cf CLI:

  1. Download the cf CLI for Mac OS X (64 bit) from the Downloads section of the cf CLI repository on GitHub. If you previously used the cf CLI v5 Ruby gem, you must uninstall the gem first.

  2. Open the .pkg file.

  3. In the installer wizard, click Continue.

  4. Select an install destination and click Continue.

  5. When prompted, click Install.

  6. To verify your installation, open a terminal window and enter cf. If your installation was successful, the cf CLI help listing appears.

Install Pivotal Platform Dev

To install Pivotal Platform Dev:

  1. Download the latest version of Pivotal Platform Dev from the Pivotal Platform Dev page on Pivotal Network.

  2. Install the CF Dev plugin required to run Pivotal Platform Dev by running:

    cf install-plugin cfdev
    
  3. Start Pivotal Platform Dev by running:

    cf dev start -f FILEPATH
    

    Where FILEPATH is the filepath of the .iso or .tgz file you downloaded. It may take several minutes for the Pivotal Platform Dev VM and its services to start.

    Note: You may be prompted to continue if your available memory is less than the recommended amount.

After the Pivotal Platform Dev is now running banner appears, you can log in. For more information about logging in, see the Log In to Your Pivotal Platform Dev Instance section of the Using Pivotal Platform Dev topic.

Stop Pivotal Platform Dev

To stop Pivotal Platform Dev:

  1. Navigate to your workspace.

  2. Run:

    cf dev stop
    

Uninstall Pivotal Platform Dev

To remove Pivotal Platform Dev:

  1. Navigate to your workspace.

  2. Run:

    cf uninstall-plugin pcfdev