X-Git-Url: https://feistymeow.org/gitweb/?a=blobdiff_plain;f=production%2Fsites%2Fcakelampvm.com%2Fdocs%2Fmanual%2Fcakelampvm_guide_v002.html;h=010635031446c218a7c9610bd20f074ee0a52ac3;hb=8e574c3a0f2a4395e332f120ca05acd226d11174;hp=610b4564f960ec684afd245a279c08a7bdffbbbc;hpb=445830cea59cd440fcb81254b4600545b1cbe581;p=feisty_meow.git diff --git a/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html b/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html index 610b4564..01063503 100644 --- a/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html +++ b/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html @@ -9,17 +9,54 @@ Configuration and Usage
The cakelampvm project provides a virtualbox VM that acts as an "internet + in a bottle". The virtual machine provides DNS services (bind9), a Web server (Apache2), a full Ubuntu Linux desktop environment, + the Fluxbox X window manager, + and a suite of tools called the Feisty Meow® codebase + + . Together, these services provide you with a very flexible and + powerful testbed for web development, especially suited for CakePHP.
+todo: arrange gritty details to back.
+TOC GOES HERE.
[First, let me drop the registered trademark symbol from here on + in. I hope its presence above has been sufficiently clear for legal + purposes, but now it will just get in the way. Also, capitalization + really bores me, and it's the feisty meow codebase anyhow, so that's how + it will be written henceforth.]
+The feisty meow scripts are a cohesive bash scripting environment for + getting a variety of tasks done. The scripts recently incorporated + the 'avbash' collection from Saco Designs, which provides tools for + bringing up CakePHP web sites and managing the collection of repositories + for those sites. Each website is considered an "application", and + the application name itself (e.g. "winterportlibrary") can often provide + all the details for "powering up" the site. The feisty meow team has + added additional scripts for managing DNS domains and Apache websites that + provide the capability to "stand up" an entire website around an + application, with accompanying domain.
+The scripts for now are documented separately within the Feisty Meow + codebase. The Feisty Meow readme file provides some valuable + information on configuring the codebase. If you have the cakelampvm, + then this has already been done for you on the vm in the developer account. + The script documentation is available in the UHHHHHH page of something..
Using the virtualbox interface, you should now be able to start your + virtual machine. Virtualbox will complain if it detects any + remaining configuration problems in the VM, but it should start + normally. The Linux boot sequence will show many lines of text, + before bringing up a black console window with a login dialog.
+You can log in directly on the VM console with the developer account, but + it is generally more useful to connect to the cakelampvm over ssh. + If the networking has been established properly, you should be able to do + this with:
+ssh developer@cakelampvm.com (or equivalent with your ssh client)+
And then provide the password to log in.
+A feature called "X forwarding" is enabled, so if you start graphical + applications on the VM, you can display them from an appropriately + configured host. (If you're running Linux as the host for the VM, + you can definitely run remote windows. Windows may not support + that.)
+#### check this!!!
The cakelampvm has been set up to provide a DNS server which will answer name requests for all of the sites that the VM hosts.
@@ -103,6 +159,20 @@ping cakelampvm.com
ping defaultcake.cakelampvm.com
ping mapsdemo.cakelampvm.com+
The ipconfig tool will provide helpful information about your current + networking and DNS configuration:
+ipconfig --all+
The DNS configuration on Windows is somewhat byzantine. The pipe + characters ('|') below are used to separate the menus or tabs or dialogs + to traverse. Follow this path to get to the DNS config:
+Control Panel | Network & Sharing | click WiFI or Ethernet link near top right | click Adapter Settings on left | click on specific network device to modify | select Properties+
+
+
+
On the host computer, look for the guest vm as a networked computer called cakelampvm. This should provide some network shares using