http://opensimulator.org/api.php?action=feedcontributions&feedformat=atom&user=SeanDague 2026-05-16T01:23:43Z User contributions MediaWiki 1.19.9 http://opensimulator.org/wiki/Infrastructure 2009-09-02T18:47:19Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> We are currently running a patched mantis 1.1.1. It has patches added for additional fields for patch flow (the green states), and to write to a named pipe in /var/run/mantis/mantis-notify with bug change information. This named pipe is read by the osmantis bot. Mantis has not been upgraded in a while because 1.2.x looks like it's on the near horizon, and it would be better to update to that if possible.<br /> <br /> === osmantis bot ===<br /> <br /> This is a piece of perl code hacked together quickly by sean dague based on a an example perl irc bot using the POE framework. It monitors the panda rss feed for build results, and the named pipe for mantis changes, reformats the messages, and sticks them back out onto IRC. While by no means elegant, it does get the job done. The source code for this is at http://github.com/sdague/osmantis/tree/master. It must be run inside a screen session, and does not currently reconnect in the event of loosing connection with the irc server.<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Source Management ==<br /> <br /> === git ===<br /> <br /> The git repository for opensim is in /var/git/opensim. This has been initialized with --shared=group which keeps group writable permissions on it. The opensim-svn group is the shared writable group for that repo.<br /> <br /> git:// urls are served via the git-daemon package on debian, which is run as part of the init process.<br /> <br /> === git emails ===<br /> <br /> Commit emails are sent out via the post-receive hook (.git/hooks/post-receive) using the post-receive-email script. Some jiggling of references is required to support both email and ciabot.<br /> <br /> === git to cia bot ===<br /> <br /> Using the post-receive hook every commit is pushed to the ciabot using .git/hooks/ciabot.pl. This uses the xml-rpc interface for cia.<br /> <br /> === mirroring to github ===<br /> <br /> The opensim-mirror id is used to mirror the opensim git repo out to github every 10 minutes. This is one directional, and done under cron.<br /> <br /> === panda ===<br /> <br /> Panda is configured in /var/www/panda.opensimulator.org. Panda was written from scratch by sean dague to meet the unit testing needs of opensim which none of the other tools were meeting. It is separately maintained at http://projects.dague.net. Most panda configuration is done via the database, though that isn't nicely exposed administratively yet.<br /> <br /> The best current information on panda setup and configuration is at http://github.com/sdague/panda/tree/master (the README.rdoc is nicely formatted on that page)<br /> <br /> === viewgit ===<br /> <br /> Viewgit is configured in /var/www/opensimulator.org/viewgit, and provides web access to the git repo.<br /> <br /> === svn tracking mirror ===<br /> <br /> The opensim-mirror id also uses a very crude script to attempt to create an svn mirror of the git repo. This is quite error prone, as svn seems to love to remove permissions on executables. Hopefully this will eventually be retired.<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T18:13:20Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> We are currently running a patched mantis 1.1.1. It has patches added for additional fields for patch flow (the green states), and to write to a named pipe in /var/run/mantis/mantis-notify with bug change information. This named pipe is read by the osmantis bot. Mantis has not been upgraded in a while because 1.2.x looks like it's on the near horizon, and it would be better to update to that if possible.<br /> <br /> === osmantis bot ===<br /> <br /> This is a piece of perl code hacked together quickly by sean dague based on a an example perl irc bot using the POE framework. It monitors the panda rss feed for build results, and the named pipe for mantis changes, reformats the messages, and sticks them back out onto IRC. While by no means elegant, it does get the job done. The source code for this is at http://github.com/sdague/osmantis/tree/master. It must be run inside a screen session, and does not currently reconnect in the event of loosing connection with the irc server.<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Source Management ==<br /> <br /> === git ===<br /> <br /> The git repository for opensim is in /var/git/opensim. This has been initialized with --shared=group which keeps group writable permissions on it. The opensim-svn group is the shared writable group for that repo.<br /> <br /> git:// urls are served via the git-daemon package on debian, which is run as part of the init process.<br /> <br /> === git emails ===<br /> <br /> Commit emails are sent out via the post-receive hook (.git/hooks/post-receive) using the post-receive-email script. Some jiggling of references is required to support both email and ciabot.<br /> <br /> === git to cia bot ===<br /> <br /> Using the post-receive hook every commit is pushed to the ciabot using .git/hooks/ciabot.pl. This uses the xml-rpc interface for cia.<br /> <br /> === mirroring to github ===<br /> <br /> The opensim-mirror id is used to mirror the opensim git repo out to github every 10 minutes. This is one directional, and done under cron.<br /> <br /> === panda ===<br /> <br /> Panda is configured in /var/www/panda.opensimulator.org. Panda was written from scratch by sean dague to meet the unit testing needs of opensim which none of the other tools were meeting. It is separately maintained at http://projects.dague.net. Most panda configuration is done via the database, though that isn't nicely exposed administratively yet.<br /> <br /> === viewgit ===<br /> <br /> Viewgit is configured in /var/www/opensimulator.org/viewgit, and provides web access to the git repo.<br /> <br /> === svn tracking mirror ===<br /> <br /> The opensim-mirror id also uses a very crude script to attempt to create an svn mirror of the git repo. This is quite error prone, as svn seems to love to remove permissions on executables. Hopefully this will eventually be retired.<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T15:43:20Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> We are currently running a patched mantis 1.1.1. It has patches added for additional fields for patch flow (the green states), and to write to a named pipe in /var/run/mantis/mantis-notify with bug change information. This named pipe is read by the osmantis bot. Mantis has not been upgraded in a while because 1.2.x looks like it's on the near horizon, and it would be better to update to that if possible.<br /> <br /> === osmantis bot ===<br /> <br /> This is a piece of perl code hacked together quickly by sean dague based on a an example perl irc bot using the POE framework. It monitors the panda rss feed for build results, and the named pipe for mantis changes, reformats the messages, and sticks them back out onto IRC. While by no means elegant, it does get the job done. The source code for this is at http://github.com/sdague/osmantis/tree/master. It must be run inside a screen session, and does not currently reconnect in the event of loosing connection with the irc server.<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Source Management ==<br /> <br /> === git ===<br /> <br /> === git emails ===<br /> <br /> === git to cia bridge ===<br /> <br /> === panda ===<br /> <br /> === viewgit ===<br /> <br /> === svn tracking mirror ===<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T15:38:00Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> We are currently running a patched mantis 1.1.1. It has patches added for additional fields for patch flow (the green states), and to write to a named pipe in /var/run/mantis/mantis-notify with bug change information. This named pipe is read by the osmantis bot. Mantis has not been upgraded in a while because 1.2.x looks like it's on the near horizon, and it would be better to update to that if possible.<br /> <br /> === osmantis bot ===<br /> <br /> This is a piece of perl code hacked together quickly by sean dague based on a an example perl irc bot using the POE framework. It monitors the panda rss feed for build results, and the named pipe for mantis changes, reformats the messages, and sticks them back out onto IRC. While by no means elegant, it does get the job done. The source code for this is at http://github.com/sdague/osmantis/tree/master. It must be run inside a screen session, and does not currently reconnect in the event of loosing connection with the irc server.<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Panda ==<br /> Our integrated build server <br /> <br /> == viewgit ==<br /> Our source code viewer.<br /> <br /> ''Last Updated'': 9/18/2008 - SeanDague<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T15:21:09Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> We are currently running a patched mantis 1.1.1. It has patches added for additional fields for patch flow (the green states), and to write to a named pipe in /var/run/mantis/mantis-notify with bug change information. This named pipe is read by the osmantis bot. Mantis has not been upgraded in a while because 1.2.x looks like it's on the near horizon, and it would be better to update to that if possible.<br /> <br /> === osmantis bot ===<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Panda ==<br /> Our integrated build server <br /> <br /> == viewgit ==<br /> Our source code viewer.<br /> <br /> ''Last Updated'': 9/18/2008 - SeanDague<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T13:37:12Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> The wiki is currently Mediawiki 1.13.3. Mediawiki should be kept up to date, look for security updates once a month or so on this.<br /> <br /> === Search for Wiki ===<br /> <br /> Search for the wiki is provided by MWSearch, which requires a seperate lucene process running. Lucene is a java program that generates a full text search engine for a set of data. It does this for media wiki by doing db dumps on a periodic basis. MWSearch is flakey, and some times needs to be whacked and restarted. <br /> <br /> MWSearch lives in /var/www/lucene-search-2.1. You currently need to run ./build on a regular basis there because OAI extension is not yet correctly configured to do incremental updates.<br /> <br /> == Mantis ==<br /> Our version of mantis has some patches in it that:<br /> * add the various patch states<br /> * provide a message conduit for the osmantis bot<br /> <br /> === osmantis bot ===<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Panda ==<br /> Our integrated build server <br /> <br /> == viewgit ==<br /> Our source code viewer.<br /> <br /> ''Last Updated'': 9/18/2008 - SeanDague<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> <br /> * Mediawiki Upgrade<br /> * Find new backup solution<br /> <br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Infrastructure 2009-09-02T13:10:06Z

<p>SeanDague: /* Current Infrastructure */</p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> This page is designed to keep track of the current infrastructure running the opensim project. If you have questions or suggestions, please use the Talk page.<br /> <br /> = Current Infrastructure =<br /> <br /> == Wiki ==<br /> Media Wiki 1.11 (TODO list additional pluggins we use)<br /> <br /> === Search for Wiki ===<br /> <br /> == Mantis ==<br /> Our version of mantis has some patches in it that:<br /> * add the various patch states<br /> * provide a message conduit for the osmantis bot<br /> <br /> === osmantis bot ===<br /> <br /> == Mailing Lists ==<br /> These are on berlios.de because the current opensimulator.org box sits on an ip that is in a lot of spam black lists. For this reason many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net<br /> <br /> == Panda ==<br /> Our integrated build server <br /> <br /> == viewgit ==<br /> Our source code viewer.<br /> <br /> ''Last Updated'': 9/18/2008 - SeanDague<br /> <br /> == Backups ==<br /> This is a two step process:<br /> * A nightly cronjob that dumps the mysql databases to /var/dbbackups<br /> * A backuppc process running at Sean Dague's house that sshes in nightly and backs up<br /> ** /home<br /> ** /etc<br /> ** /var/www<br /> ** /var/svn<br /> ** /var/dbbackups<br /> <br /> Backuppc has aged backups, so we've got dailies for a week, weeklies for a month, monthlies for 4 months, and every 4 months for 16 months. After the data losses on the previous box, good backups were a must.<br /> <br /> = Todo =<br /> * Publish osmantis bot to opensim forge<br /> * Upgrade mantis to latest stable<br /> <br /> [[Category:Infrastructure]]</div>

SeanDague http://opensimulator.org/wiki/Git 2009-08-13T19:23:58Z

<p>SeanDague: Redirecting to Using Git</p> <hr /> <div>#REDIRECT [[Using_Git]]</div>

SeanDague http://opensimulator.org/wiki/Git 2009-08-13T19:23:12Z

<p>SeanDague: New page: redirect:Using_Git</p> <hr /> <div>redirect:Using_Git</div>

SeanDague http://opensimulator.org/wiki/Main_Page 2009-08-04T14:29:15Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:MainPageQuicklinks}}<br /> {{Layout_box2|1=<br /> &lt;center&gt;'''Languages:'''[[OpenSimSpanish | Spanish]], [[OpenSimGerman |German]], [[fr |Francais]], [[OpenSimItalian | Italian]], [[PT| Português]], [[メインページ | Japanese]]<br /> &lt;/center&gt;}}<br /> <br /> {{Layout_box2|1=<br /> &lt;center&gt;'''FYI:''' We've migrated the main source repository to git, most of the English documentation is updated, but other languages may be behind. See [[Using_Git]] for more information.&lt;/center&gt;}}<br /> <br /> === What is OpenSimulator? ===<br /> {{Template:FrontPageSidebar}}<br /> <br /> OpenSimulator is a 3D Application Server. It can be used to create a virtual environment (or world) which can be accessed through a variety of clients, on multiple protocols. OpenSimulator allows you to develop your environment using the technologies you feel work best - we've designed the software to be easily extendable through [[Getting Started with Region Modules|loadable modules]] to build completely custom configurations. OpenSimulator is released under a [[BSD License]], making it both open source, and commercially friendly to embed in products.<br /> <br /> Out of the box, OpenSimulator can be used to simulate a virtual environment similar to Second Life™ (including client compatibility). Other environments, protocols and features are supported via add on modules. For a list of available modules check out our [http://forge.opensimulator.org/gf/ forge site].<br /> <br /> Although OpenSimulator is still considered '''alpha software''', many people are [http://technorati.com/search/opensim?authority=a4&amp;language=en doing exciting things with it].<br /> <br /> === Features ===<br /> Even though OpenSimulator is relatively young software it already has many useful features<br /> * Supports creating multiple 'worlds' in a single application instance.<br /> * Supports multiple clients and protocols - access the same world at the same time via multiple protocols.<br /> * Extensive ability to customize your avatar, both with custom clothing, skins, and attached objects.<br /> * Realtime Physics Simulation, with multiple engine options including ODE, PhysX, Bullet and more.<br /> * The ability to create content real time in the environment using in world building tools. What you see is what you get.<br /> * In world application development using a number of different languages, including LSL/OSSL, C#, JScript and VB.NET<br /> <br /> === Using OpenSimulator ===<br /> The fastest way to get started using OpenSimulator is to create an account on [http://osgrid.org OSGrid], then download the [http://opensim-viewer.sourceforge.net/ Hippo Viewer] or [http://secondlife.com/support/downloads.php Linden Lab's Second Life viewer] (amongst others) to connect to OSGrid. This process should take no longer than 10 minutes, and will give you a flavor for what OpenSimulator is like.<br /> <br /> You can also easily connect to any one of the many [[Grid_List|public grids]] on the internet.<br /> <br /> Or you could run a simple standalone OpenSim on your Windows desktop to create and preview content. [http://www.youtube.com/watch?v=ZcR7Jcar_8k Here is a tutorial showing how to get opensimulator running in stand-alone mode.].<br /> <br /> === Running your own OpenSimulator ===<br /> If you are interested in running your own OpenSimulator server, to host your own 3D environments you'll want to check out the following links:<br /> * [[Download|Getting OpenSimulator]]<br /> * [[Build_Instructions|Building OpenSimulator]]<br /> * [[Configuration|Configuring OpenSimulator]]<br /> * [[Running|Running OpenSimulator]]<br /> * [[FAQ|Frequently Asked Questions in Running OpenSimulator]]<br /> * [[Technical Reference | Technical Reference Pages]]<br /> <br /> === Participating in the OpenSimulator Community ===<br /> OpenSimulator is an [http://en.wikipedia.org/wiki/Open_source open source] project, and is powered by the community members that devote time and energy to the effort. There are many ways to participate and contribute to the community:<br /> * Participate via [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] - [irc://irc.freenode.net/opensim #opensim] (for users) and [irc://irc.freenode.net/opensim-dev #opensim-dev]<br /> * Participate via the mailing lists - [https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users] (for users) and [https://lists.berlios.de/mailman/listinfo/opensim-dev opensim-dev] (for developers).<br /> * [[WikiStructure|Contribute to this wiki]], making the OpenSimulator documentation even better.<br /> * Report [[bugs]], submit [[Submitting_code_to_OpenSim|patches]] or submit content contributions via our [http://opensimulator.org/mantis/ mantis bug tracker]<br /> * Create an OpenSimulator related project hosted on the [http://forge.opensimulator.org Forge] or [http://opensimulator.org/wiki/Related_Software elsewhere] on the web. In the forge there are over a dozen registered projects, and it's a great way to further extend the OpenSimulator community.<br /> * Participate to open content creation for OpenSimulator. More details at [[Artist Home]].<br /> * Blog about OpenSimulator, and let us know about that blog on [irc://irc.freenode.net/opensim #opensim] so it can be added to [http://planet.opensim.us Planet OpenSim]<br /> * Participate in one of the weekly [[Office Hours]] for OpenSimulator. We currently have weekly office hours for development, wiki work, and testing.<br /> * Secure project infrastructure by [[Donations|donating]] to the [[Donations|OpenSim Project Infrastructure Fund]].<br /> <br /> {{Layout_box2|1=<br /> ===Pages by Category:===<br /> &lt;b&gt;<br /> [[:Category:Getting_Started | Getting Started]] , [[:Category:Support | Support]] , [[:Category:Tech Reference|Technical Reference Pages]] , [[:Category:Help|Help]] , [[:Category:Configuration|Configuration Pages]] , [[:Category:Users|User's Pages]] , [[:Category:Development | Development Pages]] , [[:Category:Scripts|Scripts]] , [[:Special:Recentchanges| Recent Wiki Changes]]&lt;/b&gt;&lt;br /&gt;<br /> }}<br /> <br /> {{Layout_box2|1=<br /> ===Wiki Translations:===<br /> &lt;b&gt;Languages:&lt;/b&gt; [[OpenSimSpanish | Spanish]], [[OpenSimGerman |German]], [[fr |Francais]], [[OpenSimItalian | Italian]], [[PT| Português]], [[メインページ | Japanese]]<br /> }}<br /> <br /> [[Category:Main]]<br /> [[Category:Getting Started]]<br /> [[Category:Development]]<br /> [[Category:Support]]<br /> [[Category:Tech Reference]] <br /> [[Category:Help]]<br /> [[Category:Configuration]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Git_extended 2009-08-04T14:26:45Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> &lt;div style=&quot;background:#FFF;solid #CCC&quot;&gt;&lt;h3&gt;Recent Git Commits&lt;/h3&gt;&lt;p&gt;&lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;p=opensim|max=30|title=none&lt;/rss&gt;&lt;/p&gt;&lt;/div&gt;</div>

