Getting started

Setup for OS X

Installing Adobe Flex

Download the free Flex 3 SDK. This is bundled with:

• mxmlc: Command-line utility for compiling ActionScript into a SWF file.
• Flash Player.app: OS X application for playing a SWF file outside of a browser.
• fdb: Command-line utility for tracking debug messages during SWF runtime.

Assuming that you installed at /Applications/Flex SDK 3, add the following to your ~/.profile, ~/.bash_profile, ~/.bashrc, or appropriate equivalent:

export PATH=/Applications/Flex\ SDK\ 3/bin:$PATH

Installing ejabberd

1. Download the free ejabberd installer and run it. When it asks you for a virtual host, enter localhost, not your computer’s name.
2. Add ejabberdctl to your bash aliases or PATH in your ~/.profile or equivalent. For example:

   alias ejabberdctl="/Applications/ejabberd-2.0.2_2/bin/ejabberdctl"

3. Use ejabberdctl to get ejabberd running on your computer:

   ejabberdctl start

   
   Should the need arise, the commands ejabberdctl stop, ejabberdctl restart, and ejabberdctl status are also available.

For more information, see the ejabberd reference.

Configuring ejabberd

1. Ensure that your computer has ports 5222 and 5280 open. OS X Leopard should handle this automatically, while older versions can manage their firewall ports via System Preferences > Sharing.
2. Disable secure data transfers for now. Open /Applications/ejabberd-2.0.2_2/conf/ejabberd.cfg in a text editor. Look for the 5222, ejabberd_c2s block in the “LISTENING PORTS” section, and comment out the line resembling:

   {certfile, "/Applications/ejabberd-2.0.2_2/conf/server.pem"}, starttls,

3. Ensure that ejabberd.cfg lists localhost as a virtual host. To do this, check that ejabberd.cfg contains this in the “SERVED HOSTNAMES” section:

   {hosts, ["YOUR_COMPUTER_NAME.local", "localhost"]}.

   
   (Note: You might later want to replace YOUR_COMPUTER_NAME with the name of the project, so that you can have a separate Jabber database per project.)
4. Restart ejabberd: ejabberdctl restart

Setting up your ejabberd accounts

1. Set up your local admin account (ejabberd admin setup instructions).
2. After creating your admin account, create additional test accounts via your local web admin interface.