...

CheatSheet for setting up CloudStack Dev environment on Windows

Step 1) Install cygwin. This will give you a unix like bash shell for your windows.

To install Cygwin, you download and run the setup.

• The install option will download, cache, and install the packages that you have selected.

• The selection of default packages to install is inadequate, because development and common editors are not included.
  • Under 'Develop', select git for 'Install'. Or set the whole 'Develop' category to install. This takes more time, but it is simpler.\
  • Under 'Editors', select vim or emacs depending on which you expect to be available from the Cygwin command line.

• Unfortunately, the download can be slow depending on the mirror you select (~30 min or more).
  • Set unnecessary package categories to 'Uninstall', e.g. KDE and Games.\
• After completing the install, you can run it again.  In that case, it will use the packages you last selected as the defaults.

-> ensure that you choose mkisofs and git.

NB:  When you open a Cygwin shell, the Windows environment variables, including PATH, are imported into the shell environment. When we install the following items, we will update the Windows environment variables.

Step 2) Install latest eclipse on windows.

Step

...

3) Download tomcat 6.0.

...

33

= http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.2933/bin/apache-tomcat-6.0.29.exe

Step 3) Install cygwin. This will give you a unix like bash shell for your windows.
= http://cygwin.com/setup.exe

              -> choose all packages except those for KDE, Games, and the like, when installing cygwin. You will need git at a minimum. It takes a while (~30 mins) for this install to go through depending on n/w bandwidth of the mirror you chose from the list.

              -> ensure that you choose mkisofs and git.33.exe

Step 4) Install the downloaded tomcat. While installing, change the path to C:\ and don’t put in any spaces.. you will need to set tomcat_home to that directory in a file inside cloudstack-oss (actually I didn’t need to do this, looks like adding the path to Tomcat\bin\ in PATH, and defining CATALINA_HOME as an env variable in Windows (google it up) was enough.

              -> Leave the port at 8080 and the username/password empty.

              -> JRE will be auto detected. Mine was: C:\Program Files\Java\jre6

Step 5) In a cygwin window, do a git clone of the cloudstack-oss source code into some directory.

              -> create a cloudstack-oss directory, cd into it and fire:

              -> git clone ssh://<username>@git.cloud.com/var/lib/git/cloudstack-oss

Step 6) Edit the file cloudstack-oss/build/override/build-cloud.properties to include a tomcat_home variable:

              -> tomcat_home=C:\Tomcat 6.0

Step 7) Install "mkisofs" in windows if for any reason cygwin’s mkisofs isn’t picked up.

              -> http://svnpenn.blogspot.com/2011/06/mkisofs-for-windows_24.html

...