=head1 INSTALL CENTOS
-These directions are written for CentOS 4.3 on an i386 machine; however,
+These directions are written for CentOS 4.4 on an i386 machine; however,
you can substitute other versions as they become available.
=item *
-Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk).
+Download C<CentOS-4.4-i386-bin1of4.iso> (you only need the first disk).
=item *
Type the following:
- perl -MCPAN -e shell
+ $ perl -MCPAN -e shell
...
- Are you ready for manual configuration? [yes] n
+ Are you ready for manual configuration? [yes] yes
+ The following questions are intended to help you with the
...
cpan> quit
+=item *
+
+B<Note:> You need to have CPAN manually configured prior to running
+cat-install. As shown above, you should automatically receive
+a prompt for this when you first run C<perl -MCPAN -e shell>. You
+can re-run the configuration script by typing C<o conf init> at the
+C<cpanE<gt>> prompt.
+
+B<Optional:> The remaining steps of the installation could run
+significantly faster if you configure a fast mirror that uses HTTP vs.
+FTP (both transfer data at the same rate once the transfer is in
+progress, but HTTP connects much more quickly... and a Catalyst
+installation involves many connections). If you want to change the
+selection(s) you made during the "manual configuration" process above,
+you can manually add a single URL. To prepend a new URL to the B<front>
+of the list, use the C<unshift> option to C<o conf>:
+
+ cpan> o conf urllist unshift http://www.perl.com/CPAN/
+
+Where C<http://www.perl.com/CPAN/> is replaced by a nearby, HTTP-based
+mirror. You can get a list of all mirrors (including where they are
+located, their bandwidth, and their update frequency) at
+L<http://www.perl.com/CPAN/MIRRORED.BY>.
+
+Then, be sure to save your changes (or they will be lost the next
+time you restart the CPAN shell):
+
+ cpan> o conf commit
+
+You can view the current settings with C<o conf urllist> (or just
+C<o conf> to view all settings):
+
+ cpan> o conf urllist
+ urllist
+ http://www.perl.com/CPAN/
+ Type 'o conf' to view configuration edit options
+
+Note that multiple values can be entered for the C<urllist> option (the
+first entry will be used as long as it responds).
+
+=item *
+
+Review the C<cat-install> documentation from the
+L<http://www.shadowcatsystems.co.uk> web site:
+
+ If you want to get started quickly with Catalyst, Shadowcat provides an
+ installer script that will automate most of the process of installing it
+ for you. Please bear in mind that this script is currently considered
+ beta quality; we don't think it will eat your system but we make no
+ guarantee of that.
+
+ First, you'll need -
+
+ * Perl, 5.8.1+ (if you're on windows, get it from Active State)
+ * make of some sort. On unix/linux you should already have one. On
+ windows get nmake from Microsoft.
+ * A compiler. On unix/linux you should already have one. On windows,
+ get the latest Dev-C++ beta.
+ * All three of the above in your PATH for whatever shell you're using
+ * A configured CPAN.pm. perl -MCPAN -e shell should get CPAN to walk
+ you through the configuration process
+ * Module::Build. Active State kindly include this for you.
+
+ Ok, now that your environment is set up, download the installer from
+ this link, open a command prompt in the directory you downloaded it to
+ and run perl cat-install. By the time it exits, you should have a full
+ Catalyst install.
+
+ If anything goes wrong, please send the full build log and the output of
+ perl -V to cat-install (at) shadowcatsystems.co.uk so we can try and
+ resolve your issue.
+
+
=item *
Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to
following lines at the bottom of the file (after the
C<install('Catalyst');> line):
- install('Catalyst::Devel');
install('ExtUtils::ParseXS');
install('Digest::SHA1');
install('Digest::SHA');
install('Class::DBI');
install('DBIx::Class');
install('DBIx::Class::HTMLWidget');
+ install('Module::ScanDeps');
+ install('Module::CoreList');
+ install('PAR::Dist');
+ install('Archive::Tar');
+ install('Module::Install');
+ install('Catalyst::Devel');
+ install('Catalyst::Plugin::ConfigLoader');
install('Catalyst::Plugin::Session');
install('Catalyst::Plugin::Session::State::Cookie');
install('Catalyst::Plugin::Session::Store::FastMmap');
install('Catalyst::Plugin::HTML::Widget');
install('Catalyst::Model::DBIC::Schema');
install('Catalyst::View::TT');
+ install('Test::WWW::Mechanize');
install('Test::WWW::Mechanize::Catalyst');
install('Test::Pod');
install('Test::Pod::Coverage');
Type C<perl cat-install>. It will take a while to complete.
+Tip: You may want to enable logging of the output that C<cat-install>
+generates as it runs -- it can be useful if you need to troubleshoot
+a failure. The log will generate almost 1 MB of output.
+
+Note: Once the C<perl cat-install> is complete, you may want to rerun the
+command to check the status of the packages listed in <cat-install>. Ideally,
+everything should return a I<name> C<is up to date> message. If any packages
+try to re-install, the you could need to manually install the package with the
+C<force> option. Also, look for new optional dependences that C<cat-install>
+was not able to automatically handle. You can address these by manually
+installing the dependency and then re-running C<perl cat-install>.
+
+In some cases you may wish to install an earlier version of a module. For
+example, say that the latest version of Module::Install is 0.64 and you
+want to install 0.63. The following command under C<perl -MCPAN -e shell>:
+
+ cpan> install A/AD/ADAMK/Module-Install-0.63.tar.gz
+
=back
You should now have a functioning Catalyst installation with the modules
and plugins required to run the Catalyst tutorial.
+=head1 TESTING THE INSTALLATION
+
+=over 4
+
+=item *
+
+Download the tarball of the final tutorial application:
+
+ $ wget http://dev.catalyst.perl.org/repos/Catalyst/trunk/examples/Tutorial/Final_Tarball/MyApp.tgz
+
+=item *
+
+Untar it:
+
+ $ tar zxvf MyApp.tgz
+ $ cd MyApp
+
+=item *
+
+Run the tests:
+
+ $ CATALYST_DEBUG=0 prove --lib lib t
+ t/02pod...............skipped
+ all skipped: set TEST_POD to enable this test
+ t/03podcoverage.......skipped
+ all skipped: set TEST_POD to enable this test
+ t/01app...............ok
+ t/controller_Login....ok
+ t/live_app01..........ok 1/0[debug] ***Root::auto User not found, forwarding to /login
+ t/live_app01..........ok 2/0[debug] ***Root::auto User not found, forwarding to /login
+ t/live_app01..........ok 15/0[debug] ***Root::auto User not found, forwarding to /login
+ t/live_app01..........ok 16/0[debug] ***Root::auto User not found, forwarding to /login
+ t/live_app01..........ok
+ t/model_MyAppDB.......ok
+ All tests successful, 2 tests skipped.
+ Files=6, Tests=55, 11 wallclock secs ( 4.68 cusr + 4.84 csys = 9.52 CPU)
+
+You should see C<All tests successful>.
+
+=back
+
+
+
=head1 AUTHOR
Kennedy Clark, C<hkclark@gmail.com>
Please report any errors, issues or suggestions to the author. The
-most recent version of the Catlayst Tutorial can be found at
+most recent version of the Catalyst Tutorial can be found at
L<http://dev.catalyst.perl.org/repos/Catalyst/trunk/Catalyst-Runtime/lib/Catalyst/Manual/Tutorial/>.
Copyright 2006, Kennedy Clark, under Creative Commons License