Shared-VM Service Offering

Warning: Redis for PCF v2.0 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.

Page last updated:

Redis for Pivotal Cloud Foundry (PCF) offers on-demand and shared-VM service plans. This section describes the architecture, lifecycle, and configurations of the shared-VM plan. For similar information for the on-demand service plan, see On-Demand Service Offering.

Breaking Change: If you use dedicated VMs, then migrate to the on-demand service plan or back up data before upgrading to Redis for PCF v2.0 to prevent data loss in Redis deployments used as persistent storage.

If you are upgrading from Redis for PCF v1.14.3 or earlier, you must run the upgrade-all-service-instances errand after upgrading.

About the Shared-VM Plan

The shared-VM plan is a pre-provisioned service plan for development and testing purposes only. An instance of this plan provisions a single Redis process on a single shared VM. This plan is suitable for workloads that do not require dedicated hardware. This plan is not suitable for production purposes.

Architecture Diagram for Shared Plans

This diagram shows the architecture of the service broker and shared-VM plans and how the user’s app binds to a Redis instance.

Architecture Diagram

Settings for Shared-VM Service Plans

You cannot change the default Redis settings for shared-VM plans. Because of this, you cannot run cf update-service with the -c flag to set config parameters, as described in the Cloud Foundry documentation.

The default Redis settings are as follows:

Memory Policy

  • Redis is configured with a maxmemory-policy of no-eviction. This policy means that when the memory is full, the service does not evict any keys or perform any write operations until memory becomes available.


  • Shared-VM Redis supports both Redis Database Backup (RDB) and Append-Only File (AOF) persistence options. Redis writes to the AOF log every second. For more information, see Redis Persistence in the Redis documentation.

Number of Connections

  • The maximum number of connections, maxclients, is set at 10,000 by default. Redis might reduce this number when run on a system with a low maximum number of file descriptors. You can retrieve the actual setting on your Redis service instances with the Redis command CONFIG GET maxclients.

    You can run the Redis command CONFIG SET maxclients NUMBER in your service instance to reduce maxclients until the next BOSH action occurs. For example:
    $ CONFIG SET maxclients 9000
    You cannot set maxclients above 10,000 and you cannot configure shared plans to permanently use a custom limit.

Replication and Event Notification

  • Replication and event notification are not configured.

Operator Notes for the Shared-VM Plan

  • This plan deploys a Redis instance in a shared VM and a single service broker VM.

  • This plan can be disabled by setting the Max instances limit on the Shared-VM Plan tab in Ops Manager to 0.

  • You can increase the maximum number of service instances that can run on a shared VM from five, which is the default, up to 250. There is a hard maximum of 250 shared instances.

  • If you increase the number of instances that can be run on a VM, consider increasing the resources allocated to the VM, in particular RAM and CPU. Failure to do so might lead to a degradation of performance.

  • You can also increase the maximum amount of RAM allocated to each service instance that is running on this VM.

  • If you decrease the service instance limit, any instances that are now running beyond the limit are not automatically terminated. You cannot create any new instances until the total falls below the new limit.

    For example, if you use 10 service instances, and you then reduce the limit to 8, the two instances outside the limit continue to run until you terminate them.

  • The number of shared-VM instances available to developers is set by the operator. The maximum number of shared-VM instances is relative to the memory allocated to each shared-VM instance and the total memory of the Redis service broker. For more information, see Shared-VM Plan Settings.

  • You can enable or disable Lua scripting. Changes to this configuration apply to all existing shared-VM instances. Pivotal recommends that Lua scripting is disabled unless developers need it to be enabled. This is because using it can affect the performance of other service instances on the VM.

Warning: The Steeltoe connector for Redis requires Redis for PCF to support Lua scripting. Check if any of your apps require Lua scripting. By default, Lua scripting is disabled for Redis for PCF, but a PCF operator can change the setting to enable it by selecting the Lua Scripting checkbox in the Shared-VM Plan configuration pane.

Known Limitations of the Shared-VM Plan

The shared-vm plan cannot:

  • Scale beyond a single VM
  • Constrain CPU or disk usage
  • Manage “noisy neighbor” problems, which makes it unsuitable for production apps

Lifecycle for Shared-VM Service Plan

Below is the lifecycle of Redis for PCF, from an operator installing the tile, to an app developer using the service, to an operator deleting the tile.

Lifecycle Diagram