Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
SRAS -- An Asset Server for OpenSimulator
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
config
lib
sql
test
.gitignore
.travis.yml
CHANGELOG
Gemfile
Gemfile.lock
LICENSE
README.md
sras.gemspec

README.md

SRAS -- An Asset Server for OpenSimulator

NOTICE

Hi. I haven't used OpenSim for over 3 years, and I'm unlikely to update SRAS in the future, so rather than keep it lingering as a project of unknown compatibility with current versions of OpenSim I'm just going to officially declare SRAS abandonware.

I wrote the first version in an afternoon back in 2010, and it was only supposed to be a stop-gap measure for "2 or 3 weeks". Hopefully today there are better, more up-to-date options available to you.

Thanks for your support.

-coyled 2014-12-18

Features

  • Asset de-duplication
  • Compressed asset storage on disk
  • Ability to disable serving of specific assets without deleting

Install

The packages of Ruby shipping with Ubuntu don't include built-in zlib support. I prefer using RVM [ http://rvm.beginrescueend.com/ ] anyway.

Built & tested with Ruby v1.9.2.

Install via:

$ gem install sras

then copy the following text into /etc/sras/sras.conf or ~/.srasrc and edit as appropriate: ::

sras:
    production:
        default_asset_dir: /srv/sras
        port: 8003
        log_file: /var/log/sras.log
        pid_file: /tmp/sras.pid

mysql:
    production:
        adapter: mysql
        host: localhost
        username: sras
        password: sras
        database: sras

Running

Then just:

$ sras start

to start a single instance. In a production environment you would likely want to run several instances behind a reverse proxy like Nginx.

To see additional options:

$ sras --help

Testing

To test asset creation:

$ curl -d @test/test.asset -X POST -w '%{http_code}\n' \
    http://yourserver.example.com:8003/assets/

You should get a 200 HTTP response, have an entry in your assets table, and have a file contain the asset data on disk.

To test retrieval of that asset:

$ curl -X GET -w '%{http_code}\n' \
    http://yourserver.example.com:8003/assets/0193663d-44e4-4e6e-9a1c-8dd2febc5fc5/data 

Mailing List

For SRAS-related announcements and discussion feel free to join the low-volume mailing list. You can join the list by submitting the form at https://lists.sourceforge.net/lists/listinfo/sras-list

Mailing list members can email the list via sras-list@lists.sourceforge.net

List archives can be found at http://sourceforge.net/mailarchive/forum.php?forum_name=sras-list

Something went wrong with that request. Please try again.