KwikiInstallation

Installing a Kwiki Site

If you are not familiar with installing Perl modules from CPAN and you do not have "root" access to your computer, Kwiki will take a bit more effort. See KwikiFriendlyHosting to learn about step-by-step instructions and workarounds for web hosting servers. [No info on this page yet, so you're screwed if you need to run from your web host, which typically won't give you root or shell access.]

Installation Check List:

• You have computer with an Apache Web server installed.
• Perl must be configured as the interpreter for .cgi
• You have Perl 5.6.1 or newer installed. Note: probably you want 5.8.6 or later (see here for some discussion).
• The following CPAN modules are installed (See InstallingPerlModules for more information):
• Kwiki
• Spoon
• URI
• Spiffy
• IO::All
• Template (Template Toolkit 2)
• Your computer is connected to the Internet to reach the CPAN website to install the Kwiki module
• You can log in as "root" or have sufficient system privileges to install new software.

First: Install Kwiki module

The best way to install Kwiki, the Kwiki plugins, and all the Kwiki dependencies is by using the Kwiki Subversion Repository, follow the instructions in README.

If you are using Debian GNU/Linux, see KwikiDebianPackages.

If you are using Fedore Core all the required packages are available via Dries RPM Repository , i.e. you can just run "apt-get install perl-Kwiki".

It is not recommended installing the Kwiki module from CPAN, because it has not been updated for a long time.

• Windows users: Kwiki requires Perl and Apache (see above). These are not mutually exclusive with Windows, but installation of such is beyond the scope of this site. Google is your friend - a search on "Windows Perl" and "Windows Apache" will get you started.
• Kwiki is released as a Perl module and requires other Perl modules to function. The great thing about CPAN installs, however, is being prompted when a required module is missing. Kwiki requires the modules IO and Spiffy, for example. When prompted, you may hit enter and request these prerequisite modules (and any others) are added to the installation que. CPAN will grab, compile and install all this stuff for you, too!
• Mac OSX Users: I recommend that you use the manual configuration option. If you get the following warning, download the XCode Tools from the Apple Developer site.

Warning: make not found in PATH

Second: Create a directory for your Kwiki

Create a new directory in your Apache web docs folder. Depending on your configuration and preference, you can either create a directory for Kwiki in your web docs folder or you can create a new directory for Kwiki in your cgi-bin directory (but see ScriptAlias if you do).

Change the ownership of the directory to match that of the apache process on your machine.

Third: Create your new Kwiki in the directory

Navigate to this new directory from the command line and execute the following command:

# kwiki -new

