Upgrading the PullRequest Proxy

There are two ways to upgrade the PullRequest proxy. The first is to manually install a new package you obtain via a link from PullRequest support. The second is to take advantage of the auto-upgrade functionality included in proxy version 1.0.0 onwards.

Manual Upgrade

To manually upgrade, you'll first have to stop the PullRequest Proxy service from running:

systemctl stop pullrequest-proxy

Now, go ahead and switch to the pullrequest user and install the new package over top of the old one:

su pullrequest
cd $HOME
curl <proxy_url> --output - | tar zxvf -
exit

Now, a simple start for the service should bring in the new version:

systemctl start pullrequest-proxy

Auto-Upgrade

Auto-Upgrade is feature included in the PullRequest Proxy. It uses the existing environment to manage multiple versions of the proxy software. As such, it's a convenient way for the PullRequest application to upgrade your proxy to the latest release automatically without having to schedule downtime to perform the manual upgrade.

As this feature is enabled by default, most users won't have to perform any action to take advantage of it. However, if you do not want the proxy to upgrade automatically, you may turn this feature off from your organization's status page on https://app.pullrequest.com:

If you decide to disable auto-upgrade, you will still be able to take advantage of its functionality when a new upgrade is available, but it will require you to push the "Start Upgrade" button.

Auto-upgrade is very quick and should have a minimal effect, if any, on your organization's workflow. As such, we recommend that it be enabled. In this way, we can automatically roll out bug fixes and new features to on-premise customers without needing to schedule a maintenance window.