If you would prefer to install directly from CPAN and not use the
Tutorial Virtual machine, you can download the example program and all
the necessary dependencies to your local machine by installing the
-C<Task::Catalyst::Tutorial> distribution:
+L<Task::Catalyst::Tutorial> distribution:
cpan Task::Catalyst::Tutorial
=over 4
-=item *
+=item *
A simple application that lists and adds books.
some of the more advanced techniques you will probably want to use in
your applications).
-=item *
+=item *
How to write CRUD (Create, Read, Update, and Delete) operations in
Catalyst.
Authentication ("auth").
-=item *
+=item *
Role-based authorization ("authz").
-=item *
+=item *
Attempts to provide an example showing current (5.9) Catalyst
practices.
-=item *
+=item *
The use of Template Toolkit (TT).
-=item *
+=item *
Useful techniques for troubleshooting and debugging Catalyst
applications.
-=item *
+=item *
The use of SQLite as a database (with code also provided for MySQL and
PostgreSQL). (Note: Because we make use of the DBIx::Class Object
agnostic and can easily be used by any of the databases supported by
DBIx::Class.)
-=item *
+=item *
The use of L<HTML::FormFu> or L<HTML::FormHandler>
for automated form processing and validation.
=over 4
-=item 1
+=item 1
Download a Tutorial Virtual Machine image from
L<http://cattut.shadowcat.co.uk/>
=item 3
Boot the virtual machine using a tool like VMWare Player
-L<http://www.vmware.com/products/player> or VirtualBox
-L<http://www.virtualbox.org/>.
+L<https://www.vmware.com/products/workstation-player.html> or VirtualBox
+L<https://www.virtualbox.org/>.
=item 4
...
You want the IP address on the second line below the C<eth0> interface.
-The image it design to automatically use a DHCP-assigned address.
+The image is designed to automatically use a DHCP-assigned address.
Try to ping this IP address from your "host machine" (main desktop):
Catalyst Development Server:
$ cd Final/Chapter03/MyApp
- $ perl scripts/myapp_server
+ $ perl script/myapp_server.pl
=item 8
the terminology above) and then use that main desktop machine to SSH and
web browse into the "guest VM" as they work through the tutorial. If
you wish to install X Windows (or any other packages), just use the
-C<aptitude> (or C<apt-get>) Debian commands. For example, to install
-X Windows with the Gnome desktop manager, you can do:
+C<aptitude> (or C<apt-get>) Debian commands.
+
+For example, to install X Windows with Fluxbox (a lightweight
+WindowManager -- it is great for things like this tutorial since it's
+about 1/10th the size of other common X Windows environments), you can
+do:
$ sudo aptitude update
- $ sudo ptitude install gnome iceweasel
+ $ sudo aptitude install xorg fluxbox iceweasel
+
+And then start X Windows from the B<VM Console> with this command:
+
+ $ startx
+
+Note that if you want to start Fluxbox from an SSH session, you can use
+the C<sudo dpkg-reconfigure x11-common> and select "anybody" from the
+menu. Otherwise, you will need to be on the actual "VM console" to
+start it.
-Or, if you prefer KDE:
+If you have a preference for the Gnome desktop environment, you can do:
$ sudo aptitude update
+ $ sudo aptitude install gnome iceweasel
+ $
+ $ # You can reboot or start with 'startx', we will just reboot here
+ $ reboot
+
+For KDE, just substitute the package name "C<kde>" for "C<gnome>" above.
+
$ sudo aptitude install kde iceweasel
-You can then start X Windows with:
+Note that C<iceweasel> is basically used to install Firefox on Debian
+boxes. You can start it under X Windows with either the C<firefox>
+command or the C<iceweasel> command (or use the menus). You can get
+more information on Iceweasel at L<https://wiki.debian.org/Iceweasel>.
- $ startx
+Also, you might need to add more memory to your virtual machine if you
+want to run X Windows (or other tools that might require additional
+memory). Consult the documentation of your virtualization software
+for instructions on how to do this (it's usually pretty simple).
=back
recommend that you also consider using this very handy module. It can
greatly ease the process of maintaining and testing different
combinations or Perl modules across development, staging, and production
-servers. (The "relocatable Perl" feature can also be used to to run
+servers. (The "relocatable Perl" feature can also be used to run
both the modules B<and> Perl itself from your home directory [or any
other directory you chose]).
machine host environments let you configure a "static NAT" or "port
forwarding" to reach the guest OS, but others omit this functionality.
+Note: NAT mode can work fine if you install X Windows and do the whole
+tutorial locally on the actual VM vs. using SSH and a web browser from
+your host machine.
+
"Local host only" mode let's the guest VM and the host machine talk on a
"private subnet" that other devices in your network cannot reach. This
can work as long as you don't need to go from the VM to the Internet
(for example, to install other Debian packages).
+
Consult the documentation on your virtual machine host environment for
help configuring the options above. Here are some links that might
help:
=item *
-L<http://vmfaq.com/entry/34/>
+L<https://web.archive.org/web/20160623183717/http://vmfaq.com/index.php?View=entry&EntryID=34>
=item *
-L<http://www.vmware.com/support/pubs/player_pubs.html>
+L<https://www.vmware.com/support/pubs/player_pubs.html>
=item *
-L<http://www.virtualbox.org/manual/ch06.html>
+L<https://www.virtualbox.org/manual/ch06.html>
=back
=over 4
-=item *
+=item *
Debian 6 (Squeeze)
-=item *
+=item *
Catalyst v5.90002
Catalyst::Devel v1.34
-=item *
+=item *
DBIx::Class v0.08195
HTML::FormFu -- v0.09004
-=item *
+=item *
B<NOTE:> You can check the versions you have installed with the
following command (note the slash before the space):
perl -MCatalyst::Devel -e 'print "$Catalyst::Devel::VERSION\n";'
-=item *
+=item *
This tutorial will show URLs in the format of C<http://localhost:3000>,
but if you are running your web browser from outside the Tutorial
eth0 from the C<ifconfig> command). For example, if your VM has an
IP address of 192.168.0.12, you will want to use a base URL of
C<http://192.168.0.12:3000>. Note that the development server
-defaults to port 3000 (you can change with with the "-p" option on the
-command line.
+defaults to port 3000 (you can change with the "-p" option on the
+command line).
B<Please Note:> Depending on the web browser you are using, you might
need to hit C<Shift+Reload> or C<Ctrl+Reload> to pull a fresh page when
testing your application at various points (see
-L<http://en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache> for a
+L<https://en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache> for a
comprehensive list of options for each browser).
Also, the C<-k> B<keepalive option> to the development server can be
Copyright 2006-2011, Kennedy Clark, under the
Creative Commons Attribution Share-Alike License Version 3.0
-(L<http://creativecommons.org/licenses/by-sa/3.0/us/>).
+(L<https://creativecommons.org/licenses/by-sa/3.0/us/>).
projects / catagits/Catalyst-Manual.git / blobdiff