Wikka Documentation : UpgradeNotes

HomePage :: Index :: RecentChanges :: Search :: Login/Register
[2106] Latest edit on 2009-09-03 03:24:54 by DarTar [link]


Additions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications. Before upgrading make sure you read the specific instructions for the version you are upgrading to.
Deletions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.


[2102] Edited on 2009-09-03 02:08:45 by DarTar [->1.2]


Additions:


Deletions:




[1990] Edited on 2009-06-15 03:01:49 by DarTar [version update]


Additions:


Deletions:




[1989] Edited on 2009-06-15 03:01:22 by DarTar [version update]


Additions:


Deletions:




[1925] Edited on 2009-02-16 06:28:05 by DarTar [link to 1.1.6.6 upgrade notes]


Additions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.
Deletions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.


[1721] Edited on 2009-01-14 09:01:19 by DarTar [removing extra whitespace]


No Differences


[1336] Edited on 2008-11-01 23:23:06 by DarTar [Removed HomePage link]


Deletions:
HomePage


[1130] Edited on 2008-06-25 03:35:18 by DarTar [removing link to 1.1.6.4]


Additions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.
Deletions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.


[1015] Edited on 2008-03-20 07:30:08 by DarTar [link to 1.1.6.4 upgrade notes]


Additions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.
Deletions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.

Upgrade notes

  • since 1.1.6.4
    the template files (header.php and footer.php) can be found in a dedicated directory called /templates If you made any modifications to the original files (in the /actions directory), you will need to apply these changes to the new files.



[615] Edited on 2008-02-01 02:09:51 by DarTar [upgrade notes]


Additions:

  • since 1.1.6.4
    the template files (header.php and footer.php) can be found in a dedicated directory called /templates If you made any modifications to the original files (in the /actions directory), you will need to apply these changes to the new files.

