..
	Copyright (c) 2020 Varnish Software AS
	SPDX-License-Identifier: BSD-2-Clause
	See LICENSE file for full text of license

.. _whatsnew_upgrading_6.4:

%%%%%%%%%%%%%%%%%%%%%%%%%%
Upgrading to Varnish 6.4.0
%%%%%%%%%%%%%%%%%%%%%%%%%%

Upgrading to Varnish 6.4 from 6.3 should not require any changes
to VCL.

This document contains information about other relevant aspects which
should be considered when upgrading.

varnishd
--------

* The hash algorithm of the ``hash`` director was changed, so backend
  selection will change once only when upgrading.

  Users of the ``hash`` director are advised to consider using the
  ``shard`` director instead, which, amongst other advantages, offers
  more stable backend selection through consistent hashing. See
  :ref:`vmod_directors(3)` for details.

* We fixed a case where :ref:`ref_param_send_timeout` had no effect on HTTP/1
  connections when streaming from a backend fetch, in other words, a
  connection might not have got closed despite the :ref:`ref_param_send_timeout`
  having been reached. HTTP/2 was not affected.

  When :ref:`ref_param_send_timeout` is reached on HTTP/1, the
  ``MAIN.sc_tx_error`` is increased. Users with long running backend
  fetches and HTTP/1 clients should watch out for an increase of that
  counter compared to before the deployment and consider increasing
  :ref:`ref_param_send_timeout` appropriately.

  The timeout can also be set per connection from VCL as
  ``sess.send_timeout``.

  .. actually H2 is really quite different and we have a plan to
     harmonize timeout handling across the board

Statistics
----------

* The ``MAIN.sess_drop`` counter is gone. It should be removed from
  any statistics gathering tools, if present

* ``sess.timeout_idle`` / :ref:`ref_param_timeout_idle` being reached
  on HTTP/1 used to be accounted to the ``MAIN.rx_timeout``
  statistic. We have now added the ``MAIN.rx_close_idle`` counter for
  this case specifically.

* ``sess.send_timeout`` / :ref:`ref_param_send_timeout` being reached
  on HTTP/1 used to be accounted to ``MAIN.sc_rem_close``. Such
  timeout events are now accounted towards ``MAIN.sc_tx_error``.

See :ref:`varnish-counters(7)` for details.

vsl/logs
--------

* The ``Process`` timestamp for ``vcl_synth {}`` was wrongly issued
  before the VCL subroutine was called, now it gets emitted after VCL
  returns for consistency with ``vcl_deliver {}``.

  Users of this timestamp should be aware that it now includes
  ``vcl_synth {}`` processing time and appears at a different
  position in the log.

* A ``Notice`` VSL tag has been added.

*eof*
