Ubuntu Repository Cache

Learn about configurations >

• admin_email | string

  Email to use to send mail.

• apache2_mpm_maxconnectionsperchild | int

  Maximum number of requests a server process serves

• apache2_mpm_maxrequestworkers | int

  Maximum number of simultaneous client connections (0 means autocalculate)

• apache2_mpm_maxsparethreads | int

  Maximum number of worker threads which are kept spare (0 means auto calculate)

• apache2_mpm_minsparethreads | int

  Minimum number of worker threads which are kept spare (0 means auto calculate)

• apache2_mpm_serverlimit | int

  Upper limit on configurable number of processes (0 means autocalculate)

• apache2_mpm_startservers | int

  Initial number of server processes to start (0 means auto calculate)

• apache2_mpm_threadlimit | int

  Sets the upper limit on the configurable number of threads per child process (0 means autocalculate with max. 2560; override here)

• apache2_mpm_threadsperchild | int

  Constant number of worker threads in each server process (0 means autocalculate)

• apache2_mpm_type | string

  Default: worker

  Select the worker or prefork multi-processing module

• apache2_server_signature | string

  Default: On

  Security setting. Set to one of On Off EMail

• apache2_server_tokens | string

  Default: OS

  Security setting. Set to one of Full OS Minimal Minor Major Prod

• apache2_trace_enabled | string

  Default: Off

  Security setting. Set to one of On Off extended

• cache-memory-size | int

  Configurable option (in MBytes) to tune/override memory used by squid cache. If 0 or unset, then auto-calculate.

• cache-storage-size | int

  Configurable option (in MBytes) to tune/override storage used by squid cache. If 0 or unset, then auto-calculate.

• cache-swap-high | int

  Default: 75

  Configurable option to tune/override the high-water mark for cache object eviction.

• cache-swap-low | int

  Default: 70

  Configurable option to tune/override the low-water mark for cache object eviction.

• display-host | string

  Default: archive.ubuntu.com

  The hostname displayed in certain contexts, for example Apache directory listings. This is not required to be exactly the same as the logical hostname of the deployment (for example, region.cloud.archive.ubuntu.com can use the default archive.ubuntu.com), but should be changed if the archive type is non-default (e.g. ports.ubuntu.com).

• enable_healthcheck | boolean

  Default: True

  Enables health-check endpoint for load-balancers or frontends to use. This endpoint will check both metadata served from local storage as well as pool files via the locally running squid-deb-proxy service.

• enable_sync-host_monitoring | boolean

  Enable periodic mtr outputs to configured sync-host

• ephemeral-devices | string

  Provide a comma-separated list of storages devices to use for metadata and squid cache storage. Leave this empty if only the root disk will be used. the device(s) will be formatted and mounted during charm installation. This option must be set at in itial charm deployment. Changes after deployment will not effect running units, only newly added units. An example would be '/dev/xvdb,/dev/xvdc' to specify two ephemeral disks for cache storage.

• extra_packages | string

  Space separated list of extra deb packages to install.

• install_keys | string

  List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.

• install_sources | string

  List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.

• leader_unit | string

  Override and specify leader unit used for metadata sync. (e.g. ubuntu-repository-cache/1)

• logrotate_count | int

  Default: 21

  The number of days we want to retain logs for

• logrotate_dateext | boolean

  Default: True

  Use daily extension like YYYMMDD instead of simply adding a number

• logrotate_rotate | string

  Default: daily

  daily, weekly, monthly, or yearly?

• mirror-series | string

  A space-separated list of ubuntu series metadata to mirror. An empty or blank string will mirror everything.

• nagios_context | string

  Default: juju

  A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.

• nagios_servicegroups | string

  A comma-separated list of nagios servicegroups. If left empty, the nagios_context will be used as the servicegroup

• package_status | string

  Default: install

  The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".

• path-base | string

  Default: ubuntu

  The base URI path of the site you want to mirror. At the moment, this may only be a single-level base (no directory slashes). Default is ubuntu.

• remoteip_logging | boolean

  Enables configuration that treats incoming connections to Apache from RFC1918 addresses as proxy connections and logs the contents of the X-Forwarded-For header (if any) to the Apache logs.

• rsync-host | string

  The DNS or IP of the mirror to rsync the Ubuntu Archive metadata from.

• rsync-module | string

  Default: ubuntu

  The rsync module to sync from on sync-host, normally the same as path-base. Default is ubuntu.

• squid_dns_v4_first | boolean

  If true, prefer IPv4 addresses for dual-stack sites.

• squid_snmp | boolean

  Enable SNMP for Squid (bound on localhost:3401, community "public")

• sync-age-crit | int

  Default: 21600

  Age (in seconds) of CRITICAL level in Nagios check for cache sync.

• sync-age-warn | int

  Default: 10800

  Age (in seconds) of WARNING level in Nagios check for cache sync.

• sync-host | string

  Default: archive.ubuntu.com

  The DNS or IP of the site you want to mirror. Default is archive.ubuntu.com.

• sync-on-start | boolean

  Default: True

  Pull data from the sync-host during inital charm deployment. This should be true if deploying a single unit and false if deploying multiple units to reduce initial startup time.

• update-unit-apt-sources | boolean

  Default: True

  Whether to configure the units' sources.list to point to upstream sync-host directly, to avoid chicken/egg problems when bootstrapping a cloud. Default is true; disable if mirrored distro or archive type does not match the unit host.