Upgrading Your Tiki

If you already have a Tiki site, upgrading to the current release is easy. Be sure to read the release notes for complete information about the new release, including any specific migration issues.

 Tip

For detailed information, see upgrading Tiki in Tiki Essentials.

 Note

If you installed Tiki from an automated installer, you may be to upgrade automatically. Check with your specific application for details.

Update the Tiki Files

  1. Backup your database.
  2. Backup any Tiki files that you customized. This includes any theme or style customizations.

     Tip

    If you customize any Tiki templates (TPL files) or styles (CSS files) you should do so in your own theme — not by changing existing theme files. This will make the upgrade process much easier.
  3. Download the latest Tiki archive (or patch set, if available). See Downloading Tiki for details.
  4. Copy the Tiki files to your web host. See Copying the Files to your Host for details.
  5. Reapply any Tiki customizations (from the files you backed-up in step 2). For themes and styles, simply copy the files to the appropriate Tiki directory.
    • Place your custom theme files in: ../themes/YOURSTYLE.CSS/..
      • css
      • fonts
      • icons
      • images
      • less
      • options
      • templates

Update your Database

Now that the new Tiki files are on your web host, you can use the Tiki installer to upgrade your database.

  1. Open your web browser to: http://www.yourdomain.com/tiki-install.php.

     Note

    If you copied the Tiki files to a subdirectory, include it, too. For example: http://www.yourdomain.com/subdirectory/tiki-install.php.

     Tip

    Tiki has been translated to more than 40 different languages. To access the installer in your language, use http://www.yourdomain.com/tiki-install.php?lang=XX, where XX is the two-letter ISO code for the language.

    If the message Installer disabled. Remove 'db/lock' to enable the installer. appears instead of the Tiki installer screen, that means you locked the installer. See this troubleshooting page for information on re-enabling the installer.
    Tiki Installer Disabled warning
    For your protection, you must unlock the installer first.
  2. On the Tiki installer Security Precaution screen, enter your Database administrator password and click Validate and Continue.
    Security Precaution

     Note

    This is the database username and password that you used when you configured the database connection.
    If you have forgotten this information, it is located in your ../db/local.php file.
  3. On the Tiki installer page, go directly to Step 5: Install & Upgrade.
    Tiki installer, selecting the upgrade step.
  4. On the Tiki installer screen, in the Upgrade area, click Upgrade to upgrade your database to the current Tiki version.
    File not found.

     Note

    To completely reinstall the database (that is, remove your existing database and start with a brand new install), click Reinstall The Database in the Installation area.

    This should take only a few moments, as Tiki busily upgrades your database tables. Upon completion, the final installer screen appears.
    File not found.

     Note

    Review any warnings or notices that Tiki displays. Especially important is the PHP Memory notice. Tiki requires at least 32MB of PHP memory. Review the Tiki Installation Requirements document for details.


You should be greeted by your Tiki's home page. Be sure to review the release notes for the new version (available on the Tiki Community Portal) for details on the new features available in this release.

 Tip

You should always clear the Tiki cache after performing an upgrade.


<HR>

Copyright

This guide is based on content originally published by KeyContent.org.

This guide is Copyright (C) 2007-2013, 2019 by Rick Sapir and others under a Creative Commons Attribution-Share Alike 4.0 License. Some rights reserved.

Essentially, you are are free:

Image

to Share — to copy, distribute and transmit the work
Image

to Remix — to adapt the work


Under the following conditions:

Image
Attribution. You must attribute the work to me, as the original licencor, but not in any way that suggests that I endorse you or your use of the work.
Fair attribution includes a return link to http://tikiforsmarties.com (for online use) and mention of primary author (Rick Sapir) and original publisher (KeyContent.org).
Image

Share Alike. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same, similar or a compatible license.


Please read http://creativecommons.org/licenses/by-sa/3.0/legalcode for the full license.

Tiki®, TikiWiki® and the Tiki logo are registered trademarks of the Tiki Software Community Association, used with permission.