Merge pull request #2428 from matrix-org/rav/update_upgrade

Tweaks to the upgrade instructions
This commit is contained in:
Richard van der Hoff 2017-08-24 11:42:02 +01:00 committed by GitHub
commit 934ab76835

View File

@ -5,39 +5,48 @@ Before upgrading check if any special steps are required to upgrade from the
what you currently have installed to current version of synapse. The extra what you currently have installed to current version of synapse. The extra
instructions that may be required are listed later in this document. instructions that may be required are listed later in this document.
If synapse was installed in a virtualenv then active that virtualenv before 1. If synapse was installed in a virtualenv then active that virtualenv before
upgrading. If synapse is installed in a virtualenv in ``~/.synapse/`` then run: upgrading. If synapse is installed in a virtualenv in ``~/.synapse/`` then
run:
.. code:: bash .. code:: bash
source ~/.synapse/bin/activate source ~/.synapse/bin/activate
If synapse was installed using pip then upgrade to the latest version by 2. If synapse was installed using pip then upgrade to the latest version by
running: running:
.. code:: bash .. code:: bash
pip install --upgrade --process-dependency-links https://github.com/matrix-org/synapse/tarball/master pip install --upgrade --process-dependency-links https://github.com/matrix-org/synapse/tarball/master
If synapse was installed using git then upgrade to the latest version by # restart synapse
running: synctl restart
.. code:: bash
If synapse was installed using git then upgrade to the latest version by
running:
.. code:: bash
# Pull the latest version of the master branch. # Pull the latest version of the master branch.
git pull git pull
# Update the versions of synapse's python dependencies. # Update the versions of synapse's python dependencies.
python synapse/python_dependencies.py | xargs -n1 pip install --upgrade python synapse/python_dependencies.py | xargs pip install --upgrade
To check whether your update was sucessfull, run: # restart synapse
./synctl restart
To check whether your update was sucessful, you can check the Server header
returned by the Client-Server API:
.. code:: bash .. code:: bash
# replace your.server.domain with ther domain of your synapse homeserver # replace <host.name> with the hostname of your synapse homeserver.
curl https://<your.server.domain>/_matrix/federation/v1/version # You may need to specify a port (eg, :8448) if your server is not
# configured on port 443.
So for the Matrix.org HS server the URL would be: https://matrix.org/_matrix/federation/v1/version. curl -kv https://<host.name>/_matrix/client/versions 2>&1 | grep "Server:"
Upgrading to v0.15.0 Upgrading to v0.15.0
==================== ====================