Read the config introduction
for an overview of the cloud config system.
The config proxy runs on every Vespa node.
It has a set of config sources, defined with the environment variable
The config proxy will act as a proxy for config clients on the same machine,
so that all clients can ask for config on localhost:19090.
The config source that the config proxy uses is set by the
and may consist of one or more config sources
(usually config servers,
but may be other config proxies).
The proxy has a memory cache that is used to serve configs if it is possible. In default mode, the proxy will have an outstanding request to the config server that will return when the config has changed (a new generation of config). This means that every time config changes on the config server, the proxy will get a response, update its cache and respond to all its clients with the changed config.
The config proxy has two modes:
|default||Gets config from server and stores in memory cache. The config proxy will always be started in default mode. Serves from cache if possible. Always uses a config source. If restarted, it will lose all configs that were cached in memory.|
|memorycache||Serves config from memory cache only. Never uses a config source. A restart will lose all cached configs. Setting the mode to memorycache will make all applications on the node work as before (given that they have previously been running, and hence, requested config), since the config proxy will serve config from cache and work without any connection to the config server. Applications on this node will not work if the config proxy stops, is restarted or crashes.|
Major Vespa software upgrade
Use the upgrade procedure, but also detach hosts from config servers:
Use the memorycache mode for incompatible major upgrades. A config proxy can be detached from the config server, disconnecting from the config server, serving current config from its local snapshot:
Detach all nodes from the config servers by running this command on all hosts:
$ vespa-configproxy-cmd -m setmode memorycache
- Upgrade the config servers and start them
- Deploy the application package
- Stop, upgrade and start the configured nodes one by one. As the default is using the config servers, there is no need to set the mode again