Server Download: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(Merged in content from Server Setup)
Line 1: Line 1:
<small>[[Products]] > [[Server]] > ServerDownload</small>
<small>[[Products]] > [[Server]] > Server Download</small>


The MusicBrainz Server is not available as an executable application. Setting up the server will require you to checkout the <code>mb_server</code> code from Subversion and manually follow the INSTALL file's directions.


You can browse the <code>mb_server</code> Subversion repository directly using the [http://bugs.musicbrainz.org/browser/mb_server/ source browser].
==Introduction==


==Setup instructions==
The MusicBrainz server is not available as an executable software. You have to install the 3rd party products which are required to run the product and then checkout the the modules '''mb_server''' from Subversion (See [[Server Setup|How to Setup a MusicBrainz Server]] for a step-by-step instructions on how to setup your own copy of the server).
# If you are a MusicBrainz developer use [http://bugs.musicbrainz.org/browser/mb_server/trunk/INSTALL /trunk/INSTALL] ''(potentially unstable)''.
# For everyone else use [http://bugs.musicbrainz.org/browser/mb_server/branches/RELEASE_20090524-BRANCH/INSTALL /branches/RELEASE_20090524-BRANCH/INSTALL] ''(latest stable release)''.
# If you just want a running database (i.e. no website frontend) see the [[Database Setup|database setup]] guide instead.
# Additionally, if you want to setup your own search server instead of having to query <code>search.musicbrainz.org</code>, use the <code>search_server</code> [http://bugs.musicbrainz.org/browser/search_server/trunk/README README].


An alternate option is to install a [[Virtual MusicBrainz Server|virtual MusicBrainz server]]. The virtual image comes fully configured with a Linux environment and the latest stable release of the <code>mb_server</code> source code.
==License==


The requirements may look daunting, but please don't let this discourage you; the INSTALL/README files are thorough and contain a lot of information, and we are willing to provide assistance. If you have questions about installing, join us in the [http://webchat.freenode.net/?channels=musicbrainz #musicbrainz IRC channel] or post a question on the [[Developers Mailing List|developers mailing list]] and we will attempt to help you out.
The '''mb_server''' is licensed under the [http://www.gnu.org/copyleft/gpl.html GPL (Gnu Public License)].


We recommend that you dive in and give it a try - who knows how far you'll get and what you might learn along the way!
==Version==


==Requirements==
There is a vast number of [http://bugs.musicbrainz.org/browser/mb_server/tags versions] available for the releases the '''mb_server''' project has gone through since its beginning in 2000. You'll find the current running version in the lowest right part of any page running on [http://musicbrainz.org http://musicbrainz.org] (version at the time this document was written: <code><nowiki>server version: RELEASE-20081123</nowiki></code>)


In order to set up a running MusicBrainz server with the full database you will need:
==Source Code==
* A linux box, preferably Ubuntu, that is a PIII-700 or better with 256MB RAM.
* 8GB of free disk space, (if you are a developer and only want the server code and database structure 2GB is more than enough).
* [[Subversion]] knowledge which will enable you to check out the source code.


As a developer the following knowledge/skills are beneficial:
The source code of '''mb_server''' is available using anonymous Subversion access. Read the [[Subversion|Subversion document]] for instructions on how to use Subversion and checkout the '''mb_server''' source code. Alternatively, you can browse the '''mb_server''' Subversion repository directly using the [http://bugs.musicbrainz.org/browser/mb_server/ source browser].
* Apache, Perl, mod_perl, PostgreSQL and a number of perl modules.
* How to compile and install packages from source on a Linux box.
* How to patch existing packages, although we can help you out if you have questions about that.

Note: The server has ''never been ported to Windows'', and we suspect that it would be a fair amount of work to make that happen.

==License==


The <code>mb_server</code> is licensed under the [http://www.gnu.org/copyleft/gpl.html GPL (Gnu Public License)].
<pre> svn checkout http://svn.musicbrainz.org/mb_server/trunk mb_server
</pre>


[[Category:WikiDocs Page]] [[Category:Download]] [[Category:Server]]
[[Category:WikiDocs Page]] [[Category:Download]] [[Category:Server]]

Revision as of 22:54, 26 January 2010

Products > Server > Server Download

The MusicBrainz Server is not available as an executable application. Setting up the server will require you to checkout the mb_server code from Subversion and manually follow the INSTALL file's directions.

You can browse the mb_server Subversion repository directly using the source browser.

Setup instructions

  1. If you are a MusicBrainz developer use /trunk/INSTALL (potentially unstable).
  2. For everyone else use /branches/RELEASE_20090524-BRANCH/INSTALL (latest stable release).
  3. If you just want a running database (i.e. no website frontend) see the database setup guide instead.
  4. Additionally, if you want to setup your own search server instead of having to query search.musicbrainz.org, use the search_server README.

An alternate option is to install a virtual MusicBrainz server. The virtual image comes fully configured with a Linux environment and the latest stable release of the mb_server source code.

The requirements may look daunting, but please don't let this discourage you; the INSTALL/README files are thorough and contain a lot of information, and we are willing to provide assistance. If you have questions about installing, join us in the #musicbrainz IRC channel or post a question on the developers mailing list and we will attempt to help you out.

We recommend that you dive in and give it a try - who knows how far you'll get and what you might learn along the way!

Requirements

In order to set up a running MusicBrainz server with the full database you will need:

  • A linux box, preferably Ubuntu, that is a PIII-700 or better with 256MB RAM.
  • 8GB of free disk space, (if you are a developer and only want the server code and database structure 2GB is more than enough).
  • Subversion knowledge which will enable you to check out the source code.

As a developer the following knowledge/skills are beneficial:

  • Apache, Perl, mod_perl, PostgreSQL and a number of perl modules.
  • How to compile and install packages from source on a Linux box.
  • How to patch existing packages, although we can help you out if you have questions about that.

Note: The server has never been ported to Windows, and we suspect that it would be a fair amount of work to make that happen.

License

The mb_server is licensed under the GPL (Gnu Public License).