Difference between revisions of "NGS Server Setup"

From MusicBrainz Wiki
m (Redirecting to MusicBrainz Server/Setup)
(21 intermediate revisions by 8 users not shown)
Line 1: Line 1:
#REDIRECT [[MusicBrainz Server/Setup]]
<small>[[Products]] > [[MusicBrainz Server]] > NGS Server Setup</small>
== Next Generation MusicBrainz Server ==
To set up a Next Generation Schema (NGS) MusicBrainz server, you can choose to download and setup a virtual machine image of NGS or you can install the server into your own Linux instance.
== MusicBrainz NGS Virtual Server Image ==
Running an NGS virtual machine requires some Linux knowledge, but it vastly simpler than installing NGS from scratch. To use the virtual machine instance, follow these steps:
# Start downloading the latest [ftp://ftp.musicbrainz.org/pub/musicbrainz/ngs/MusicBrainz_NGS_vm_20110416.ova.7z virtual machine instance]. Beware: This is a large (3.8Gb) download!
# Download and install [http://virtualbox.org Virtual Box] on your machine.
# 7Unzip the virtual machine instance. If you don't have a 7unzip program, [http://www.7-zip.org/ download one].
# (optional) The md5sum for the .ova appliance file is: 7fbdc6f9e949190b90c21363ef9fa14b
# Start Virtual Box and choose ''Import Appliance'' from the File menu. Select the newly unzipped file that ends in the .ova extension.
# Once Virtual Box has imported the appliance, select the imported virtual machine from the list of virtual machines and click on Start.
# Once the instance has started up, log in on the console using the username ''musicbrainz'' and password ''musicbrainz''. This account has sudo privileges -- if you would like to set a root passwd, you can do that via sudo.
# Run ''ifconfig'' and look at the ''inet addr'' for eth0. This is the IP address of your virtual machine. Note this IP address.
# Optional: The console for Virtual Box is very slow. I find it faster to SSH into the virtual box with a good terminal program.
# To start the NGS server, enter these commands:
musicbrainz@clear:~$ cd musicbrainz-server/script
musicbrainz@clear:~/musicbrainz-server/script$ ./musicbrainz_server.pl -r
Now you can reach the MusicBrainz server by pointing your browser to port 3000 of the IP address in step 7. If your IP address from step 7 was:, then point your browser to
== Setting up MusicBrainz NGS from source code ==
(First note: your mileage may vary -- this is one way, that works for some people; it's especially good if your package manager doesn't have all the perl dependencies for musicbrainz-server. However, it's possible it won't work for you at all!)
# Install local::lib (See http://search.cpan.org/~apeiron/local-lib-1.008004/lib/local/lib.pm for details on local::lib and one way to install it ("The bootstrapping technique"))
# Install app::cpanminus as you see fit (either using regular CPAN, installing to the local::lib directories, or using your package manager)
# Get a copy of musicbrainz-server from git: git clone git://git.musicbrainz.org/musicbrainz-server.git musicbrainz-server
# Make sure the proper environment variables for local::lib are set (PERL5LIB, PERL_MM_OPT, MODULEBUILDRC, and PATH)
# As of 2011-04-27, cpanm chokes on Method::Signature 0.67 -- use <code>cpanm http://search.cpan.org/CPAN/authors/id/F/FL/FLORA/Module-Signature-0.66.tar.gz</code>
# Install OSSP::uuid separately using the packages at http://www.ossp.org/pkg/lib/uuid/ or using your package manager (Debian/Ubuntu instructions in INSTALL)
# Install Test::WWW::Mechanize separately, probably from a package manager
# <code>cd musicbrainz-server</code>
# <code>cpanm .</code>
# finish installation using instructions in INSTALL (the dependencies are installed, or should be)
[[Category:Products]] [[Category:Server]]

Latest revision as of 01:36, 11 November 2011