Deploying PCF Runtime for Windows

This topic describes how to install and configure the Pivotal Cloud Foundry (PCF) Runtime for Windows v1.12 tile. The PCF Runtime for Windows tile installs Windows cells on your PCF deployment.


To install the PCF Runtime for Windows v1.12 tile, you must have Ops Manager v1.12.0 or later and Elastic Runtime v1.12.0 or later deployed to vSphere, Amazon Web Services (AWS), Google Cloud Platform (GCP), or Azure.

Step 1: Confirm Elastic Runtime Settings

There are two settings in the Elastic Runtime tile that affect the Windows cells installed by the PCF Runtime for Windows tile. Configure these settings as desired:

  • In the Networking section, if you select the Disable SSL certificate verification for this environment checkbox, SSL certificate verification is disabled for Windows cells.
  • In the System Logging section, if you configure an external syslog aggregator, logs are drained from Windows cells as well as non-Windows cells.

Step 2: Install the Tile

  1. Download the product file from the Pivotal Cloud Foundry Runtime for Windows section of Pivotal Network.

  2. Navigate to the Ops Manager Installation Dashboard and click Import a Product to upload the product file.

  3. Click + under the uploaded PCF Windows Runtime tile to add it to your staging area.

Step 3: Configure and Deploy the Tile

  1. Click the newly added PCF Runtime for Windows tile.

    Pcf windows tile orange 1 12

  2. Click Assign AZs and Networks or Assign Networks. The name of the section varies depending on your IaaS.

  3. Assign your AZs and networks and click Save.

  4. Click VM Options.

    Vm options

  5. Specify how you would like to manage the administrator password for your Windows VMs. The default option is to Use the Windows default password.

  6. (Optional) Select the BETA: Enable BOSH-native SSH support on all VMs checkbox to start the Microsoft beta port of the OpenSSH daemon on port 22 on all VMs. Users will be able to SSH onto Windows VMs with the bosh ssh command, and enter a CMD terminal as an administrator user. They can then run powershell.exe to start a PowerShell session.

    Note: This feature is beta and not considered production-ready.

  7. (Optional) If you want your PCF Runtime for Windows application workloads to be deployed to an isolation segment, perform the following steps:

    1. Click Application Containers.

      App containers segment name

    2. Under Segment Name, enter a name for your isolation segment. Ensure that this name is unique across your PCF deployment.

    3. Click Save.

    4. Perform the steps in the Create an Isolation Segment section of the Managing Isolation Segments topic to create the isolation segment in the Cloud Controller Database (CCDB).

  8. Click Errands. Pivotal recommends that you set the Install HWC Buildpack Errand to On. This ensures that you receive the most up-to-date HWC Buildpack.

    Errands hwc

  9. Click Resource Config and adjust the number and VM types of your Windows cells as needed. Ensure that all VMs have disk sizes that match the possible sizes listed in the Root Disk Sizing table. If you are deploying PAS for Windows 2012R2 on Azure, see the Configure Resources section of the Deploying the Azure Light Stemcell topic.

  10. Click Save.

  11. Click Stemcell. Record the stemcell version number required by the tile.

    Pcf windows tile stemcell

  12. Retrieve the stemcell by following the steps below for your IaaS.

  13. Click Save.

  14. Return to the Ops Manager Installation Dashboard and click Apply Changes to install the PCF Runtime for Windows tile.

After you have deployed the PCF Runtime for Windows tile, developers can then push .NET applications to Windows cells. For more information, see the Deploying .NET Apps to Windows Cells topic.

Step 4: (Optional) Copy the Tile

If you want to create multiple isolation segments for the Windows tile, perform the following steps to copy the PCF Runtime for Windows tile with the Replicator tool:

  1. Download the Replicator tool from the Pivotal Cloud Foundry Runtime for Windows section of Pivotal Network.

  2. Navigate to the directory where you downloaded the Replicator tool.

  3. Replicate the tile:

    ./replicator \
        -name "YOUR-NAME" \
        -path /PATH/TO/ORIGINAL.pivotal \
        -output /PATH/TO/COPY.pivotal

    Replace the values above with the following:

    • YOUR-NAME: Provide a unique name for the new PCF Runtime for Windows tile. The name must be ten characters or less and only contain alphanumeric characters, dashes, underscores, and spaces.
    • /PATH/TO/ORIGINAL: Provide the absolute path to the original PCF Runtime for Windows tile you downloaded from Pivotal Network.
    • /PATH/TO/COPY: Provide the absolute path for the copy of the PCF Runtime for Windows tile that the Replicator tool produces.
  4. Follow the procedures in this topic using the new .pivotal file, starting with Step 1.

Create a pull request or raise an issue on the source for this page in GitHub