Skip to content
Mo Morsi edited this page Nov 1, 2013 · 14 revisions

Installation Instructions

The following are instructions on how to run Omega from source on the platform of your choice.

Eventually I'd like to submit packages to the major Linux distributions (any contributions on that front would be more than welcome!). But until that time, this page will be updated to reflect the latest setup process on the supported platforms. Any errors in this process are high priority bugs in the application that need to be resolved (please file an issue if you run into anything).

Fedora Linux

From a fresh Fedora 19 install:

  • sudo yum update
  • sudo reboot

Install Omega Dependencies:

  • sudo yum install git gcc gcc-c++ ruby-devel openssl-devel libcurl-devel rabbitmq-server
  • gem install rjr
  • gem install curb
  • gem install eventmachine_httpserver
  • gem install em-http-request (--version 1.0.3)
  • gem install em-websocket
  • gem install em-websocket-client
  • gem install amqp

Startup the messaging queue (optional, though enabled by default):

  • sudo service rabbitmq-server start
  • sudo chkconfig --levels 35 rabbitmq-server start

Download Omega:

Run the server:

  • RUBYLIB='lib' ./bin/omega-server

Seed it (in a seperate terminal):

  • RUBYLIB='lib' ./examples/universes/small.rb

Create a user:

  • RUBYLIB='lib' ./examples/users Anubis sibuna Athena regular_user

Include rjr js deps in UI:

  • rm site/source/javascripts/vendor/rjr
  • ln -s ~/.gem/ruby/gems/rjr-0.16.6/site/ site/source/javascripts/vendor/rjr

Include static image and audio content in ui:

  • git clone https://github.com/movitto/omega-conf.git # this may take a few minutes
  • ln -s ~/omega/omega-conf/release/omega-content/audio/ site/source
  • ln -s ~/omega/omega-conf/release/omega-content/images/ site/source

Setup the web frontend:

  • sudo yum install nodejs
  • gem install rake
  • gem install middleman
  • rake site:preview

A web server is needed to proxy requests between the browser and omega-server/ the web frontend:

  • sudo yum install httpd
  • sudo setenforce 0
  • Copy the omega.conf to /etc/httpd/conf.d/omega.conf.
  • sudo service httpd start

Pop open firefox, navigate to http://localhost/womega and login! Note the web frontend uses WebGL so you will need a graphics card/adapter with OpenGL capabilities. Support for non-opengl rendering is on the TODO list.

Gem list:

  • activesupport (3.2.15)
  • addressable (2.3.5)
  • amq-protocol (1.8.0)
  • amqp (1.1.0)
  • bigdecimal (1.2.0)
  • bundler (1.3.5)
  • chunky_png (1.2.9)
  • coffee-script (2.2.0)
  • coffee-script-source (1.6.3)
  • compass (0.12.2)
  • cookiejar (0.3.0)
  • curb (0.8.5)
  • em-http-request (1.0.3)
  • em-socksify (0.3.0)
  • em-websocket (0.5.0)
  • em-websocket-client (0.1.2)
  • eventmachine (1.0.3)
  • eventmachine_httpserver (0.2.1)
  • execjs (1.4.0)
  • ffi (1.9.3)
  • fssm (0.2.10)
  • haml (4.0.3)
  • hike (1.2.3)
  • http_parser.rb (0.6.0.beta.2, 0.5.3)
  • i18n (0.6.5)
  • io-console (0.4.2)
  • json (1.7.7)
  • kramdown (1.2.0)
  • listen (1.3.1)
  • middleman (3.1.6)
  • middleman-core (3.1.6)
  • middleman-more (3.1.6)
  • middleman-sprockets (3.1.4)
  • multi_json (1.8.2)
  • psych (2.0.0)
  • rack (1.5.2)
  • rack-test (0.6.2)
  • rake (10.1.0)
  • rb-fsevent (0.9.3)
  • rb-inotify (0.9.2)
  • rb-kqueue (0.2.0)
  • rdoc (4.0.1)
  • rjr (0.16.6)
  • sass (3.2.12)
  • sprockets (2.10.0)
  • sprockets-helpers (1.0.1)
  • sprockets-sass (1.0.2)
  • thor (0.18.1)
  • tilt (1.3.7)
  • uglifier (2.1.2)
  • websocket (1.1.1)

Ubuntu Linux

Windows

Mac OSX

Coming soon...

Production install

Next Steps...