Main Site Contents Next

Installing Citrus Perl

Citrus Perl is provided as a tar.gz archive for Linux and MacOSX and as a zip archive for MS Windows.

Once you have downloaded your desired version of Citrus Perl from the Download Site you are ready for the simple installation procedure.

Extract the downloaded archive to your desired install location. The archive contains a top level directory called 'perl'. Do not install to a path containing spaces. Citrus Perl does not support this.


MS Windows

You may change the name of the default top level folder 'perl' to anything you wish provided you do so before relocating the Perl distribution or running any of the executables in the Perl distribution. Once any of the executables have run, the distrubution will have been relocation to its new fixed location.

to relocate Perl you may run the relocate executable directly:

..\perl\bin\relocateperl

or you may run the Citrus Utilities application:

..\perl\bin\citrusutils

Citrus Perl will also auto relocate if any Perl binary is run. For example:

..\perl\bin\perl -V

will cause the distribution to be relocated.

Once the distribution is relocated, running the batch file at:

..\perl\bin\citrusterm

will open a command prompt window set up for this installation of Citrus Perl.

You can change from the default install of wxWidgets for your Citrus Perl flavour to the alternative (if available) using the Citrus Perl Utilities application.


Linux

You may change the name of the default top level folder 'perl' to anything you wish provided you do so before relocating the Perl distribution or running any of the executables in the Perl distribution. Once any of the executables run, the distribution will relocate to its new fixed location.

to relocate Perl you may run the relocate executable directly:

../perl/bin/relocateperl

or you may run the Citrus Utilities application:

../perl/bin/citrusutils

Citrus Perl will also auto relocate if any Perl binary is run. For example:

../perl/bin/perl -V

will cause the distribution to be relocated.

Once the distribution is relocated, you can set your environment to use this distribution by importing the file at ../perl/bin/citrusvars.sh into your terminal session. For example:

< myprompt: > .  perl/bin/citrusvars.sh

will open a command prompt window set up for this installation of Citrus Perl.

You can change from the default install of wxWidgets for your Citrus Perl flavour to the alternative (if available) using the Citrus Perl Utilities application.


Setup for wxWidgets and OpenGL

wxWidgets and OpenGL rely on some runtime packages being present on your system. For the Wx::Demo and OpenGL alone you will require the freeglut libraries on your system.

For yum / rpm based systems run:

yum install freeglut

For apt based systems run:

apt-get install freeglut3

If you are running the ubuntults flavour with the latest wxWidgets features you will also need the libwebkitgtk runtime installed.

For yum / rpm based systems run:

yum install webkitgtk

For apt based systems run:

apt-get install libwebkitgtk-1.0

Note: The actual package names may differ slightly on your system. The above names are for Fedora 17 and Ubuntu LTS 12.04.


Mac OS X

You may change the name of the default top level folder 'perl' to anything you wish provided you do so before relocating the Perl distribution or running any of the executables in the Perl distribution. Once any of the executables run, the distribution will relocate to its new fixed location.

to relocate Perl you may run the relocate executable directly:

../perl/bin/relocateperl

or you may run the Citrus Utilities application:

"../perl/bin/Citrus Perl Utilities.app"

Citrus Perl will also auto relocate if any Perl binary is run. For example:

../perl/bin/perl -V

will cause the distribution to be relocated.

Once the distribution is relocated, you can set your environment to use this distribution by importing the file at ../perl/bin/citrusvars.sh into your terminal session. For example:

< myprompt: > .  perl/bin/citrusvars.sh

will open a command prompt window set up for this installation of Citrus Perl.

You can change from the default install of wxWidgets for your Citrus Perl flavour to the alternative (if available) using the Citrus Perl Utilities application.





Contents Next


Citrus Utilities Copyright © 2012 Mark Dootson