doc/sphinx/whats-new/upgrading-4.1.rst
.. Copyright (c) 2016 Varnish Software AS SPDX-License-Identifier: BSD-2-Clause See LICENSE file for full text of license
.. _whatsnew_upgrading_4_1:
%%%%%%%%%%%%%%%%%%%%%%%% Upgrading to Varnish 4.1 %%%%%%%%%%%%%%%%%%%%%%%%
Data type conversion functions now take a fallback
Data type conversion functions in the std vmod now takes an additional
argument *fallback*, which is returned if the conversion does not succeed.
Version statement is kept
~~~~~~~~~~~~~~~~~~~~~~~~~
The VCL syntax has not chanced significantly, and as such the Varnish 4.0
version marker is kept for Varnish 4.1.
One of the initial lines in a Varnish 4.1 VCL should read::
vcl 4.0;
Remote address accessors
~~~~~~~~~~~~~~~~~~~~~~~~
New in 4.1 is the `local.ip` and `remote.ip` representing the (local) TCP
connection endpoints.
With PROXY listeners the `server.ip` and `client.ip` are set from the PROXY
preamble. On normal HTTP listeners the behaviour is unchanged.
Management interface
====================
The management interface enabled with ``-M`` previously supported the telnet
protocol.
Support for telnet control sequences have been retired. Replacement clients
like netcat or (preferred) ``varnishadm`` should be used instead.
Runtime users and groups
========================
With the new jail support, an additional runtime user (`vcache`) should be used
for the Varnish worker child process.
Additionally, the ``varnishlog``, ``varnishncsa`` and other Varnish shared log
utilities must now be run in a context with `varnish` group membership.
Changes to parameters
=====================
`vcl_cooldown` is new, and decides how long time a VCL is kept warm after being
replaced as the active VCL.
The following parameters have been retired:
* `group` (security revamp)
* `group_cc` (security revamp)
* `listen_address` (security revamp)
* `pool_vbc`
* `timeout_req` - merged with `timeout_idle`.
* `user` (security revamp)
Minor changes of default values on `workspace_session` and `vsl_mask`.