From OpenSimulator

Revision as of 14:43, 25 January 2010 by Justincc (Talk | contribs)

Jump to: navigation, search

Contents

Introduction

Please note: As OpenSim is still at an alpha code maturity stage, there is absolutely no guarantee that functionality works or is stable, even in the numbered releases. Certain features may not work either because the code is in rapid evolution, or because functionality expected by the Linden Labs Second Life viewer has simply not been implemented yet. However, constructive feedback is still welcomed.

Also, please be aware that setting up OpenSim requires a high level of technical knowledge. WE CANNOT HANDHOLD YOU THROUGH THIS PROCESS.

Binaries

Binary packages of the latest OpenSim release are provided in .zip or .tar.gz form - these are identical apart from the compression format. Once you've unzipped/untarred these you'll be able to run OpenSim 'out of the box' in standalone mode - no code compilation required.

The current release is 0.6.8 (released on 23rd December 2009) and can be downloaded at:

Further instructions can be found in README.txt after you untar/unzip the archives.

Installers

The OpenSim project does not currently provide installers for the latest releases - you're better off downloading the binary packages and just unzipping them. However, if you do want an executable installer, here are some links to some older install packages.

  • 0.6.6 Windows Installer (Post-fixes version r9993)
http://forge.opensimulator.org/gf/download/frsrelease/199/588/OpenSim0.6.6Setup.exe
  • 0.6.6 Mac OS X Installer (Post-fixes version r9993)
http://forge.opensimulator.org/gf/download/frsrelease/198/587/OpenSimulator-0.6.6-post-fixes-r9993.dmg
  • 0.6.6 (and other releases/revs) unofficial Debian and Ubuntu Linux .deb packages
http://opensimulator.org/wiki/UnofficialDebPackages

Source code

Here are the current released versions of OpenSim.

Please see Branches for more information on the repository branches and what they are for.

The latest source releases are always hosted at http://dist.opensimulator.org.

Both these packages are the same except for the compression format.


Release Code via Git

Instead of using a source archive release, you can pull specific releases from our git source code repository. For more information on installing and using Git, please see Using Git.

In each case you'll want to start with a clone:

git clone git://opensimulator.org/git/opensim

Then all other commands are run from inside the checked out directory. For example

  • Command for retrieving 0.6.8
git checkout 0.6.8-release
  • Command for retrieving 0.6.8 with ongoing fixes
git checkout -b 0.6.8-post-fixes origin/0.6.8-post-fixes
  • Command for updating an existing checked out 0.6.8 branch with subsequent changes
git pull

Release Code via ViewGit Web Utility

You can also get OpenSimulator code via the ViewGit web utility at

http://opensimulator.org/viewgit/?a=summary&p=opensim

or for the 0.6.8-post-fixes branch.

http://opensimulator.org/viewgit/?a=shortlog&p=opensim&h=refs/heads/0.6.8-post-fixes

You'll see a list of revisions as shown below.

Git Summary.png

The tarball or zip source code package for any particular revision can be downloaded by the tar/gz and zip links in the rightmost "Actions" column.

Release notes

These are extracted from the subversion history log and correlated with the tagged releases. It should provide some idea of the changes between each tagged version. How ever, since the tagged releases are moved out of the trunk, the versions aren't an exact correlation. Please read and understand Release Cycle and On revisions, tags and branches before using this information.

These notes are not currently being maintained. Need to update process for git which shouldn't be hard to do


Other Distributions

Other projects are free to repackage OpenSim and add their own modules or configuration. Current known distributions are

  • Diva Distribution, a Preconfigured hypergrided standalone. Easy to setup and to keep up to date. Windows and Linux/Unix. Download the file diva-rNNNN.zip, unzip it, read README.txt and take it from there.

http://github.com/diva/diva-distribution/downloads

  • OSGrid distribution. This is preconfigured for connection of an OpenSim instance to http://osgrid.org.

http://www.osgrid.org/elgg/pg/utilities/software


Older Versions Archive

All older versions of OpenSim are available from the Git repo (this includes fully converted versions of every change that existed in the subversion repository, including all old tags and branches). Please be aware that even if there is zero official support for the latest version, there's even less support for older ones. They are kept here for historical and technological reference only.

The 'official' release tags and branches are all available from:

git://opensimulator.org/git/opensim

The named branches are typically extremely experimental offshoots. Stick with recent numbered versions if you expect anything to work.


Experimental Upstream Code

There Be Dragons Beyond This Point

If you are truly feeling dangerous, adventurous, or want to help us test the next version of OpenSim you are welcome to grab the latest unstable code out of our git master repository. Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of master. Never, ever, ever, never run this in production environments, it is not suitable for that unless you are very familiar with the source code, and can hot fix any piece of it (that probably means you are an OpenSim core member). Feedback and testing on the unstable tree is appreciated, as that helps us make the next release better. If this scares you from using trunk, that was intended.

If it breaks, you get to keep both pieces.

  • Latest git revision version (bleeding edge)
git clone git://opensimulator.org/git/opensim
  • To checkout a specific revision

After creating the clone, chnage into the directory and:

git reset --hard ########

Where ######## is the unique hash of the version you are interested in.

Another option for obtaining the code is via subversion with our svn mirror. This mirrors all git changes since the old 10k1 changeset in subversion. It is synchronized every 15 minutes, so may be 15 minutes behind git master.

  • Latest subversion revision version (bleeding edge)
svn co http://opensimulator.org/svn/opensim-track/trunk opensim

To do this with git:

git-svn clone http://opensimulator.org/svn/opensim-track opensim -T trunk


Related Software

Related Software Section - CLICK HERE

Pages by Category: User-pages, Developer-pages, Scripts
UNIQ6b6e123064530a0e-cleanpage-00000000-QINU

Personal tools
General
About This Wiki