Home English Mozilla  Friday, March 29 10:19:36 
Wcal
Print

 Home

 Screenshots
 Demo
 Downloads

 News RSS 2.0
 FAQ
 Mail archive
Documentation
 Roadmap

 P*Wcal
 CWcal
 DWcal
 Themes
 Internationalization

 Maintainer
 Contributors
 Web repositories
 CVS

 NeoSystem
 MyNews

  
Search
INSTALL
Web Server Configuration
------------------------

Your web server must be configured to

- execute files ending to .cgi as CGI scripts, and

- show index.cgi as directory index

In the directory where Wcal is installed, by default
/var/www/html/wcal/.

If using Apache:

    Add the following lines to srm.conf or httpd.conf and restart Apache

      <Directory /var/www/html/wcal>
        AddHandler cgi-script .cgi
        DirectoryIndex index.cgi index.html
        Options +ExecCGI
      </Directory>

    (Change the directory to where you installed Wcal.)

If using Netscape Enterprise Server:

    - To make index.cgi run as a CGI script, set "Activate CGI as a file
      type to "Yes" under "Programs" / "CGI File Type".

    - To make the server show index.cgi as directory index, "index.cgi" has
      to be added to the "Index Filenames" section under "Content Mgmt" /
      "Document Preferences". Thanks to Philipp Hanes <phanes@iconnet.com>
      for these instructions.

    However, Netscape Enterprise Server (obviously) doesn't use .htaccess
    files for access control, so Wcal access control simply won't out of
    box, and you must configure it separately in web server.

I don't know about other web servers. If you get Wcal to work with other web
servers, please tell me how you did that.

Once your web server is correctly configured, install Wcal itself either
by doing automatic installation as explained in the next section, or
install it by hand as instructed in section Manual Installation.

Perl Module Installation
------------------------

You must have perl modules Data::Dumper and Date::Manip installed. Both
modules are included in Wcal distribution. Data::Dumper comes with perl
5.005. The module installation works as following:

  zcat Data-Dumper-2.07.tar.gz | tar xvf -
  cd <module-name>
  perl Makefile.pl
  make install

Wcal Installation (automatic)
-----------------------------

0. Create a user 'wcal' to run wcald as. You can also run wcald as user
   'nobody' or similar, but that is not recommended. In many systems
   the user can be created by issuing as root the command "useradd wcal".
   The 'wcal' user must belong to the group that runs your web server. 
   Generally, Apache uses the group 'apache'.

1. If your perl isn't in /usr/bin/perl, change the path to perl on the first
   line of wcald.

2. As root, issue the command

     make install

   That will compile and install Wcal.

3. Edit /etc/wcal.conf to suit yourself.

4. Now you should be done. You must start Wcal daemon wcald to the
   background, by entering the command the installation script told you
   to.

After that you should be able to access Wcal by refering to index.cgi, by
default in URL /wcal/.

If automatic installation didn't work for you, read the next section Manual
Installation.

Manual Installation
-------------------

You can change default parameters used by the Wcal Installation by editing
the Makefile. The first parameter INTERACTIVE_MODE set to 1 allow you to
interactively set the different parameters during installation.

Files and Permissions
---------------------

Wcal installs following files and directories:

/etc/wcal.conf		Wcal configuration file. Must be owned by the
			wcald user and web server group and have mode
			-rw-r-----.

/etc/wcal.msg		Translated strings.
/etc/wcal.def		Event default parameters.
/etc/wcal.sdays		Special days (non-working days).

/var/wcal/		Database directory. Must be owned by wcald
			user, and have mode -rwx------.

/var/www/html/wcal/	CGI scripts and images. Must be owned by wcald
(or other directory	user and web server group, and have mode
chosen in install)	drwxr-x---.

PREFIX/bin/wcald	Wcal daemon.

PREFIX/sbin/checkalarm	Wcal alarm checker.

PREFIX is by default /usr/local, but you can change this on top of
Makefile.

Uninstallation
--------------

To uninstall wcal, simply do

  make uninstall

You must remove the CGI/HTML directory yourself. By default it's
/var/www/html/wcal.

Customizing background
----------------------

You can use your own background by replacing background.jpg by your background

  cp mybackground.jpg /var/www/html/wcal/images/background.jpg

Customizing language
--------------------

You can change language used by Wcal to display calendars by setting the "remote lang"
resource in /etc/wcal.conf. For the moment only english (en) and french (fr) is available.
Contibutors are welcome for other language (see /etc/wcal.msg).

Using checkalarm
----------------
checkalarm checks each Wcal event with alarm and verifies if an alarm must be launched for 
the event. An alarm is launched when current time is greater than the beginning 
of event and less alarm duration. When an alarm must be launched, a mail is sent
 to people who are concerned by the event.

You can use checkalarm in crontab to periodically check calendars. For exemple:
0,15,30,45 * * * * /usr/local/bin/checkalarm -c production -m js@myorg.org
Calendar production will be checked every 15 minutes and alarm mail will be sent
to js@myorg.org

Common problems
---------------

1) When you access URL /wcal, you get just a directory listing

Your web server isn't configured to execute file 'index.cgi' as a CGI
program that generates the directory index. In Apache, add "index.cgi" to
the "DirectoryIndex" line in srm.conf or httpd.conf. In Netscape Enterprise
Server, set "Activate CGI as a file type to "Yes" under "Programs" / "CGI
File Type".

2) When you access URL /wcal, you get a "403 Forbidden" error or similar

Your web server doesn't allow executing CGI scripts in the directory where
you installed Wcal. In Apache, add for example the following into srm.conf

  <Directory /var/www/html/wcal>
    Options +ExecCGI
  </Directory>


If you have problems, suggestions, fixes or anything, don't hesitate to
contact me.


			Joël Savignon <js@neosystem.com>


© 2004 Joël Savignon