Installing Pivotal Platform Dev on Microsoft Windows 7 and 8

Note: This topic applies only to Pivotal Platform Dev v0.30 or earlier. If you are using a later version of Pivotal Platform Dev, see Installing Pivotal Platform Dev on Microsoft Windows 10.

This topic describes how to install Pivotal Platform Dev on Windows 7 and 8.

Prerequisites

These sections describe the prerequisites you must have before installing Pivotal Platform Dev on Windows 7 and 8.

VirtualBox

Pivotal Platform Dev uses VirtualBox v5.0 or later as its virtualizer.

To install VirtualBox:

  1. Download VirtualBox v5.0.14 for Windows hosts from VirtualBox.

  2. Open the .exe file and install using the wizard.

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 Windows (64 bit). If you previously used the cf CLI v5 Ruby gem, uninstall this gem first.

  2. Unpack the ZIP file and open the cf_installer app.

  3. Follow the installer wizard to install.

  4. 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 Pivotal Platform Dev v0.30 from the Pivotal Platform Dev page on Pivotal Network.

  2. Unzip the downloaded ZIP file.

  3. Using PowerShell, navigate to the directory containing the unzipped plugin file.

  4. Install the CF Dev plugin by running:

    .\pcfdev-VERSION-windows.exe
    
  5. Start Pivotal Platform Dev by running:

    cf dev start
    

    It may take several minutes for the Pivotal Platform Dev virtual machine (VM) and its services to start.

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

  6. If prompted, enter your API token. This token is required for authentication and appears at the bottom of the Edit Profile tab in your Pivotal Network account.

    Note: The API token does not appear in the terminal session when you enter it.

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 destroy the Pivotal Platform Dev VM:

  1. Navigate to your workspace.

  2. Run:

    cf dev destroy
    

To remove the Pivotal Platform Dev:

  1. Navigate to your workspace.

  2. Run:

    cf uninstall-plugin pcfdev