SeanDague http://opensimulator.org/wiki/Svn_extended 2009-08-04T14:26:33Z

<p>SeanDague: Svn extended moved to Git extended</p> <hr /> <div>#REDIRECT [[Git extended]]</div>

SeanDague http://opensimulator.org/wiki/Git_extended 2009-08-04T14:26:33Z

<p>SeanDague: Svn extended moved to Git extended</p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> &lt;div style=&quot;background:#FFF;solid #CCC&quot;&gt;&lt;h3&gt;Recent SVN Commits&lt;/h3&gt;&lt;p&gt;&lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;p=opensim|max=30|title=none&lt;/rss&gt;&lt;/p&gt;&lt;/div&gt;</div>

SeanDague http://opensimulator.org/wiki/Git_extended 2009-08-04T14:26:21Z

<p>SeanDague: </p> <hr /> <div>__NOTOC__<br /> {{Template:Quicklinks}}<br /> &lt;br /&gt;<br /> <br /> &lt;div style=&quot;background:#FFF;solid #CCC&quot;&gt;&lt;h3&gt;Recent SVN Commits&lt;/h3&gt;&lt;p&gt;&lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;p=opensim|max=30|title=none&lt;/rss&gt;&lt;/p&gt;&lt;/div&gt;</div>

SeanDague http://opensimulator.org/wiki/Developer_Documentation 2009-08-04T14:25:26Z

