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").
-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).
+
+B<Note:> Throughout the tutorial, we will shows the UNIX shell prompt as
+"C<$>". If you are using the Tutorial VM, the prompt will really be
+"C<catalyst@catalyst:~$>" (where "C<~"> will change to show your
+current directory), but we will keep it short and just use "C<$>".
=over 4
=item 4
-Once you get a login prompt, enter the username B<root> and a password
-for C<catalyst>. You should now be at a prompt that looks like:
+Once you get a login prompt, enter the username B<catalyst> and a
+password for C<catalyst>. You should now be at a prompt that looks
+like:
- catalyst login: root
+ catalyst login: catalyst
Password: catalyst
...
- root@catalyst:~#
+ catalyst@catalyst:~$
=item 5
B<From your main desktop machine>, open an SSH client and connect to the
IP address found in the previous step. You should get a login prompt
(accept the SSH key if you get a warning message about that). Login
-with the same username and password as we used in Step 4: B<root> /
+with the same username and password as we used in Step 4: B<catalyst> /
B<catalyst>
- catalyst login: root
+ catalyst login: catalyst
Password: catalyst
...
- root@catalyst:~#
+ catalyst@catalyst:~$
=item 7
=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:
+
+ $ sudo aptitude update
+ $ sudo 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:
+
+ $ sudo aptitude update
+ $ sudo ptitude install gnome iceweasel
+
+Or, if you prefer KDE:
+
+ $ sudo aptitude update
+ $ sudo aptitude install kde iceweasel
+
+You can then start X Windows with:
+
+ $ startx
- $ aptitude install emacs
=back
You may note that the Tutorial Virtual Machine uses L<local::lib> so
-that the Perl modules are run from ~/perl5 (in this case, /root/perl5)
-vs. the usual location of your "system Perl". We 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 both the modules
-B<and> Perl itself from your home directory [or any other directory you
-chose]).
+that the Perl modules are run from ~/perl5 (in this case,
+/home/catalyst/perl5) vs. the usual location of your "system Perl". We
+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
+both the modules 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
projects / catagits/Catalyst-Manual.git / blobdiff