Updating sites

You can use Jive Cloud Admin to update your installation files, but make sure you first upload to it a non-production instance to minimize risk to your Jive instance.

Before you begin, you must prepare a complete record and backups of your planned installation changes. For more information about database backups, see Working with your database dumps.

Fastpath: Jive Cloud Admin > Update Your Site

Updating your installation through Jive Cloud Admin updates all the nodes in your installation, so you don't need to log into each installation node separately through the Admin Console. Note that updating files in your installation does not always apply them to your site. For example, when you upload theme files, your site's theme will not change until you log into the Admin Console and map the site to your new theme. Uploading a WAR file does take effect immediately, however. For more information, see Updating themes FAQ and Updating WAR files overview.

Note: Updating an installation is a non-trivial operation: uploading unverified files can bring down your Jive community. If you upload to an instance that's already running in production, make sure you're using the same files that you tested in staging.

To update your installation files:

  1. Make sure you have a complete record and backups of your planned installation changes.
  2. Log into Jive Cloud Admin.
  3. If you have more than one site, select the installation you want to update from the Choose an Installation menu.
  4. Enable Maintenance Mode.
    For more information, see Using Maintenance Mode.
  5. Under Menu, select Update Your Site.
    If you haven't tested your customizations, you should upload them to a staging instance first and test them for stability. You can switch instances by using the Choose Installation menu at the top.
  6. In Email Contact, enter the email address for update notifications.
    By default, the notifications are sent to the email of the current user.
  7. Create a list of files to update as follows:
    1. Under Files, choose a file type.
    2. Click Select Files and browse to the location of the files you want to upload.
    If you choose to upload a WAR file, you automatically get a diff of your file against a standard WAR file of the same version. You can then decide whether to continue the update. If you decide not to complete the upload, you will have to start your update over, even if your update included other files that you still want to add. For more information about theme updates, see Updating themes FAQ. For more information about WAR uploads, see Updating WAR files overview.
  8. Choose a time for the update.
    • If you want to update immediately, select Restart immediately.
    • If you want to perform the update later, select Restart at this time and enter a target time.
    Times are interpreted as current Pacific time. It's helpful to make updates at a less-busy time for your site.
  9. In Note (required), write a note that describes why the site is updated.
    This note is used for reference in your Recent Activity log.
  10. Click Continue.
    CAUTION:
    Your update is queued immediately with no confirmation step! You should make sure you have selected the correct files and the correct instance because you won't be able to cancel in the event of a mistake.
  11. Under Menu, click Recent Activity to track the progress and success of your update.
    An hourglass icon indicates your upload is still in progress. For more information, see Tracking recent activity.