Setting Up a CloudStack Development Environment on Mac OS X

• Java is already installed in OSX
• Tomcat 6 can be downloaded from the Apache website.
  • Uncompress and copy apache-tomcat-6.0.32 to /usr/local
  • sudo cp -r ~/Downloads/apache-tomcat-6.0.32 /usr/local/; sudo chown -R <you>:staff /usr/local/apache-tomcat-6.0.32*

  • Edit ~/.profile and insert:

    export CATALINA_HOME=/usr/local/apache-tomcat-6.0.32
    

• git can be downloaded from the internet (search git for mac)
• The cloudstack build requires mkisofs. To get this:
  • Install XCode from the AppStore (Xcode is around 1.53 GB, so it will take a while before this completes. Look at the "Purchases" window of the App Store to view the download progress)
    • On Mac OS X, installation of Xcode via App Store doesn't actually install Xcode - you will need to go to Finder -> Applications -> Xcode and then you will be prompted to install Xcode.
    • After the Xcode installation goes through, you will need to install the Command Line Tools for Xcode. To do this, open Xcode, and then, on the top left corner of the screen, click on Xcode -> Preferences. In the dialog box that opens, click on Downloads. There, click on Install for Command Line Tools.
  • Install MacPorts (google for it) or install brew (http://mxcl.github.com/homebrew/)
  • sudo port install cdrtools; or using brew: brew install cdrtools (could take a long time)
    • 'brew install cdrtools' did not work for me on OSX 10.9.  However, 'brew install dvdrtools' did work for me...
  • NOTE - If after the above steps, for any reason, mkisofs is still not installed, download it from the net. One good link to get mkisofs for mac is - http://www.helios.de/viewart.html?id=1000-en#download . Follow the instructions in the section "Download HELIOS “mkisofs” tested binary versions". Use the macosx86 binary if you're running mac os x on an intel platform. After downloading the mkisofs binary, copy it over to /usr/local/bin/.

• Download and install mysql from the mysql website. Select the installed instead of the binary package. After installing mysql server from the dmg package, also install the startup package. Include the path to /usr/local/mysql/bin in your PATH variable by editing ~/.profile . In the .dmg file, you will also find a "MySQL.PrefPane" file. Double click it and it will create a preferences pane where you can start up the mysql server, and configure it to auto start on system startup. You can change this later in "System Preferences" of OS X.
• Download Eclipse from the eclipse mirror. After downloading, simply copy the folder into the Applications folder
• Open up the firewall to allow 8250 incoming:sudo ipfw add 00710 set 3 allow log tcp from any to any dst-port 8250 in setup keep-state

Troubleshooting::

• If you run into import requests or import mysql error; Do a pip install requests and pip install mysql-connector-python. If pip is not available do a sudo easy_install on pip.
• Out of Memory upon Server run then, export MAVEN_OPTS="-Xmx2048m -XX:MaxPermSize=800m -Xmx2g -Xdebug -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n"