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.04
+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 *
=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
=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.04 (aka, Hardy Heron) 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
+Copyright 2006-2008, Kennedy Clark, under Creative Commons License
(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
projects / catagits/Catalyst-Manual.git / blobdiff