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