X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FInstallation%2FCentOS4.pod;h=79c12052d0fd0c27c7b208dde49394a1f3ef42d4;hb=88ff44a29fe6beedcfe6046bbf2e62e1bc1a0207;hp=40ccb02eacff442afd7ca56094bc02baf07b899f;hpb=d532d3540a37e6efc518ffa0bd8fd0e240453240;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Manual/Installation/CentOS4.pod b/lib/Catalyst/Manual/Installation/CentOS4.pod index 40ccb02..79c1205 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 * @@ -166,7 +166,8 @@ Type the following: ... - 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 ... @@ -181,22 +182,20 @@ Type the following: =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). One way to do this is to -answer C to the C prompt -when you ran C above. Or, you can rerun the -script by entering the following command at the C> prompt: - - cpan> o conf init - -It will then take you through the configuration dialog. - -However, it's often easiesr to avoid the full configuration dialog and -manually add a URL. To prepend a new URL to the B of the list, -use the C option to C: +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/ @@ -223,6 +222,39 @@ 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. @@ -232,14 +264,17 @@ 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'); @@ -263,6 +298,24 @@ 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 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