This will run a short script to copy the necessary template and configuration files to the directory where the command was executed. (Note: the directory must be empty. Kwiki won't install into a directory that already has files.)

Now execute the following command:

# kwiki -update

This will make sure the configuration is completed.

Fourth:

Open up your browser and point it to that directory and on your web server.

Voila! You can set up new Kwikis in seconds hereafter. Just create other directories and install other Kwikis on your server with ease.

Fifth: Install desired kwiki plugins

The command "kwiki -new" only installs the most basic kwiki. Everything in kwiki are other Perl modules. To update your kwiki with plugins, return to the command line to retrieve additional Kwiki Perl modules from CPAN. See InstallingPerlModules. Bundle::Kwiki contains several commonly used plugins.

Or more directly to the point, see KwikiPluginInstallation.

Apache Config

Here's a sample Apache config section that may help. NOTE: This information has been snipped due to a bug in Wikiwyg. See WikiwygBugs for details. You should be able to find the full config section in one of the revisions of this page.

Alias /kwiki/ /home/ingy/kwiki/

Adjust to your needs.

The following may be out of date.

See Also

• KwikiUpgrading
• KwikiModPerl
• KwikiPrivacy
• KwikiFriendlyHosting

All the text from here and the rest of the page ought to be either moved to KwikiInstallationProblems or deleted.

Kwiki 0.38 "trace" is not exported by the Spoon::Base module at C:/Perl/site/lib/Spiffy.pm

I have installed

• Locale::Maketext
• Locale::Maketext::Lexicon
• I18N:: LangTags

to see if the problem is resolved but nothing. what can i do ?

Kwiki 0.38 'No plugin for action display'

I got this error after installing Kwiki 0.38. It took me a while to figure out that I could solve it by running kwiki -update. See also ShortRegistry.

Problem creating a new kwiki:

While creating a new kwiki: "virtual kwiki -new" (the "virtual" is because it is on a VirtualPrivateServer hosted by Verio)

Pages.pm finds a problem. After putting this line into line 43 of Spiffy.pm,

print "$self_package\n";

I get the output below. Something in Pages.pm fails. I have done other debugging steps that show @ Spoon::Base::EXPORT does indeed contain "trace", and other futzing around trying to see what is happening. If you can point me to where the error may lie, I'd be happy to follow your hint. Or do you instantly know the problem? Ron mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto: mailto:kwiki@magnadev.com

www1% virtual kwiki new

Comment:

Installing these modules makes the problem go away on a fresh install.

• Locale::Maketext
• Locale::Maketext::Lexicon
• I18N:: LangTags

The original fix at: kwikimj.kn.vutbr.cz/index.cgi?BugReport

Question:

my webserver doesn't use cgi-bin... (dreamhost.com)... you can place things anywhere and they'll run. now what– do i have to rename a bunch of files with a cgi extention? which ones?

A: Probably not, see: KwikiOnDreamhost – GeoffHubbard

Might need the -new paramater

Following these instructions I got the following error message when installing on Solaris:

$ kwiki -install

To get around the problem, I ran this command instead:

$ kwiki -new `pwd` -install

(Those are backticks around the "pwd" command. You can replace with the installation directory if you like.) – DanDan

Kwiki_0.32 OnWindowsNtUsingIIS

-- This space was left blank on proupose --

302 Error on page save - malformed header / Bad header errors

If you get a 302 error message when saving a page, check your logs. If you see a message such as the following, read on:

malformed header from script. Bad Header=Location="index.cgi?action=edi: index.cgi

Thanks to the RTWiki, I learned that this error is due to a bug in perl 5.8.0 (#21951) under UTF8 locales. CGI.pm = 2.92. If you are on a shared host, you can install the CGI libraries locally. Curiously, this error only appears when saving a page.

• note : I have recently got this error for all redirects sent by kwiki, not just saving a page. E.g. ? PageName (=> ?page_id= PageName) would throw it, but the target would be ok. Updating CGI via CPAN did the job. – Jon Dowland

Question

Using the command "kwiki -new `pwd` -install" I received the error:

Can't locate object method "parse_y0c0_file" via package "Kwiki::Config" at /usr/lib/perl5/site_perl/5.8.0/Spoon/Config.pm line 52.

This is with Kwiki 0.33.

Workaround is documented here: www.kwiki.org/?BugReports

Installation Documentation Suggestions

A couple of minor changes to the documentation might be in order, as there are some instructions that would mean absolutely nothing to someone not particularly knowledgeable about PERL or Apache:

1. Most people expect you have to download something manually to install it. I did. I downloaded the 0.33 file, looked at the readme which said:

If you are impatient (don't worry, that's a good thing!) read Kwiki::Command to get the details on how to install and configure a new Kwiki wiki in record time.

• In the download package look under lib/Kwiki/Command.pm, maybe by doing `perldoc lib/Kwiki/Command.pm`
• or install Kwiki through the CPAN shell

Unfortunately for me (or anyone else unfamiliar with PERL or CPAN) "read [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [Kwiki::Command"]]]]]]]]]]]]]]]] is about as meaningful as "read QgdeaTdw Wdgge@$". I have absolutely no idea what that means or how to get to those instructions.

• Most documentation is collected on these Wiki pages here.

2. I did find out that the above wasn't necessary to install by reading the installation information on the kwiki.org website (this page). However, I got stuck on the second command, "Make a new directory in your Apache cgi-bin", as I also don't know where my Apache cgi-bin might be, or where to look for it (Debian Sarge).

• Try /usr/lib/cgi-bin, but you could have found that by looking into your /etc/apache/httpd.conf. Just on an other note, you could use the KwikiDebianPackages on Debian.

Just a couple of minor suggestions. I'd answer them myself (this being a wiki), but I don't actually know the answers, so I'll leave it to someone who does know (or will return when I find out).

Question

When running perl -MCPAN -e 'install Kwiki' it fails and says:

Could not eval '

package ExtUtils::MakeMaker::_version;

How do i fix this???

Not an answer

What platform (Linux/BSD/Windows/?), what perl version (perl -v)?

Try:

perl -MCPAN -e shell

Problems Installing on Mac OS-X

On my OS 10.4 Mac I Found I also needed to run

kwiki -add Kwiki::Display

and

sudo chown -R www:www .

both from my new kwiki directory.

The second command allowed the http deamon which runs as www to write to the files and directories which were installed with my default ownership and prevented a "Software Error" writting to theme_screen.html.ttc. I guess other hosts may have a similar problem, but may run httpd as a different user and/or group. In that case you would need to replace www:www with : . I found the user and group (www and www) in httpd.conf

I'm having problems installing

Hi.

I've been trying to install kwiki using CPAN but at the end it says:

make had returned bad status, install seems impossible.

I'm on a Mac running os X 1.4.2.

Here's the text from my terminal:

CPAN.pm: Going to build A/AB/ABW/AppConfig-1.56.tar.gz

Checking if your kit is complete... Looks good Writing Makefile for AppConfig

-- NOT OK

Running make test

Can't test without successful make

Running make install

make had returned bad status, install seems impossible

Running make for A/AB/ABW/Template-Toolkit-2.14.tar.gz

Is already unwrapped into directory /Users/tomas/.cpan/build/Template-Toolkit-2.14

