From 32d3f111121f3a9ebdd60e6b777cf49ab1f2f60d Mon Sep 17 00:00:00 2001 From: Chris Koeritz Date: Thu, 16 Nov 2017 20:33:07 -0500 Subject: [PATCH] more updates --- .../docs/manual/cakelampvm_guide_v002.html | 49 +++++++++++++------ 1 file changed, 34 insertions(+), 15 deletions(-) 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 0f81c380..279fd5f3 100644 --- a/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html +++ b/production/sites/cakelampvm.com/docs/manual/cakelampvm_guide_v002.html @@ -84,6 +84,11 @@ meow

Configuring host-only networking for the VM makes the VM completely local to your machine.  The cakelampvm will not be accessible on the internet or from the LAN, and can only be accessed by your host PC.

+

Note: If the host-only or NAT network exist ahead of time, virtualbox may + complain about them even if they have the correct configuration.  + This can be corrected simply by opening the VM settings and selecting the + appropriate network names again.

+

To configure the host-only network, follow these steps:

  1. Go to virtual box "Preferences" (global preferences, not for a specific vm).
    2. @@ -105,9 +110,15 @@ meow for convenience and stability.

Additional information on host-only (and other) network adapter types is - at: https://www.virtualbox.org/manual/ch06.html#network_nat_service
-

-

Configure the Nat Network on virtualbox

+ at: https://www.virtualbox.org/manual/ch06.html#network_nat_service

+

Configure the NAT Network on virtualbox

+

The NAT (Network Address Translation) network allows the VM to get off of + the machine and onto the internet safely.  It will use this interface + for any communication off of the host machine.  Since the real IP + address of the VM is hidden behind the NAT firewall on Virtualbox, this + keeps the VM safe from attackers, and hence your machine stays safe as + well.

+

To set up the NAT network, follow these steps:

  1. Go to virtual box "Preferences" (global preferences, not for a specific vm).
    2. @@ -165,7 +176,7 @@ meow 
    ping cakelampvm.com
    ping defaultcake.cakelampvm.com
    ping mapsdemo.cakelampvm.com
    -

    Setting up DNS on Windows

    +

    Setting up DNS on Windows

    The ipconfig tool will provide helpful information about your current networking and DNS configuration:

    ipconfig --all
    @@ -175,11 +186,12 @@ meow 
    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


    -


    +

    {fill in rest}


    -

    Editing files on the guest VM from the host

    +

    Editing files on the guest VM from the host

    On the host computer, look for the guest vm as a networked computer called cakelampvm.  This should provide some network shares using Microsoft SMB protocol, and they can be attached to using the "developer" @@ -197,7 +209,7 @@ meow 

    sudo chmod g+w /var/www

    Afterwards, the www folder should allow the developer user to create new folders at will.

    -

    Accessing files on the host PC from the guest VM

    +

    Accessing files on the host PC from the guest VM

    If you want to share a folder from the host to the guest, perhaps for driver updates or other conveniences, then make the share with these steps:

    @@ -215,14 +227,21 @@ meow

Adding a new website and domain on the guest VM

-

To add a new website, you will need to pick one of the DNS options below - (A or B) depending on how you want to name the site.  After the DNS - is updated, then follow the section after for creating a new apache conf - file.

-

Assuming one has created a new folder in "www" called "greatsite", then - the new web site can be brought online on the vm with one of the following - options.

-

DNS Option A: Using a sub-domain in the cakelampvm.com domain

+

To add a new website, you will first need to pick one of the DNS options + below (A or B) depending on how you want to name the site.

+

Let us say a customer needs an application called "excalibur".  It + will be a new subdomain within an existing domain, such as the + "cakelampvm.com" domain, meaning we want the VM to start answering + requests for "excalibur.cakelampvm.com".

+

DNS Option A: Adding a sub-domain in an existing domain

+ Note that this option requires the containing domain "cakelampvm.com" to + already exist before adding the subdomain; see DNS Option B below for + details on how to add a containing domain for the first time. +

Quick approach: Use the feisty meow add_domain command.

+

Run this command in a bash shell on the VM:

+ 
add_domain excalibur.cakelampvm.com
+

Done.

+

Manual approach: Edit the bind9 configuration.

Connect to the cakelampvm via ssh as the developer user, e.g.: ssh developer@cakelampvm.com

Execute the following command to edit the DNS file for the cakelampvm -- 2.34.1