From: Jonathan Rockway Date: Tue, 7 Nov 2006 17:36:16 +0000 (+0000) Subject: svk-commitBGCdt.tmp X-Git-Tag: 5.7099_04~287 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d02448efd90a5acd76ec0b195939aebf8e64d1e6;hp=f984f5d78dfc0e47038fe6e7f8f7dd41cc5fecd0;p=catagits%2FCatalyst-Runtime.git svk-commitBGCdt.tmp --- diff --git a/lib/Catalyst/Manual/Installation/CentOS4.pod b/lib/Catalyst/Manual/Installation/CentOS4.pod new file mode 100644 index 0000000..7fca29b --- /dev/null +++ b/lib/Catalyst/Manual/Installation/CentOS4.pod @@ -0,0 +1,378 @@ +=head1 NAME + +Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4 + + + +=head1 DESCRIPTION + +This document provides directions on how to install CentOS 4 (a rebuild +of RedHat Enterprise 4) and then install Catalyst. + +If you already have a functioning install of CentOS, RHEL, or a +comparable Linux OS, you should be able to skip this first section and +go straight to the C section. + +B You might want to consult the latest version of this document. It +is available at: +L + + + +=head1 INSTALL CENTOS + +These directions are written for CentOS 4.4 on an i386 machine; however, +you can substitute other versions as they become available. + + +=over 4 + +=item * + +Go to L and click the +nearest mirror. + +=item * + +Download C (you only need the first disk). + +=item * + +Burn the .iso to CD. + +=item * + +Insert the CD into your machine and power it up. + +=item * + +Hit C at the C prompt. + +=item * + +CD media test: you can either select C or C depending on +whether or not you trust your burn. + +=item * + +The installation GUI should start. Click next at the "Welcome to +CentOS-4" screen. + +=item * + +Select a language and click C. + +=item * + +Select a keyboard configuration and click C. + +=item * + +Select C for the installation type and click C. + +=item * + +Leave C selected on the C and click C. + +=item * + +Uncheck C, but +leave the rest of the default settings on the C +screen. Then click C. + +=item * + +Click C at the C warning. + +=item * + +Click C on the C screen. + +=item * + +Update the C screen as necessary and click C. + +=item * + +Check C and click C on the C screen. + +=item * + +Select additional languages as necessary. Click C. + +=item * + +Select the appropriate time zone and click C. + +=item * + +Enter a root password and click C. + +=item * + +Scroll to the bottom of the C screen and check +C (the last option). Click C. + +=item * + +Click C at the C screen. + +=item * + +The installation will prepare the hard drive and then install the +required rpm packages. + +=item * + +Once the installation completes, remove the CD and click C. + +=item * + +Type C and add the following line as the +third to last line of the file (I the C<-A RH-Firewall-1-INPUT -j +REJECT --reject-with icmp-host-prohibited> line): + + -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT + +This will allow Catalyst to make use of port 3000 (the default for the +development server). + +Type C to restart the iptables firewall using +the updated configuration. + +=item * + +Type C to retrieve the latest patches. + +=back + + +=head1 INSTALL CATALYST + +=over 4 + +=item * + +Type C to install several +packages used by Catalyst. + +=item * + +Type the following: + + $ perl -MCPAN -e shell + + ... + + Are you ready for manual configuration? [yes] yes + The following questions are intended to help you with the + + ... + + cpan shell -- CPAN exploration and modules installation (v1.7601) + ReadLine support available (try 'install Bundle::CPAN') + + cpan> force install Module::Build + + ... + + 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 +retrieve a copy of the C script. + +=item * + +Type C to open the installer script, then insert the +following lines at the bottom of the file (after the +C line): + + 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::Authorization::ACL'); + install('Catalyst::Plugin::Authentication'); + install('Catalyst::Plugin::Authorization::Roles'); + install('Catalyst::Plugin::Authentication::Store::DBIC'); + install('Catalyst::Plugin::DefaultEnd'); + install('Catalyst::Plugin::StackTrace'); + install('Catalyst::Plugin::Dumper'); + 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'); + +=item * + +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 dependences 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 + +Please report any errors, issues or suggestions to the author. The +most recent version of the Catalyst Tutorial can be found at +L. + +Copyright 2006, Kennedy Clark, under Creative Commons License +(L).