Kumera Home > basic install

Basic Installation

  1. First you need to make sure your perl environment will support Kumera. As mentioned in the FAQ you'll need the perl modules:


    These can be installed either from .rpm or .deb files, or from the CPAN archive.

    If you're using Debian you can grab these using apt-get.

    # apt-get install liburi-perl libhtml-tree-perl libxml-dom-perl

    If you're using the cpan script, then you need to run:

    # perl -MCPAN -e shell

    And follow the prompts for installing the above modules.

    NOTE: When you configure perl to use CPAN there are two things to consider: (a) it will update your perl modules and possibly make them become out of sync with your .deb or .rpm versions, and if you select the follow option for libraries and have a very fast connection and machine, it may pull down a new version of perl and rebuild it, which may cause untold disaster to your environment. Apart from that, it's pretty nifty.

  2. Unzip and untar the source in your web server root directory. This may wipe out some of your files, so you might want to perform a backup before you start. These operations will probably need to be performed as the root user, depending on how your system is set up.

    # cd /home/httpd
    # gzip -dc <path_to_archive>/kumera-0.3.tar.gz | tar xvf -

    [ lots of output ]
  3. Change the ownership and permissions of the files that need to be written to or executed by the web server. This step, although unix specific, may need an equivalent for Windows2000/XP (but not Win95/98 or ME.)

    Before you start, you may wish to clean up the permissions that the tar command applies from the archive. Replace the username and group grumpy:users with your username and group.

    # chown -R grumpy:users htdocs/ data/ cgi-bin/ lib/

    The group www-data may need to be changed to either nobody, nogroup or www depending on how your system is set up. These are the minimum requirements to make the system work.

    The last step might not be necessary as the archive already has execute permissions set for the cgi scripts. The file cgi-bin/Kumera.pm does not need execute permissions.

    # find data/files -type f -exec chmod 664 {} \;
    # find data/files -type d -exec chmod 2775 {} \;
    # chgrp -R www-data data/files

    # find htdocs/ -type f -exec chmod 664 {} \;
    # find htdocs/ -type d -exec chmod 2775 {} \;
    # chgrp -R www-data htdocs/
    # chmod 755 cgi-bin/*.cgi

    This will also mean the template files can be edited by anyone in the www-data group.

  4. Edit the file cgi-bin/Kumera.pm and change line 40 to point to the web server root directory.

    $BaseDir = '/home/httpd';
  5. The last step is to edit the configuration file for your web host settings. Edit the file data/conf/config.xml replacing the pre-set defaults (which don't work.) These should be the same as if you were running an ftp session, so if you ftp into your hosting provider, and you don't need to change directory, set the dir parameter to a single dot ".".

    <parameter name="username">grumpy</parameter>
    <parameter name="password">grumpy</parameter>
    <parameter name="host">www.yourhostingprovider.com.au</parameter>
    <parameter name="dir">public_html</parameter>
  6. At this point, everything should be configured, and all permissions should be set. You can now start with the sample files by pointing your browser to http://<hostname>/cgi-bin/login.cgi

Cyber4 logo This site provided by CyberCyberCyberCyber

Built with Kumera

This page last updated 10/9/2012