Catalyst::Manual::Installation - Catalyst Installation


Catalyst::Manual::Installation - Catalyst Installation


How to install Catalyst.


One of the frequent problems reported by new users of Catalyst is that it can be extremely time-consuming and difficult to install.

One of the great strengths of Perl as a programming language is its use of CPAN, the Comprehensive Perl Archive Network, an enormous global repository containing over 10,000 free modules. For almost any basic task--and a very large number of non-basic ones--there is a module on CPAN that will help you. Catalyst has taken advantage of this, and uses a very large number of CPAN modules, rather than reinventing the wheel over and over again. On the one hand, Catalyst gains power and flexibility through this re-use of existing code. On the other hand, Catalyst's reliance on CPAN can complicate initial installations, especially in shared-hosting environments where you, the user, do not have easy control over what versions of other modules are installed.

It is worth stressing that the difficulties found in installing Catalyst are caused not by anything intrinsic to Catalyst itself, but rather by the interrelated dependencies of a large number of required modules.

Fortunately, there are a growing number of methods that can dramatically ease this undertaking. Note that for many of these, you will probably need to install additional Catalyst-related modules (especially plugins) to do the things you want. As of version 5.70, Catalyst has split into two packages, the Catalyst::Runtime manpage, which includes the core elements necessary to deploy a Catalyst application, and the Catalyst::Devel manpage, which includes the Helpers and other things necessary or useful for developing Catalyst applications. In a purely deployment environment you can omit the Catalyst::Devel manpage.


In addition to the ``all-in-one'' approaches mentioned above, there are a variety of other installation techniques:

NOTE: Although all of the above methods can be used to install a base Catalyst system, only the VMWare image is likely to have all of the plugins and modules you need to use Catalyst properly. When you start the script/ development server, it will tell you about any modules that are missing. To add them, type something along the lines of the following (Catalyst::Model::DBIC::Schema is used here as a representative example):

    # perl -MCPAN -e 'install Catalyst::Model::DBIC::Schema'
 Catalyst::Manual::Installation - Catalyst Installation