Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To install Cygwin, you download and run the setup.

  • Cygwin and many utilities do not like spaces in the path.  When asked for the path to install to, use a path such as 'c:\bin\cygwin' or 'c:\cygwin'.
  • 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 'DevelopDevel', 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.
    • Under 'Utils', select genisoimage and mkisofs
  • 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.

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 the JDK.

You can download the latest JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

  • Pick the self-installing executable corresponding to your O/S type (32 or 64bits)
  • When asked about the install path, use something that doesn't have space in it.  e.g. c:\bin\Java
  • Note where you're installing it. Set the Windows System variable JAVA_HOME to this path.
    • I removed the user 'JAVA_HOME' variable to prevent the System variable from being overridden.

Step 3) Install the latest Eclipse

Eclipse is available from http://www.eclipse.org/downloads/

  • Eclipse does not have an O/S-specific installer. Thus, the .zip you download does not include an .MSI file
  • At the time of writing the latest version was Eclipse Juno (4.2)
  • Place the unzipped download in the folder you want to run Eclipse from.

Step

...

3a) Add Plugins to Eclipse

CloudStack includes portions of Python code, which is best editted edited with the PyDev Eclipse plug-in

...

  • Open Eclipse, if it is not already open.
  • Navigate to tool bar menu Help --> Installing New Software...
  • Select -All Available Sites- from the dropdown list.
    • Wait for 'Pending...' to disappear from the box with the Name and Version colums
  • Filter the results with the text 'm2e'

Add M2Eclipse

...

OPTIONAL: Install EGit to provide integration to git from Eclipse

  • Click on About
  • Click on Eclipse Market Place
  • Click on Popular tab
  • Find EGit - Git Team Provider

Step 4) OPTIONAL:  Install Apache Tomcat 6.0.33

For development purposes, you do not need Apache Tomcat.  There are Maven scripts available to launch the management server in Jetty, which provides Tomcat functionality.

...

NB: Test your environment variables by opening a Cygwin shell and typing 'which Tomcat6'. This should return the path to the Tomcat executable.

Step

...

You can download the latest JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html.

  • Pick the self-installing executable corresponding to your O/S type (32 or 64bits)
  • Note where you're installing it. Set the Windows System variable JAVA_HOME to this path.
    • I removed the user 'JAVA_HOME' variable to prevent the System variable from being overriden.

Step 5) Install MySQL for windows.

...

  • The most recent 5.1.x is recommended; however, developers are also using 5.5
  • Check the box that asks whether you want to include mysql bin directory in the PATH. The option is a checkbox towards the end of the config wizard.
  • Also download the MySQL Workbench UI to give yourself an UI to the MySQL database.

Step 5a) Install Python bindings for MySQL for windows.

...

  • Version 3.x is preferred required for CloudStack
  • Maven does not have an O/S-specific installer. Thus, the .zip you download does not include an .MSI file
  • Place the unzipped download in the folder you want to run Maven from.
  • Choose folder such that there are no spaces in the path!  E.g. C:\cstoolsbin\maven

To inform the Cygwin environment of where Maven is, update your Windows environment variables.

...