Page History

...

• The selection of default packages to install is inadequate, because development and common editors are not included.
  • Under 'Devel', 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 'Libs', select libsasl2
  • Under 'Net', select ca-certificates
  • Select Python for 'Install'
  • Under 'Utils', select genisoimage and mkisofs

...

• 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 Python 2.7 for Windows

CloudStack includes portions of Python code. I know you just installed the Cygwin Python but some parts of the maven build process also require a "native" python installation as it won't be able to access the Cygwin installation.

• Download from http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi and install
• Also download and install the setuptools from http://pypi.python.org/pypi/setuptools
• Add the path (typically C:
  Python27) to the Windows System environment variable PATH

Step 4) 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

...

4a) Add Plugins to Eclipse

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

OPTIONAL:   Install Python 2.7

When Eclipse is launched from the Windows shell, its PyDev plugin will not have access to the Cygwin installation of Python.  If you want to give PyDev access to Python, install it.

• Download from http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi

OPTIONAL:  Install PyDev using Eclipse

PyDev enhances the Eclipse environment Python specific features.

...

• 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 columscolumns
• Filter the results with the text 'm2e'

...

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

Step

...

5) 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

...

6) Install MySQL for windows.

Download the self-installing exe from http://dev.mysql.com/downloads/mysql/5.0.html#downloads

• 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

...

6a) Install Python bindings for MySQL for windows.

Download the self-installing exe for Python 2.7 from http://dev.mysql.com/downloads/connector/python/

Step

...

7) DEPRECATED:  Install Apache Ant

A manual installation of Ant is only required for building CloudStack 4.0.

...

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

Step

...

8) Install Apache Maven 3.0

Maven is available from http://maven.apache.org/download.html

...

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

Step

...

9) Download cloudstack-oss source

From a Cygwin window:

• Create a cloudstack-oss directory, cd into it
• Use git clone to download the repo from https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git
  • E.g. git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git

Step

...

10) Install "mkisofs"

Cygwin's mkisofs is a soft link. These do not work with the build.

...

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

Step

...

11) Tell CloudStack the password for mysql

Password is assigned to DBROOTPW= in the build/replace.properties file.

E.g.
{{$ cat build/override/replace.properties
DBUSER=cloud
DBPW=cloud
DBROOTPW=
MSLOG=vmops.log
APISERVERLOG=api.log
DBHOST=localhost
AGENTLOGDIR=logs
AGENTLOG=logs/agent.log
MSMNTDIR=/mnt
COMPONENTS-SPEC=components-premium.xml}}

Step

...

12) Build

To clean out existing artifacts, go to the cloudstack source folder and run:

...

Open the mgmt server console using http://localhost:8080 and configure it as required.

Step

...

13) OPTIONAL: Start working with DevCloud

DevCloud provides a self-contained CloudStack development environment, which runs in a VirtualBox VM. For details, refer to Setup CloudStack development environment in 8 steps DevCloud

Troubleshooting

1) Problem: Server will not start and throws following exception

...