Wiki source for Installing140

Show raw source

===== Installation and upgrade notes for Wikka 1.4.0 =====

These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.2 or earlier to 1.4.0. If you are installing Wikka for the first time, please refer to [[WikkaInstallation | this page]] instead.
""<div style="float:left; margin: 20px 0; padding: 0 15px 10px 15px; width:97%; background-color:#FEE; border:1px solid #EDD">
<h3>Important notes</h3>
<b>Old-style forced links now largely nonfunctional</b><br/>
Forced links using a space separator (<tt>[[HomePage | My home page]]</tt>) have been deprecated since 1.3.1. They are now largely nonfunctional as of this version. See the upgrade instructions below for more details.
This release has been tested with MySQL 5.7.14 and PHP 7.0.10. Minimum requirements are MySQL 5.5 (earlier versions may work but are unsupported) and PHP 7.0. Also note that MySQL versions 5.7.3 through 5.7.7 will generate installation errors due to an erroneously-deprecated feature on MySQL's part. Please avoid using these versions (this release was tested with 5.7.14).
<b>Upgrading from 1.3.7 to 1.4.0</b><br/>
Note that 1.4.0 requires PHP 7.0! You will need to have PHP 7.0 running <em>prior to accessing the upgraded site to initiate the upgrade.</em>
<b>Upgrading from 1.2 to 1.3.7</b><br/>
Some CSS changes have been made to the themes, so as always, please make a backup of your <tt>default</tt>, <tt>light</tt>, and/or <tt>kubric</tt> themes if you have customized them.
Also, the 1.3.6 installer now backs up the standard installed files in <tt>config/</tt>, as these have changed significantly. If you have modified your menus, you will have to manually merge your changes into the new installed <tt>config/</tt> files.
<b>Upgrading from 1.1.x to 1.3.7</b><br/>
As of 1.2, WikkaWiki incorporates new support for modularized themes. A new file hierarchy has been introduced, and the old <tt>css/</tt> directory is going away. <strong>It is imperative that you make a backup of your <tt>css/</tt> and <tt>templates/</tt> directory BEFORE attempting to upgrade, if you have customized your site theme!</strong> Failure to do so will most likely result in a loss of part or all of your theme changes. <em>It's always good practice to back up both your Wikka install directory and your database prior to any upgrades.</em>
Since WikkaWiki has supported a <tt>plugins/</tt> directory that is guaranteed not to be modified by the installer/updater. While it's important to backup any customized themes or actions, you should really be putting these into the <tt>plugins/</tt> directory.


>>==See also:==
~-[[WhatsNew140 | What's new in 1.4.0]]
~-[[Changelog | Changelog for 1.4.0]]
~- [[InstallingPlugins | How to use the plugins folder]]
>>Users running previous versions of Wikka are recommended to **[[UpgradeNotes | upgrade]]** or **[[WikkaInstallation | install a fresh package]]**. [[UpgradeNotes | Upgrading]] via the web-based wizard takes only a few minutes.

====Upgrading from 1.3.5 or earlier====
Forced links using a space separator (##""[[HomePage | My home page]]""##) have been deprecated since 1.3.1. They are now largely nonfunctional as of this version. You will need to modify your forced links and use the ##|## symbol as the separator (##""[[HomePage | | My home page]]""##). You can either do this manually, or use a script that can be found in the ##scripts/## directory. If you use the script, it will make a backup of your current database, but it's always a good idea to back up your database whenever you make any system changes. It is not currently integrated in the installer, so you will need command-line access to perform the link migration. Navigate to your top-level wikka directory and invoke:

php scripts/migrateDeprecatedLinks.php

(Thanks to klenwell for implementing this!)

====Upgrading from 1.2 or earlier====
To upgrade from a previous 1.2 or earlier install, simply overwrite all existing files from the installation with a fresh [[WhatsNew12 | 1.2 download]]. The upgrader will be invoked so you can verify existing DB and/or config settings. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**

====Upgrading from or earlier====
Significant changes were made in 1.2, so you're advised to scan through the [[Installing12 | 1.2 installation notes]] prior to upgrading. **Please be sure to read the important upgrade notice at the top of this page before proceeding.**

We have moved our repository and issues tracker to github. Links to the previous SVN repository and tracker will at some point fail to resolve. Feedback on potential issues related to upgrading from previous versions is always welcome. Please report any bug, issue or feature suggestions in the [[ | issues tracker]].

Valid XHTML :: Valid CSS: :: Powered by WikkaWiki