Installing PCF Isolation Segment
Page last updated:
This topic describes how to install the PCF Isolation Segment tile, which allows operators to isolate deployment workloads into dedicated resource pools called isolation segments.
Installing the tile installs a single isolation segment. However, you can install multiple isolation segments using the Replicator tool documented in Step 4.
After installing the tile, you must 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). The topic also includes information about managing an isolation segment.
For more information about how isolation segments work, see the Isolation Segments section of the Understanding Cloud Foundry Security topic.
By default, the Elastic Runtime Router handles traffic for your isolation segment. However, you can deploy a dedicated router for your isolation segment instead.
To deploy a dedicated router, perform the following steps:
- Add a load balancer in front of the Elastic Runtime Router. The steps to do this depend on your IaaS, but the setup of the load balancer should mirror the setup of the load balancer for the Elastic Runtime Router that you configured in the Elastic Runtime tile.
- Create a wildcard DNS entry for traffic routed to any app in the isolation segment. For example,
- Attach the wildcard DNS entry to the load balancer you created.
Perform the following steps to install the PCF Isolation Segment tile:
Download the product file from Pivotal Network.
YOUR-OPSMAN-FQDNin a browser to log in to the Ops Manager Installation Dashboard.
Click Import a Product and select the downloaded product file.
Under PCF Isolation Segment in the left column, click the plus sign.
Perform the following steps to configure the PCF Isolation Segment tile:
Click the orange PCF Isolation Segment tile to start the configuration process.
Click Assign AZs and Networks.
Select an availability zone for your singleton jobs, and one or more availability zones to balance other jobs in.
Select a network. This network does not need to be the same network where you deployed Elastic Runtime. For most deployments, operators should create unique networks in which to deploy the Isolation Segment tile. These networks should maintain network reachability with the Diego components so that the cells can reach the Diego Brain and Diego Database VMs.
Click Application Containers.
(Optional): Under Private Docker Insecure Registry Whitelist, enter one or more private Docker image registries that are secured with self-signed certificates. Use a comma-delimited list in the format
Under Segment Name, enter the name of your isolation segment. This name must be unique across your PCF deployment. You use this name when performing 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).
By default, containers use the same DNS servers as the host. If you want to override the DNS servers to be used in the containers in the isolation segment, enter a comma-separated list of servers in DNS Servers.
Under Enabling NFSv3 volume services, select Enable or Disable. NFS volume services allow application developers to bind existing NFS volumes to their applications for shared file access. For more information, see the Enabling NFS Volume Services topic.
Note: In a clean install of the PCF Isolation Segment tile, NFSv3 volume services will be enabled by default. In an upgrade, NFSv3 volume services will be set to the same setting as it was in the previous tile.
(Optional): Under Router IPs, enter one or more static IP addresses for the routers that handle this isolation segment. These IP addresses must be within the subnet CIDR block that you defined in the Ops Manager network configuration. If you have a load balancer, configure it to point to these IP addresses.
Note: Entering the static IPs is not necessary for deployments running on a public IaaS because PCF users specify the IaaS load balancer in the Resource Config section of the PCF Isolation Segment tile.
(Optional): Under Applications Network Maximum Transmission Unit, change the Maximum Transmission Unit (MTU). The default is
Under TLS Termination Certificates, select one of the following options:
- Forward SSL to Isolation Segment Router with provided certificates: Select this option if your deployment uses an external load balancer that can forward encrypted traffic to the Elastic Runtime Router for the isolation segment, or if you are running a development environment that does not require load balancing. Complete the fields for the Router SSL Termination Certificate and Private Key and Router SSL Ciphers.
- Forward SSL to Isolation Segment Router with ERT Router certificates: Select this option to inherit the certificates provided to the Elastic Runtime Router when you configured the Elastic Runtime tile. This option assumes an external load balancer is configured to forward encrypted traffic.
- Forward unencrypted traffic to Elastic Runtime Router: Select this option if your deployment uses an external load balancer that cannot forward encrypted traffic to the Elastic Runtime Router, or for a development environment that does not require load balancing.
To enable container-to-container networking, perform the following steps:
- Select the Enable button.
- (Optional): Enter an IP range for the overlay network in the Network CIDR box. If you do not set a custom range, PCF Isolation Segment uses
- (Optional): Enter a UDP port number in the VXLAN Tunnel Endpoint Port box. If you do not set a custom port, PCF Isolation Segment uses
4789. For more information about configuring container-to-container networking rules, see the Create Policies for Container-to-Container Networking section of the Administering Container-to-Container Networking topic.
To disable container-to-container networking, perform the following steps:
- Select the Disable button.
- (Optional): Under Applications Subnet, enter a CIDR subnet mask specifying the range of available IP addresses to assign to your app containers. This must be different from the network used by the system VMs. Modify the default value only if you need to avoid address collision with a third-party service on the same subnet. If you do not set a custom range, PCF Isolation Segment uses
(Optional): Edit the configurations in Advanced Features as desired.
In the System Logging menu, select an option from the Do you want to configure syslog for system components? menu. No is selected by default.
If you want to use syslog, select Yes.
Enter the address of your external syslog aggregation service in the Address field. The address can be a hostname or IP address.
Enter a port number in the Port field.
Select a protocol from the Transport Protocol menu. This is the protocol the sytem uses to transmit logs to syslog.
- (Optional) Select the Enable TLS option if you want to transmit logs over TLS.
- Enter a Permitted Peer.
- Paste the certificate for your TLS certificate authority (CA) in the TLS CA Certificate field.
- Click Save.
(Optional): If you are using a dedicated router for your isolation segment, click Resource Config and enter the wildcard DNS entry attached to your load balancer into the Router row under Load Balancers.
Note: Configuration settings available in Resource Config vary depending on your IaaS.
If you do not have the Load Balancers column in your Resource Config, perform the following steps:
- Navigate to the Networking section of the PCF Isolation Segment tile.
- Specify Router IPs.
- Attach the IPs to your load balancer manually.
(Optional): Edit the Stemcell configuration as desired.
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).
Return to the Ops Manager Installation Dashboard and click Apply Changes to deploy the tile.
After the tile finishes deploying, see the Managing Isolation Segments topic for more information about managing an isolation segment.
If you want to create multiple isolation segments, perform the following steps to copy the PCF Isolation Segment tile with the Replicator tool:
Download the Replicator tool from the Pivotal Cloud Foundry Isolation Segment section of Pivotal Network.
Navigate to the directory where you downloaded the Replicator tool.
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 Isolation Segment 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 Isolation Segment tile you downloaded from Pivotal Network.
/PATH/TO/COPY: Provide the absolute path for the copy that the Replicator tool produces.
Follow the procedures in this topic using the new
.pivotalfile, starting with Step 1.