Running make test

Can't test without successful make

Running make install

make had returned bad status, install seems impossible

Running make for I/IN/INGY/Spoon-0.23.tar.gz

Is already unwrapped into directory /Users/tomas/.cpan/build/Spoon-0.23

Running make test

Can't test without successful make

Running make install

make had returned bad status, install seems impossible

Running make for I/IN/INGY/Kwiki-0.38.tar.gz

Is already unwrapped into directory /Users/tomas/.cpan/build/Kwiki-0.38

Running make test

Can't test without successful make

Running make install

make had returned bad status, install seems impossible

And when I try to run the perl script "perl kwiki -new", I get this error:

Can't locate Spoon.pm in @INC (@INC contains: lib /System/Library/Perl/5.8.6/darwin-thread-multi-2level /System/Library/Perl/5.8.6 /Library/Perl/5.8.6/darwin-thread-multi-2level /Library/Perl/5.8.6 /Library/Perl /Network/Library/Perl/5.8.6/darwin-thread-multi-2level /Network/Library/Perl/5.8.6 /Network/Library/Perl /System/Library/Perl/Extras/5.8.6/darwin-thread-multi-2level /System/Library/Perl/Extras/5.8.6 /Library/Perl/5.8.1 .) at lib/Kwiki.pm line 2. BEGIN failed–compilation aborted at lib/Kwiki.pm line 2. Compilation failed in require at kwiki line 10. BEGIN failed–compilation aborted at kwiki line 10.

Can anyone help with this?

Thanks!

The kwiki install doesn't seem to deal with rights. I finally got all the modules installed, but when I point my browser at the kwiki's index.cgi, I get

Internal Server Error

I looked in my apache error log and I found

failed to open log file fopen: Permission denied [Wed Aug 31 03:31:44 2005] error [client 210.195.78.19] Premature end of script headers: /home/virtual/site98/fst/var/www/cgi-bin/kwiki/index.cgi

Does anyone have an idea where this log is trying to be created? I looked through the kwiki modules and couldn't find any error messages regarding a log file.

Usually "fopen: permission denied" indicates that the #! line at the start of a script is not setup properly. Be sure to check that is the actual path to perl.

Also note that on Linux system with control panels and virtual file roots like Ensim, it's possible that the perl available to the root user is not the same as the perl available to the domain users. For example, /usr/bin/perl might be the perl in all the chroot'd domains, but the main root user might have /usr/local/bin/perl set as their default perl. If /usr/local/bin/perl is not explicitly linked into the file system of a domain account, that won't be available from scripts running from a particular domain account.

Also, on systems that have multiple perls installed, when installing Kwiki and it's modules be sure to run the perl that will be used with scripts served by the web server.

Finally, one of the lower level dependencies of Kwiki is Encode.pm, and that is not available on Perls before 5.7.2, so it will not be possible to get Kwiki to run on the default perl on older control paneled web hosts.

- Garnet

Installation dependencies for URI::Escape

When installing on Cygwin (clean install), CPAN install may fail due to a missing dependency. Spoon requires URI::Escape, and this isn't automatically found. After installing

perl -MCPAN -e 'install URI::Escape'

Spoon installation succeeds, and Kwiki installation succeeds. - (anthony at anthony dot org)

After installing and running page "index.cgi"

after installing trough perl and running "kwiki new /var/www/kwiki" > localhost/kwiki i get

#!/usr/bin/perl -w

what could be the problem?

I Can´t install kWiki

I Tried to install kwiki, and all modules of Perl are installed, but when put :

kwiki -new

this is a message result:

Extracting files for Kwiki Files: - ./index.cgi - ./README - ./palm90.png

Extracting files for Kwiki Configuration: - ./config/config.yaml - ./config.yaml - ./plugins

Generating Kwiki Registry '.registry.dd'Can't locate Template.pm in @INC (@INC contains: lib C: PXPerllib C:/ PXPerl/site/lib .) at C:/ PXPerl/site/lib/Spoon/Template.pm line 3, line 1.BEGIN failed–compilation aborted at C:/ PXPerl/site/lib/Spoon/Template.pm line 3, line 1.Compilation failed in require at C:/ PXPerl/site/lib/Spoon/Template/TT2.pm line 2, line 1.BEGIN failed–compilation aborted at C:/ PXPerl/site/lib/Spoon/Template/TT2.pm line 2, line 1.Compilation failed in require at C:/ PXPerl/site/lib/Kwiki/Template/TT2.pm line 2, line 1.BEGIN failed–compilation aborted at C:/ PXPerl/site/lib/Kwiki/Template/TT2.pm line 2, line 1.Compilation failed in require at (eval 88) line 3, line 1.

I have Windows XP and Apache installed, please help me!!!!

and the kwiki -update not run!!!

Contac mailto: mailto: mailto: mailto: mailto:leonuneza@gmail.com =8-)