Infrastructure

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(New page: = Web = * wiki page on opensimulator.org (done) * integration of RSS for planet.opensim.org to Main_Page * integration of RSS for latest SVN commits to Main_Page = Email = (probably has t...)
 
(Todo)
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
= Web =
+
__NOTOC__
* wiki page on opensimulator.org (done)
+
{{Quicklinks}}
* integration of RSS for planet.opensim.org to Main_Page
+
<br />
* integration of RSS for latest SVN commits to Main_Page
+
  
= Email =
+
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.
(probably has to be on berlios due to bad ip of server)
+
* creation of opensim-core
+
* creation of new opensim-dev
+
* creation of opensim-users
+
* creation of new opensim-commits
+
  
= Subversion =
+
= Current Infrastructure =
* setup on new server
+
 
* web svn configured on new server
+
== Wiki ==
 +
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.
 +
 
 +
=== Search for Wiki ===
 +
 
 +
Search for the wiki is provided by MWSearch, which requires a separate 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 sometimes needs to be whacked and restarted.
 +
 
 +
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.
 +
 
 +
== Mantis ==
 +
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 mantis 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.
 +
 
 +
=== osmantis bot ===
 +
 
 +
This is a piece of Perl code hacked together quickly by Sean Dague based on 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 losing connection with the IRC server.
 +
 
 +
== Mailing Lists ==
 +
These are on berlios.de because the current opensimulator.org box sits on an IP that is in a lot of spam blacklists. For this reason, many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net
 +
 
 +
== Source Management ==
 +
 
 +
=== git ===
 +
 
 +
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.
 +
 
 +
git:// URLs are served via the git-daemon package on Debian, which is run as part of the init process.
 +
 
 +
=== git emails ===
 +
 
 +
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.
 +
 
 +
=== git to cia bot ===
 +
 
 +
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.
 +
 
 +
=== mirroring to github ===
 +
 
 +
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.
 +
 
 +
=== panda ===
 +
 
 +
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.
 +
 
 +
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)
 +
 
 +
=== viewgit ===
 +
 
 +
Viewgit is configured in /var/www/opensimulator.org/viewgit, and provides web access to the git repo.
 +
 
 +
=== svn tracking mirror ===
 +
 
 +
The OpenSim-mirror id also uses a very crude script to attempt to create an svn mirror of the git repo. This is quite an error-prone program, as svn seems to love to remove permissions on executables. Hopefully, this will eventually be retired.
 +
 
 +
== Backups ==
 +
This is a two step process:
 +
* A nightly cronjob that dumps the mysql databases to /var/dbbackups
 +
* A backuppc process running at Sean Dague's house that sshes in nightly and backs up
 +
** /home
 +
** /etc
 +
** /var/www
 +
** /var/svn
 +
** /var/dbbackups
 +
 
 +
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.
 +
 
 +
= Todo =
 +
 
 +
* Mediawiki Upgrade
 +
* Find a new backup solution
 +
* Upgrade mantis to latest stable

Revision as of 11:36, 6 December 2018


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.

Current Infrastructure

Wiki

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.

Search for Wiki

Search for the wiki is provided by MWSearch, which requires a separate 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 sometimes needs to be whacked and restarted.

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.

Mantis

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 mantis 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.

osmantis bot

This is a piece of Perl code hacked together quickly by Sean Dague based on 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 losing connection with the IRC server.

Mailing Lists

These are on berlios.de because the current opensimulator.org box sits on an IP that is in a lot of spam blacklists. For this reason, many people don't get mantis emails. Networks that are especially bad about that are yahoo.com and pacbell.net

Source Management

git

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.

git:// URLs are served via the git-daemon package on Debian, which is run as part of the init process.

git emails

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.

git to cia bot

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.

mirroring to github

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.

panda

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.

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)

viewgit

Viewgit is configured in /var/www/opensimulator.org/viewgit, and provides web access to the git repo.

svn tracking mirror

The OpenSim-mirror id also uses a very crude script to attempt to create an svn mirror of the git repo. This is quite an error-prone program, as svn seems to love to remove permissions on executables. Hopefully, this will eventually be retired.

Backups

This is a two step process:

  • A nightly cronjob that dumps the mysql databases to /var/dbbackups
  • A backuppc process running at Sean Dague's house that sshes in nightly and backs up
    • /home
    • /etc
    • /var/www
    • /var/svn
    • /var/dbbackups

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.

Todo

  • Mediawiki Upgrade
  • Find a new backup solution
  • Upgrade mantis to latest stable
Personal tools
General
About This Wiki