Using Pivotal Platform Dev Offline

Note: This functionality is not supported in the current version of Pivotal Platform Dev. Use Pivotal Platform Dev v0.30 for Pivotal Platform v1.11 or earlier for this functionality.

This topic describes how to use Pivotal Platform Dev offline.

Overview

By default, Pivotal Platform Dev functions largely without a network connection. To use Pivotal Platform Dev with no network connection, complete the procedure in the following sections that is specific to your operating system.

Using Pivotal Platform Dev Offline with Mac OS X

For OS X, Pivotal recommends using Dnsmasq as your DNS forwarder. For more information about Dnsmasq, see the Dnsmasq documentation.

To install and configure Dnsmasq:

  1. Check that you have Homebrew installed by running brew -v in your terminal. If you do not, see the Homebrew webpage to install Homebrew.

  2. Update Homebrew and install Dnsmasq by running:

    brew update
    brew install dnsmasq
    
  3. To have launchd start Dnsmasq and restart at startup, run:

    sudo brew services start dnsmasq
    
  4. Configure Dnsmasq by editing the default configuration file placed at /usr/local/etc/dnsmasq.conf to redirect the domain name local.pcfdev.io to the IP 192.168.11.11 without requiring a network connection to resolve the DNS. To do this, add the line address=/.local.pcfdev.io/192.168.11.11 to the dnsmasq.conf file by running:

    echo "address=/.local.pcfdev.io/192.168.11.11" >> /usr/local/etc/dnsmasq.conf
    

    Note: If the subnet containing 192.168.11.11 is already in use, Pivotal Platform Dev picks the next available IP address that adheres to the pattern 192.168.xx.11, and a corresponding system domain. For example, 192.168.44.11 and local4.pcfdev.io. If your Pivotal Platform Dev reports that it is using an alternate configuration when it comes up, use the appropriate combination in your dnsmasq.conf file.

  5. Restart Dnsmasq to ensure it recognizes your change by running:

    sudo launchctl stop homebrew.mxcl.dnsmasq
    sudo launchctl start homebrew.mxcl.dnsmasq
    
  6. To configure your system to use Dnsmasq, go to your network preferences and add 127.0.0.1 as your first DNS server.

Using Pivotal Platform Dev Offline with Windows

For Windows, Pivotal recommends using Acrylic as your DNS proxy. To install and configure Acrylic:

  1. Download Acrylic from the Acrylic DNS Proxy website and follow the wizard to install it on your system.

  2. Navigate to Start > Programs > Acrylic DNS Proxy > Config and click Edit Acrylic Hosts File.

  3. Add the following text to the end of the file:

    192.168.11.11 *.local.pcfdev.io
    
  4. To configure your computer to use Acrylic as a DNS server, see Acrylic DNS Proxy Windows 7 Configuration, Acrylic DNS Proxy Windows 8 Configuration, or Acrylic DNS Proxy Windows 10 Configuration in the Acrylic documentation, depending on which version of Windows you use.

  5. You may need to restart your DNS cache by navigating to Start > Programs > Acrylic DNS Proxy > Config and clicking Restart Acrylic Service.

Using Pivotal Platform Dev Offline with Linux

These sections describe how to configure Dnsmasq for Ubuntu or other Linux distributions.

Ubuntu v14.04 or Later

To configure Dnsmasq for Ubuntu:

  1. Edit the dnsmasq.conf file to redirect the domain name local.pcfdev.io to the IP 192.168.11.11 without requiring a network connection to resolve the DNS. To do this, add the line address=/.local.pcfdev.io/192.168.11.11 to /etc/NetworkManager/dnsmasq.d/pcfdev by running:

    echo "address=/.local.pcfdev.io/192.168.11.11" > /etc/NetworkManager/dnsmasq.d/pcfdev
    
  2. Reload the service.

    • For Ubuntu v14.04 and later patches, run:

      service network-manager restart
      
    • For Ubuntu v15.04 and later patches, run:

      systemctl restart NetworkManager.service
      

Other Linux Distributions

To configure Dnsmasq for other Linux distributions:

  1. Edit the dnsmasq.conf file to redirect the domain name local.pcfdev.io to the IP 192.168.11.11 without requiring a network connection to resolve the DNS.

  2. Install Dnsmasq using your distribution’s package manager.

  3. Configure Dnsmasq by editing the dnsmasq.conf file to redirect the domain name local.pcfdev.io to the IP 192.168.11.11 without requiring a network connection to resolve the DNS. To do this, add the line address=/.local.pcfdev.io/192.168.11.11 to /etc/dnsmasq.conf by running:

    echo "address=/.local.pcfdev.io/192.168.11.11" >> /etc/dnsmasq.conf
    

Note: Details about configuring your Linux installation to use Dnsmasq may differ by distribution.