Setup on Amazon EC2¶
We provide a Crossbar.io on Amazon EC2 Virtual Machine Image as a Community AMI to make setup on Amazon EC2 as simple as possible. The image has Crossbar.io running on Ubuntu Server 14.04 LTS.
If you want to install Crossbar.io from scratch, or run it on a different OS, see the Installation of Crossbar.io.
Create an Instance¶
Press ‘Launch Instance’
Select ‘Community AMIs’ in the list of AMI sources on the left.
Search for ‘crossbar’ using the search box.
Select the found AMI.
In the setup, when configuring the security group, it makes sense to add a ‘Custom TCP Rule’ for the ‘Port Range’ ‘8080’ since the application templates that come with Crossbar are served on this port.
There are AMIs for all regions, so this should work no matter where you want to run you EC2 instance.
SSH into the instance¶
Now connect to the machine via SSH software of your choice.
The IP or domain name are listed in the instance information
The user name is ‘ubuntu’.
Once you’ve logged into the machine, you can set up Crossbar.io. One place to start is by using the application templates. For example, to set up the hello:browser demo and run it, do
crossbar init --template hello:browser --appdir hello_browser
cd hello_browser
crossbar start
You can then access the demo from any (modern) browser at the IP of your machine at port 8080.
Updating Crossbar.io¶
Since Crossbar.io is under active development, the version of Crossbar installed in the image will often lag behind.
There are two ways of updating Crossbar.io:
Update to latest release¶
You can udpate to the latest release version using pip
(a Python
package manager). Simply do
pip install -U crossbar[all]
Update to trunk¶
To get the most current development version of Crossbar.io, you can
update from the GitHub repository. Git is already installed and the
repository is cloned into crossbar
.
To update do
git pull
cd crossbar
pip install --upgrade -e .[all]