X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FInstallation%2FCentOS4.pod;h=ccaf39a4dad7cac8a8de3d91c661a7e11743eb10;hp=03924adf7276d877251a66d6b1f593be956a23de;hb=ae29b412955743885e80350085167b54b69672da;hpb=7d310f12e2caaf8e94e8f7f94e88d46698c77fde diff --git a/lib/Catalyst/Manual/Installation/CentOS4.pod b/lib/Catalyst/Manual/Installation/CentOS4.pod index 03924ad..ccaf39a 100644 --- a/lib/Catalyst/Manual/Installation/CentOS4.pod +++ b/lib/Catalyst/Manual/Installation/CentOS4.pod @@ -21,7 +21,7 @@ L (you only need the first disk). +Download C (you only need the first disk). =item * @@ -162,11 +162,12 @@ packages used by Catalyst. 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 ... @@ -179,6 +180,79 @@ Type the following: cpan> quit +=item * + +B 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. You +can re-run the configuration script by typing C at the +C> prompt. + +B 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 +of the list, use the C option to C: + + cpan> o conf urllist unshift http://www.perl.com/CPAN/ + +Where C 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. + +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 (or just +C 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 option (the +first entry will be used as long as it responds). + +=item * + +Review the C documentation from the +L 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 to @@ -190,13 +264,18 @@ Type C to open the installer script, then insert the following lines at the bottom of the file (after the C 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'); @@ -210,6 +289,7 @@ C line): 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'); @@ -218,12 +298,73 @@ C line): Type C. It will take a while to complete. +Tip: You may want to enable logging of the output that C +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 is complete, you may want to rerun the +command to check the status of the packages listed in . Ideally, +everything should return a I C message. If any packages +try to re-install, the you could need to manually install the package with the +C option. Also, look for new optional dependencies that C +was not able to automatically handle. You can address these by manually +installing the dependency and then re-running C. + +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: + + 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. + +=back + + + =head1 AUTHOR Kennedy Clark, C