MusicBrainz Server: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (Server moved to MusicBrainz Server: Official title)
('Overview' still needs to be written; 'Required Software' could be integrated into 'Overview'.)
Line 1: Line 1:
<small>[[Products]] > Server</small>
<small>[[Products]] > MusicBrainz Server</small>


The '''MusicBrainz Server''' is an open source [http://www.gnu.org/copyleft/gpl.html GPL] licensed software application that is written in Perl. The MusicBrainz Server provides the primary interface to the [[MusicBrainz Database]] by providing a website for users to browse and edit the data on, and a [[XML Web Service|web service]] to power client applications like [[MusicBrainz Picard]]. The server can be accessed at http://musicbrainz.org/ or alternatively you may setup and [[Server Setup|run your own server]].
The MusicBrainz server is the keeper of all of the [[MusicBrainz]] data. Users can use the server at [http://musicbrainz.org/ http://musicbrainz.org/] and developers can [[Server Download| download]] the server code and run their own MusicBrainz server.


'''If you are a user''' and want to use the server, you should probably head to the [[How To|HowTo]]s, the [[Beginners Guide|BeginnersGuide]] or the [[Frequently Asked Questions|FrequentlyAskedQuestions]].
If you are looking for help in understanding how MusicBrainz works the [[Beginners Guide|beginners guide]] and [[Frequently Asked Questions|FAQs]] will provide a more thorough overview.

'''If you are a developer''' and want to download and install the server, you are at the right place. This page groups all the resources about the server that you will need.


==Overview==
==Overview==
Line 12: Line 10:


As the diagram illustrates, the MusicBrainz server listens for incoming web page / [[Web Service|WebService]] requests over HTTP, processes the requests referring to the database where necessary, and returns an appropriate response to the calling client. (See the [[Development Overview|DevelopmentOverview]] page for more details). The '''Relatable TRM Signature Server''' is not part of the MusicBrainz server. It is a closed-source proprietary system licensed from [http://www.relatable.com/ Relatable]. For more information, please see [[How TRM Generation Works|HowTRMGenerationWorks]]. Since the Relatable TRM Signature Server is closed-source, you cannot download or modify its source code.
As the diagram illustrates, the MusicBrainz server listens for incoming web page / [[Web Service|WebService]] requests over HTTP, processes the requests referring to the database where necessary, and returns an appropriate response to the calling client. (See the [[Development Overview|DevelopmentOverview]] page for more details). The '''Relatable TRM Signature Server''' is not part of the MusicBrainz server. It is a closed-source proprietary system licensed from [http://www.relatable.com/ Relatable]. For more information, please see [[How TRM Generation Works|HowTRMGenerationWorks]]. Since the Relatable TRM Signature Server is closed-source, you cannot download or modify its source code.

==Download==

:[[Image:download.gif]] [[Server Setup|Download and setup the server]].


==Required Software==
==Required Software==


The [[MusicBrainz]] server is built on top of the following components:
The MusicBrainz server is built on top of the following components:
* The data is stored in a [http://www.postgresql.org/ PostgreSQL] relational database.
* The data is stored in a [http://www.postgresql.org/ PostgreSQL] relational database.
* Virtually all of the server code is written in [http://www.perl.com/ Perl 5.8].
* Virtually all of the server code is written in [http://www.perl.com/ Perl 5.8].
Line 21: Line 23:
* A selection of Perl modules from [http://cpan.org/ CPAN] are used; in particular the web pages are constructed using [http://www.masonhq.com/ Mason].
* A selection of Perl modules from [http://cpan.org/ CPAN] are used; in particular the web pages are constructed using [http://www.masonhq.com/ Mason].
* The [http://sourceforge.net/projects/expat Expat XML parser library] is used to handle the RDF web services.
* The [http://sourceforge.net/projects/expat Expat XML parser library] is used to handle the RDF web services.

==Download==

:[[Image:download.gif]] [[Server Setup|Download and setup the server]].


==Learn More==
==Learn More==


* Learn more about the [[Server Development|ServerDevelopment]]
* [[Server Setup|Setup your own server]]
* [[Server Setup|ServerSetup]]
* [[Server Development|Server development]]
* Read how to setup, and import data into the [[Database Development|MusicBrainz Database]].
* [[Database Development|Database development]]
* [[XML Web Service|XML web service]]
*lists all pages that refer to the MusicBrainz server. (in progress)
* [[Web Service|WebService]]


[[Category:To Be Reviewed]] [[Category:Product Sever]] [[Category:WikiDocs Page]] [[Category:Products]] [[Category:Server]]
[[Category:WikiDocs Page]] [[Category:Products]] [[Category:Server]]

Revision as of 06:11, 7 February 2010

Products > MusicBrainz Server

The MusicBrainz Server is an open source GPL licensed software application that is written in Perl. The MusicBrainz Server provides the primary interface to the MusicBrainz Database by providing a website for users to browse and edit the data on, and a web service to power client applications like MusicBrainz Picard. The server can be accessed at http://musicbrainz.org/ or alternatively you may setup and run your own server.

If you are looking for help in understanding how MusicBrainz works the beginners guide and FAQs will provide a more thorough overview.

Overview

The following diagram briefly illustrates the different components of the MusicBrainz service:
MBComponents.png
How the MusicBrainz components are related to each other

As the diagram illustrates, the MusicBrainz server listens for incoming web page / WebService requests over HTTP, processes the requests referring to the database where necessary, and returns an appropriate response to the calling client. (See the DevelopmentOverview page for more details). The Relatable TRM Signature Server is not part of the MusicBrainz server. It is a closed-source proprietary system licensed from Relatable. For more information, please see HowTRMGenerationWorks. Since the Relatable TRM Signature Server is closed-source, you cannot download or modify its source code.

Download

download.gif Download and setup the server.

Required Software

The MusicBrainz server is built on top of the following components:

  • The data is stored in a PostgreSQL relational database.
  • Virtually all of the server code is written in Perl 5.8.
  • The web server is built using Apache and mod_perl.
  • A selection of Perl modules from CPAN are used; in particular the web pages are constructed using Mason.
  • The Expat XML parser library is used to handle the RDF web services.

Learn More