X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Manual.git;a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FTutorial%2F01_Intro.pod;h=00c7c0c0160df58bc2d451ade3d77d382682ff82;hp=02725c458c6496a9f20a071ef2711a93d68cb946;hb=d1598ab8aef2d8506e8e82baa0d9c22867b81f8e;hpb=f0deaac8206658b8fb4c948774ede828b0574860 diff --git a/lib/Catalyst/Manual/Tutorial/01_Intro.pod b/lib/Catalyst/Manual/Tutorial/01_Intro.pod index 02725c4..00c7c0c 100644 --- a/lib/Catalyst/Manual/Tutorial/01_Intro.pod +++ b/lib/Catalyst/Manual/Tutorial/01_Intro.pod @@ -194,10 +194,11 @@ 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"). -B Throughout the tutorial, we will shows the UNIX shell prompt -as "C<$>". If you are using Tutorial VM, the prompt will really be -"C", but we will keep it short (and also use "C<$>" in -lieu of "C<#>", since "C<#>" looks too much like a Perl comment). + +B 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" (where "C<~"> will change to show your +current directory), but we will keep it short and just use "C<$>". =over 4 @@ -212,9 +213,9 @@ B<(and everything else they do for the Perl community)!> =item 2 -Uncompress the image: +Uncompress the image on the "host machine": - tar zxvf CatalystTutorial.tgz + MAINCOMPUTER:~$ tar zxvf CatalystTutorial.tgz =item 3 @@ -224,13 +225,14 @@ L. =item 4 -Once you get a login prompt, enter the username B and a password -for C. You should now be at a prompt that looks like: +Once you get a login prompt, enter the username B and a +password for C. You should now be at a prompt that looks +like: - catalyst login: root + catalyst login: catalyst Password: catalyst ... - root@catalyst:~# + catalyst@catalyst:~$ =item 5 @@ -248,7 +250,7 @@ The image it design to automatically use a DHCP-assigned address. 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 @@ -275,13 +277,13 @@ tutorial. B, 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 / +with the same username and password as we used in Step 4: B / B - catalyst login: root + catalyst login: catalyst Password: catalyst ... - root@catalyst:~# + catalyst@catalyst:~$ =item 7 @@ -313,26 +315,53 @@ back and carefully check each of the steps above. =item 9 -B 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 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 package manager to install other packages. +You will first want to pull the apt cache files with C +(or C 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 (or C) 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 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 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 Perl itself from your home directory [or any +other directory you chose]). B: Please provide feedback on how the Virtual Machine approach for the tutorial works for you. If you have suggestions or comments, you