Difference between revisions of "NGS Server Setup"

From MusicBrainz Wiki
Line 10: Line 10:
 
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:
 
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!
+
# Start downloading the latest [ftp://ftp.musicbrainz.org/pub/musicbrainz/ngs/MusicBrainz_NGS_vm_20110427.ova.7z virtual machine instance]. Beware: This is a large (3.8Gb) download!
 
# Download and install [http://virtualbox.org Virtual Box] on your machine.
 
# 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].
 
# 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
+
# (optional) The md5sum for the .ova appliance file is: 7f587a8fd1682eb2b8edae9f3ea0dbb5
 
# Start Virtual Box and choose ''Import Appliance'' from the File menu. Select the newly unzipped file that ends in the .ova extension.
 
# 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 Virtual Box has imported the appliance, select the imported virtual machine from the list of virtual machines and click on Start.

Revision as of 00:40, 3 May 2011

Products > MusicBrainz Server > NGS Server Setup

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:

  1. Start downloading the latest virtual machine instance. Beware: This is a large (3.8Gb) download!
  2. Download and install Virtual Box on your machine.
  3. 7Unzip the virtual machine instance. If you don't have a 7unzip program, download one.
  4. (optional) The md5sum for the .ova appliance file is: 7f587a8fd1682eb2b8edae9f3ea0dbb5
  5. Start Virtual Box and choose Import Appliance from the File menu. Select the newly unzipped file that ends in the .ova extension.
  6. Once Virtual Box has imported the appliance, select the imported virtual machine from the list of virtual machines and click on Start.
  7. 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.
  8. Run ifconfig and look at the inet addr for eth0. This is the IP address of your virtual machine. Note this IP address.
  9. Optional: The console for Virtual Box is very slow. I find it faster to SSH into the virtual box with a good terminal program.
  10. 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: 10.1.1.104, then point your browser to http://10.1.1.104:3000

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!)

  1. 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"))
  2. Install app::cpanminus as you see fit (either using regular CPAN, installing to the local::lib directories, or using your package manager)
  3. Get a copy of musicbrainz-server from git: git clone git://git.musicbrainz.org/musicbrainz-server.git musicbrainz-server
  4. Make sure the proper environment variables for local::lib are set (PERL5LIB, PERL_MM_OPT, MODULEBUILDRC, and PATH)
  5. 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)
  6. Install Test::WWW::Mechanize separately, probably from a package manager
  7. cd musicbrainz-server
  8. cpanm .
  9. As of 2011-04-27, cpanm chokes on Method::Signature 0.67 -- use cpanm http://search.cpan.org/CPAN/authors/id/F/FL/FLORA/Module-Signature-0.66.tar.gz and restart cpanm . if this applies to you
  10. finish installation using instructions in INSTALL (the dependencies are installed, or should be)