=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 *
...
- 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
...
=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). One way to do this is to
-answer C<yes> to the C<Are you ready for manual configuration?> prompt
-when you ran C<perl -MCPAN -e shell> above. Or, you can rerun the
-script by entering the following command at the C<cpanE<gt>> 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<front> of the list,
-use the C<unshift> option to C<o conf>:
+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/
=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
retrieve a copy of the C<cat-install> script.
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');
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 dependencies 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