Cloud Foundry

Version 5 by Jack van Ooststroom
on Jun 05, 2012 14:59.

<< Changes from 4 to 5

compared with

Version 6 by Jack van Ooststroom
on Jun 05, 2012 15:23.

Changes from 6 to 7 >>

Key

These lines were removed. This word was removed.

These lines were added. This word was added.

View page history

There are 6 changes. View first change.

		h1. Table of Contents

		{toc:printable=false}
		----
		h1. Introduction

		This tutorial covers deploying an ICEfaces application to Micro Cloud Foundry and Cloud Foundry. Cloud Foundry is described by VMware, Inc. as:
		{panel}_"Cloud Foundry is an open platform as a service, providing a choice of clouds, developer frameworks and application services. Initiated by VMware, with broad industry support, Cloud Foundry makes it faster and easier to build, test, deploy and scale applications. It is an open source project and is available through a variety of private cloud distributions and public cloud instances, including CloudFoundry.com."_{panel}Optionally, the developer can utilize Micro Cloud Foundry as well, which is described by VMware, Inc. as:
		{panel}
		_"Micro Cloud Foundry provides the VMware open platform as a service in a standalone environment running in a virtual machine. It is a self-contained local development environment as similar as possible to the Cloud Foundry cloud, making application development for the cloud and the transition from development to production much more seamless."_{panel}
		----
		h1. Legend

		\|\| Terms \|\| Description \|\|
		\| {{\[micro-cloud-foundry-home\]}} \| This is the user defined home directory in which the Micro Cloud Foundry VM is (to be) unpacked. \|
		\| {{\[icefaces-application-home\]}} \| This is the user defined home directory in which the ICEfaces application is (to be) unpacked. \|

		----
		h1. Requirements

		This tutorial assumes the following requirements are met before continuing:

		* Cloud Foundry account
		* VMware Player

		{note:title=Note}Other VMware products can be used instead, like VMware Workstation or others, but this tutorial focuses on VMware Player.{note}
		----
		h1. Cloud Foundry

		In order to deploy and manage ICEfaces applications VMware provides two Cloud Foundry tools:

		* VMC (Command-line interface)
		* Cloud Foundry extension to SpringSource Tool Suite (STS) or Eclipse (Graphical IDE)

		Installing one or both is a requirement in order to deploy and manage ICEfaces applications using Cloud Foundry.

		h2. Installing VMC
		h2. Creating a Domain

		h2. Create

		* Log into [https://my.cloudfoundry.com/micro] using your credentials.
		* Enter the desired _Domain Name_ and click on the _Create_ button.
		* Save the _configuration token_ for later use.
		* Click on the _Download Micro Cloud Foundry VM_ button.
		* Select the desired location for _"micro-1.x.x.zip"_ and download the VM.

		h2. Configuring the Micro Cloud Foundry VM

		* Unpack the _"micro-1.x.x.zip"_ into the {{\[micro-cloud-foundry-home\]}} directory.
		* Using VMware Player:
		** Navigate to _File_ \-> _Open a Virtual Machine..._.
		** Navigate to the {{\[micro-cloud-foundry-home\]}} directory, select the _"micro.vmx"_ file and click on the _Open_ button.
		** Select the _Micro Cloud Foundry v1.x.x_ virtual machine and click on the _Play virtual machine_ link.
		** Enter _"1"_ to configure and press \[Enter\] to continue.
		** Enter the desired _Password_ and press \[Enter\] to continue.
		** Enter the desired Password again as the _Confirmation_ and press \[Enter\] to continue.
		** Enter the desired _network_ (e.g. _"1"_ for DHCP) and press \[Enter\] to continue.
		** Enter the desired _HTTP proxy_ and press \[Enter\] to continue.
		** Enter the \_confirmation token (as saved earlier) and press \[Enter\] to continue.
		** Press \[Enter\] to continue.
		** Confirm that the status of _Identity_ and _Services_ is _ok_ and that the status of _IP Address_ is _network up_.

		h2. Configuring VMC
		h2. VMC (Command-Line Interface)

		h3. Installing VMC

		h3. Deployment

		h4. Micro Cloud Foundry

		h5. Configuring VMC for Micro Cloud Foundry

		* Target the Micro Cloud Foundry using the following single-line command where the {{\[hostname\]}} placeholder needs to be replaced with the desired hostname (e.g. _"icesoft.cloudfoundry.me"_):
		{code}
		vmc target api.[hostname]{code}
		* Create a new account using the following single-line command:
		{code}
		vmc register{code}
		* Enter the desired _Email_ and press \[Enter\] to continue.
		* Enter the desired _Password_ and press \[Enter\] to continue.
		* Enter the desired Password again as the _Verify Password_ and press \[Enter\] to continue.

		h2. Deploying an ICEfaces Application
		h5. Deploying an ICEfaces Application to Micro Cloud Foundry

		In order to deploy an ICEfaces application using a command prompt or console follow these steps:

		* Navigate to the {{\[icefaces-application-home\]}} directory.
		* Deploy an ICEfaces application using the following single-line command:
		{code}
		vmc push{code}
		* Enter _"Y"_ to the _"Would you like to deploy from the current directory? \[Yn\]"_ question and press \[Enter\] to continue.
		* Enter the desired _Application Name_ (e.g. _"showcase"_) and press \[Enter\] to continue.
		* Enter _"Y"_ to the _"Detected a Java Web Application, is this correct? \[Yn\]"_ question and press \[Enter\] to continue.
		* Enter the desired _Application Deployed URL_ (e.g. _"showcase.icesoft.cloudfoundry.me"_) and press \[Enter\] to continue.
		* Enter the desired _Memory reservation_ (e.g. _"512M"_) and press \[Enter\] to continue.
		* Enter the desired number of _instances_ (e.g. _"1"_) and press \[Enter\] to continue.
		* Enter _"N"_ to the _"Create services to bind to '\[application-name\]'? \[yN\]"_ question and press \[Enter\] to continue.
		* Enter _"N"_ to the _"Would you like to save this configuration? \[yN\]"_ question and press \[Enter\] to continue.
		* Confirm the ICEfaces application is running correctly by going to [http://\[application-name\].\[hostname\].cloudfoundry.me/] (e.g. [http://showcase.icesoft.cloudfoundry.me/\|http://showcase.icesoft.cloudfoundry.me/]).

		h4. Cloud Foundry

		h5. Configuring VMC for Cloud Foundry

		* Target the Cloud Foundry using the following single-line command:
		{code}
		vmc target api.cloudfoundry.com{code}
		* Log into Cloud Foundry using the following single-line command:
		{code}
		vmc login{code}
		* Enter your _Email_ and press \[Enter\] to continue.
		* Enter your _Password_ and press \[Enter\] to continue.

		h5. Deploying an ICEfaces Application to Cloud Foundry

		In order to deploy an ICEfaces application using a command prompt or console follow these steps:

		* Navigate to the {{\[icefaces-application-home\]}} directory.
		* Deploy an ICEfaces application using the following single-line command:
		{code}
		vmc push{code}
		* Enter _"Y"_ to the _"Would you like to deploy from the current directory? \[Yn\]"_ question and press \[Enter\] to continue.
		* Enter the desired _Application Name_ (e.g. _"showcase"_) and press \[Enter\] to continue.
		* Enter _"Y"_ to the _"Detected a Java Web Application, is this correct? \[Yn\]"_ question and press \[Enter\] to continue.
		* Enter the desired _Application Deployed URL_ (e.g. _"showcase.cloudfoundry.com"_) and press \[Enter\] to continue.
		* Enter the desired _Memory reservation_ (e.g. _"512M"_) and press \[Enter\] to continue.
		* Enter the desired number of _instances_ (e.g. _"1"_) and press \[Enter\] to continue.
		* Enter _"N"_ to the _"Create services to bind to '\[application-name\]'? \[yN\]"_ question and press \[Enter\] to continue.
		* Enter _"N"_ to the _"Would you like to save this configuration? \[yN\]"_ question and press \[Enter\] to continue.
		* Confirm the ICEfaces application is running correctly by going to [http://\[application-name\].cloudfoundry.com/] (e.g. [http://showcase.cloudfoundry.com/\|http://showcase.icesoft.cloudfoundry.me/]).

		----
		h1. External Link(s)

		* [http://cloudfoundry.com/]