Deletions:

  • {{since version="1.1.6.4" display="inline"} the template files (header.php and footer.php) can be found in a dedicated directory called /templates If you made any modifications to the original files (in the /actions directory), you will need to apply these changes to the new files.



[614] Edited on 2008-02-01 02:09:24 by DarTar [note on templates]


Additions:

Upgrade notes

  • {{since version="1.1.6.4" display="inline"} the template files (header.php and footer.php) can be found in a dedicated directory called /templates If you made any modifications to the original files (in the /actions directory), you will need to apply these changes to the new files.



[613] Edited on 2008-02-01 02:05:48 by DarTar [layout]


Additions:
For older versions of Wikka that have no custom modifications at all, and which didn't use file uploads.
 

For older versions of Wikka with extra plugins, extensions and file uploads.
 

Deletions:
For older versions of Wikka that have no custom modifications at all, and which didn't use file uploads.
 

For older versions of Wikka with extra plugins, extensions and file uploads.
 



[612] Edited on 2008-02-01 02:04:51 by DarTar [notes]


Additions:
Wikka releases are upgrade tested before release, but, for your protection, backup all your Wikka files and the Wikka MySQL tables before upgrading. Backups are particularly important when restoring custom extensions after upgrading (see notes below).

Step 2: Select your upgrade method

  1. If you made modifications to files that are part of a Wikka distribution, these modifications will be lost when overwriting the files. This applies in particular to template files (e.g. header.php and footer.php) and stylesheets. If you made a backup before the upgrade (step 1), you will be able to restore specific modifications after the files have been overwritten by the installer. If you restore your custom wikka.css stylesheet after upgrading following method B, consider that there might be changes (e.g. new CSS selectors and settings) that need to be included in the stylesheet for Wikka to display properly.

Deletions:
Wikka releases are upgrade tested before release, but, for your protection, backup all your Wikka files and the Wikka MySQL tables before upgrading.

Step 2: select your upgrade method

  1. If you made modifications to files that are part of a Wikka distribution, these modifications will be lost when overwriting the files. This applies in particular to template files (e.g. header.php and footer.php) and stylesheets. If you restore your custom wikka.css stylesheet after upgrading following method B, consider that there might be changes (e.g. new CSS selectors and settings) that need to be included in the stylesheet for Wikka to display properly.



[611] Edited on 2008-02-01 02:02:11 by DarTar [notes]


Additions:

  1. If you made modifications to files that are part of a Wikka distribution, these modifications will be lost when overwriting the files. This applies in particular to template files (e.g. header.php and footer.php) and stylesheets. If you restore your custom wikka.css stylesheet after upgrading following method B, consider that there might be changes (e.g. new CSS selectors and settings) that need to be included in the stylesheet for Wikka to display properly.

Deletions:

  1. If you made modifications to files that are part of a Wikka distribution, these modifications will be lost when overwriting the files. This applies in particular to stylesheets. If you restore your custom wikka.css stylesheet after upgrading following method B, consider that there might be changes (e.g. new CSS selectors and settings) that need to be included in the stylesheet for Wikka to display properly.



[610] Edited on 2008-02-01 01:58:35 by DarTar [intro sentence]


Additions:
Upgrading a wiki to the latest version of Wikka is done via a web wizard and only takes a few minutes. However there are a few points to bear in mind when upgrading, in particular if your wiki has custom extensions or code modifications.


[609] Edited on 2008-02-01 01:55:28 by DarTar [further notes]


Additions:

Tips

If you have a high-traffic site, it is recommended that you lock your site first. Simply create a file called locked in the directory Wakka is located in. This file should contain a (plain text) password on its first line. When you go to your Wakka site, it will then ask you for a user name and password -- enter adminas the user name and the password in your locked file as the password. When you're done with upgrading, you should remove the locked file again.

Deletions:
Tips
If you have a high-traffic site, it is recommended that you lock your site first. Simply create a file called locked in the directory Wakka is located in. This file should contain a (plain text) password on its first line. When you go to your Wakka site, it will then ask you for a user name and password -- enter "admin" as the user name and the password in your locked file as the password. When you're done with upgrading, you should remove the locked file again.



[608] Edited on 2008-02-01 01:54:42 by DarTar [further notes]


Additions:

Step 1: Backup, backup, backup!

Step 2: select your upgrade method

  1. For Wikka instances with no custom modifications at all (very rare cases), Method A should be best : it's the simple "delete & replace" method. If you haven't hacked wikka's code, this method is for you. If you have changed the code, or if you used the "file upload" action, this method is risky because the wiki admin could lose data like file uploads, as well as any custom mods.
  2. For Wikka instances with custom extensions, plugins or file uploads, Method B (the overwrite method) is highly recommended. It should be made clear that using the overwrite method may leave useless files in the Wikka directory if the installer does not explicitly remove them. Note that some custom extensions may not work any more if they are not compliant with the new Wikka version.

Method A: delete old files & replace with a fresh installation

Method B: overwrite a previous installation

  1. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server by selecting the overwrite mode on your FTP client. [see notes]
Notes:
  1. Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories in the Wikka directory into the /public_html/wikka directory..... do not upload the Wikka directory itself into the Wikka directory. Otherwise, your installation will be in: /public_html/wikka/wikka/. See the difference?
  2. If you made modifications to files that are part of a Wikka distribution, these modifications will be lost when overwriting the files. This applies in particular to stylesheets. If you restore your custom wikka.css stylesheet after upgrading following method B, consider that there might be changes (e.g. new CSS selectors and settings) that need to be included in the stylesheet for Wikka to display properly.

Deletions:

Step 1: Backup, backup, backup!

If you experience any issues with upgrading, leave feedback on this page or use the form below.

Step 2: select your upgrade method

  1. For Wikka instances with no custom modifications at all (very rare cases), Method A should be best : it's the simple "delete & replace" method. If you haven't hacked wikka's code, this method is for you. If you have changed the code, or if you used the "file upload" action, this method is risky because the wiki admin could lose data like file uploads, as well as any custom mods.
  2. For Wikka instances with custom extensions, plugins or file uploads, Method B (the overwrite method) is highly recommended. It should be made clear that using the overwrite method may leave useless files in the Wikka directory if the installer does not explicitly remove them.
Method A: delete old files & replace with a fresh installation
or Method B: overwrite a previous installation
  1. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server by selecting the overwrite mode on your FTP client. [Note *]
* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories in the Wikka directory into the /public_html/wikka directory..... do not upload the Wikka directory itself into the Wikka directory. Otherwise, your installation will be in: /public_html/wikka/wikka/. See the difference?



[604] Edited on 2008-01-31 18:56:23 by YanB [rewrite: 1st draft]


Additions:

Upgrading Wikka to the latest release

There are two methods to upgrade Wikka, but both begin with Step 1.

Step 1: Backup, backup, backup!

Wikka releases are upgrade tested before release, but, for your protection, backup all your Wikka files and the Wikka MySQL tables before upgrading.

Step 2: select your upgrade method

  1. For Wikka instances with no custom modifications at all (very rare cases), Method A should be best : it's the simple "delete & replace" method. If you haven't hacked wikka's code, this method is for you. If you have changed the code, or if you used the "file upload" action, this method is risky because the wiki admin could lose data like file uploads, as well as any custom mods.
  2. For Wikka instances with custom extensions, plugins or file uploads, Method B (the overwrite method) is highly recommended. It should be made clear that using the overwrite method may leave useless files in the Wikka directory if the installer does not explicitly remove them.
Method A: delete old files & replace with a fresh installation
For older versions of Wikka that have no custom modifications at all, and which didn't use file uploads.
 

  1. Make a backup of your Wikka Wiki directory and MySQL data (see Step 1 above).
  2. Delete all of the files and subfolders in the Wikka directory except wikka.config.php. This is the only file that you need: it contains the information necessary to connect to your MySQL database.
  3. Point a web browser at the URL for your Wikka Wiki site. The web-based updater will appear (instead of your site) and the Wikka upgrade script will run.
or Method B: overwrite a previous installation
For older versions of Wikka with extra plugins, extensions and file uploads.
 

  1. Make a backup of your Wikka Wiki directory and MySQL data (see Step 1 above).
  2. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server by selecting the overwrite mode on your FTP client. [Note *]
  3. Start your favorite web browser and point it at the Wikka installation directory. The web-based updater will appear (instead of your site): look it over and make any desired changes, then click Continue at the bottom of the page.
* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories in the Wikka directory into the /public_html/wikka directory..... do not upload the Wikka directory itself into the Wikka directory. Otherwise, your installation will be in: /public_html/wikka/wikka/. See the difference?
Tips
If you have a high-traffic site, it is recommended that you lock your site first. Simply create a file called locked in the directory Wakka is located in. This file should contain a (plain text) password on its first line. When you go to your Wakka site, it will then ask you for a user name and password -- enter "admin" as the user name and the password in your locked file as the password. When you're done with upgrading, you should remove the locked file again.

Deletions:

Upgrading Wikka to the latest release

Backup, backup, backup!
Wikka releases are upgrade tested before release, but, for your protection, backup all your Wikka files and the Wikka MySQL tables before upgrading.
If you have a high-traffic site, it is recommended that you lock your site first. Simply create a file called locked in the directory Wakka is located in. This file should contain a (plain text) password on its first line. When you go to your Wakka site, it will then ask you for a user name and password -- enter "admin" as the user name and the password in your locked file as the password. When you're done with upgrading, you should remove the locked file again.
Instructions
  1. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server. Overwrite existing Wikka files. [Note *]
  2. Start your favorite web browser and point it at the Wikka installation directory.
  3. The web-based updater will appear (instead of your site): look it over and make any desired changes, then click Continue at the bottom of the page.
  4. That's it.
Alternative instructions:
  1. Delete all of the files and subfolders in the Wikka directory except wikka.config.php. This is the only file that you need.
  2. Read step 3 again -- do not delete the wikka.config.php file.
  3. Point a web browser at the URL for your Wikka Wiki site: The web-based updater will appear (instead of your site) and the Wikka upgrade script will run.
* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories into the /public_html/wikka directory..... do not upload the Wikka directory into the Wikka directory so that it looks like this: /public_html/wikka/wikka/. See the difference? In other words, when you select the files in your FTP client, browse into the Wikka release directory and select all files and folders, then upload.
  • What's the difference between the two methods above?
    • In the first set of intructions you are only uploading new files over the old files.
    • In the second set, you are cleaning out old, potentially unneeded files.



[367] Edited on 2006-12-27 12:06:57 by YanB [updated, formatting, cat.]


Additions:
HomePage
  1. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server. Overwrite existing Wikka files. [Note *]
  2. Read step 3 again -- do not delete the wikka.config.php file.
  3. Upload all the files from the latest Wikka release into the Wikka directory. [Note *]
* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories into the /public_html/wikka directory..... do not upload the Wikka directory into the Wikka directory so that it looks like this: /public_html/wikka/wikka/. See the difference? In other words, when you select the files in your FTP client, browse into the Wikka release directory and select all files and folders, then upload.
CategoryEN

Deletions:
Wikka Documentation
  1. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server. Overwrite existing Wikka files. *
  2. Read step 3 again -- do not delete the wikka.config.php file.
  3. Upload all the files from the latest Wikka release into the Wikka directory. *
* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories into the /public_html/wikka directory..... do not upload the Wikka directory into the Wikka directory so that it looks like this: /public_html/wikka/wikka/. See the difference? In other words, when you select the files in your FTP client, browse into the Wikka release directory and select all files and folders, then upload.
Any questions?
Q: Is the table structure the same as WakkaWiki 0.1.2 ? Is it possible to upgrade to Wikka by simply overwriting the previous wakka installation? -- DarTar

A: Yes, it is possible to upgrade by overwriting. See UpgradingFromWakkaWiki for more info. -- JsnX
CategoryDocumentation



[110] The oldest known version of this page was created on 2005-06-15 12:01:24 by MarcosAugusto

History of recent changes for UpgradeNotes
Wikka Documentation

Upgrading Wikka to the latest release


Backup, backup, backup!

Wikka releases are upgrade tested before release, but, for your protection, backup all your Wikka files and the Wikka MySQL tables before upgrading.

If you experience any issues with upgrading, leave feedback on this page or use the form below.


If you have a high-traffic site, it is recommended that you lock your site first. Simply create a file called locked in the directory Wakka is located in. This file should contain a (plain text) password on its first line. When you go to your Wakka site, it will then ask you for a user name and password -- enter "admin" as the user name and the password in your locked file as the password. When you're done with upgrading, you should remove the locked file again.
Instructions
  1. Backup your Wikka Wiki directory.
  2. Backup your Wikka Wiki MySQL data.
  3. Upload all the files and subfolders in the latest Wikka release file to the Wikka installation directory on your web server. Overwrite existing Wikka files. *
  4. Start your favorite web browser and point it at the Wikka installation directory.
  5. The web-based updater will appear (instead of your site): look it over and make any desired changes, then click Continue at the bottom of the page.
  6. Click Continue on the upgrading status page.
  7. That's it.

Alternative instructions:
  1. Backup your Wikka Wiki directory.
  2. Backup your Wikka Wiki MySQL data.
  3. Delete all of the files and subfolders in the Wikka directory except wikka.config.php. This is the only file that you need.
  4. Read step 3 again -- do not delete the wikka.config.php file.
  5. Upload all the files from the latest Wikka release into the Wikka directory. *
  6. Point a web browser at the URL for your Wikka Wiki site: The web-based updater will appear (instead of your site) and the Wikka upgrade script will run.

* Note: Make sure you upload the Wikka files into the correct directory. For example, if your Wikka directory is /public_html/wikka, upload the Wikka files and subdirectories into the /public_html/wikka directory..... do not upload the Wikka directory into the Wikka directory so that it looks like this: /public_html/wikka/wikka/. See the difference? In other words, when you select the files in your FTP client, browse into the Wikka release directory and select all files and folders, then upload.




Any questions?

Q: Is the table structure the same as WakkaWiki 0.1.2 ? Is it possible to upgrade to Wikka by simply overwriting the previous wakka installation? -- DarTar

A: Yes, it is possible to upgrade by overwriting. See UpgradingFromWakkaWiki for more info. -- JsnX


CategoryDocumentation
Creative Common Attribution-ShareAlike License
Valid XHTML 1.0 Transitional :: Valid CSS :: Powered by WikkaWiki
Page was generated in 0.0428 seconds