lib/Catalyst/Manual/Installation/CentOS4.pod

   1 =head1 NAME
   2
   3 Catalyst::Manual::Installation::CentOS4 - Catalyst Installation on CentOS 4
   4
   5
   6
   7 =head1 DESCRIPTION
   8
   9 This document provides directions on how to install CentOS 4 (a rebuild
  10 of RedHat Enterprise 4) and then install Catalyst.
  11
  12 If you already have a functioning install of CentOS, RHEL, or a
  13 comparable Linux OS, you should be able to skip this first section and
  14 go straight to the C<INSTALL CATALYST> section.
  15
  16
  17 =head1 INSTALL CENTOS
  18
  19 These directions are written for CentOS 4.3 on an i386 machine; however,
  20 you can substitute other versions as they become available.
  21
  22
  23 =over 4
  24
  25 =item *
  26
  27 Go to L<http://isoredirect.centos.org/centos/4/isos/i386/> and click the
  28 nearest mirror.
  29
  30 =item *
  31
  32 Download C<CentOS-4.3-i386-bin1of4.iso> (you only need the first disk).
  33
  34 =item *
  35
  36 Burn the .iso to CD.
  37
  38 =item *
  39
  40 Insert the CD into your machine and power it up.
  41
  42 =item *
  43
  44 Hit C<Enter> at the C<boot:> prompt.
  45
  46 =item *
  47
  48 CD media test: you can either select C<OK> or C<Skip> depending on
  49 whether or not you trust your burn.
  50
  51 =item *
  52
  53 The installation GUI should start.  Click next at the "Welcome to
  54 CentOS-4" screen.
  55
  56 =item *
  57
  58 Select a language and click C<Next>.
  59
  60 =item *
  61
  62 Select a keyboard configuration and click C<Next>.
  63
  64 =item *
  65
  66 Select C<Custom> for the installation type and click C<Next>.
  67
  68 =item *
  69
  70 Leave C<Automatically partition> selected on the C<Disk Partitioning
  71 Setup> and click C<Next>.
  72
  73 =item *
  74
  75 Uncheck C<Review (and modify if needed) the partitions created>, but
  76 leave the rest of the default settings on the C<Automatic Partitioning>
  77 screen.  Then click C<Next>.
  78
  79 =item *
  80
  81 Click C<Yes> at the C<Are you sure you want to do this?> warning.
  82
  83 =item *
  84
  85 Click C<Next> on the C<Boot Loader Configuration> screen.
  86
  87 =item *
  88
  89 Update the C<Network Configuration> screen as necessary and click C<Next>.
  90
  91 =item *
  92
  93 Check C<Remote Login (SSH)> and click C<Next> on the C<Firewall
  94 Configuration> screen.
  95
  96 =item *
  97
  98 Select additional languages as necessary.  Click C<Next>.
  99
 100 =item *
 101
 102 Select the appropriate time zone and click C<Next>.
 103
 104 =item *
 105
 106 Enter a root password and click C<Next>.
 107
 108 =item *
 109
 110 Scroll to the bottom of the C<Package Group Selection> screen and check
 111 C<Minimal> (the last option).  Click C<Next>.
 112
 113 =item *
 114
 115 Click C<Next> at the C<About to Install> screen.
 116
 117 =item *
 118
 119 The installation will prepare the hard drive and then install the
 120 required rpm packages.
 121
 122 =item *
 123
 124 Once the installation completes, remove the CD and click C<Reboot>.
 125
 126 =item *
 127
 128 Type C<vi /etc/sysconfig/iptables> and add the following line as the
 129 third to last line of the file (I<above> the C<-A RH-Firewall-1-INPUT -j
 130 REJECT --reject-with icmp-host-prohibited> line):
 131
 132     -A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 3000 -j ACCEPT
 133
 134 This will allow Catalyst to make use of port 3000 (the default for the
 135 development server).
 136
 137 Type C<service iptables restart> to restart the iptables firewall using
 138 the updated configuration.
 139
 140 =item *
 141
 142 Type C<yum -y update> to retrieve the latest patches.
 143
 144 =back
 145
 146
 147 =head1 INSTALL CATALYST
 148
 149 =over 4
 150
 151 =item *
 152
 153 Type C<yum -y install gcc expat-devel sqlite3> to install several
 154 packages used by Catalyst.
 155
 156 =item *
 157
 158 Type the following:
 159
 160     perl -MCPAN -e shell
 161
 162     ...
 163
 164     Are you ready for manual configuration? [yes] n
 165
 166     ...
 167
 168     cpan shell -- CPAN exploration and modules installation (v1.7601)
 169     ReadLine support available (try 'install Bundle::CPAN')
 170
 171     cpan> force install Module::Build
 172
 173     ...
 174
 175     cpan> quit
 176
 177 =item *
 178
 179 Type C<wget http://www.shadowcatsystems.co.uk/static/cat-install> to
 180 retrieve a copy of the C<cat-install> script.
 181
 182 =item *
 183
 184 Type C<vi cat-install> to open the installer script, then insert the
 185 following lines at the bottom of the file (after the
 186 C<install('Catalyst');> line):
 187
 188     install('Digest::SHA1');
 189     install('Class::DBI');
 190     install('DBIx::Class');
 191     install('DBIx::Class::HTMLWidget');
 192     install('Catalyst::Plugin::Session');
 193     install('Catalyst::Plugin::Session::State::Cookie');
 194     install('Catalyst::Plugin::Session::Store::FastMmap');
 195     install('Catalyst::Plugin::Authorization::ACL');
 196     install('Catalyst::Plugin::Authentication');
 197     install('Catalyst::Plugin::Authorization::Roles');
 198     install('Catalyst::Plugin::Authentication::Store::DBIC');
 199     install('Catalyst::Plugin::DefaultEnd');
 200     install('Catalyst::Plugin::StackTrace');
 201     install('Catalyst::Plugin::Dumper');
 202     install('Catalyst::Model::DBIC::Schema');
 203     install('Catalyst::View::TT');
 204     install('Test::WWW::Mechanize::Catalyst');
 205
 206 =item *
 207
 208 Type C<perl cat-install>.  It will take a while to complete.
 209
 210 =back
 211
 212 You should now have a functioning Catalyst installation with the modules
 213 and plugins required to run the Catalyst tutorial.
 214
 215
 216 =head1 AUTHOR
 217
 218 Kennedy Clark, C<hkclark@gmail.com>
 219
 220 Please report any errors, issues or suggestions to the author.
 221
 222 Copyright 2006, Kennedy Clark, under Creative Commons License
 223 (L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
 224
 225 Version: .01
 226