Wiki source for Installing137


Show raw source

===== Installation and upgrade notes for Wikka 1.3.7 =====

These are instructions you should follow if you wish to upgrade an existing wiki running on Wikka 1.2 or earlier to 1.3.7. 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.
<p><p>
<b>Requirements</b><br/>
This release has been tested with MySQL 5.5.43 and PHP 5.5.9. Please note that if you are using a version of PHP < 5.4, breadcrumbs must be disabled (<tt>'enable_breadrumbs' => '0'</tt> in <tt>wikka.config.php</tt>).
<p><p>
<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>
<p><p>
Since 1.1.6.6 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.
<p><p>
<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.
<p><p>
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.
</div>""

>>==See also:==
~-[[WhatsNew137 | What's new in 1.3.7]]
~-[[Changelog | Changelog for 1.3.7]]
~- [[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.1.6.7 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.**

====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 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!)

====Feedback====
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 [[https://github.com/wikkawik/WikkaWiki/issues | issues tracker]].

----
CategoryEN
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki