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