Revision history for WikkaInstallation
Additions:
=====Installing Wikka from Scratch=====
Deletions:
Additions:
~-[[Installing12 | Installation & upgrade notes for 1.2]]
Deletions:
Additions:
~-[[Installing1167 | Installation & upgrade notes for 1.1.6.7]]
Deletions:
Additions:
~-[[http://wikkawiki.org/WikkaHosting | Preconfigured Wikka hosting]]
Additions:
~-[[Installing1166 | Installation & upgrade notes for 1.1.6.6]]
~-[[ThirdPartyDistributions | 3rd party installers & distributions]]
~-[[ThirdPartyDistributions | 3rd party installers & distributions]]
Deletions:
Revision [1355]
Edited on 2008-11-12 04:10:37 by TormodHaugen [bit better info about fixing missing mod_rewrite]Additions:
a) If you get an error, your server might have disabled ##mod_rewrite##. You should:
i) consider disabling ##""RewriteEngine""## and continue to use Wikka without it.
i) Talk to your Administrator about ##mod_rewrite##, or check up on [[ModRewrite | Wikka and mod_rewrite]] if you control your server yourself.
i) consider disabling ##""RewriteEngine""## and continue to use Wikka without it.
i) Talk to your Administrator about ##mod_rewrite##, or check up on [[ModRewrite | Wikka and mod_rewrite]] if you control your server yourself.
Deletions:
Deletions:
Additions:
~-[[http://wiki.uniformserver.com/index.php/Installing_Wikka_Wiki | Installing Wikka on Uniform Server]]
Additions:
>>==Notes:==
~-[[Installing1164 | Installation & upgrade notes for 1.1.6.4]]
~-[[Installing1164 | Installation & upgrade notes for 1.1.6.4]]
Deletions:
Additions:
1) **Download** the wikka-file from the Wikkawiki [[http://wikkawiki.org/HomePage | 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).
1) 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 program like [[http://www.winzip.com/ | Winzip]], [[http://www.7-zip.org/ | 7zip]] or [[http://en.wikipedia.org/wiki/WinRAR | Winrar]] for this. Make sure you let it re-create (sub) directories.
1) 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 program like [[http://www.winzip.com/ | Winzip]], [[http://www.7-zip.org/ | 7zip]] or [[http://en.wikipedia.org/wiki/WinRAR | Winrar]] for this. Make sure you let it re-create (sub) directories.
Deletions:
1) 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 program like [[http://www.winzip.com/ Winzip]], [[http://www.7-zip.org/ | 7zip]] or [[http://en.wikipedia.org/wiki/WinRAR | Winrar]] for this. Make sure you let it re-create (sub) directories.
Revision [368]
Edited on 2006-12-27 12:13:02 by YanB [revised version, updated formatting and links]Additions:
HomePage
~-If you encounter **problems** during the installation, take a look at [[http://wikkawiki.org/WikkaTroubleshooting | WikkaTroubleshooting]].
##""http://www.mysite.com/wikka/""##.
1) **Download** the wikka-file from the Wikkawiki [[http://wikkawiki.org/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).
1) 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 program like [[http://www.winzip.com/ Winzip]], [[http://www.7-zip.org/ | 7zip]] or [[http://en.wikipedia.org/wiki/WinRAR | Winrar]] for this. Make sure you let it re-create (sub) directories.
1) 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].
1) Create the **database** for wikka. If you can, use [[http://www.phpmyadmin.net]] | for it, but you could also ##""CreateNewDB""## 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, modifying and deleting records, as well as creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
***note**: If you are installing in a subdirectory **and** using ##mod_rewrite##, see [[http://wikkawiki.org/ModrewriteInSubdirectoryWorkaround ModRewrite In Subdirectory Workaround]].
While installing Wikka, and if you don't get what you expected when pointing to //##""http://yoursite/subdirectory_if_it_exists""/##// or ##//""http://yoursite/""##// if your wikka is installed at root (we'll name this URL ::indexpage::), then try these little steps:
1) edit the file ##.htaccess## and change ##""RewriteEngine"" {{color c="red" text="On"}}## to ##""RewriteEngine"" {{color c="green" text="Off"}}##
1) go to the corresponding URL (::indexpage::). This should lead you to something like ##{{color c="blue" text="/wikka.php?wakka=HomePage"}}##. If that happens, and you get the first-step installation page, then
a) Re-edit the file ##.htaccess## and restore the ##""RewriteEngine""## directive to ##""RewriteEngine"" {{color c="green" text="On"}}##
a) put a ##""RewriteBase""## directive after it : ##{{color c="green" text="RewriteBase /"}}## if you install wikka at root or ##{{color c="green" text="RewriteBase /subdirectory/"}}##
a) If you get an error, then consider you shoud really disable ##""RewriteEngine""## and continue to use Wikka without it.
During first installs, the installer will try to create a file called ##[[ConfigurationOptions | 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:
__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.
If you want to use [[http://en.wikipedia.org/HTTPS | HTTPS]], you have to adjust the ##base dir##, i.e. the path to your wikka which you enter during the installation must start with //##https##// instead of //##http##//. You can change this at any time in the [[ConfigurationOptions | configuration file]].
CategoryEN
~-If you encounter **problems** during the installation, take a look at [[http://wikkawiki.org/WikkaTroubleshooting | WikkaTroubleshooting]].
##""http://www.mysite.com/wikka/""##.
1) **Download** the wikka-file from the Wikkawiki [[http://wikkawiki.org/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).
1) 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 program like [[http://www.winzip.com/ Winzip]], [[http://www.7-zip.org/ | 7zip]] or [[http://en.wikipedia.org/wiki/WinRAR | Winrar]] for this. Make sure you let it re-create (sub) directories.
1) 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].
1) Create the **database** for wikka. If you can, use [[http://www.phpmyadmin.net]] | for it, but you could also ##""CreateNewDB""## 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, modifying and deleting records, as well as creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
***note**: If you are installing in a subdirectory **and** using ##mod_rewrite##, see [[http://wikkawiki.org/ModrewriteInSubdirectoryWorkaround ModRewrite In Subdirectory Workaround]].
While installing Wikka, and if you don't get what you expected when pointing to //##""http://yoursite/subdirectory_if_it_exists""/##// or ##//""http://yoursite/""##// if your wikka is installed at root (we'll name this URL ::indexpage::), then try these little steps:
1) edit the file ##.htaccess## and change ##""RewriteEngine"" {{color c="red" text="On"}}## to ##""RewriteEngine"" {{color c="green" text="Off"}}##
1) go to the corresponding URL (::indexpage::). This should lead you to something like ##{{color c="blue" text="/wikka.php?wakka=HomePage"}}##. If that happens, and you get the first-step installation page, then
a) Re-edit the file ##.htaccess## and restore the ##""RewriteEngine""## directive to ##""RewriteEngine"" {{color c="green" text="On"}}##
a) put a ##""RewriteBase""## directive after it : ##{{color c="green" text="RewriteBase /"}}## if you install wikka at root or ##{{color c="green" text="RewriteBase /subdirectory/"}}##
a) If you get an error, then consider you shoud really disable ##""RewriteEngine""## and continue to use Wikka without it.
During first installs, the installer will try to create a file called ##[[ConfigurationOptions | 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:
__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.
If you want to use [[http://en.wikipedia.org/HTTPS | HTTPS]], you have to adjust the ##base dir##, i.e. the path to your wikka which you enter during the installation must start with //##https##// instead of //##http##//. You can change this at any time in the [[ConfigurationOptions | configuration file]].
CategoryEN
Deletions:
~-If you encounter **problems** during the installation, take a look at WikkaTroubleshooting.
""http://www.mysite.com/wikka/"".
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).
1) 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 program like Winzip, 7zip or Winrar for this. Make sure you let it re-create (sub) directories.
1) 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].
1) Create the **database** for wikka. If you can, use phpmyadmin for it, but you could also CreateNewDB 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, modifying and deleting records, as well as creating tables (which is what the installer is going to do); being allowed to drop tables (not databases) may also be needed later.
***note**: If you are installing in a subdirectory **and** using mod_rewrite, see ModrewriteInSubdirectoryWorkaround.
While installing Wikka, and if you don't get what you expected when pointing to {{color c="darkgray" text="http://yoursite/subdirectoryifexists/"}} (or {{color c="darkgray" text="http://yoursite/"}} if your wikka is installed at root), we'll name this URL ::indexpage::, try these little steps:
1) edit the file .htaccess and change {{color c="red" text="RewriteEngine On"}} to {{color c="green" text="RewriteEngine Off"}}
1) go to the corresponding URL (::indexpage::). This should lead you to something like {{color c="blue" text="/wikka.php?wakka=HomePage"}}. If that happens, and you get the first-step installation page, then
a) Re-edit the file .htaccess and restore the ""RewriteEngine"" directive to {{color c="green" text="RewriteEngine On"}}
a) put a ""RewriteBase"" directive after it : {{color c="green" text="RewriteBase /"}} if you install wikka at root or {{color c="green" text="RewriteBase /subdirectory/"}}
a) If you get an error, then consider you shoud really disable RewriteEngine and continue to use Wikka without it.
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:
__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.
If you want to use HTTPS, you have to adjust the base dir, i.e. the path to your wikka which you enter during the installation must start with //https// instead of //http//. You can change this at any time in [[ConfigurationOptions | the config]].
CategoryDocumentation