=head1 OVERVIEW
-This is B<Part 2 of 10> for the Catalyst tutorial.
+This is B<Part 1 of 10> for the Catalyst tutorial.
L<Tutorial Overview|Catalyst::Manual::Tutorial>
inadvertently made any typographic errors, or accidentally skipped
part of the tutorial.>
-Additionally, if you're reading this manual online, you can download
-the example program and all the necessary dependencies to
-your local machine by installing the C<Task::Catalyst::Tutorial>
-distribution from CPAN:
+B<NOTE: You can use any perl-supported OS and environment to run
+Catalyst.> It should make little or no difference to Catalyst's
+operation, but this tutorial has been written using Ubuntu 8.10
+because that represents a quick and easy for most people to try out
+Catalyst with virtually zero setup time and hassles. See the Catalyst
+installation section below for more information.
+
+If you're reading this manual online, you can download the example
+program and all the necessary dependencies to your local machine by
+installing the C<Task::Catalyst::Tutorial> distribution from CPAN:
cpan Task::Catalyst::Tutorial
have trouble installing these, please ask for help on the #catalyst
IRC channel, or the Catalyst mailing list.
-Subjects covered include:
+Subjects covered by the tutorial include:
=over 4
practices. For example, the use of
L<Catalyst::Action::RenderView|Catalyst::Action::RenderView>,
DBIC, L<Catalyst::Plugin::ConfigLoader|Catalyst::Plugin::ConfigLoader>
-with C<myapp.yml>, the use of C<lib/MyApp/Controller/Root.pm>
+with C<myapp.conf>, the use of C<lib/MyApp/Controller/Root.pm>
vs. C<lib/MyApp.pm>, etc.
=item *
=item *
-Ubuntu 8.04 Hardy Heron
+Ubuntu 8.10 (Intrepid Ibex)
=item *
-Catalyst v5.7011
+Catalyst v5.7014
=item *
-Catalyst::Devel v1.03
+Catalyst::Devel v1.07
=item *
-DBIx::Class v0.08008
+DBIx::Class v0.08010
=item *
=item *
-Catalyst::Plugin::Authentication -- v0.10002
-
-=item *
-
-Catalyst::Plugin::Authentication::Store::DBIC -- v0.09
+Catalyst::Plugin::Authentication -- v0.10006
=item *
=item *
-Catalyst::Plugin::ConfigLoader -- v0.17
+Catalyst::Plugin::ConfigLoader -- v0.20
=item *
-Catalyst::Plugin::Session -- v0.18
+Catalyst::Plugin::Session -- v0.19
=item *
-Catalyst::Plugin::Session::State::Cookie -- v0.08
+Catalyst::Plugin::Session::State::Cookie -- v0.09
=item *
-Catalyst::Plugin::Session::Store::FastMmap -- v0.03
+Catalyst::Plugin::Session::Store::FastMmap -- v0.05
=item *
-Catalyst::Plugin::StackTrace -- v0.06
+Catalyst::Plugin::StackTrace -- v0.08
=item *
=item *
+B<NOTE:> You can check the versions you have installed with the
+following command:
+
+ perl -ME<lt>mod_nameE<gt> -e '"print $E<lt>mod_nameE<gt>::VERSION\n"'
+
+For example:
+ perl -MCatalyst::Plugin::StackTrace -e 'print "$Catalyst::Plugin::StackTrace::VERSION\n"'
+
Since the web browser is being used on the same box where Perl and the
Catalyst development server is running, the URL of
C<http://localhost:3000> will be used (the Catalyst development server
=head1 CATALYST INSTALLATION
-If approach in the wrong manner, it can be a daunting tasks to get
-Catalyst initally installed. Although a compelling strength of
-Catalyst is that it makes use of many of the modules in the
-vast repository that is CPAN, this can complicate the installation
-process. However, there are a growing number of methods
-that can dramatically ease this undertaking. Of these, the following
-are likely to be applicable to the largest number of potential new
-users:
+While the rough edges of Catalyst installation have been a problem in
+the past, this is now mostly solved. Nonetheless, installing Catalyst
+can be a little time consuming. Although a compelling strength of
+Catalyst is that it makes use of many of the modules in the vast
+repository that is CPAN, this can complicate the installation process.
+However, there are a growing number of methods that can dramatically
+ease this undertaking. Of these, the following are likely to be
+applicable to the largest number of potential new users:
=over 4
Ubuntu
-Given the popularity of Ubuntu and it's ease of use, Ubuntu can be
+Given the popularity of Ubuntu and its ease of use, Ubuntu can be
a great way for newcomers to experiment with Catalyst. Because it
is a "live CD," you can simply boot from the CD, run a few commands,
and you should have a fully functional environment in which to do
=item *
-Download Ubuntu 8.04 (aka, Hardy Heron) and boot from the CD and/or
-image file, select your language, and then "Try Ubuntu without any
-changes to your computer."
+Download Ubuntu 8.10 (aka, Intrepid Ibex) Desktop edition and boot from
+the CD and/or image file, select your language, and then "Try Ubuntu
+without any changes to your computer."
=item *
-Open a terminal session.
+Open a terminal session (click "Applications" in the upper-left
+corner, then "Accessories," then "Terminal").
=item *
Add the 'universe' repositories:
- sudo vi /etc/apt/sources.list
+ sudo gedit /etc/apt/sources.list
And remove the comments from the lines under the comments about the
'universe' repositories.
Install Catalyst:
sudo apt-get update
- sudo apt-get upgrade
- sudo apt-get install sqlite3 libdbd-sqlite3-perl libcatalyst-perl libcatalyst-modules-perl
+ sudo apt-get install libdbd-sqlite3-perl libcatalyst-perl libcatalyst-modules-perl libconfig-general-perl
Accept all of the dependencies. Done.
+NOTE: If you are low on disk space after the above commands (use C<df />
+to tell), you can free up some space with
+C<sudo rm /var/cache/apt/archives/*.deb> (the Live CD uses memory for
+disk space, so having a decent amount of memory will help). And,
+while the instructions above mention the Live CD because that makes it
+easy for people new to Linux, you can obviously also use one of the
+options to install Ubuntu on your drive.
+
=back
=item *
already been installed, complete with database engines and a full
complement of Catalyst plugins.
+=item *
+
+Frank Speiser's Amazon EC2 Catalyst SDK
+
+There are currently two flavors of publicly available Amazon Machine
+Images (AMI) that include all the elements you'd need to begin
+developing in a fully functional Catalyst environment within minutes.
+See L<Catalyst::Manual::Installation|Catalyst::Manual::Installation>
+for more details.
+
=back
For additional information and recommendations on Catalyst installation,
most recent version of the Catalyst Tutorial can be found at
L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Manual/lib/Catalyst/Manual/Tutorial/>.
-Copyright 2006, Kennedy Clark, under Creative Commons License
-(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
-
-
+Copyright 2006-2008, Kennedy Clark, under Creative Commons License
+(L<http://creativecommons.org/licenses/by-sa/3.0/us/>).