the physical machine where you will run the virtualization software and
boot up the VM. The terms "guest machine" or just "VM" refer to the
virtual machine itself -- the thing where you actually do the tutorial
-and that you boot up on the "host machine".
-
-Also, to reduce download size, the Tutorial VM just includes a minimal
-command-line environment. In general, it is expected that people will
-boot up the Tutorial VM on their main desktop (the "host machine" using
-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.
+(and that you boot up on the "host machine").
+B<Note:> Throughout the tutorial, we will shows the UNIX shell prompt
+as "C<$>". If you are using Tutorial VM, the prompt will really be
+"C<root@catalyst:~#>", but we will keep it short (and also use "C<$>" in
+lieu of "C<#>", since "C<#>" looks too much like a Perl comment).
=over 4
=item 2
-Uncompress the image:
+Uncompress the image on the "host machine":
- tar zxvf CatalystTutorial.tgz
+ MAINCOMPUTER:~$ tar zxvf CatalystTutorial.tgz
=item 3
Try to ping this IP address from your "host machine" (main desktop):
- MainComputer:~$ ping 192.168.0.12
+ MAINCOMPUTER:~$ ping 192.168.0.12
PING 192.168.0.12 (192.168.0.12) 56(84) bytes of data.
64 bytes from 192.168.0.12: icmp_req=1 ttl=255 time=4.97 ms
64 bytes from 192.168.0.12: icmp_req=2 ttl=255 time=3.43 ms
=item 9
-B<Optional:> The VI/VIM editor is already installed on the Tutorial
-Virtual Machine. In order to reduce the size of the download, Emacs is
-not pre-installed. Since people obviously have very strong opinions
-about which editor is best, :-) Debian fortunately make it very easy to
-install Emacs:
+B<Optional:> Also, to reduce download size, the Tutorial VM just
+includes a minimal command-line environment. You are free to use
+Debian's very capable C<apt> package manager to install other packages.
+You will first want to pull the apt cache files with C<aptitude update>
+(or C<apt-get update> if you prefer apt-get).
+
+The VI/VIM editor is already installed on the Tutorial Virtual Machine.
+In order to reduce the size of the download, Emacs is not pre-installed.
+Since people obviously have very strong opinions about which editor is
+best, :-) fortunately it's very easy to install Emacs:
+ $ aptitude update
$ aptitude install emacs
+In general, it is expected that people will
+boot up the Tutorial VM on their main desktop (the "host machine" using
+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:
+
+ $ aptitude update
+ $ aptitude install gnome iceweasel
+
+Or, if you prefer KDE:
+
+ $ aptitude update
+ $ aptitude install kde iceweasel
+
+You can then start X Windows with:
+
+ $ startx
+
+
=back
B<and> Perl itself from your home directory [or any other directory you
chose]).
+B<Note>: Please provide feedback on how the Virtual Machine approach for
+the tutorial works for you. If you have suggestions or comments, you
+can reach the author through the email address at the bottom of this
+page or via an RT ticket at
+L<https://rt.cpan.org/Public/Dist/Display.html?Name=Catalyst-Manual>.
+
+
=head2 Sorting Out Virtual Machine Network-Related Issues