Using PCF Dev Offline

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

This topic describes how to use PCF Dev offline. By default, PCF Dev functions largely without a network connection. To use PCF Dev with no network connection, complete the following steps specific to your operating system.

Using PCF Dev Offline with Mac OS X

For OS X, Pivotal recommends using Dnsmasq as your DNS forwarder. Perform the following steps to install and configure Dnsmasq.

  1. Check that you have Homebrew installed by running brew -v in your terminal. If you do not, follow these instructions to install Homebrew.
  2. Run the following commands to update Homebrew and install Dnsmasq:
    $ brew update
    $ brew install dnsmasq
    
  3. To have launchd start Dnsmasq and restart at startup, run the following command:
    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 perform this redirection, add the line address=/.local.pcfdev.io/192.168.11.11 to the dnsmasq.conf file:

    $ 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, PCF 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 PCF 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.

    $ 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 PCF Dev Offline with Windows

For Windows, Pivotal recommends using Acrylic as your DNS proxy. Perform the following steps to install and configure Acrylic:

  1. Download Acrylic from their site and follow the wizard to install it on your system.
  2. Navigate to Start > Programs > Acrylic DNS Proxy > Config > Edit Acrylic Hosts File.
  3. Add the following text to the end of the file: 192.168.11.11 *.local.pcfdev.io
  4. The Acrylic site has detailed instructions to configure your computer to use Acrylic as a DNS server for Windows 7, Windows 8, and Windows 10.
  5. You may need to restart your DNS cache by navigating to Start > Programs > Acrylic DNS Proxy > Config > Restart Acrylic Service.

Using PCF Dev Offline with Linux

Option 1: Ubuntu 14.04+

  1. 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 perform this redirection, add the line address=/.local.pcfdev.io/192.168.11.11 to /etc/NetworkManager/dnsmasq.d/pcfdev:

    $ echo "address=/.local.pcfdev.io/192.168.11.11" > /etc/NetworkManager/dnsmasq.d/pcfdev
    

  2. Reload the service. For Ubuntu v14.04+, run service network-manager restart. For Ubuntu v15.04+, run systemctl restart NetworkManager.service

Option 2: Other Linux Distribution

  1. 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.

  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 perform this redirection, add the line address=/.local.pcfdev.io/192.168.11.11 to /etc/dnsmasq.conf:

    $ 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.

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