Micro Cloud Foundry^TM Quick Start

Pre-requisites

• CloudFoundry.com account
• VMC or STS installed
• VMware Workstation, Fusion, or Player installed
• 64-bit CPU

Steps

1)   Go to http://cloudfoundry.com/micro

2)   Create a Domain and get a DNS configuration Token

3)   Download Micro Cloud Foundry VM

4)   Unzip/untar compressed Micro Cloud Foundry VM and start up Micro.vmx using VMware Workstation, Fusion, or Player. Note for Windows users: to uncompress the downloaded .tgz file use a program such as 7-Zip

9)   When prompted for Proxy information, press enter for “none”; if you are behind an HTTP Proxy, you should enter that information here

10) After installing the VMC client, you must register a new user with your Micro Cloud Foundry. Type the following VMC commands:

1. vmc target api.yourcloud.cloudfoundry.me
2. vmc register

 Congratulations, you are now ready log in and use your Micro Cloud Foundry!

 

Micro Cloud Foundry Installation - Details

Pre-requisites

• Registered CloudFoundry.com account
• vmc and Spring STS (If you want to deploy Spring Apps) installed on your desktop or laptop
• You must have installed one of the following:

 

Obtaining Micro Cloud Foundry

 First go to http://cloudfoundry.com/micro and download the Micro Cloud Foundry VM

 

Obtaining your Micro Cloud Foundry DNS Configuration Token

Type in your desired sub-domain name and click “Create”

 

This will generate a unique DNS token (save the token, as it will be required when you configure the Micro Cloud Foundry instance).

Running and Configuring Micro Cloud Foundry

After the download completes, uncompress the archive file containing the VM.

The archive will contain a directory named “micro” with two files located inside:

Double click the micro.vmx file and VMware Fusion, Workstation, or Player will start and begin booting the Micro Cloud Foundry instance.

If you are prompted to upgrade the virtual machine – CHOOSE “Don’t Upgrade”.

You will then be prompted to configure your Micro Cloud Foundry instance.

Select Option 1 to configure

First, you will be prompted to set the Micro Cloud Foundry VM user password, which will set the password for the 'root' and 'vcap' users on the VM.  You will also be asked to Verify the password that you entered.

You will now be prompted to configure the Micro Cloud Foundry networking. The most convenient option is DHCP and should work for most users. Alternatively, choose Static to manually configure an IP address.

You will then be prompted for Proxy information.  If you are behind an HTTP Proxy, you should enter that information here.  If not, just press Enter to continue.

You will then need to input the DNS configuration token that you received on the page where you downloaded the Micro Cloud VM.

Once the verification and update of the DNS is complete, the Micro Cloud Foundry instance now has enough information to complete the installation and configuration process.

Once the Micro Cloud Foundry instance has completed you will see the following screen.

Note: It may take a few minutes for the DNS entries to propagate back down through your provider. 

When this completes, you should now be able to use vmc or STS from your client and successfully target your Micro Cloud Foundry instance. 

Using a Client to connect

You can now begin using the vmc or STS client by targeting the url listed in the following message that's displayed on the Micro Cloud Foundry console:

Micro Cloud Foundry operational, to access use: 
vmc target http://api.demo.cloudfoundry.me

From the command line of your development computer, type 'vmc target http://api.demo.cloudfoundry.me'.  You will replace the demo with whatever name you have chosen for your Micro Cloud Foundry instance.

Logging into Micro Cloud Foundry

To use the Micro Cloud Foundry instance, you will have to register a user.  The first thing that must be done to use Micro Cloud Foundry is to target the Micro Cloud Foundry instance.  

Using vmc this is done by typing:

vmc target http://api.YOURMICROCLOUDNAME.cloudfoundry.me

You will then need to register a user on the Micro Cloud Foundry instance.  This is done by typing:

vmc register

You will then be prompted to input a username (e-mail address) and a password

Once you have successfully registered, you can log in through vmc or STS using those credentials.  At this point, you are ready to use Micro Cloud Foundry the same way that you would use CloudFoundry.com.

For details on how to use Micro Cloud Foundry, please see the Introduction to using Micro Cloud Foundry or the Introduction to Using Micro Cloud Foundry with Spring STS.