Dashboard > Openfire > Home > Wildfire Upgrade Guide
  Openfire Log In View a printable version of the current page.  
  Wildfire Upgrade Guide
Added by Greg Unrein, last edited by LG on Aug 22, 2007  (view change) show comment
Labels: 
(None)

Upgrading from Wildfire to Openfire?

Check out the Wildfire to Openfire Upgrade Guide. The document below describes upgrading to Wildfire 3.2, so if you're already on 3.2 looking to get to 3.3.0 or later, see the Wildfire to Openfire Upgrade Guide.

Looking for upgrade instructions for the Wildfire Enterprise plug-in? A brief guide is available.

Upgrading Wildfire to 3.2, Including Plugins and Certificates

Upgrading Wildfire must be completed in the following sequence:

  1. Upgrade Wildfire
  2. Upgrade Wildfire Enterprise
  3. Run the manual steps to move the update the Fastpath data for the new Enterprise plugin.

Do not upgrade plugins prior to upgrading Wildfire itself or the plugins will stop working.

Windows EXE

Upgrading Wildfire on a Windows machine can be accomplished by following these steps.

  1. Stop Wildfire.
  2. Backup the Wildfire installation directory. The default is C:\Program Files\Wildfire
  3. Backup the Wildfire database. Note that the embedded database is backed up in step 2.
  4. Run the installer for the new version of Wildfire (note that the installer MUST point to the base installation directory of the previous version).
    http://www.igniterealtime.org/downloads/download-landing.jsp?file=wildfire/wildfire_3_2_0.exe
  5. Complete the installer process.
  6. Start Wildfire.

The new version of Wildfire will be installed over the existing version and all settings and data will be retained.

Linux RPM

Upgrading Wildfire on Linux with an RPM can be accomplished by following these steps.

  1. Stop Wildfire.
  2. Backup the Wildfire installation directory. This step is critical because the data will be overwritten with the new RPM install.
  3. Backup the Wildfire database. Note that the embedded database is backed up in step 2.
  4. Install the RPM.
    http://www.igniterealtime.org/downloadServlet?filename=wildfire/wildfire_3_2_0.rpm
  5. Copy the conf directory from the backup to the installation directory.
  6. Copy the embedded-db directory from the backup to the installation directory.
  7. Copy the enterprise directory from the backup to the installation directory, if it exists.
  8. Copy the plugins directory from the backup to the installation directory except for plugins/admin.
  9. Copy the resources/security/keystore file from the backup to the installation directory.
  10. Copy the resources/security/truststore file from the backup to the installation directory if you modified this file.
  11. Start Wildfire.

Mac OS X DMG

Upgrading Wildfire on an OS X machine can be accomplished by following these steps.

  1. Stop Wildfire.
  2. Backup the Wildfire installation directory. The default is /usr/local/wildfire.
  3. Backup the Wildfire database. Note that the embedded database is backed up in step 2.
    http://www.igniterealtime.org/downloads/download-landing.jsp?file=wildfire/wildfire_3_2_0.dmg
  4. Open the installer for the new version of Wildfire.
  5. Complete the installer process.

The new version of Wildfire will be installed over the existing version and all settings and data will be retained.

ZIP or TAR.GZ

Upgrading with a ZIP or TAR.GZ file is can be accomplished by following these steps.

  1. Stop Wildfire.
  2. Backup the Wildfire installation directory. This step is critical because the data will be overwritten with the new .tar.gz install.
  3. Backup the Wildfire database. Note that the embedded database is backed up in step 2.
    http://www.igniterealtime.org/downloadServlet?filename=wildfire/wildfire_3_2_0.tar.gz
  4. Install the .tar.gz file (extract it over the current directory).
  5. Copy the conf directory from the backup to the installation directory.
  6. Copy the embedded-db directory from the backup to the installation directory.
  7. Copy the enterprise directory from the backup to the installation directory, if it exists.
  8. Copy the plugins directory from the backup to the installation directory except for plugins/admin.
  9. Copy the resources/security/keystore file from the backup to the installation directory.
  10. Copy the resources/security/truststore file from the backup to the installation directory if you modified this file.
  11. Start Wildfire

FreeBSD Port

See the FreeBSD Port Guide for more information on this operating system.

Plugins

After successfully installing Wildfire, start the service and ensure your users exist, and that you can still connect. Once you have done this, you need to upgrade the plugins. This is a two step process. Note that the Fastpath plugin is now included in the Wildfire Enterprise plugin.

  1. Navigate to the plugins directory, and select to upgrade Wildfire Enterprise.
  2. Follow the guide to migrate your Fastpath data.

Certificates

During an initial setup Wildfire will create the resources/security/keystore and resources/security/truststore files. The keystore file is where certificates of the XMPP server are stored and truststore is where certificates of trusted Certificate Authorities are stored. The keystore file is completed with self-signed certificates after the setup process has been completed. The truststore is never modified by Wildfire.

During the update process Wildfire will never overwrite the keystore and truststore files. Wildfire 3.2.0 has updated the truststore file with new trusted Certificate Authorities. Therefore, it is important to update this file in your existing installation. If you have not modified the truststore file then you can just replace it with this one. However, if you have modified your truststore file then you may want to recreate it. The suggested procedure is to download this new version and apply again your changes.

Site powered by a free Open Source Project / Non-profit License (more) of Confluence - the Enterprise wiki.
Learn more or evaluate Confluence for your organisation.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.3.3 Build:#645 Feb 13, 2007) - Bug/feature request - Contact Administrators