Upgrading HipChat Server

Checking for upgrades in the CLI

Enter the following command in the CLI:

hipchat upgrade --check

HipChat Server polls the update server. A message appears stating whether your system is up to date or an upgrade is available.

Upgrading

We offer two software update channels: Beta and production. Typically, the production update channel is older than the beta channel. By default, you get the production channel when you upgrade. You can choose to upgrade to the Beta channel.

You can upgrade HipChat Server through the HipChat web app or CLI.

Before you upgrade

1. Make a full backup of your HipChat Server installation.
2. Let your users know that HipChat will be unavailable during the upgrade.

Upgrading using the web app

1. Open a web browser and browse to the URL for your HipChat server web app. For example, browse to https://hipchat.yourcompany.com
2. Optional: If you want to upgrade to the Beta channel, click Beta, then Change upgrade channel.
3. Click Upgrade to the latest version.
   A message appears informing you HipChat users will be disconnected temporarily while you upgrade.
4. Click OK.

Upgrading using the CLI

To view the current upgrade channel:

hipchat upgrade --show

To set the current upgrade channel to the Beta channel:

hipchat upgrade --channel beta

To set the current upgrade channel to the production channel:

hipchat upgrade --channel production

To upgrade using the current channel:

hipchat upgrade --upgrade

Using an outbound proxy server

If your company requires use of a Proxy Server for outbound network traffic you can configure HipChat Server to check for updates using an outbound proxy server. In the CLI, enter:

hipchat upgrade --proxy http://user:password@proxy.example.com:portnumber

hipchat upgrade --check

hipchat upgrade --upgrade

Troubleshooting

Also see the Connectivity Issues When Upgrading knowledge base article.