Upgrading the agent
You are strongly encouraged to keep your redirection.io install up-to-date. We regularly push new versions of the agent, which include new features, improvements and fixes. Using the latest version of the agent is always a good idea.
The update can always be run safely, as we do not introduce breaking changes in minor versions of the agent or proxy modules. When breaking changes are required, they are added in a new major version, that can only be used after changing the packages repository URL.
- for the legacy version 1.x, use the repository URLs
https://packages.redirection.io/deb
orhttps://packages.redirection.io/rpm
- for the current version 2.x, use the repository URLs
https://packages.redirection.io/deb/2/stable
orhttps://packages.redirection.io/rpm/2/stable
Upgrading to a new major version of the agent and proxy¶
Upgrading from a legacy version to the current version of the agent and the proxy requires to change the APT or RPM packages repositories.
Debian and APT-based distributions¶
-
Locate the apt redirection.io configuration files - the should live somewhere under
/etc/apt/sources.list.d
- usually in/etc/apt/sources.list.d/packages_redirection_io_deb.list
-
change the repository URL. For example, for the current version (
2.x
) of the agent or the proxies, use:deb https://packages.redirection.io/deb/stable/2 any main deb https://packages.redirection.io/deb/stable/2 buster main
Of course, please only change the repository URL, not the distribution name.
-
Run the other usual upgrade steps, as described below.
Red Hat and RPM-based distributions¶
-
Locate the rpm redirection.io configuration files - the should live somewhere under
/etc/yum.repos.d/
-
change the repository URL. For example, for the current version (
2.x
) of the agent or the proxies, use:baseurl=https://packages.redirection.io/rpm/any/stable/2 deb https://packages.redirection.io/rpm/stable/2 any main deb https://packages.redirection.io/rpm/stable/2/centos_8 main
Of course, use your distribution name in the repository URL.
-
Run the other usual upgrade steps, as described below.
APT-based distributions¶
-
Update the apt cache
sudo apt update
-
Update only the agent:
sudo apt install --only-upgrade redirectionio-agent
-
Restart the agent service. Depending on your service manager, it can be one of:
sudo systemctl restart redirectionio-agent sudo service redirectionio-agent restart sudo /etc/init.d/redirectionio-agent restart
RPM-based distributions¶
-
Update the agent:
sudo yum update redirectionio-agent
-
Restart the agent service. Depending on your service manager, it can be one of:
sudo systemctl restart redirectionio-agent sudo service redirectionio-agent restart sudo /etc/init.d/redirectionio-agent restart
Binary / manual upgrade¶
Upgrading the manual way is the same as the manual installation. However, we strongly advise, if possible, to use a package manager to streamline the upgrade process.