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
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
+ $ 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
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
+ $ sudo aptitude update
+ $ sudo ptitude install gnome iceweasel
Or, if you prefer KDE:
- $ aptitude update
- $ aptitude install kde iceweasel
+ $ sudo aptitude update
+ $ sudo aptitude install kde iceweasel
You can then start X Windows with:
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