Revision [6185]

This is an old revision of WikkaInstallation made by JavaWoman on 2005-02-20 10:04:26.

 

Wikka Documentation

Installing Wikka


Short instructions

If you are upgrading from an earlier version of Wikka or from WakkaWiki, see Upgrading Wikka to the latest release.
If you encounter problems during the installation, take a look at WikkaTroubleshooting.
Installing Wikka takes just a few steps:
  1. Unpack the distribution files
  2. Upload them into a directory that can be accessed via the web.
  3. Create the database for wikka
  4. Go to the corresponding URL. A web-based installer will walk you through the rest.

Example
If your website, say, http://www.mysite.com, is mapped to the directory /home/johnny/www/,
and you have uploaded the Wikka distribution files into /home/johnny/www/wikka/, you should go to
http://www.mysite.com/wikka/.

Longer version

  1. Download the wikka-file from the HomePage. It is recommended to use the latest version marked as stable, unless you are interested in doing beta-testing (which is a good thing to be done, too).
  2. The file is a *.tar.gz file, which means that it is a packed file which you need to unpack. Windows users can use a programm like Winzip, 7zip or Winrar for this. Make sure you let it re-create (sub) directories.
  3. Upload the contents of the Wikka directory into your webfolder (something like www or public_html, for example www-data in debian, apache on redhat linux); or a subdirectory of that if you prefer [see *note].
  4. Create the database for wikka. If you can, use phpmyadmin for it, but you could also do it from the prompt. If your host won't let you create a new database, don't worry - you can use an existing one and tell the installer to use a prefix for all the table names so there won't be any name clashes. You also need to have (or create) a user for the database with sufficient permissions for Wikka to use to access the database; this user needs all the usual permissions for reading, writing and modifying, as well as creating tables (which is what the installer is going to do).
  5. Point your browser to your web directory where Wikka is located - this will start the installer.
  6. Follow the instructions of the installer.

*note: If you are installing in a subdirectory and using mod_rewrite, see ModrewriteInSubdirectoryWorkaround.

Config file
During first installs, the installer will try to create a file called wikka.config.php in your Wikka directory. In order to do this, you will need to either make the Wikka directory writable by the web server, or create a new (empty) file called wikka.config.php which is writable by the web server. On Unix systems this can be done via the following commands:
touch wikka.config.php; chmod 666 wikka.config.php; (don't forget to remove write access again later, i.e. chmod 644 wikka.config.php).
If the installer still fails to create the file, it will dump the file's contents which you can then save and upload manually.

IMPORTANT: for installing or upgrading Wikka, do NOT access any of the files contained in the setup/ subdirectory. They're used by the web-based installer/updater and should not be called directly from a browser.



CategoryDocumentation
There are 88 comments on this page. [Show comments]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki