MUSOO

Server requirement

Installation

1. Download the latest distribution package file and uncompress it.

   * For Windows platform, Windows Support package for GetID3() library is required to import mp3 file.

   1. Go to getID3() project page. http://sourceforge.net/projects/getid3/
   2. Download getID3() Windows Support package and uncompress it.
   3. Copy the extracted helperapps directory into extlib/getid3/.

2. Open and edit ms.ini.php.

   • Configure the database options
     • In using MySQL

       The database must be prepared in advance. MUSOO will check the connection to the database and initialize it by creating tables later.
       Host name, database name, user name and password are required to connect.

       DB_DSN = "mysql:host=localhost; dbname=musoo_01"
       DB_USER = "username"
       DB_PASSWORD = "password"

     • In using SQLite

       The SQLite is a file-based database system that reads and writes directly to and from the database files on the same disk as the MUSOO runs.
       Directives of DB_USER and DB_PASSWORD are ignored. Set write permission the directory where the database file will be placed, MUSOO create the database file during initialization. Set the DB_DSN directive with server full path to the database file.

       DB_DSN = "SQLite:/server/absolute/path/to/database.sq3"

   • Configure the domain and url path where ms.php is placed in. If ms.php is accessible by http://musoo.31tools.com/demo/ms.php, configure the directives of SITE_DOMAIN and GATEWAY_URL_PATH like bellow.

     e.g.
     SITE_DOMAIN = "http://musoo.31tools.com"
     GATEWAY_URL_PATH = "/demo/"

   • Configure the url path and the server path where your works (mp3 and images) are stored in. Either the server absolute path or the relative path to gateway path where ms.php is placed in is acceptable for ARCHIVE_PATH.

     e.g.
     ARCHIVE_URL_PATH = "/demo/archives/"
     ARCHIVE_PATH = "archives"

   • Select the following options for making thumbnails of images.
     ImageMagick convert or PHP GD module.

     IMAGE_LIB="convert" or "gd"

     If you select convert option, CONVERT_PATH directive is also required to config the path to convert command.

     e.g.
     CONVERT_PATH="/usr/bin"

   • If you run MUSOO on Windows server or you want to change the path where session files are stored to other than default value "/tmp/musoo", set SESSION_SAVE_PATH properly with existing, accessible directory.
     

     e.g. (if run on Windows)
     SESSION_SAVE_PATH="c:/windows/temp"

3. Upload all files of MUSOO into predefined server directory by FTP etc.
4. SQLite users: Create database directory

   If you select SQLite database option, you should create database directory. For security reasons, it's better that the directory resides outside of your MUSOO system and document root web directory.
   If you create the database directory in a place where is accessible via the Web, you should take measures to restrict a direct access to database file.
   ( e.g. Place .htaccess file contains deny from all in the database dir )

5. Check the write permission of following files and directory.

   • archives directory
   • If you use SQLite, the database directory you created.
   • import directory
   • index.php
   • tmpl directory

6. Access install.php in your Web browser and click CHECK button to check server status.
   (e.g. http://www.yourdomain.com/musoo_root/install.php)

   

7. The install.php script does automatically following tests.

   System Environment

   The information about web server, OS and PHP are checked. MUSOO runs with PHP version 5.1.0 or greater.

   Directory Permission

   Checker attempts to write a test file in the target directory.

   The PHP configuration directives concerns file uploading

   For uploading mp3 and images via browser, it is required that php can utilize enough memory for it. If you can't control the directives of php post_max_size, upload_max_filesize and memory_limit, uploading by ftp may be only option for importing large MP3 files.

   Modules for importing images

   To import image file (png, jpeg, gif) to MUSOO, server should have either php GD module or ImageMagick convert installed.

   Modules for DB

   MUSOO utilizes PHP PDO modules to access its database. This test shows available PDO database drivers and confirm the database connectivity from setting value described in ms.ini.php

   If there are some problems, correct it and click the CHECK AGAIN button to check again.
   If the results are OK, INITIALIZE DATABASE button appeaers at the bottom of the screen. Click the button to initialize database. All existing tables will be overwritten with new empty tables.

   
8. The results of database initialization are shown in next screen. You are ready to play MUSOO !
   install.php should be deleted immediately, or your MUSOO may be initialized by someone!