<p>SeanDague: /* SVN Access */</p> <hr /> <div>{{Template:Quicklinks}}<br /> <br /> [[Technical Reference | Technical Reference]] -&gt; [[Technical Reference/terms | Terms]] -&gt; [[Developer_Documentation | Developer Documentation]]<br /> <br /> == Developer Documentation ==<br /> <br /> ==== General ====<br /> * [[Development Team]] &amp;mdash; OpenSim is brought to you by...<br /> * [[OpenSim:Introduction_and_Definitions | OpenSim: Introduction and Definitions]] &amp;mdash; A work in progress describing the high level components of OpenSim<br /> * [[Technical Reference | OpenSim: Technical Reference]] &amp;mdash; A technical description of the simulator operation.<br /> * [[Grid Architecture Diagram]]<br /> * [[OpenSim: Screenshots]] &amp;mdash; Various OpenSim screenshots.<br /> * [http://docs.opensimulator.org/index.html The OpenSim API]<br /> <br /> ==== Development ====<br /> * [[Release Cycle]]<br /> * [[On revisions, tags and branches]]<br /> * [[Hacking OpenSim for fun and profit]] &amp;mdash; A starters guide for programming OpenSim.<br /> * [[Coding standards]] &amp;mdash; Coding conventions for developers.<br /> * [[Automated Testing]] &amp;mdash; How to write tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; How to debug the automated tests.<br /> * [[Branches]] &amp;mdash; An overview of the repository branches and what they are for.<br /> * [[Monodevelop]] &amp;mdash; How to use the [[monodevelop]] IDE for editing C# solutions.<br /> * [[Creating New Solution]] &amp;mdash; How to create new solution according to OpenSim conventions.<br /> * [[Improving Performance]] &amp;mdash; Efforts to increase OpenSim's performance.<br /> <br /> ==== Services ====<br /> <br /> * [http://opensimulator.org/mantis Mantis Bug Tracking] &amp;mdash; Mantis is the issue tracking tool of OpenSimulator.<br /> * [http://www.opensimulator.org:8085/browse/OPENSIM-TRUNK Bamboo Continuous Integration] &amp;mdash; Bamboo builds the source base continuously and runs unit tests.<br /> * [http://forge.opensimulator.org/gf/ OpenSimulator GForge] &amp;mdash; Project hosting for OpenSimulator related projects.<br /> <br /> ==== Client Stacks ====<br /> * [[Sim Throttles]] &amp;mdash; Information on how OpenSim handles throttling of packets to the client.<br /> <br /> ==== Database ====<br /> * [[Database Documentation]] &amp;mdash; A map of grid and region instances used in OpenSim<br /> * [[MonoSqlite]] &amp;mdash; How the database model currently works.<br /> * [[LSL:PrimitiveParams]] &amp;mdash; Notes on converting SL Edit GUI values and LSL PrimitiveParams to OpenSim PrimitiveBaseShape fields<br /> * [[NHibernate Performance Testing]] &amp;mdash; SQLite and MySQL performance tests with NHibernate.<br /> <br /> ==== File formats ====<br /> * [[Technical_Reference/OpenSim_Archive_Region_Format]] - Opensim ARchive (OAR) region archive file format.<br /> <br /> ==== Grid ====<br /> * [[Asset Server problems]] - list of known problems with the asset server<br /> * [[Teleports]] - some diagrams about OGP and Hypergrid teleport sequences<br /> <br /> ==== Integration ====<br /> * [[Webinterface]] &amp;mdash; How to mashup with the web.<br /> * [[RemoteAdmin]] &amp;mdash; How to use the remote admin plug-in.<br /> * [[REST]] &amp;mdash; Information about the REST interface to assets, inventory, etc.<br /> * [[Known Web Interfaces within OpenSim]] &amp;mdash; The set of CAPS, XMLRPC, or REST entry points in the project.<br /> <br /> ==== Modules ====<br /> * [[RegionModules]] &amp;mdash; The various modules that are used in the RegionServer and how to write new ones.<br /> * [[How to create a dynamic plugin]] - A tutorial for using PluginLoader<br /> * [[Getting Started with Region Modules]] - This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API.<br /> * [[Web Statistics Module]] - The web statistics module documentation and counter wish list.<br /> <br /> ==== Permissions ====<br /> * [[OpenSim:Permissions(Server)]] &amp;mdash; Permissions system as implemented on the region server.<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on how object permissions are handled on the client.<br /> <br /> ==== Physics ====<br /> * [[PhysicsEngines]] &amp;mdash; Options for physics engines in OpenSim.<br /> <br /> ==== Protocols ====<br /> * [[Metaverse Exchange Protocol]] &amp;mdash; MXP is alternative protocol for secondlife protocol.<br /> <br /> ==== Regions ====<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on object permissions &amp; definition of the ObjectFlags variable.<br /> * [[OpenSim Load Balancing and Region Splitting]] - Instructions for using load balancing and region splitting features.<br /> <br /> ==== Threading ====<br /> * [[OpenSim: Threading strategy]] &amp;mdash; How threading is implemented and handled.<br /> <br /> ==== Scripting ====<br /> * [[Scripting_Documentation]] &amp;mdash; How to use scripts and what limitations apply.<br /> * [[LSL_Status/Functions|LSL Implemented]] &amp;mdash; A list of LSL-functions that are available in OpenSim.<br /> * [[OSSL]] &amp;mdash; Some information about the OpenSimulator Scripting Language, and how to implement an OSSL function<br /> * [[OpenSim.Region.ScriptEngine]] &amp;mdash; How the ScriptEngine looks internally.<br /> <br /> ==== Search ====<br /> * [[OpenSim.Region.DataSnapshot]] - Shiny new data gathering/search system<br /> * [[ImageService]] - Shiny new region module for serving search-related images<br /> <br /> ==== Testing ====<br /> * [[Automated_Testing]] &amp;mdash; Writing Automated tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; Debugging unit tests.<br /> * [[OpenSim: Debugging - profiler dumps]] &amp;mdash; Dumps of OpenSim profiles to aid in tracking memory leaks.<br /> * [[Prim_Linking_Testing]] &amp;mdash; Test cases for in world link/unlinking of prims.<br /> <br /> ==Proposals==<br /> <br /> * [[Opensim: 0.5 Release Target Discussion]]<br /> * [[Opensim: 0.6 Release Target Discussion]]<br /> * [[Opensim: Future Release Discussion]]<br /> <br /> * [[A better SimCrossing]] - A work in progress about implementing a smooth simcrossing<br /> * [[OpenID]] - Proposal for using OpenID in OpenSim<br /> * [[AssetServerProposal]] - Proposal for a distributed asset server<br /> * [[Creating profiles not used for login]] - RFC for alternative ways of creating profiles that will never be used for login<br /> * [[OpenSim_Services_and_Service_Connectors]] - new infrastructure for connecting region simulators to backend services<br /> * [[OpenSim Profile Anchors]] - a mechanism for retaining creator information for offline item transfers<br /> * [[Explicit Object Serialization]] - a proposal to explicitly serialize scene objects rather than using automatic .NET XML serialization<br /> <br /> ==== Proposed projects ====<br /> <br /> * [[OpenWiredux: Taking the next step]]<br /> * [[Using SNMP in OpenSim]]<br /> <br /> ==Communication==<br /> <br /> A good first point of contact is the OpenSim IRC, on irc.freenode.net channels #opensim / #opensim-dev. The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at &quot;Wright Plaza&quot; on OSGrid. There is a &quot;Test Hour&quot; on Saturdays, also generally on &quot;Wright Plaza&quot;. Both these weekly events are held at 1900UTC. Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.<br /> <br /> There is also a mailman email distribution list available at https://lists.berlios.de/mailman/listinfo/opensim-dev<br /> <br /> ==Interest Groups==<br /> * [[OpenSim Quality Focus Group]] - A proposed group for developers interested in improving the quality of OpenSim as we head towards beta status.<br /> <br /> ==Git Access==<br /> You can browse the source code for OpenSim [http://opensimulator.org/viewgit using a web browser] or via git.<br /> * Anonymous Checkout - see [[Download]]<br /> * Developer Checkout<br /> git clone ssh://USERNAME@opensimulator.org/var/git/opensim<br /> <br /> ==Submitting Patches==<br /> <br /> Please review [[Submitting_code_to_OpenSim]]<br /> <br /> ==Recent Git Commits==<br /> &lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;p=opensim|max=5|title=none&lt;/rss&gt;<br /> <br /> [[Category:Main]]<br /> [[Category:Support]]<br /> [[Category:Tech Reference]] <br /> [[Category:Help]]<br /> [[Category:Configuration]]<br /> [[Category:Getting_Started]]<br /> [[Category:Development]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Developer_Documentation 2009-08-04T14:24:30Z

<p>SeanDague: /* Recent Git Commits */</p> <hr /> <div>{{Template:Quicklinks}}<br /> <br /> [[Technical Reference | Technical Reference]] -&gt; [[Technical Reference/terms | Terms]] -&gt; [[Developer_Documentation | Developer Documentation]]<br /> <br /> == Developer Documentation ==<br /> <br /> ==== General ====<br /> * [[Development Team]] &amp;mdash; OpenSim is brought to you by...<br /> * [[OpenSim:Introduction_and_Definitions | OpenSim: Introduction and Definitions]] &amp;mdash; A work in progress describing the high level components of OpenSim<br /> * [[Technical Reference | OpenSim: Technical Reference]] &amp;mdash; A technical description of the simulator operation.<br /> * [[Grid Architecture Diagram]]<br /> * [[OpenSim: Screenshots]] &amp;mdash; Various OpenSim screenshots.<br /> * [http://docs.opensimulator.org/index.html The OpenSim API]<br /> <br /> ==== Development ====<br /> * [[Release Cycle]]<br /> * [[On revisions, tags and branches]]<br /> * [[Hacking OpenSim for fun and profit]] &amp;mdash; A starters guide for programming OpenSim.<br /> * [[Coding standards]] &amp;mdash; Coding conventions for developers.<br /> * [[Automated Testing]] &amp;mdash; How to write tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; How to debug the automated tests.<br /> * [[Branches]] &amp;mdash; An overview of the repository branches and what they are for.<br /> * [[Monodevelop]] &amp;mdash; How to use the [[monodevelop]] IDE for editing C# solutions.<br /> * [[Creating New Solution]] &amp;mdash; How to create new solution according to OpenSim conventions.<br /> * [[Improving Performance]] &amp;mdash; Efforts to increase OpenSim's performance.<br /> <br /> ==== Services ====<br /> <br /> * [http://opensimulator.org/mantis Mantis Bug Tracking] &amp;mdash; Mantis is the issue tracking tool of OpenSimulator.<br /> * [http://www.opensimulator.org:8085/browse/OPENSIM-TRUNK Bamboo Continuous Integration] &amp;mdash; Bamboo builds the source base continuously and runs unit tests.<br /> * [http://forge.opensimulator.org/gf/ OpenSimulator GForge] &amp;mdash; Project hosting for OpenSimulator related projects.<br /> <br /> ==== Client Stacks ====<br /> * [[Sim Throttles]] &amp;mdash; Information on how OpenSim handles throttling of packets to the client.<br /> <br /> ==== Database ====<br /> * [[Database Documentation]] &amp;mdash; A map of grid and region instances used in OpenSim<br /> * [[MonoSqlite]] &amp;mdash; How the database model currently works.<br /> * [[LSL:PrimitiveParams]] &amp;mdash; Notes on converting SL Edit GUI values and LSL PrimitiveParams to OpenSim PrimitiveBaseShape fields<br /> * [[NHibernate Performance Testing]] &amp;mdash; SQLite and MySQL performance tests with NHibernate.<br /> <br /> ==== File formats ====<br /> * [[Technical_Reference/OpenSim_Archive_Region_Format]] - Opensim ARchive (OAR) region archive file format.<br /> <br /> ==== Grid ====<br /> * [[Asset Server problems]] - list of known problems with the asset server<br /> * [[Teleports]] - some diagrams about OGP and Hypergrid teleport sequences<br /> <br /> ==== Integration ====<br /> * [[Webinterface]] &amp;mdash; How to mashup with the web.<br /> * [[RemoteAdmin]] &amp;mdash; How to use the remote admin plug-in.<br /> * [[REST]] &amp;mdash; Information about the REST interface to assets, inventory, etc.<br /> * [[Known Web Interfaces within OpenSim]] &amp;mdash; The set of CAPS, XMLRPC, or REST entry points in the project.<br /> <br /> ==== Modules ====<br /> * [[RegionModules]] &amp;mdash; The various modules that are used in the RegionServer and how to write new ones.<br /> * [[How to create a dynamic plugin]] - A tutorial for using PluginLoader<br /> * [[Getting Started with Region Modules]] - This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API.<br /> * [[Web Statistics Module]] - The web statistics module documentation and counter wish list.<br /> <br /> ==== Permissions ====<br /> * [[OpenSim:Permissions(Server)]] &amp;mdash; Permissions system as implemented on the region server.<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on how object permissions are handled on the client.<br /> <br /> ==== Physics ====<br /> * [[PhysicsEngines]] &amp;mdash; Options for physics engines in OpenSim.<br /> <br /> ==== Protocols ====<br /> * [[Metaverse Exchange Protocol]] &amp;mdash; MXP is alternative protocol for secondlife protocol.<br /> <br /> ==== Regions ====<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on object permissions &amp; definition of the ObjectFlags variable.<br /> * [[OpenSim Load Balancing and Region Splitting]] - Instructions for using load balancing and region splitting features.<br /> <br /> ==== Threading ====<br /> * [[OpenSim: Threading strategy]] &amp;mdash; How threading is implemented and handled.<br /> <br /> ==== Scripting ====<br /> * [[Scripting_Documentation]] &amp;mdash; How to use scripts and what limitations apply.<br /> * [[LSL_Status/Functions|LSL Implemented]] &amp;mdash; A list of LSL-functions that are available in OpenSim.<br /> * [[OSSL]] &amp;mdash; Some information about the OpenSimulator Scripting Language, and how to implement an OSSL function<br /> * [[OpenSim.Region.ScriptEngine]] &amp;mdash; How the ScriptEngine looks internally.<br /> <br /> ==== Search ====<br /> * [[OpenSim.Region.DataSnapshot]] - Shiny new data gathering/search system<br /> * [[ImageService]] - Shiny new region module for serving search-related images<br /> <br /> ==== Testing ====<br /> * [[Automated_Testing]] &amp;mdash; Writing Automated tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; Debugging unit tests.<br /> * [[OpenSim: Debugging - profiler dumps]] &amp;mdash; Dumps of OpenSim profiles to aid in tracking memory leaks.<br /> * [[Prim_Linking_Testing]] &amp;mdash; Test cases for in world link/unlinking of prims.<br /> <br /> ==Proposals==<br /> <br /> * [[Opensim: 0.5 Release Target Discussion]]<br /> * [[Opensim: 0.6 Release Target Discussion]]<br /> * [[Opensim: Future Release Discussion]]<br /> <br /> * [[A better SimCrossing]] - A work in progress about implementing a smooth simcrossing<br /> * [[OpenID]] - Proposal for using OpenID in OpenSim<br /> * [[AssetServerProposal]] - Proposal for a distributed asset server<br /> * [[Creating profiles not used for login]] - RFC for alternative ways of creating profiles that will never be used for login<br /> * [[OpenSim_Services_and_Service_Connectors]] - new infrastructure for connecting region simulators to backend services<br /> * [[OpenSim Profile Anchors]] - a mechanism for retaining creator information for offline item transfers<br /> * [[Explicit Object Serialization]] - a proposal to explicitly serialize scene objects rather than using automatic .NET XML serialization<br /> <br /> ==== Proposed projects ====<br /> <br /> * [[OpenWiredux: Taking the next step]]<br /> * [[Using SNMP in OpenSim]]<br /> <br /> ==Communication==<br /> <br /> A good first point of contact is the OpenSim IRC, on irc.freenode.net channels #opensim / #opensim-dev. The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at &quot;Wright Plaza&quot; on OSGrid. There is a &quot;Test Hour&quot; on Saturdays, also generally on &quot;Wright Plaza&quot;. Both these weekly events are held at 1900UTC. Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.<br /> <br /> There is also a mailman email distribution list available at https://lists.berlios.de/mailman/listinfo/opensim-dev<br /> <br /> ==Interest Groups==<br /> * [[OpenSim Quality Focus Group]] - A proposed group for developers interested in improving the quality of OpenSim as we head towards beta status.<br /> <br /> ==SVN Access==<br /> You can browse the source code for OpenSim [http://opensimulator.org/cgi-bin/viewvc.cgi using a web browser] or via SVN.<br /> * Anonymous Checkout - see [[Download]]<br /> * Developer Checkout<br /> svn co svn+ssh://USERNAME@opensimulator.org/var/svn/opensim/trunk<br /> <br /> ==Submitting Patches==<br /> <br /> Please review [[Submitting_code_to_OpenSim]]<br /> <br /> ==Recent Git Commits==<br /> &lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;p=opensim|max=5|title=none&lt;/rss&gt;<br /> <br /> [[Category:Main]]<br /> [[Category:Support]]<br /> [[Category:Tech Reference]] <br /> [[Category:Help]]<br /> [[Category:Configuration]]<br /> [[Category:Getting_Started]]<br /> [[Category:Development]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Developer_Documentation 2009-08-04T14:23:41Z

<p>SeanDague: /* Recent SVN Commits */</p> <hr /> <div>{{Template:Quicklinks}}<br /> <br /> [[Technical Reference | Technical Reference]] -&gt; [[Technical Reference/terms | Terms]] -&gt; [[Developer_Documentation | Developer Documentation]]<br /> <br /> == Developer Documentation ==<br /> <br /> ==== General ====<br /> * [[Development Team]] &amp;mdash; OpenSim is brought to you by...<br /> * [[OpenSim:Introduction_and_Definitions | OpenSim: Introduction and Definitions]] &amp;mdash; A work in progress describing the high level components of OpenSim<br /> * [[Technical Reference | OpenSim: Technical Reference]] &amp;mdash; A technical description of the simulator operation.<br /> * [[Grid Architecture Diagram]]<br /> * [[OpenSim: Screenshots]] &amp;mdash; Various OpenSim screenshots.<br /> * [http://docs.opensimulator.org/index.html The OpenSim API]<br /> <br /> ==== Development ====<br /> * [[Release Cycle]]<br /> * [[On revisions, tags and branches]]<br /> * [[Hacking OpenSim for fun and profit]] &amp;mdash; A starters guide for programming OpenSim.<br /> * [[Coding standards]] &amp;mdash; Coding conventions for developers.<br /> * [[Automated Testing]] &amp;mdash; How to write tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; How to debug the automated tests.<br /> * [[Branches]] &amp;mdash; An overview of the repository branches and what they are for.<br /> * [[Monodevelop]] &amp;mdash; How to use the [[monodevelop]] IDE for editing C# solutions.<br /> * [[Creating New Solution]] &amp;mdash; How to create new solution according to OpenSim conventions.<br /> * [[Improving Performance]] &amp;mdash; Efforts to increase OpenSim's performance.<br /> <br /> ==== Services ====<br /> <br /> * [http://opensimulator.org/mantis Mantis Bug Tracking] &amp;mdash; Mantis is the issue tracking tool of OpenSimulator.<br /> * [http://www.opensimulator.org:8085/browse/OPENSIM-TRUNK Bamboo Continuous Integration] &amp;mdash; Bamboo builds the source base continuously and runs unit tests.<br /> * [http://forge.opensimulator.org/gf/ OpenSimulator GForge] &amp;mdash; Project hosting for OpenSimulator related projects.<br /> <br /> ==== Client Stacks ====<br /> * [[Sim Throttles]] &amp;mdash; Information on how OpenSim handles throttling of packets to the client.<br /> <br /> ==== Database ====<br /> * [[Database Documentation]] &amp;mdash; A map of grid and region instances used in OpenSim<br /> * [[MonoSqlite]] &amp;mdash; How the database model currently works.<br /> * [[LSL:PrimitiveParams]] &amp;mdash; Notes on converting SL Edit GUI values and LSL PrimitiveParams to OpenSim PrimitiveBaseShape fields<br /> * [[NHibernate Performance Testing]] &amp;mdash; SQLite and MySQL performance tests with NHibernate.<br /> <br /> ==== File formats ====<br /> * [[Technical_Reference/OpenSim_Archive_Region_Format]] - Opensim ARchive (OAR) region archive file format.<br /> <br /> ==== Grid ====<br /> * [[Asset Server problems]] - list of known problems with the asset server<br /> * [[Teleports]] - some diagrams about OGP and Hypergrid teleport sequences<br /> <br /> ==== Integration ====<br /> * [[Webinterface]] &amp;mdash; How to mashup with the web.<br /> * [[RemoteAdmin]] &amp;mdash; How to use the remote admin plug-in.<br /> * [[REST]] &amp;mdash; Information about the REST interface to assets, inventory, etc.<br /> * [[Known Web Interfaces within OpenSim]] &amp;mdash; The set of CAPS, XMLRPC, or REST entry points in the project.<br /> <br /> ==== Modules ====<br /> * [[RegionModules]] &amp;mdash; The various modules that are used in the RegionServer and how to write new ones.<br /> * [[How to create a dynamic plugin]] - A tutorial for using PluginLoader<br /> * [[Getting Started with Region Modules]] - This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API.<br /> * [[Web Statistics Module]] - The web statistics module documentation and counter wish list.<br /> <br /> ==== Permissions ====<br /> * [[OpenSim:Permissions(Server)]] &amp;mdash; Permissions system as implemented on the region server.<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on how object permissions are handled on the client.<br /> <br /> ==== Physics ====<br /> * [[PhysicsEngines]] &amp;mdash; Options for physics engines in OpenSim.<br /> <br /> ==== Protocols ====<br /> * [[Metaverse Exchange Protocol]] &amp;mdash; MXP is alternative protocol for secondlife protocol.<br /> <br /> ==== Regions ====<br /> * [[OpenSim: Permissions]] &amp;mdash; Notes on object permissions &amp; definition of the ObjectFlags variable.<br /> * [[OpenSim Load Balancing and Region Splitting]] - Instructions for using load balancing and region splitting features.<br /> <br /> ==== Threading ====<br /> * [[OpenSim: Threading strategy]] &amp;mdash; How threading is implemented and handled.<br /> <br /> ==== Scripting ====<br /> * [[Scripting_Documentation]] &amp;mdash; How to use scripts and what limitations apply.<br /> * [[LSL_Status/Functions|LSL Implemented]] &amp;mdash; A list of LSL-functions that are available in OpenSim.<br /> * [[OSSL]] &amp;mdash; Some information about the OpenSimulator Scripting Language, and how to implement an OSSL function<br /> * [[OpenSim.Region.ScriptEngine]] &amp;mdash; How the ScriptEngine looks internally.<br /> <br /> ==== Search ====<br /> * [[OpenSim.Region.DataSnapshot]] - Shiny new data gathering/search system<br /> * [[ImageService]] - Shiny new region module for serving search-related images<br /> <br /> ==== Testing ====<br /> * [[Automated_Testing]] &amp;mdash; Writing Automated tests for OpenSim.<br /> * [[Debugging Unit Tests]] &amp;mdash; Debugging unit tests.<br /> * [[OpenSim: Debugging - profiler dumps]] &amp;mdash; Dumps of OpenSim profiles to aid in tracking memory leaks.<br /> * [[Prim_Linking_Testing]] &amp;mdash; Test cases for in world link/unlinking of prims.<br /> <br /> ==Proposals==<br /> <br /> * [[Opensim: 0.5 Release Target Discussion]]<br /> * [[Opensim: 0.6 Release Target Discussion]]<br /> * [[Opensim: Future Release Discussion]]<br /> <br /> * [[A better SimCrossing]] - A work in progress about implementing a smooth simcrossing<br /> * [[OpenID]] - Proposal for using OpenID in OpenSim<br /> * [[AssetServerProposal]] - Proposal for a distributed asset server<br /> * [[Creating profiles not used for login]] - RFC for alternative ways of creating profiles that will never be used for login<br /> * [[OpenSim_Services_and_Service_Connectors]] - new infrastructure for connecting region simulators to backend services<br /> * [[OpenSim Profile Anchors]] - a mechanism for retaining creator information for offline item transfers<br /> * [[Explicit Object Serialization]] - a proposal to explicitly serialize scene objects rather than using automatic .NET XML serialization<br /> <br /> ==== Proposed projects ====<br /> <br /> * [[OpenWiredux: Taking the next step]]<br /> * [[Using SNMP in OpenSim]]<br /> <br /> ==Communication==<br /> <br /> A good first point of contact is the OpenSim IRC, on irc.freenode.net channels #opensim / #opensim-dev. The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at &quot;Wright Plaza&quot; on OSGrid. There is a &quot;Test Hour&quot; on Saturdays, also generally on &quot;Wright Plaza&quot;. Both these weekly events are held at 1900UTC. Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.<br /> <br /> There is also a mailman email distribution list available at https://lists.berlios.de/mailman/listinfo/opensim-dev<br /> <br /> ==Interest Groups==<br /> * [[OpenSim Quality Focus Group]] - A proposed group for developers interested in improving the quality of OpenSim as we head towards beta status.<br /> <br /> ==SVN Access==<br /> You can browse the source code for OpenSim [http://opensimulator.org/cgi-bin/viewvc.cgi using a web browser] or via SVN.<br /> * Anonymous Checkout - see [[Download]]<br /> * Developer Checkout<br /> svn co svn+ssh://USERNAME@opensimulator.org/var/svn/opensim/trunk<br /> <br /> ==Submitting Patches==<br /> <br /> Please review [[Submitting_code_to_OpenSim]]<br /> <br /> ==Recent Git Commits==<br /> &lt;rss&gt;http://opensimulator.org/viewgit?a=rss-log&amp;amp;p=opensim|max=5|title=none&lt;/rss&gt;<br /> <br /> [[Category:Main]]<br /> [[Category:Support]]<br /> [[Category:Tech Reference]] <br /> [[Category:Help]]<br /> [[Category:Configuration]]<br /> [[Category:Getting_Started]]<br /> [[Category:Development]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Download 2009-08-04T14:20:15Z

<p>SeanDague: /* Release Code via Git */</p> <hr /> <div>{{Template:Quicklinks}}<br /> =Source code=<br /> Here are the current released versions of OpenSim. <br /> <br /> Please see [[Branches]] for more information on the repository branches and what they are for.<br /> <br /> &lt;font color=red&gt;'''Please note:'''&lt;/font&gt; 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.<br /> <br /> Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.<br /> <br /> The latest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.6''' and provided as:<br /> * http://dist.opensimulator.org/opensim-0.6.6-release.tar.gz - best for Linux systems<br /> * http://dist.opensimulator.org/opensim-0.6.6-release.zip - best for Windows systems<br /> <br /> The only difference between the two is the archive format, the source is exactly the same.<br /> <br /> == Release Code via Git ==<br /> <br /> Instead of using a source archive release, you can pull specific releases from our git repository. For more information on installing and using Git, please see [[Using_Git]].<br /> <br /> In each case you'll want to start with a clone:<br /> <br /> git clone git://opensimulator.org/git/opensim opensim-0.6.6<br /> <br /> Then all other commands are run from inside the checked out directory.<br /> <br /> * '''0.6.6 Alpha with post-release fixes''' (preferred)<br /> git checkout origin/0.6.6-post-fixes<br /> <br /> * '''0.6.6 Alpha release tag''' <br /> git checkout 0.6.6-release<br /> <br /> == Release notes ==<br /> <br /> 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.<br /> * [[Recent]] (since last tagged version)<br /> * [[0.6.6-release]] (SVN version 9961)<br /> * [[0.6.5-release]] (SVN version 9667)<br /> * [[0.6.4.1-release]] (SVN version 9009)<br /> * [[0.6.4-release]] (SVN version 8960)<br /> * [[0.6.3-release]] (SVN version 8506)<br /> * [[0.6.2-release]] (SVN version 8068)<br /> * [[0.6.1-release]] (SVN version 7880)<br /> * [[0.6.0-release]] (SVN version 7176)<br /> * [[0.5.11-release]] (SVN version 6676)<br /> * [[0.5.10-release]] (SVN version 6422)<br /> * [[0.5.9-release]] (SVN version 5970)<br /> * [[0.5.8-release]] (SVN version 5111)<br /> * [[0.5.7-release]] (SVN version 4818)<br /> * [[0.5.6-release]] (SVN version 4488)<br /> * [[0.5.5-release]] (SVN version 4239)<br /> * [[0.5.4-release]] (SVN version 3879) (Not sure what happened to 0.5.3 &amp; 0.5.2)<br /> * [[0.5.1-release]] (SVN version 3724)<br /> * [[0.5.0-release]] (SVN version 3184)<br /> * [[0.4.5.3-stable]] (SVN version 2844)<br /> * [[0.4.5.2-stable]] (SVN version 2772)<br /> * [[0.4.5.1-stable]] (SVN version 2610)<br /> * [[0.4.5-release]] (SVN version 2293)<br /> * [[0.4.0-rc]] (SVN version 1953)<br /> * [[0.3.2-release]] (SVN version 1385)<br /> * [[0.3.1-devel]] (SVN version 1226) (Around here things start to get a bit confusing)<br /> * [[0.2.1-release]] (SVN version 1224)<br /> * [[0.3.0-devel]] (SVN version 1126)<br /> * [[0.0.0-release]] (SVN version 1022)<br /> * [[0.1.0-release]] (SVN version 1021)<br /> * [[0.2.0-release]] (SVN version 1020)<br /> <br /> =Binaries=<br /> The OpenSim project only does source based releases, which you must [[Build_Instructions|compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases. Links below are provided for convenience.<br /> <br /> ==Installers==<br /> <br /> * '''0.6.6 Windows Installer (Post-fixes version r9993)'''<br /> http://forge.opensimulator.org/gf/download/frsrelease/199/588/OpenSim0.6.6Setup.exe<br /> <br /> * '''0.6.6 Mac OS X Installer (Post-fixes version r9993)'''<br /> http://forge.opensimulator.org/gf/download/frsrelease/198/587/OpenSimulator-0.6.6-post-fixes-r9993.dmg<br /> <br /> * '''[[UnofficialDebPackages|Unofficial .deb packages]]<br /> <br /> = Older Versions Archive =<br /> <br /> 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.<br /> <br /> The 'official' release tags and branches are all available from:<br /> git://opensimulator.org/git/opensim<br /> <br /> The named branches are typically extremely experimental offshoots. Stick with recent numbered versions if you expect anything to work.<br /> <br /> = Experimental Upstream Code =<br /> &lt;font style=&quot;color: red; font-size: big&quot;&gt;'''There Be Dragons Beyond This Point'''&lt;/font&gt;<br /> <br /> 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.<br /> <br /> If it breaks, you get to keep both pieces.<br /> <br /> * '''Latest git revision version (bleeding edge)'''<br /> git clone git://opensimulator.org/git/opensim<br /> <br /> * '''To checkout a specific revision'''<br /> After creating the clone, chnage into the directory and:<br /> git reset --hard ########<br /> <br /> Where ######## is the unique hash of the version you are interested in.<br /> <br /> 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.<br /> <br /> * '''Latest subversion revision version (bleeding edge)'''<br /> svn co http://opensimulator.org/svn/opensim-track/trunk opensim<br /> <br /> =Related Software=<br /> [[Related_Software|Related Software Section - CLICK HERE]]&lt;br&gt;&lt;br&gt;<br /> <br /> ''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]&lt;br /&gt;<br /> <br /> [[Category:Users]]<br /> [[Category:Developers]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Download 2009-08-04T14:16:18Z

<p>SeanDague: </p> <hr /> <div>{{Template:Quicklinks}}<br /> =Source code=<br /> Here are the current released versions of OpenSim. <br /> <br /> Please see [[Branches]] for more information on the repository branches and what they are for.<br /> <br /> &lt;font color=red&gt;'''Please note:'''&lt;/font&gt; 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.<br /> <br /> Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.<br /> <br /> The latest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.6''' and provided as:<br /> * http://dist.opensimulator.org/opensim-0.6.6-release.tar.gz - best for Linux systems<br /> * http://dist.opensimulator.org/opensim-0.6.6-release.zip - best for Windows systems<br /> <br /> The only difference between the two is the archive format, the source is exactly the same.<br /> <br /> == Release Code via Git ==<br /> <br /> Instead of using a source archive release, you can pull specific releases from our git repository. For more information on installing and using Git, please see [[Using_Git]].<br /> <br /> In each case you'll want to start with a clone:<br /> <br /> git clone git://opensimulator.org/git/opensim opensim-0.6.6<br /> <br /> Then all other commands are run from inside the checked out directory.<br /> <br /> * '''0.6.6 Alpha with post-release fixes''' (preferred)<br /> git checkout 0.6.6-post-fixes<br /> <br /> * '''0.6.6 Alpha release tag''' <br /> git checkout 0.6.6-release<br /> <br /> == Release notes ==<br /> <br /> 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.<br /> * [[Recent]] (since last tagged version)<br /> * [[0.6.6-release]] (SVN version 9961)<br /> * [[0.6.5-release]] (SVN version 9667)<br /> * [[0.6.4.1-release]] (SVN version 9009)<br /> * [[0.6.4-release]] (SVN version 8960)<br /> * [[0.6.3-release]] (SVN version 8506)<br /> * [[0.6.2-release]] (SVN version 8068)<br /> * [[0.6.1-release]] (SVN version 7880)<br /> * [[0.6.0-release]] (SVN version 7176)<br /> * [[0.5.11-release]] (SVN version 6676)<br /> * [[0.5.10-release]] (SVN version 6422)<br /> * [[0.5.9-release]] (SVN version 5970)<br /> * [[0.5.8-release]] (SVN version 5111)<br /> * [[0.5.7-release]] (SVN version 4818)<br /> * [[0.5.6-release]] (SVN version 4488)<br /> * [[0.5.5-release]] (SVN version 4239)<br /> * [[0.5.4-release]] (SVN version 3879) (Not sure what happened to 0.5.3 &amp; 0.5.2)<br /> * [[0.5.1-release]] (SVN version 3724)<br /> * [[0.5.0-release]] (SVN version 3184)<br /> * [[0.4.5.3-stable]] (SVN version 2844)<br /> * [[0.4.5.2-stable]] (SVN version 2772)<br /> * [[0.4.5.1-stable]] (SVN version 2610)<br /> * [[0.4.5-release]] (SVN version 2293)<br /> * [[0.4.0-rc]] (SVN version 1953)<br /> * [[0.3.2-release]] (SVN version 1385)<br /> * [[0.3.1-devel]] (SVN version 1226) (Around here things start to get a bit confusing)<br /> * [[0.2.1-release]] (SVN version 1224)<br /> * [[0.3.0-devel]] (SVN version 1126)<br /> * [[0.0.0-release]] (SVN version 1022)<br /> * [[0.1.0-release]] (SVN version 1021)<br /> * [[0.2.0-release]] (SVN version 1020)<br /> <br /> =Binaries=<br /> The OpenSim project only does source based releases, which you must [[Build_Instructions|compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases. Links below are provided for convenience.<br /> <br /> ==Installers==<br /> <br /> * '''0.6.6 Windows Installer (Post-fixes version r9993)'''<br /> http://forge.opensimulator.org/gf/download/frsrelease/199/588/OpenSim0.6.6Setup.exe<br /> <br /> * '''0.6.6 Mac OS X Installer (Post-fixes version r9993)'''<br /> http://forge.opensimulator.org/gf/download/frsrelease/198/587/OpenSimulator-0.6.6-post-fixes-r9993.dmg<br /> <br /> * '''[[UnofficialDebPackages|Unofficial .deb packages]]<br /> <br /> = Older Versions Archive =<br /> <br /> 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.<br /> <br /> The 'official' release tags and branches are all available from:<br /> git://opensimulator.org/git/opensim<br /> <br /> The named branches are typically extremely experimental offshoots. Stick with recent numbered versions if you expect anything to work.<br /> <br /> = Experimental Upstream Code =<br /> &lt;font style=&quot;color: red; font-size: big&quot;&gt;'''There Be Dragons Beyond This Point'''&lt;/font&gt;<br /> <br /> 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.<br /> <br /> If it breaks, you get to keep both pieces.<br /> <br /> * '''Latest git revision version (bleeding edge)'''<br /> git clone git://opensimulator.org/git/opensim<br /> <br /> * '''To checkout a specific revision'''<br /> After creating the clone, chnage into the directory and:<br /> git reset --hard ########<br /> <br /> Where ######## is the unique hash of the version you are interested in.<br /> <br /> 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.<br /> <br /> * '''Latest subversion revision version (bleeding edge)'''<br /> svn co http://opensimulator.org/svn/opensim-track/trunk opensim<br /> <br /> =Related Software=<br /> [[Related_Software|Related Software Section - CLICK HERE]]&lt;br&gt;&lt;br&gt;<br /> <br /> ''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]&lt;br /&gt;<br /> <br /> [[Category:Users]]<br /> [[Category:Developers]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-08-04T13:00:33Z

<p>SeanDague: /* Git Repositories for OpenSim */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> === CLI ===<br /> :Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> ::* Debian, Ubuntu: &lt;pre&gt;apt-get install git-core&lt;/pre&gt;<br /> ::* Centos: see the instructions at http://www.how-to-linux.com/2009/01/install-git-161-on-centos-52/<br /> <br /> === GUIs ===<br /> :[http://www.kernel.org/pub/software/scm/git/docs/git-gui.html git-gui]<br /> ::* Debian, Ubuntu:<br /> $ sudo apt-get install git-gui<br /> $ git gui<br /> <br /> :[http://cola.tuxfamily.org/ git-cola]<br /> ::* Debian, Ubuntu:<br /> $ apt-get install git-cola<br /> $ git-cola<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {| border=&quot;1&quot;<br /> ! Repository !! Developer URL !! Anon URL <br /> |- <br /> || opensim (main repository) || ssh://opensimulator.org/var/git/opensim || git://opensimulator.org/git/opensim<br /> |}<br /> <br /> == Cloning the Repositry (for Core Developers) ==<br /> <br /> If you are a core developer, use the developer url above. If you aren't a core developer, use the anon url above. The initial clone will take a few minutes, as it is pulling the entire change history. Don't be concerned about space, all the change history stored in git takes up less space than a single checked out copy of opensim. Welcome to the wonderful world of content addressable storage.<br /> <br /> Unlike with svn, you can define multiple sources to pull from. So if you initially start with an anon tree (which is read only), you can still later define the core tree (or some other remote target on github) and push to that.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim. You username and password will be the ones used for opensimulator.org.<br /> <br /> == Cloning the Repositry (for Non Core Developers) ==<br /> <br /> You can use the same approach as above, but '''instead''' of using the ssh:// urls use the '''git://''' urls. This is the equivalent of anonymous svn access.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> Distributed source code control is a substantially different mental model than centralized source code control. If it freaks you out a bit, don't worry, everyone has that same reaction initially. This [http://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/ blog post] is the best explanation that I've seen of the concepts involved.<br /> <br /> For heavy users of subversion you should read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> The biggest real change is the Subversion dictates a very specific workflow. Git does not. Git allows for many different workflows, and lets each developer use the one that is best suited to his/her self.<br /> <br /> = Using Git like Subversion/trunk development =<br /> <br /> This is a set of quick instructions to use git like we do subversion development today. It is targetted for core developers (so assumes you are using the ssh access), though most of it will work for non developers by just changing a url.<br /> <br /> This is done by giving the unix commands. These options should all be available in the context menu on tortoise git as well.<br /> <br /> == Getting the source code ==<br /> <br /> '''git clone ssh://opensimulator.org/git/opensim-test'''<br /> <br /> This is the equivalent of '''svn co'''<br /> <br /> '''Note:''' all other operations assume that you are in the git directory.<br /> <br /> == Updating your checkout ==<br /> <br /> '''git pull'''<br /> <br /> This is the equivalent of '''svn update'''<br /> <br /> == Inspecting what has changed in your working tree ==<br /> <br /> '''git status'''<br /> <br /> This is the equivalent of '''svn status'''<br /> <br /> == Committing a change ==<br /> <br /> either:<br /> <br /> '''git add file1 file2 ...'''<br /> <br /> '''git commit'''<br /> <br /> or <br /> <br /> '''git commit -a'''<br /> <br /> by default git does not add all files during a commit.<br /> <br /> == Pushing the committed change ==<br /> <br /> The first time you do this you'll need to specify which branch to push.<br /> <br /> '''git push origin master'''<br /> <br /> After the first time a simple '''git push''' will be enough, as it defaults to origin, and now git knows that master should by synced to origin.<br /> <br /> '''Important:''' commits in git are local. They are not included in the main tree '''until you push''' them. This means you can create commits when you are not on the network and sync afterwards.<br /> <br /> == Setting the checkout dir to a specific revision ==<br /> <br /> '''git reset --hard #HASHVALUE'''<br /> <br /> This will effectively rewind the tree to the specific revision, and modify the checkout dir accordingly. This is equiv to '''svn up -R#version'''.<br /> <br /> git reset can also be useful if you screwed up commits and want to get rid of them <br /> <br /> == Resetting the tree to master (i.e. trunk) ==<br /> <br /> '''git pull'''<br /> <br /> per previous<br /> <br /> == Creating a Patch ==<br /> <br /> '''git format-patch #HASHVALUE'''<br /> <br /> This will create a patch suitable for attaching or emailing from a single commit. You can also specify a range of commits. <br /> <br /> This is closest to '''svn diff &gt; patchfile.txt''' for uncommitted changes in subversion.<br /> <br /> == Applying a Git Patch ==<br /> <br /> If someone has formatted a git patch you can apply it directly (including all file adds, file mode changes, and their change log entry) with:<br /> <br /> '''git apply patchfile.patch'''<br /> <br /> == Reverting a Change ==<br /> <br /> '''git revert #HASHVALUE'''<br /> <br /> This directly reverts the change, with a commit message stating that fact. There is no svn direct equiv, though this is often accomplished through: svn diff -R revisions &gt; revert.patch &amp;&amp; patch -p0 &lt; revert.patch &amp;&amp; svn ci -m &quot;reverting revisions&quot;<br /> <br /> == Resetting part of the tree to master ==<br /> <br /> '''git checkout -- file1 file2 ...'''<br /> <br /> Checkout is an operation that populates the working directory from the git repository. Doing a git checkout (master is the implied branch) -- file1 file2 repulls those files from the git repo, clobbering them in your local directory. This is like '''svn revert'''.<br /> <br /> == Diffing Changes ==<br /> <br /> Against your most recently committed changes<br /> <br /> '''git diff'''<br /> <br /> From your most recent changes to a past change<br /> <br /> '''git diff #HASHVALUE'''<br /> <br /> Between any 2 changes<br /> <br /> '''git diff #HASHVALUE1 #HASHVALUE1'''</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-08-04T12:56:12Z

<p>SeanDague: /* Git Repositories for OpenSim */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> === CLI ===<br /> :Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> ::* Debian, Ubuntu: &lt;pre&gt;apt-get install git-core&lt;/pre&gt;<br /> ::* Centos: see the instructions at http://www.how-to-linux.com/2009/01/install-git-161-on-centos-52/<br /> <br /> === GUIs ===<br /> :[http://www.kernel.org/pub/software/scm/git/docs/git-gui.html git-gui]<br /> ::* Debian, Ubuntu:<br /> $ sudo apt-get install git-gui<br /> $ git gui<br /> <br /> :[http://cola.tuxfamily.org/ git-cola]<br /> ::* Debian, Ubuntu:<br /> $ apt-get install git-cola<br /> $ git-cola<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {| border=&quot;1&quot;<br /> ! Repository !! Developer URL !! Anon URL <br /> |- <br /> || opensim (main repository) || ssh://opensimulator.org/var/git/opensim || git://opensimulator.org/git/opensim<br /> |}<br /> <br /> == Cloning the Repositry (for Core Developers) ==<br /> <br /> If you are a core developer, use the developer url above. If you aren't a core developer, use the anon url above. The initial clone will take a few minutes, as it is pulling the entire change history. Don't be concerned about space, all the change history stored in git takes up less space than a single checked out copy of opensim. Welcome to the wonderful world of content addressable storage.<br /> <br /> Unlike with svn, you can define multiple sources to pull from. So if you initially start with an anon tree (which is read only), you can still later define the core tree (or some other remote target on github) and push to that.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim. You username and password will be the ones used for opensimulator.org.<br /> <br /> == Cloning the Test Repositry (for Non Core Developers) ==<br /> <br /> You can use the same approach as above, but '''instead''' of using the ssh:// urls use the '''git://''' urls. This is the equivalent of anonymous svn access.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> Distributed source code control is a substantially different mental model than centralized source code control. If it freaks you out a bit, don't worry, everyone has that same reaction initially. This [http://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/ blog post] is the best explanation that I've seen of the concepts involved.<br /> <br /> For heavy users of subversion you should read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> The biggest real change is the Subversion dictates a very specific workflow. Git does not. Git allows for many different workflows, and lets each developer use the one that is best suited to his/her self.<br /> <br /> = Using Git like Subversion/trunk development =<br /> <br /> This is a set of quick instructions to use git like we do subversion development today. It is targetted for core developers (so assumes you are using the ssh access), though most of it will work for non developers by just changing a url.<br /> <br /> This is done by giving the unix commands. These options should all be available in the context menu on tortoise git as well.<br /> <br /> == Getting the source code ==<br /> <br /> '''git clone ssh://opensimulator.org/git/opensim-test'''<br /> <br /> This is the equivalent of '''svn co'''<br /> <br /> '''Note:''' all other operations assume that you are in the git directory.<br /> <br /> == Updating your checkout ==<br /> <br /> '''git pull'''<br /> <br /> This is the equivalent of '''svn update'''<br /> <br /> == Inspecting what has changed in your working tree ==<br /> <br /> '''git status'''<br /> <br /> This is the equivalent of '''svn status'''<br /> <br /> == Committing a change ==<br /> <br /> either:<br /> <br /> '''git add file1 file2 ...'''<br /> <br /> '''git commit'''<br /> <br /> or <br /> <br /> '''git commit -a'''<br /> <br /> by default git does not add all files during a commit.<br /> <br /> == Pushing the committed change ==<br /> <br /> The first time you do this you'll need to specify which branch to push.<br /> <br /> '''git push origin master'''<br /> <br /> After the first time a simple '''git push''' will be enough, as it defaults to origin, and now git knows that master should by synced to origin.<br /> <br /> '''Important:''' commits in git are local. They are not included in the main tree '''until you push''' them. This means you can create commits when you are not on the network and sync afterwards.<br /> <br /> == Setting the checkout dir to a specific revision ==<br /> <br /> '''git reset --hard #HASHVALUE'''<br /> <br /> This will effectively rewind the tree to the specific revision, and modify the checkout dir accordingly. This is equiv to '''svn up -R#version'''.<br /> <br /> git reset can also be useful if you screwed up commits and want to get rid of them <br /> <br /> == Resetting the tree to master (i.e. trunk) ==<br /> <br /> '''git pull'''<br /> <br /> per previous<br /> <br /> == Creating a Patch ==<br /> <br /> '''git format-patch #HASHVALUE'''<br /> <br /> This will create a patch suitable for attaching or emailing from a single commit. You can also specify a range of commits. <br /> <br /> This is closest to '''svn diff &gt; patchfile.txt''' for uncommitted changes in subversion.<br /> <br /> == Applying a Git Patch ==<br /> <br /> If someone has formatted a git patch you can apply it directly (including all file adds, file mode changes, and their change log entry) with:<br /> <br /> '''git apply patchfile.patch'''<br /> <br /> == Reverting a Change ==<br /> <br /> '''git revert #HASHVALUE'''<br /> <br /> This directly reverts the change, with a commit message stating that fact. There is no svn direct equiv, though this is often accomplished through: svn diff -R revisions &gt; revert.patch &amp;&amp; patch -p0 &lt; revert.patch &amp;&amp; svn ci -m &quot;reverting revisions&quot;<br /> <br /> == Resetting part of the tree to master ==<br /> <br /> '''git checkout -- file1 file2 ...'''<br /> <br /> Checkout is an operation that populates the working directory from the git repository. Doing a git checkout (master is the implied branch) -- file1 file2 repulls those files from the git repo, clobbering them in your local directory. This is like '''svn revert'''.<br /> <br /> == Diffing Changes ==<br /> <br /> Against your most recently committed changes<br /> <br /> '''git diff'''<br /> <br /> From your most recent changes to a past change<br /> <br /> '''git diff #HASHVALUE'''<br /> <br /> Between any 2 changes<br /> <br /> '''git diff #HASHVALUE1 #HASHVALUE1'''</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T20:29:30Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {| border=&quot;1&quot;<br /> ! Repository !! Developer URL !! Anon URL <br /> |- <br /> || opensim || n/a this is the svn mirror || git://opensimulator.org/git/opensim<br /> |- <br /> || opensim-test || ssh://opensimulator.org/var/git/opensim-test || git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry (for Core Developers) ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> == Cloning the Test Repositry (for Non Core Developers) ==<br /> <br /> You can use the same approach as above, but '''instead''' of using the ssh:// urls use the '''git://''' urls. This is the equivalent of anonymous svn access.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> Distributed source code control is a substantially different mental model than centralized source code control. If it freaks you out a bit, don't worry, everyone has that same reaction initially. This [http://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/ blog post] is the best explanation that I've seen of the concepts involved.<br /> <br /> For heavy users of subversion you should read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> The biggest real change is the Subversion dictates a very specific workflow. Git does not. Git allows for many different workflows, and lets each developer use the one that is best suited to his/her self.<br /> <br /> = Using Git like Subversion/trunk development =<br /> <br /> This is a set of quick instructions to use git like we do subversion development today. It is targetted for core developers (so assumes you are using the ssh access), though most of it will work for non developers by just changing a url.<br /> <br /> This is done by giving the unix commands. These options should all be available in the context menu on tortoise git as well.<br /> <br /> == Getting the source code ==<br /> <br /> '''git clone ssh://opensimulator.org/git/opensim-test'''<br /> <br /> This is the equivalent of '''svn co'''<br /> <br /> '''Note:''' all other operations assume that you are in the git directory.<br /> <br /> == Updating your checkout ==<br /> <br /> '''git pull'''<br /> <br /> This is the equivalent of '''svn update'''<br /> <br /> == Inspecting what has changed in your working tree ==<br /> <br /> '''git status'''<br /> <br /> This is the equivalent of '''svn status'''<br /> <br /> == Committing a change ==<br /> <br /> either:<br /> <br /> '''git add file1 file2 ...'''<br /> <br /> '''git commit'''<br /> <br /> or <br /> <br /> '''git commit -a'''<br /> <br /> by default git does not add all files during a commit.<br /> <br /> == Pushing the committed change ==<br /> <br /> The first time you do this you'll need to specify which branch to push.<br /> <br /> '''git push origin master'''<br /> <br /> After the first time a simple '''git push''' will be enough, as it defaults to origin, and now git knows that master should by synced to origin.<br /> <br /> '''Important:''' commits in git are local. They are not included in the main tree '''until you push''' them. This means you can create commits when you are not on the network and sync afterwards.<br /> <br /> == Setting the checkout dir to a specific revision ==<br /> <br /> '''git reset --hard #HASHVALUE'''<br /> <br /> This will effectively rewind the tree to the specific revision, and modify the checkout dir accordingly. This is equiv to '''svn up -R#version'''.<br /> <br /> git reset can also be useful if you screwed up commits and want to get rid of them <br /> <br /> == Resetting the tree to master (i.e. trunk) ==<br /> <br /> '''git pull'''<br /> <br /> per previous<br /> <br /> == Creating a Patch ==<br /> <br /> '''git format-patch #HASHVALUE'''<br /> <br /> This will create a patch suitable for attaching or emailing from a single commit. You can also specify a range of commits. <br /> <br /> This is closest to '''svn diff &gt; patchfile.txt''' for uncommitted changes in subversion.<br /> <br /> == Applying a Git Patch ==<br /> <br /> If someone has formatted a git patch you can apply it directly (including all file adds, file mode changes, and their change log entry) with:<br /> <br /> '''git apply patchfile.patch'''<br /> <br /> == Reverting a Change ==<br /> <br /> '''git revert #HASHVALUE'''<br /> <br /> This directly reverts the change, with a commit message stating that fact. There is no svn direct equiv, though this is often accomplished through: svn diff -R revisions &gt; revert.patch &amp;&amp; patch -p0 &lt; revert.patch &amp;&amp; svn ci -m &quot;reverting revisions&quot;<br /> <br /> == Resetting part of the tree to master ==<br /> <br /> '''git checkout -- file1 file2 ...'''<br /> <br /> Checkout is an operation that populates the working directory from the git repository. Doing a git checkout (master is the implied branch) -- file1 file2 repulls those files from the git repo, clobbering them in your local directory. This is like '''svn revert'''.<br /> <br /> == Diffing Changes ==<br /> <br /> Against your most recently committed changes<br /> <br /> '''git diff'''<br /> <br /> From your most recent changes to a past change<br /> <br /> '''git diff #HASHVALUE'''<br /> <br /> Between any 2 changes<br /> <br /> '''git diff #HASHVALUE1 #HASHVALUE1'''</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T20:21:18Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {| border=&quot;1&quot;<br /> ! Repository !! Developer URL !! Anon URL <br /> |- <br /> || opensim || n/a this is the svn mirror || git://opensimulator.org/git/opensim<br /> |- <br /> || opensim-test || ssh://opensimulator.org/var/git/opensim-test || git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry (for Core Developers) ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> == Cloning the Test Repositry (for Non Core Developers) ==<br /> <br /> You can use the same approach as above, but '''instead''' of using the ssh:// urls use the '''git://''' urls. This is the equivalent of anonymous svn access.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> Distributed source code control is a substantially different mental model than centralized source code control. If it freaks you out a bit, don't worry, everyone has that same reaction initially. This [http://betterexplained.com/articles/intro-to-distributed-version-control-illustrated/ blog post] is the best explanation that I've seen of the concepts involved.<br /> <br /> For heavy users of subversion you should read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> The biggest real change is the Subversion dictates a very specific workflow. Git does not. Git allows for many different workflows, and lets each developer use the one that is best suited to his/her self.<br /> <br /> = Using Git like Subversion/trunk development =<br /> <br /> This is a set of quick instructions to use git like we do subversion development today. It is targetted for core developers (so assumes you are using the ssh access), though most of it will work for non developers by just changing a url.<br /> <br /> This is done by giving the unix commands. These options should all be available in the context menu on tortoise git as well.<br /> <br /> == Getting the source code ==<br /> <br /> '''git clone ssh://opensimulator.org/git/opensim-test'''<br /> <br /> This is the equivalent of '''svn co'''<br /> <br /> '''Note:''' all other operations assume that you are in the git directory.<br /> <br /> == Updating your checkout ==<br /> <br /> '''git pull'''<br /> <br /> This is the equivalent of '''svn update'''<br /> <br /> == Inspecting what has changed in your working tree ==<br /> <br /> '''git status'''<br /> <br /> This is the equivalent of '''svn status'''<br /> <br /> == Committing a change ==<br /> <br /> either:<br /> <br /> '''git add file1 file2 ...'''<br /> <br /> '''git commit'''<br /> <br /> or <br /> <br /> '''git commit -a'''<br /> <br /> by default git does not add all files during a commit.<br /> <br /> == Pushing the committed change ==<br /> <br /> The first time you do this you'll need to specify which branch to push.<br /> <br /> '''git push origin master'''<br /> <br /> After the first time a simple '''git push''' will be enough, as it defaults to origin, and now git knows that master should by synced to origin.<br /> <br /> '''Important:''' commits in git are local. They are not included in the main tree '''until you push''' them. This means you can create commits when you are not on the network and sync afterwards.<br /> <br /> == Setting the checkout dir to a specific revision ==<br /> <br /> '''git reset --hard #HASHVALUE'''<br /> <br /> This will effectively rewind the tree to the specific revision, and modify the checkout dir accordingly. This is equiv to '''svn up -R#version'''.<br /> <br /> git reset can also be useful if you screwed up commits and want to get rid of them <br /> <br /> == Resetting the tree to master (i.e. trunk) ==<br /> <br /> '''git pull'''<br /> <br /> per previous<br /> <br /> == Creating a Patch ==<br /> <br /> '''git format-patch #HASHVALUE'''<br /> <br /> This will create a patch suitable for attaching or emailing from a single commit. You can also specify a range of commits. <br /> <br /> This is closest to '''svn diff &gt; patchfile.txt''' for uncommitted changes in subversion.<br /> <br /> == Reverting a Change ==<br /> <br /> '''git revert #HASHVALUE'''<br /> <br /> This directly reverts the change, with a commit message stating that fact. There is no svn direct equiv, though this is often accomplished through: svn diff -R revisions &gt; revert.patch &amp;&amp; patch -p0 &lt; revert.patch &amp;&amp; svn ci -m &quot;reverting revisions&quot;<br /> <br /> == Resetting part of the tree to master ==<br /> <br /> '''git checkout -- file1 file2 ...'''<br /> <br /> Checkout is an operation that populates the working directory from the git repository. Doing a git checkout (master is the implied branch) -- file1 file2 repulls those files from the git repo, clobbering them in your local directory.</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:53:00Z

<p>SeanDague: /* Git Repositories for OpenSim */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {| border=&quot;1&quot;<br /> ! Repository !! Developer URL !! Anon URL <br /> |- <br /> || opensim || n/a this is the svn mirror || git://opensimulator.org/git/opensim<br /> |- <br /> || opensim-test || ssh://opensimulator.org/var/git/opensim-test || git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:51:56Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {|<br /> !Repository !Developer URL !Anon URL <br /> |- <br /> |opensim |n/a this is the svn mirror |git://opensimulator.org/git/opensim<br /> |- <br /> |opensim-test |ssh://opensimulator.org/var/git/opensim-test |git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:49:54Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {|<br /> ! Repository ! Developer URL ! Anon URL <br /> |- opensim | n/a this is the svn mirror | git://opensimulator.org/git/opensim<br /> |- opensim-test | ssh://opensimulator.org/var/git/opensim-test | git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:49:15Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {|<br /> !- Repository ! Developer URL ! Anon URL <br /> |- opensim | n/a this is the svn mirror | git://opensimulator.org/git/opensim<br /> |- opensim-test | ssh://opensimulator.org/var/git/opensim-test | git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:48:39Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> {|<br /> |- ! Repository ! Developer URL ! Anon URL <br /> |- | opensim | n/a this is the svn mirror | git://opensimulator.org/git/opensim<br /> |- | opensim-test | ssh://opensimulator.org/var/git/opensim-test | git://opensimulator.org/git/opensim-test<br /> |}<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-15T19:45:12Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose <br /> '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = Git Repositories for OpenSim =<br /> <br /> Current there are 2 git repositories on the system:<br /> * an opensim-test repository, which allows for experimentation with git (this is not kept up to date with the latest svn trunk)<br /> * an opensim git mirror of the svn trunk (this does now allow checkins, it is a direct mirror of the svn trunk)<br /> <br /> The urls for the repositories are as follows:<br /> <br /> == Cloning the Test Repositry ==<br /> <br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> === Linux ===<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> === Windows ===<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T13:32:53Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Conceptual Changes from Subversion = <br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes. That being said there are some conceptual changes to note.<br /> <br /> * Terminology<br /> ** master is the name of the primary upstream branch (in subversion terms, this is trunk)<br /> ** origin is the name and location of the tree you cloned from<br /> * All repositories are full peers to all other repositories. Your cloned git repo is all the history of the entire project, available locally. It means you can sync between any 2 clones of the repository, not just between your clone and the master repo. This lets people work together on changes not in <br /> * Version numbers are SHA1 hashes, not sequential integers. This means referring to specific revisions is a bit more interesting. For most of the git commands, you only need to give it the first 6-8 digits of the hash for them to work.<br /> * Committing <br /> ** commits are local. This means they are fast (no network involved) and they are committed against the last state of the tree. Any conflict resolution will be handled after commits, during your next pull. This is slightly different than pull-resolve-then-commit model of subversion.<br /> ** by default only files you explicitly '''git add''' are put into the commit. To get '''svn ci''' equivalency use '''git commit -a''' to commit all outstanding files (I think tortoise handles this for you)<br /> ** after making a commit you must then '''push''' it to a remote repository (probably origin). By default you push only branches you have previously pushed, typically master.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/File:Config2.png 2009-07-14T13:16:46Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/File:Config1.png 2009-07-14T13:16:27Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T13:16:04Z

<p>SeanDague: /* Configuring Git */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> [[Image:config1.png]] [[Image:Config2.png]]<br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =<br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes.</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T13:07:35Z

<p>SeanDague: /* Configuring Git */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> On Windows this done with the config menu.<br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =<br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes.</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T13:03:43Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = Configuring Git =<br /> <br /> Git has both a global config and a local config for each repo. As one might expect, local trumps global. The first important thing to do is set your name and email address, as that will be used in your commits.<br /> <br /> On Linux this is done via:<br /> <br /> git config user.email YOUR@EMAIL.ADDR <br /> git config user.name &quot;Your Name&quot;<br /> <br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =<br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes.</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T12:59:10Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]] [[Image:msysgit2.png]] [[Image:msysgit3.png]] [[Image:msysgit4.png]] [[Image:msysgit5.png]]<br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =<br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes.</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-14T12:03:18Z

<p>SeanDague: /* Subversion Like Workflow */</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]]<br /> <br /> [[Image:msysgit2.png]]<br /> <br /> [[Image:msysgit3.png]]<br /> <br /> [[Image:msysgit4.png]]<br /> <br /> [[Image:msysgit5.png]]<br /> <br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =<br /> <br /> The first thing you should do is read the [http://git.or.cz/course/svn.html git / svn cheat sheet]. This provides a very solid basis for making your changes.</div>

SeanDague http://opensimulator.org/wiki/File:Msysgit5.png 2009-07-13T21:21:39Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/File:Msysgit4.png 2009-07-13T21:21:16Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/File:Msysgit3.png 2009-07-13T21:20:46Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/File:Msysgit2.png 2009-07-13T21:20:26Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/File:Msysgit1.png 2009-07-13T21:19:58Z

<p>SeanDague: </p> <hr /> <div></div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-13T21:19:25Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> [[Image:msysgit1.png]]<br /> <br /> [[Image:msysgit2.png]]<br /> <br /> [[Image:msysgit3.png]]<br /> <br /> [[Image:msysgit4.png]]<br /> <br /> [[Image:msysgit5.png]]<br /> <br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-13T17:32:30Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> = The OpenSim Test Repository =<br /> There is a test repository on opensimulator.org in /var/git/opensim-test. This is a point in time capture of the opensim trunk (and all changes prior). It is designed for messing around with to get comfortable with git. Don't worry about breaking this repository.<br /> <br /> The initial clone will take a few minutes, as the git repository contains the entire history of the project.<br /> <br /> == Linux ==<br /> Run the following on the command line:<br /> <br /> git clone ssh://opensimulator.org/var/git/opensim-test<br /> <br /> This will create an opensim-test directory locally<br /> <br /> == Windows ==<br /> <br /> Right click on the Desktop (or wherever) and 'Git Clone...' <br /> <br /> When prompted for a url provide ssh://opensimulator.org/var/git/opensim-test. You username and password will be the ones used for opensimulator.org.<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-13T17:28:09Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> Git is provided as a package with all modern Linux distributions. Install the following packages depending on environment:<br /> * Debian, Ubuntu: git-core<br /> <br /> == Windows ==<br /> <br /> On Windows you need to install 2 packages:<br /> * msysgit - the basic git port for windows. Install this first.<br /> * [http://code.google.com/p/tortoisegit/ Tortoise Git] - the git explorer. Install this second.<br /> <br /> When '''installing msysgit''' be sure to choose '''Unix style line endings'''. This will make it so that all the line endings are managed correctly, which will prevent merge issues in the future.<br /> <br /> = The OpenSim Test Repository =<br /> <br /> == Linux ==<br /> <br /> == Windows ==<br /> <br /> = Subversion Like Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-13T15:36:54Z

<p>SeanDague: </p> <hr /> <div>This is an introduction to using git for OpenSim core developers.<br /> <br /> = Installing Git =<br /> <br /> == Linux ==<br /> <br /> == Windows ==<br /> <br /> = The OpenSim Test Repository =<br /> <br /> == Linux ==<br /> <br /> == Windows ==<br /> <br /> = Standard Workflow =</div>

SeanDague http://opensimulator.org/wiki/Using_Git 2009-07-13T15:35:11Z

<p>SeanDague: New page: This is an introduction to using git for OpenSim core developers.</p> <hr /> <div>This is an introduction to using git for OpenSim core developers.</div>

SeanDague http://opensimulator.org/wiki/Build_Instructions 2009-04-05T16:42:39Z

<p>SeanDague: </p> <hr /> <div>[[Category:Users]]<br /> This page covers building OpenSim from source code on multiple platforms. Please help us keep this page up to date as the project progresses.<br /> <br /> ==Download OpenSim ==<br /> Check out the [[Download]] page for instructions on obtaining an OpenSim source release.<br /> <br /> ==MS Windows==<br /> <br /> OpenSim requires either the .Net framework version 2.0, or the latest Mono. It supports the following compilers:<br /> * [http://msdn2.microsoft.com/en-us/express/aa700756.aspx Microsoft Visual C# Express Edition] (note: not Visual C++)<br /> * [http://www.mono-project.com/ mono]<br /> <br /> Additional note: any Microsoft C# Express edition should work (2005 or 2008)<br /> <br /> Additional note: It is possible to develop on Windows Vista 64 bits with the following tweaks:<br /> # Select OpenSim project properties from solution and choose platform to be x86. Rebuild solution.<br /> # Select OpenSim.exe properties under solution bin folder and choose windows xp sp 2 compatibility mode + run as administrator.<br /> <br /> === Building ===<br /> <br /> * In the top-level directory, run the '&lt;tt&gt;runprebuild.bat&lt;/tt&gt;' file. This will create a VS2005 solution file, a nant build file and a '&lt;tt&gt;compile.bat&lt;/tt&gt;' file.<br /> * If you prefer VS2008, run the '&lt;tt&gt;runprebuild2008.bat&lt;/tt&gt;' instead.<br /> <br /> * Open the resulting sln file with visual studio and build it there, or<br /> * Run the '&lt;tt&gt;compile.bat&lt;/tt&gt;' file. This will build the executable using MSBuild.<br /> * if you prefer to use nant, run nant in the same top-level directory. This will build the executables.<br /> <br /> If you don't care about physics (walking on prims, etc), ignore the rest of this section.<br /> <br /> === Running ===<br /> <br /> Recent versions of OpenSim come without an &lt;tt&gt;OpenSim.ini&lt;/tt&gt; file. Copy the &lt;tt&gt;OpenSim.ini.example&lt;/tt&gt; file to &lt;tt&gt;OpenSim.ini&lt;/tt&gt; before making any changes.<br /> <br /> Double-click on the &lt;tt&gt;OpenSim.exe&lt;/tt&gt; executable file in the &lt;tt&gt;bin&lt;/tt&gt; directory. This will start up OpenSim in standalone mode.<br /> <br /> The debugger in VS2005 C# may be used to step through the code. For those that use a Cygwin shell, you may find that one or more dll's have permissions that cause problems running. Most find that a &quot;&lt;tt&gt;chmod 777 *&lt;/tt&gt;&quot; from the &lt;tt&gt;bin&lt;/tt&gt; directory solves this.<br /> <br /> Physics can be invoked by adding the appropriate line to the [Startup] section of &lt;tt&gt;OpenSim.ini&lt;/tt&gt;. For ODE, that would be:<br /> <br /> physics = OpenDynamicsEngine<br /> <br /> You can also add a command line option to a shortcut, or run from a command prompt with:<br /> <br /> -physics=OpenDynamicsEngine<br /> <br /> '''''Windows Vista'''''<br /> <br /> Some people have reported that to run on Windows Vista, you must first disable Windows Firewall. Under the new &quot;Start&quot; button of Vista, select &quot;Control panel&quot;. Then double-click &quot;Windows Firewall&quot;. In the window that pops up, on the left column, select &quot;Turn Windows Firewall on or off&quot;. You will have to give permission for this to run, then select the option &quot;Off (not recommended)&quot;. Click &quot;OK&quot; and exit from the Windows Firewall window.<br /> <br /> If you have McAfee SecurityCenter, see the description below.<br /> <br /> Once all the security features are disabled, right click on &lt;tt&gt;OpenSim.exe&lt;/tt&gt; and select &quot;Run as administrator&quot;. This will pop up a window asking permission, select &quot;Allow&quot;. Your OpenSim server should run in a DOS-like window and accept connections.<br /> <br /> <br /> '''''McAfee Security'''''<br /> <br /> McAfee Security does not allow applications to listen on ports not explicitly specified. You have two options: 1) disable firewall protection all together, 2) enable &lt;tt&gt;OpenSim.exe&lt;/tt&gt; to be able to open ports.<br /> <br /> ''Disable firewall''<br /> <br /> Open McAfee SecurityCenter. Select &quot;Internet &amp; Network&quot;. In the lower left corner is a small link to &quot;Configure...&quot;. Select this. In the right side of the window, select the bar that says &quot;Firewall protection is enabled&quot;. Here you can select &quot;Off&quot;.<br /> <br /> ''Enable &lt;tt&gt;OpenSim.exe&lt;/tt&gt; to open ports''<br /> <br /> Open McAfee SecurityCenter. Select &quot;Internet &amp; Network&quot;. In the lower left corner is a small link to &quot;Configure...&quot;. Select this. In the right side of the window, select the bar that says &quot;Firewall protection is enabled&quot;. Select the &quot;Advanced...&quot; button. This will pop up a new window.<br /> <br /> In the new window, on the left side, select &quot;Program Permissions.&quot; In the middle on the right side of the window, select the &quot;Add Allowed Program&quot; button. Use the browser that pops up to find the OpenSim executable and select it.<br /> <br /> Finally, select &quot;OK&quot; and exit the McAfee SecurityCenter window.<br /> <br /> ==Linux/Mac OS X/FreeBSD==<br /> <br /> The easiest plaform to get running on the Linux side is Ubuntu 8.10, 32bit. This is what most of the developers running Linux use. If you are looking for the quick path, start there.<br /> <br /> === Ubuntu 8.04 / 8.10 ===<br /> <br /> For Ubuntu users on older distributions (7.10, 8.04, etc.) '''you need''' to upgrade your mono to at least 1.9.1. Mono 2.2 is currently the preferred version to run OpenSim with.<br /> <br /> You can use the built in packages for mono. However, for better performance, you may want to [http://xyzzyxyzzy.net/2008/05/08/updated-mono-build-script-for-hardy-heron-and-mono-191/ upgrade mono to 1.9.1] ([http://tempvariable.blogspot.com/2008/04/installing-mono-191-on-ubuntu-804-hardy.html Other simple method])<br /> <br /> sudo apt-get install subversion nant mono-gmcs libmono-microsoft8.0-cil \<br /> libmono-system-runtime2.0-cil libgdiplus libmono-i18n2.0-cil libmono-oracle2.0-cil ruby<br /> [[Download]] opensim<br /> cd opensim<br /> ./runprebuild.sh<br /> nant<br /> <br /> To upgrade the Mono version to the latest stable build Mono 2.0.1, read this page [[Build Instructions/Ubuntu-Mono-2.0.1 | Ubuntu on Mono 2.0.1]]<br /> <br /> === openSUSE 10.3/11/11.1 ===<br /> <br /> Install an openSUSE 11.1, 11 or 10.3 with its default options, add the online repositories<br /> when finished installing do an online update with all the latest packages.<br /> <br /> In yast install these packages, for running Opensim in standalone mode.<br /> (there is a slight diffrence between 10.3 and 11/11.1 but following should be same)<br /> subversion<br /> nant<br /> mono-jscript<br /> - check that mono-core is installed<br /> <br /> A tip for OpenSuSE 11.1 users - you can install packages from the command line using the 'zypper' tool. For example, to install 'nant', use this command:<br /> <br /> sudo zypper install nant<br /> <br /> If you just want to use SQLite then jump to last section <br /> within this post.<br /> <br /> * Optional mysql - for Opensim running in Grid mode:<br /> Install these mysql packages via yast<br /> mysql<br /> mysql-client<br /> mysql-administrator<br /> mysql-gui-tools<br /> mysql-query-browser<br /> <br /> (note that selecting mysql in the Yast2 Installer will select the other packages automatically)<br /> <br /> Before building create the mysql database.<br /> /etc/init.d/mysql start<br /> mysql -u root -p -h localhost<br /> (when asked for password just hit enter)<br /> <br /> mysql&gt; create database opensim;<br /> mysql&gt; use opensim;<br /> mysql&gt; create user 'opensim'@'localhost' identified by 'thePassword';<br /> mysql&gt; grant all on *.* to 'opensim'@'localhost';<br /> mysql&gt; quit<br /> <br /> *note that the '''grant all''' command may differ if you're adding the opensim database to an existing mysql installation.<br /> <br /> On current builds set the connection string inside bin/OpenSim.ini after coppying the OpenSim.ini.example file.<br /> If you are changing to MySQL from SQLite, the connection string for mysql also exists in the bin/Region/*xml files.<br /> * It is '''important''' to remember this if you start out using the built-in SQLite database engine.<br /> <br /> Build after installation of above in bash terminal. I save it in /opt<br /> <br /> su -<br /> cd /opt<br /> [[Download]] opensim<br /> cd opensim<br /> ./runprebuild.sh<br /> nant<br /> <br /> Or, if you have a current (0.6+), you can simply execute:<br /> <br /> make<br /> <br /> After this you should be able to continue on starting the diffrent Servers, look in the mysql-config section,or<br /> just run your OpenSim as a Standalone. By - eagleFX<br /> <br /> === Mac OS X 10.5/10.4 ===<br /> * OpenSim is now working on PowerPC Macs! Thanks to DrScofield and those who helped him. Current nightly builds for PowerPC are not working, not sure about Intel so use the 0.5 Build. OpenSim works on Intel Macs. I'm testing on PowerBook G4. Tested these step on 10.5, but not 10.4 but should work --[[User:Mokele|Mokele]] 22:36, 14 February 2008 (PST) (Works on iMac G5 with OS 10.4.11, including expanding to local grid mode. --[[User:Magnuz|Magnuz]] 2008-12-15 10:50 (CET))<br /> * Install XCode Developers Tools from DVD/CD Installation Disk or download from http://developer.apple.com/. You have to create an Apple account to access the downloads if you don't have an Apple account.<br /> * Install X11 for 10.4 from the Optional Install from the DVD/CD Installation Disk. X11 for 10.5 is installed by default.<br /> * Install Mono 1.2.5 from http://ftp.novell.com/pub/mono/archive/1.2.5/macos-10-universal/5/MonoFramework-1.2.5_5.macos10.novell.universal.dmg (The more recent releases Mono 1.2.6, 1.9.1 and 2.0.1 do not appear to work with these installation instructions. --[[User:Magnuz|Magnuz]] 2008-12-14 15:56 (CET)) and in Terminal or X11 edit the .profile file and add the following line:<br /> export PKG_CONFIG_PATH=&quot;/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig/:${PKG_CONFIG_PATH}&quot;<br /> * Compile OpenSim<br /> svn co http://opensimulator.org/svn/opensim/tags/0.5.0-release opensim<br /> cd opensim <br /> ./runprebuild.sh<br /> nant<br /> <br /> * Download and Compile libopenjpeg-libsl-2.1.2.0.dylib and libsecondlife.dll<br /> * libopenjpeg-libsl-2.1.2.0.dylib:<br /> svn co http://opensimulator.org/svn/opensim-libs/old/libsl1550 opensim-libs<br /> cd opensim-libs/openjpeg-libsl<br /> make -f Makefile.osx<br /> cp libopenjpeg-libsl-2.1.2.0.dylib ../../bin<br /> * Note: The Makefile that creates the libopenjpeg-libsl-2.1.2.0.so does not compile on PowerPC, but works properly on Intel Macs. Looks like a gcc issue with compile options. (It appears to work on iMac G5 with OS X 10.4.11. --[[User:Magnuz|Magnuz]] 2008-12-14 15:55 (CET))<br /> <br /> * libsecondlife.dll: (for PowerPC Only, see details on this step [http://xyzzyxyzzy.net/2008/02/12/installing-opensim-on-powerpcor-of-eggs-and-virtual-worlds installing OpenSim on PowerPC…or: of eggs and virtual worlds])<br /> cd .. (back into opensim-libs)<br /> nant<br /> cp bin/libsecondlife.dll ../bin<br /> <br /> * Edit the libsecondlife.dll.config (PowerPC Only). Remove the cpu=&quot;x86&quot; tag in the last dllmap line.<br /> <br /> === FreeBSD 6.2 ===<br /> su<br /> cd /usr/ports/devel/subversion/ &amp;&amp; make install clean (you may also need to rebuild apr-svn if this step fails)<br /> cd /usr/ports/lang/mono/ &amp;&amp; make install clean<br /> cd /usr/ports/devel/nant/ &amp;&amp; make install clean<br /> cd /usr/ports/databases/sqlite3/ &amp;&amp; make install clean<br /> cd /usr/ports/x11-toolkits/libgdiplus/ &amp;&amp; make install clean<br /> cd /opensim/installation/directory/<br /> [[Download]] opensim<br /> cd opensim<br /> ./runprebuild.sh<br /> nant<br /> <br /> Note: [http://opensimulator.org/wiki/OpenSim:FAQ#System.DllNotFoundException:_..2Flibopenjpeg-libsl-2.1.2.0.so|Follow the instructions on the FAQ to fix the]<br /> &quot;System.DllNotFoundException: ./libopenjpeg-libsl-2.1.2.0.so&quot; issue, but use &quot;gmake&quot; instead of &quot;make&quot;<br /> <br /> For ODE Physics you must do the following:<br /> cd /usr/ports/graphics/libGL/ &amp;&amp; make install clean<br /> cd /usr/ports/graphics/libGLU/ &amp;&amp; make install clean<br /> cd /opensim/installation/directory/<br /> svn co http://opensimulator.org/svn/opensim-libs/trunk opensim-libs<br /> cd opensim-libs/unmanaged/OpenDynamicsEngine2/<br /> sh autogen.sh<br /> ./configure --enable-shared --enable-release --disable-demos<br /> make<br /> mv ./ode/src/.libs/libode.so /opensim/installation/directory/opensim/bin/<br /> <br /> === RedHat Enterprise Linux 4 ===<br /> sudo vi /etc/yum.repos.d/mono.repo<br /> <br /> [mono]<br /> name=Mono for rhel-4-i386 (stable)<br /> baseurl=http://ftp.novell.com/pub/mono/download-stable/rhel-4-i386/<br /> enabled=1<br /> gpgcheck=0<br /> <br /> sudo yum install mono-complete monodoc-core nant<br /> [[Download]] opensim<br /> cd opensim<br /> ./runprebuild.sh<br /> nant<br /> <br /> === RedHat Enterprise Linux 5 ===<br /> <br /> The instructions below also work on other RedHat Linux flavors such as CentOS or maybe Fedora.<br /> <br /> 1. Put the [http://download.opensuse.org/repositories/Mono/RHEL_5/Mono.repo Mono.repo] file in the /etc/yum.repo.d/ directory:<br /> $ sudo su -<br /> $ cd /etc/yum.repos.d/<br /> $ wget http://download.opensuse.org/repositories/Mono/RHEL_5/Mono.repo<br /> Naturally use the most [http://download.opensuse.org/repositories/Mono up-to-date link for your distribution].<br /> <br /> 2. Install Mono and related tools with yum:<br /> $ yum install mono nant mono-jscript mono-nunit<br /> Make sure to use nunit-console2 to run your tests.<br /> <br /> === Fedora 5 ===<br /> * I needed to build latest mono and nant from sources to build OpenSim successfully, the ones available in yum repository didn't work so I had to uninstall and build and configure the packages.<br /> <br /> For detailed instructions go [http://ruakuu.blogspot.com/2008/06/installing-and-configuring-opensim-on.html here]<br /> <br /> === Debian 4 ===<br /> <br /> For detailed instructions please see [[Debian 4 Build Instructions]]<br /> <br /> === CentOS 5.2 32bit ===<br /> <br /> For detailed instructions please see [[CentOS 5.2 Build Instructions]]<br /> <br /> === 64bit ===<br /> Please note that only 32bit binaries are provided in the bin/ directory of subversion. If you want to use 64bit, you'll need to rebuild these shared objects. See [[Installing and running on x86-64]]<br /> <br /> <br /> === Physics (Open Dynamics Engine ODE) ===<br /> As installed from svn, ODE will work on most 32 bit platforms. If you get an ODE-related crash, and/or a &lt;i&gt;libode.so not found&lt;/i&gt; type of error, you will need to build libode from source.<br /> <br /> Remove &lt;tt&gt;libode.so&lt;/tt&gt; from the &lt;tt&gt;./bin&lt;/tt&gt; folder. (Note that subsequent svn updates may replace it again; best fix is to copy your built &lt;tt&gt;libode.so&lt;/tt&gt; to &lt;tt&gt;bin&lt;/tt&gt;). Do NOT remove &lt;tt&gt;ode.net.dll&lt;/tt&gt;! Download the latest source from:<br /> <br /> svn co http://opensimulator.org/svn/opensim-libs/trunk/unmanaged/OpenDynamicsEngine<br /> <br /> OpenSim requires a couple of patches on top of ODE which are not yet included upstream. When compiling, make sure to use the following configure options:<br /> <br /> --with-trimesh=gimpact <br /> --enable-shared<br /> <br /> Make sure the configure script confirms these choices, and always compile with single precision (I believe that's the default). Try &lt;code&gt; make -k &lt;/code&gt; if you get errors relating to drawstuff, test*, or openGL. &lt;code&gt; make install &lt;/code&gt; should put &lt;tt&gt;libode.so&lt;/tt&gt; in the proper place (usually &lt;tt&gt;/usr/local/lib&lt;/tt&gt;), and it should be seen by opensim (&lt;tt&gt;ode.net.dll&lt;/tt&gt;)<br /> <br /> '''''Note:''' if OpenSim fails to launch with &lt;tt&gt;Exception: System.DllNotFoundException: ode&lt;/tt&gt;, after compiling ODE, just copy &lt;tt&gt;libode.so&lt;/tt&gt; from its usual place (probably &lt;tt&gt;/usr/local/lib/&lt;/tt&gt;) to ./bin/, as per [http://metafuturing.net/index.php/OpenSim_Notebook_1 this suggestion]''<br /> <br /> Setting up ODE for 64 Bits systems:<br /> <br /> ========================================================================<br /> HOWTO on setting up and Install OpenSim on SLES10 - SP1 64Bit<br /> <br /> 1. I installed Mono 2.01, added this installation source in Yast2<br /> This distro supports installing packages via YaST. Add the following installation source to YaST:<br /> * http://ftp.novell.com/pub/mono/download-stable/SLE_10 [^]<br /> For assistance with using repositories and installing packages with YaST, visit the Yast help page.<br /> <br /> &quot;nant&quot; was installed also via this operation.<br /> <br /> 2. I installed subversion from http://software.opensuse.org/search [^]<br /> <br /> SLES/SLED10 -&gt;<br /> subversion-1.5.2-34.2.x86_64.rpm<br /> <br /> 3. I downloaded and installed the lastest SVN version of opensim as usual (like a 32 bit system):<br /> http://opensimulator.org/wiki/Build_Instructions [^]<br /> <br /> 4. I downloaded and installed the Open Dynamics Engine (ODE) to replace the 32 bit version of ODE with a 64 bit version.<br /> <br /> I did that with the following linux commands:<br /> (it is expected that you have all required Linux building tools installed):<br /> <br /> # cd<br /> # svn co http://opensimulator.org/svn/opensim-libs/trunk/unmanaged/OpenDynamicsEngine [^]<br /> # cd OpenDynamicEngine<br /> # chmod a+x ou/bootstrap<br /> # sh autogen.sh<br /> <br /> I installed/updated SLES10 with these rpm's for autogen.sh to run properly. http://software.opensuse.org/search [^]<br /> <br /> SLES/SLED10 -&gt;<br /> - autoconf-2.61-168.1.x86_64.rpm<br /> - automake-1.10.1-5.3.x86_64.rpm<br /> <br /> # CFLAGS=&quot;-m64&quot; ./configure --enable-shared<br /> # make<br /> <br /> I installed gtk2-devel via yast2, and all its dependancies, because make keept failing.<br /> <br /> # cp ./ode/src/.libs/libode.so /opt/opensim/bin/<br /> <br /> note:<br /> in this directory it had made several versions of the &quot;libode.so&quot; because of running the previous commands several times<br /> so i had to copy libode.so.1.0.0 to /opt/opensim/bin/libode.so<br /> <br /> # vi ../opensim/bin/OpenSim.ini (change av_capsule_standup_tensor_linux to 1700000)<br /> <br /> <br /> The 'chmod' command is required to fix permissions that are wrong.<br /> The change in OpenSim.ini is required to avoid that avatars have bend legs and/or their feet are in the ground.<br /> ========================================================================<br /> <br /> ===Running===<br /> Recent versions of OpenSim come without an &lt;tt&gt;OpenSim.ini&lt;/tt&gt; file. Copy the &lt;tt&gt;OpenSim.ini.example&lt;/tt&gt; file to &lt;tt&gt;OpenSim.ini&lt;/tt&gt; before making any changes.<br /> &lt;code&gt;<br /> cd bin<br /> mono OpenSim.exe<br /> &lt;/code&gt;<br /> <br /> Note: if you are running a 32bit Server such as Ubuntu 8.0.4 you need the alternative launcher:<br /> <br /> &lt;code&gt;<br /> mono OpenSim.32BitLaunch.exe<br /> &lt;/code&gt;<br /> <br /> <br /> <br /> * To invoke ODE, add the option:<br /> -physics=OpenDynamicsEngine<br /> to the &lt;tt&gt;mono OpenSim.exe&lt;/tt&gt; line<br /> <br /> or add &lt;code&gt; physics = OpenDynamicsEngine &lt;/code&gt; to the [Startup] section of &lt;tt&gt;OpenSim.ini&lt;/tt&gt;. Same deal for other physics engines, when available.<br /> <br /> On mono 1.2.6, some distributions may see<br /> Unhandled Exception: System.NotSupportedException: CodePage 1252 not supported<br /> on startup when using mysql. This can be resolved by installing the package libmono-i18n2.0-cil (see http://bugs.mysql.com/bug.php?id=33938).<br /> <br /> === Additional Items ===<br /> <br /> * [[GC_NO_EXPLICIT|GC NO EXPLICIT]] - Enable Large Heap in Mono, this has been known to help performance and stability<br /> <br /> == Hardware selection guide ==<br /> <br /> An often-asked question is &quot;what kind of hardware do I need to successfully run OpenSim?&quot; Unfortunately, the answer is &quot;it depends&quot;. The number of regions hosted on a given machine, number of simultaneous avatars on those regions, number of prims, use of scripts, etc., all affect hardware requirements. So, to help you make a more informed selection, some examples of hardware used are listed in the [[Hardware_Selection_Guide|hardware selection guide]]. <br /> <br /> [[Category:Users]]<br /> [[Category:Getting Started]]</div>

SeanDague http://opensimulator.org/wiki/Download 2009-04-05T16:39:31Z

<p>SeanDague: /* Binaries */</p> <hr /> <div>{{Template:Quicklinks}}<br /> =Source code=<br /> Here are the current released versions of OpenSim. <br /> <br /> Please see [[Branches]] for more information on the repository branches and what they are for.<br /> <br /> &lt;font color=red&gt;'''Please note:'''&lt;/font&gt; 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.<br /> <br /> Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.<br /> <br /> The lastest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.4''' and provided as:<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.tar.gz - best for Linux systems<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.zip - best for Windows systems<br /> <br /> The only difference between the 2 is the archive format, the source is exactly the same.<br /> <br /> == Release Code via Subversion ==<br /> <br /> Instead of using a source archive release, you can pull specific releases from our subversion. For Windows you can install just [http://subversion.tigris.org/servlets/NewsItemView?newsItemID=1941 Subversion] or the often preferred [http://tortoisesvn.tigris.org Tortoise Subversion extension]. Mac OS X 10.l5 and above have Subversion built but OS. X 10.4.x can still [http://homepage.mac.com/martinott/Subversion-1.4.4.pkg.zip download Subversion]. All Linux systems should have subversion installed, or available from their package repositories.<br /> <br /> * '''0.6.4 Alpha with post-release fixes''' (preferred)<br /> svn co http://opensimulator.org/svn/opensim/branches/0.6.4-post-fixes opensim<br /> <br /> * '''0.6.4 Alpha release tag''' <br /> svn co http://opensimulator.org/svn/opensim/tags/0.6.4-release opensim<br /> <br /> =Binaries=<br /> The OpenSim project only does source based releases, which you must [[Build_Instructions|compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases. Links below are provided for convenience.<br /> <br /> ==Installers==<br /> <br /> * '''0.6.3 Windows Installer (Postfix Edition r8730)''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/175/441/OpenSim0.6.3Setup.exe<br /> <br /> * '''0.6.2 Windows Installer''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/157/359/OpenSimSetup0.6.2.exe<br /> <br /> * '''[[UnofficialDebPackages|Unofficial .deb packages]]<br /> <br /> = Older Versions Archive =<br /> <br /> All older versions of OpenSim are available from the svn repo. 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.<br /> <br /> The 'official' release tags are kept here:<br /> http://opensimulator.org/svn/opensim/tags/<br /> <br /> The post-fixes, as well as some experimental offshoots are kept here:<br /> http://opensimulator.org/svn/opensim/branches/<br /> <br /> = Experimental Upstream Code =<br /> &lt;font style=&quot;color: red; font-size: big&quot;&gt;'''There Be Dragons Beyond This Point'''&lt;/font&gt;<br /> <br /> 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 subversion trunk. Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of trunk. '''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.<br /> <br /> If it breaks, you get to keep both pieces.<br /> <br /> * '''Latest Subversion revision version (bleeding edge)'''<br /> svn co http://opensimulator.org/svn/opensim/trunk opensim<br /> <br /> Another option for obtaining the code is via [http://git-scm.com/ git] from the [http://opensimulator.org/viewgit OpenSim Git Mirror]. The git mirror only contains trunk code (no branches or tags) and may be up to 1 hour behind the svn trunk.<br /> <br /> * '''Latest git revision version (bleeding edge)'''<br /> git clone http://opensimulator.org/git/opensim<br /> <br /> =Related Software=<br /> [[Related_Software|Related Software Section - CLICK HERE]]&lt;br&gt;&lt;br&gt;<br /> <br /> ''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]&lt;br /&gt;<br /> <br /> [[Category:Users]]<br /> [[Category:Developers]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Download 2009-04-05T16:39:01Z

<p>SeanDague: </p> <hr /> <div>{{Template:Quicklinks}}<br /> =Source code=<br /> Here are the current released versions of OpenSim. <br /> <br /> Please see [[Branches]] for more information on the repository branches and what they are for.<br /> <br /> &lt;font color=red&gt;'''Please note:'''&lt;/font&gt; 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.<br /> <br /> Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.<br /> <br /> The lastest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.4''' and provided as:<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.tar.gz - best for Linux systems<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.zip - best for Windows systems<br /> <br /> The only difference between the 2 is the archive format, the source is exactly the same.<br /> <br /> == Release Code via Subversion ==<br /> <br /> Instead of using a source archive release, you can pull specific releases from our subversion. For Windows you can install just [http://subversion.tigris.org/servlets/NewsItemView?newsItemID=1941 Subversion] or the often preferred [http://tortoisesvn.tigris.org Tortoise Subversion extension]. Mac OS X 10.l5 and above have Subversion built but OS. X 10.4.x can still [http://homepage.mac.com/martinott/Subversion-1.4.4.pkg.zip download Subversion]. All Linux systems should have subversion installed, or available from their package repositories.<br /> <br /> * '''0.6.4 Alpha with post-release fixes''' (preferred)<br /> svn co http://opensimulator.org/svn/opensim/branches/0.6.4-post-fixes opensim<br /> <br /> * '''0.6.4 Alpha release tag''' <br /> svn co http://opensimulator.org/svn/opensim/tags/0.6.4-release opensim<br /> <br /> =Binaries=<br /> The OpenSim project only does source based releases, which you must [[Build_Instructions compile]] yourself. Many members of our community provide binary installers that you can used based on those source releases. Links below are provided for convenience.<br /> <br /> ==Installers==<br /> <br /> * '''0.6.3 Windows Installer (Postfix Edition r8730)''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/175/441/OpenSim0.6.3Setup.exe<br /> <br /> * '''0.6.2 Windows Installer''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/157/359/OpenSimSetup0.6.2.exe<br /> <br /> * '''[[UnofficialDebPackages|Unofficial .deb packages]]<br /> <br /> = Older Versions Archive =<br /> <br /> All older versions of OpenSim are available from the svn repo. 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.<br /> <br /> The 'official' release tags are kept here:<br /> http://opensimulator.org/svn/opensim/tags/<br /> <br /> The post-fixes, as well as some experimental offshoots are kept here:<br /> http://opensimulator.org/svn/opensim/branches/<br /> <br /> = Experimental Upstream Code =<br /> &lt;font style=&quot;color: red; font-size: big&quot;&gt;'''There Be Dragons Beyond This Point'''&lt;/font&gt;<br /> <br /> 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 subversion trunk. Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of trunk. '''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.<br /> <br /> If it breaks, you get to keep both pieces.<br /> <br /> * '''Latest Subversion revision version (bleeding edge)'''<br /> svn co http://opensimulator.org/svn/opensim/trunk opensim<br /> <br /> Another option for obtaining the code is via [http://git-scm.com/ git] from the [http://opensimulator.org/viewgit OpenSim Git Mirror]. The git mirror only contains trunk code (no branches or tags) and may be up to 1 hour behind the svn trunk.<br /> <br /> * '''Latest git revision version (bleeding edge)'''<br /> git clone http://opensimulator.org/git/opensim<br /> <br /> =Related Software=<br /> [[Related_Software|Related Software Section - CLICK HERE]]&lt;br&gt;&lt;br&gt;<br /> <br /> ''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]&lt;br /&gt;<br /> <br /> [[Category:Users]]<br /> [[Category:Developers]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague http://opensimulator.org/wiki/Download 2009-04-05T15:05:47Z

<p>SeanDague: </p> <hr /> <div>{{Template:Quicklinks}}<br /> =Source code=<br /> Here are the current released versions of OpenSim. <br /> <br /> Please see [[Branches]] for more information on the repository branches and what they are for.<br /> <br /> &lt;font color=red&gt;'''Please note:'''&lt;/font&gt; 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.<br /> <br /> Also, please be aware that OpenSim requires that you have a fair amount of technical knowledge in order to set it up.<br /> <br /> The lastest source releases are always hosted at http://dist.opensimulator.org, the current latest releases is '''0.6.4''' and provided as:<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.tar.gz - best for Linux systems<br /> * http://dist.opensimulator.org/opensim-0.6.4-release.zip - best for Windows systems<br /> <br /> The only difference between the 2 is the archive format, the source is exactly the same.<br /> <br /> == Release Code via Subversion ==<br /> <br /> Instead of using a source archive release, you can pull specific releases from our subversion. For Windows you can install just [http://subversion.tigris.org/servlets/NewsItemView?newsItemID=1941 Subversion] or the often preferred [http://tortoisesvn.tigris.org Tortoise Subversion extension]. Mac OS X 10.l5 and above have Subversion built but OS. X 10.4.x can still [http://homepage.mac.com/martinott/Subversion-1.4.4.pkg.zip download Subversion]. All Linux systems should have subversion installed, or available from their package repositories.<br /> <br /> * '''0.6.4 Alpha with post-release fixes''' (preferred)<br /> svn co http://opensimulator.org/svn/opensim/branches/0.6.4-post-fixes opensim<br /> <br /> * '''0.6.4 Alpha release tag''' <br /> svn co http://opensimulator.org/svn/opensim/tags/0.6.4-release opensim<br /> <br /> =Binaries=<br /> ==Installers==<br /> <br /> * '''Official 0.6.3 Windows Installer (Postfix Edition r8730)''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/175/441/OpenSim0.6.3Setup.exe<br /> <br /> * '''Official 0.6.2 Windows Installer''' <br /> http://forge.opensimulator.org/gf/download/frsrelease/157/359/OpenSimSetup0.6.2.exe<br /> <br /> * '''[[UnofficialDebPackages|Unofficial .deb packages]]<br /> <br /> = Older Versions Archive =<br /> <br /> All older versions of OpenSim are available from the svn repo. 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.<br /> <br /> The 'official' release tags are kept here:<br /> http://opensimulator.org/svn/opensim/tags/<br /> <br /> The post-fixes, as well as some experimental offshoots are kept here:<br /> http://opensimulator.org/svn/opensim/branches/<br /> <br /> = Experimental Upstream Code =<br /> &lt;font style=&quot;color: red; font-size: big&quot;&gt;'''There Be Dragons Beyond This Point'''&lt;/font&gt;<br /> <br /> 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 subversion trunk. Any warnings previous expressed about the alpha nature of the code go double or triple if you are running directly off of trunk. '''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.<br /> <br /> If it breaks, you get to keep both pieces.<br /> <br /> * '''Latest Subversion revision version (bleeding edge)'''<br /> svn co http://opensimulator.org/svn/opensim/trunk opensim<br /> <br /> Another option for obtaining the code is via [http://git-scm.com/ git] from the [http://opensimulator.org/viewgit OpenSim Git Mirror]. The git mirror only contains trunk code (no branches or tags) and may be up to 1 hour behind the svn trunk.<br /> <br /> * '''Latest git revision version (bleeding edge)'''<br /> git clone http://opensimulator.org/git/opensim<br /> <br /> =Related Software=<br /> [[Related_Software|Related Software Section - CLICK HERE]]&lt;br&gt;&lt;br&gt;<br /> <br /> ''Pages by Category:''[[:Category:Users| User-pages]],[[:Category:Development| Developer-pages]],[[:Category:Scripts| Scripts]]&lt;br /&gt;<br /> <br /> [[Category:Users]]<br /> [[Category:Developers]]<br /> &lt;cleanpage title=hide cats=hide /&gt;</div>

SeanDague