The structure of a Calcium installation is fairly simple; there are basically two pieces:
This makes it easy to install Calcium, even on a virtually hosted web server. All you need to do is put the two pieces into the cgi-bin directory on the host. Just follow these steps:
And that should do it! Then browse to the "Calcium40.pl" script to get
started (something like
http://www.yourdomain.com/cgi-bin/Calcium40.pl
)
Tip: You can rename the main Calcium40.pl script to anything you'd like.
Note: some web servers will require that the main Calcium
script have a special extension, like .cgi
or
.pl
. If you see the contents of the script instead of the main
Calcium page when you browse to it, try changing the filename
extension.
Please see the Installed Files page for details on how your installation should look.
If you like, you can put the supporting CalciumDir40 directory
anywhere you like; it doesn't have to go in the cgi-bin dir. If
you do move it, you just need to edit the
Calcium40.pl script, and tell it where to find
everything. For instance, if you want to rename the CalciumDir40
directory to "myCalcium" and move it
into /home/stuff
, edit the Calcium script, and change
line 5 from this:
BEGIN {$Defines::calendar_root = 'CalciumDir40';}to this:
BEGIN {$Defines::calendar_root = '/home/stuff/myCalcium';}
Tip: By default, the main Calcium script uses a relative
path to specify the location of the rest of the files. Some web servers,
particularly on hosting services, will only work with an absolute path.
If you are having problems getting Calcium to run, try changing the path
specified in the Calcium40.pl file (as described above) from
'CalciumDir40' to the full path to that directory on your server, e.g.
something like '/home/my-site-dir/www/cgi-bin/CalciumDir40'
or
'd:\my-site-dir\www\cgi-bin\CalciumDir40'