.. _configuration: ============= Configuration ============= Cassandra ========= Cassandra is configured via `cassandra.yaml` and `log4j-server.properties` files. Queuey doesn't have any specific configuration requirements for Cassandra, though availability and durability guarantees depend on appropriate Cassandra settings. Please refer to the `Datastax community edition documentation `_ for further details. Pyramid ======= Queuey is implemented on top of the `Pyramid web framework `_. Documentation for configuring WSGI servers and general deployment techniques therefor also apply to Queuey. The `Pyramid cookbook `_ contains some advice on a variety of web servers. The simplest example of a Pyramid pipeline contains of the following:: [app:pyramidapp] use = egg:queuey [filter:catcherror] paste.filter_app_factory = mozsvc.middlewares:make_err_mdw [pipeline:main] pipeline = catcherror pyramidapp Queuey ====== Queuey is configured via an ini-style file, which is also used to configure general Pyramid settings. This ini file contains a number of sections. The following sections contain Queuey specific settings. [application_keys] ------------------ Contains a mapping of application name to application key. The application key acts as a shared secret between server and client. For example:: [application_keys] app_1 = f25bfb8fe200475c8a0532a9cbe7651e [storage] --------- Configures the storage for message data. backend The type of storage, for Cassandra use: `queuey.storage.cassandra.CassandraQueueBackend` Further settings are dependent on the storage. [metadata] ---------- Configures the storage for message metadata. backend The type of storage, for Cassandra use: `queuey.storage.cassandra.CassandraMetadata` Further settings are dependent on the storage. Cassandra storage options ------------------------- The Cassandra storages support the following additional settings: host A comma separated list of either `host` or `host:port` values specifying the Cassandra servers. Defaults to `localhost:9160`. username A username used for connecting to Cassandra's Thrift interface. password A password used for connecting to Cassandra's Thrift interface. multi_dc A boolean indicating whether or not Cassandra runs in a multi-datacenter environment, defaults to `False`. If enabled, read and write operations default to `LOCAL_QUORUM` instead of `QUORUM`. create_schema A boolean value indicating if the required Cassandra schema should be automatically created during startup. Defaults to `True`. If enabled the first server in the host list is used to create the schema. database The name of the keyspace, defaults to `MessageStore` for the storage and `MetadataStore` for the metadata section. [metlog] -------- Queuey uses metlog for logging metrics. For detailed information see the `metlog docs `_.