Installing 3rd party addins
From OpenSimulator
| Line 15: | Line 15: | ||
== 3rd Party Repositories == | == 3rd Party Repositories == | ||
| − | The next step you need to do is to add remote repositories of addins to your OpenSim installation. You can add as many repositories as needed. To add a repository, run | + | The next step you need to do is to add remote repositories of addins to your OpenSim installation. You can add as many repositories as needed. To add a repository, run these commands in OpenSim's '''bin''' folder: |
$ mautil.exe -p . -reg ''/path/to/my/registry'' rep-add ''repo_url'' | $ mautil.exe -p . -reg ''/path/to/my/registry'' rep-add ''repo_url'' | ||
| + | $ mautil.exe -p . -reg ''/path/to/my/registry'' rep-update | ||
For example: | For example: | ||
$ mautil.exe -p . -reg C:/addins-registry rep-add http://metaverseink.com/repo | $ mautil.exe -p . -reg C:/addins-registry rep-add http://metaverseink.com/repo | ||
| + | $ mautil.exe -p . -reg C:/addins-registry rep-update | ||
| + | |||
| + | (The argument to the -p parameter, in this case '.', needs to be the directory where OpenSim.exe resides. So if you run mautil.exe from somewhere else, make sure to adjust that argument's value) | ||
Revision as of 00:18, 31 December 2014
This page explains how to install, update and uninstall 3rd-party addins for the simulator server in a systematic way. 3rd-party addins are packages created around region modules, possibly with additional external libraries and resources, that extend the simulator with additional functionality. Examples are ossearch (the simulator part), MISearch images, assorted money modules, etc.
Registry Location
Before you start using managed addins, it is important that you think carefully about where you want to keep these addins. Internally, OpenSim uses its own addins, and it installs the addin database under its bin folder. If you don't change anything, 3rd-party addins will be placed there too. Depending on what process you have in place for updating OpenSim, this may cause you trouble: if your process includes deleting the entire bin folder and replacing with a new one, that process will also delete your 3rd-party addins, and you will have to reinstall them again every time you update OpenSim core.
The location of the addin registry is given by a configuration variable in OpenSim.ini:
[Startup]
...
;RegistryLocation = "."
RegistryLocation = "/path/to/my/registry"
You can change it to point to another path in your file system. This location will be important for addin installation.
3rd Party Repositories
The next step you need to do is to add remote repositories of addins to your OpenSim installation. You can add as many repositories as needed. To add a repository, run these commands in OpenSim's bin folder:
$ mautil.exe -p . -reg /path/to/my/registry rep-add repo_url $ mautil.exe -p . -reg /path/to/my/registry rep-update
For example:
$ mautil.exe -p . -reg C:/addins-registry rep-add http://metaverseink.com/repo $ mautil.exe -p . -reg C:/addins-registry rep-update
(The argument to the -p parameter, in this case '.', needs to be the directory where OpenSim.exe resides. So if you run mautil.exe from somewhere else, make sure to adjust that argument's value)
