Getting Started with Small Footprint PAS
Page last updated:
This topic describes the Small Footprint Pivotal Application Service (PAS) tile for Pivotal Platform.
The Small Footprint PAS is a repackaging of the PAS components into a smaller deployment with fewer virtual machines (VMs). For a description of the limitations that come with a smaller deployment, see Limitations.
Differentiate Small Footprint PAS and PAS
A standard PAS deployment must have at least 13 VMs, but Small Footprint PAS requires only four.
The following image displays a comparison of the number of VMs deployed by PAS and Small Footprint PAS.
Use Cases
Use Small Footprint PAS for smaller Pivotal Platform deployments on which you intend to host 2500 or fewer apps, as described in Limitations. If you want to use Small Footprint PAS in a production environment, ensure the limitations described below are not an issue in your use case.
Note: Small Footprint PAS is compatible with Pivotal Platform service tiles.
Small Footprint PAS is also ideal for the following use cases:
Proof-of-concept installations: Deploy Pivotal Platform quickly and with a small footprint for evaluation or testing purposes.
Sandbox installations: Use Small Footprint PAS as a Pivotal Platform operator sandbox for tasks such as testing compatibility.
Service tile R&D: Test a service tile against Small Footprint PAS instead of a standard PAS deployment to increase efficiency and reduce cost.
Limitations
Small Footprint PAS has the following limitations:
Number of app instances: The tile is not designed to support large numbers of app instances. You cannot scale the number of Compute VMs beyond 10 instances in the Resource Config pane. Small Footprint PAS is designed to support 2500 or fewer apps.
Increasing platform capacity: You cannot upgrade the Small Footprint PAS tile to the standard PAS tile. If you expect platform usage to increase beyond the capacity of Small Footprint PAS, Pivotal recommends using the standard PAS tile.
Management plane availability during tile upgrades: You may not be able to perform management plane operations like deploying new apps and accessing APIs for brief periods during tile upgrades. The management plane is located on the Control VM.
App availability during tile upgrades: If you require availability during your upgrades, you must scale your Compute VMs to a highly available configuration. Ensure sufficient capacity exists to move app instances between Compute VM instances during the upgrade.
Architecture
You can deploy Small Footprint PAS with a minimum of four VMs, as shown in the image below.
Note: The following image assumes that you are using an external blobstore.
To reduce the number of VMs required for Small Footprint PAS, the Control and Database VMs include colocated jobs that run on a single VM in PAS. See the next sections for details.
For more information about the components mentioned on this page, see PAS Components.
Control VM
The Control VM includes the PAS jobs that handle management plane operations, app lifecycles, logging, and user authorization and authentication. Additionally, all errands run on the Control VM, eliminating the need for a VM for each errand and significantly reducing the time it takes to run errands.
The following image shows all the jobs from PAS that are colocated on the Control VM in Small Footprint PAS.
Database VM
The Database VM includes the PAS jobs that handle internal storage and messaging.
The following image shows all the jobs from PAS that are colocated on the Database VM in Small Footprint PAS.
Compute VM
The Compute VM is the same as the Diego Cell VM in PAS.
Other VMs (Unchanged)
The following image shows the VMs performs the same functions in both versions of the PAS tile.
Requirements
The following topics list the minimum resources needed to run Small Footprint PAS and Ops Manager on the public IaaSes that Pivotal Platform supports:
- Installing Pivotal Platform on AWS
- Installing Pivotal Platform on Azure
- Installing Pivotal Platform on GCP
- Installing Pivotal Platform on vSphere
Installing Small Footprint PAS
To install Small Footprint PAS, see Architecture and Installation Overview and the installation and configuration topics for your IaaS.
Follow the same installation and configuration steps as for PAS, with these differences:
Selecting a product in Pivotal Network: When you navigate to the Pivotal Application Service page on Pivotal Network, select the Small Footprint release.
Configuring resources:
- The Resource Config pane in the Small Footprint PAS tile reflects the differences in VMs discussed in Architecture.
- Small Footprint PAS does not default to a highly available configuration like PAS does. It defaults to a minimum configuration. To make Small Footprint PAS highly available, scale the VMs to the following instance counts:
- Compute:
3
- Control:
2
- Database:
3
- Router:
3
- Compute:
Configuring load balancers: If you are using an SSH load balancer, you must enter its name in the Control VM row of the Resource Config pane. There is no Diego Brain row in Small Footprint PAS because the Diego Brain is colocated on the Control VM. You can still enter the appropriate load balancers in the Router and TCP Router rows as normal.
Troubleshooting Colocated Jobs Using Logs
To troubleshoot a job that runs on the Control or Database VMs:
Follow the procedures in Advanced Troubleshooting with the BOSH CLI to the log in to the BOSH Director for your deployment:
Use BOSH to list the VMs in your Small Footprint PAS deployment. Run:
bosh -e BOSH-ENV -d PAS-DEPLOYMENT vms
Where:
BOSH-ENV
is the name of your BOSH environment.PAS-DEPLOYMENT
is the name of your Small Footprint PAS deployment.Note: If you do not know the name of your deployment, you can run
bosh -e BOSH-ENV deployments
to list the deployments for your BOSH Director.
Use BOSH to SSH into one of the Small Footprint PAS VMs. Run:
bosh -e BOSH-ENV -d PAS-DEPLOYMENT ssh VM-NAME/VM-GUID
Where:
BOSH-ENV
is the name of your BOSH environment.PAS-DEPLOYMENT
is the name of your Small Footprint PAS deployment.VM-NAME
is the name of your VM.VM-GUID
is the GUID of your VM.
For example, to SSH into the Control VM, run:
bosh -e example-env -d example-deployment ssh control/12b1b027-7ffd-43ca-9dc9-7f4ff204d86a
To act as a super user, run:
sudo su
To list the processes running on the VM, run:
monit summary
The example output below lists the processes running on the Control VM. The processes listed reflect the colocation of jobs as outlined in Architecture.
control/12b1b027-7ffd-43ca-9dc9-7f4ff204d86a:/var/vcap/bosh_ssh/bosh_f9d2446b18b445e# monit summary The Monit daemon 5.2.5 uptime: 5d 21h 10m
Process 'bbs' running Process 'metron_agent' running Process 'locket' running Process 'route_registrar' running Process 'policy-server' running Process 'silk-controller' running Process 'uaa' running Process 'statsd_injector' running Process 'cloud_controller_ng' running Process 'cloud_controller_worker_local_1' running Process 'cloud_controller_worker_local_2' running Process 'nginx_cc' running Process 'routing-api' running Process 'cloud_controller_clock' running Process 'cloud_controller_worker_1' running Process 'auctioneer' running Process 'cc_uploader' running Process 'file_server' running Process 'nsync_listener' running Process 'ssh_proxy' running Process 'tps_watcher' running Process 'stager' running Process 'loggregator_trafficcontroller' running Process 'reverse_log_proxy' running Process 'adapter' running Process 'doppler' running Process 'syslog_drain_binder' running System 'system_localhost' running
To access logs, navigate to
/vars/vcap/sys/log
by running:cd /var/vcap/sys/log
To list the log directories for each process, run:
ls
Navigate to the directory of the process that you want to view logs for. For example, for the Cloud Controller process, run:
cd cloud_controller_ng/
From the directory of the process, you can list and view its logs. See the following example output:
control/12b1b027-7ffd-43ca-9dc9-7f4ff204d86a:/var/vcap/sys/log/cloud_controller_ng# ls cloud_controller_ng_ctl.err.log cloud_controller_ng.log.2.gz cloud_controller_ng.log.6.gz drain pre-start.stdout.log cloud_controller_ng_ctl.log cloud_controller_ng.log.3.gz cloud_controller_ng.log.7.gz post-start.stderr.log cloud_controller_ng.log cloud_controller_ng.log.4.gz cloud_controller_worker_ctl.err.log post-start.stdout.log cloud_controller_ng.log.1.gz cloud_controller_ng.log.5.gz cloud_controller_worker_ctl.log pre-start.stderr.log
Release Notes
The Small Footprint PAS tile releases alongside the PAS tile. For more information, see Pivotal Application Service v2.8 Release Notes.