Giter VIP home page Giter VIP logo

sras's Introduction

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 [email protected]

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

sras's People

Contributors

coyled avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.