This installer will install or upgrade the MusicMiner web server on your Mac OS X system.

Installation Notes
Please review the System Requirements and Prerequisites below to verify your system is prepared for this installation. If you are a technically minded administrator you may be interested in the Important Locations section below. Once installation is complete (see Completing the Installation/Upgrade below) you will need to log into the system with the login admin and password admin and then click on the Admin link in the upper right corner of the main screen to enter the administration area to begin adding users and configuring your web server.

Upgrade Notes
If you are upgrading a previously installed version this installer will upgrade your web server to the new version and will automatically transfer all your existing users and settings to the new version for you.

For extra safety, if you are maintaining a critical server, it is recommended that you:

	1.	Backup your MusicMiner and Soundminer databases before upgrading, and,
	2.	Perform the upgrade during maintenance hours such as late at night when the least number of users are trying to access the system as users will lose access during the upgrade.
	3.	Log into the upgraded system and do a quick verification that all is in order.

Completing the Installation/Upgrade
Once this installer has completed successfully you have two more important steps to complete the process:

	1.	Open up a web browser (preferably Safari) on the same machine MusicMiner was just installed or upgraded on and access the URL: http://localhost
	2.	Click on the Install or Upgrade button to complete the installation or upgrade respectively.

Troubleshooting
During installation and upgrades the installer shuts-down both the Apache web server and the local MySQL server to allow it to make its modifications. When the installer is complete it attempts to restart both of these servers so that you may begin or continue to use the MusicMiner web server. Unfortunately, in some cases one or both of these servers fails to restart.

	•	Starting Apache Web Server: Access the System Preferences of the installation machine, click on the Sharing icon under the "Internet & Network" section, and make sure Personal Web Sharing is selected under the "Services" tab.
	•	Starting MySQL Server: If you installed the MySQL System Preference item then access the System Preferences of the installation machine, click on the MySQL icon under the "Other" section, and click the "Start MySQL Server" button if the server is not already running.

System Requirements
Mac OS 10.4 (Tiger)
2-8 GB Memory (depending on how many concurrent users you expect to access the system)

Prerequisites
This web server requires that the MySQL server and PHP engine already be installed in these versions:

MySQL 5.0.27+
PHP 5.2.4+

And, to import and manage your sound or video files:

Soundminer Pro 4.0.95+

Important Locations
The following are installation locations that you should be aware of:

	•	/Library/WebServer/MusicMiner: This is where the MusicMiner web server will be installed.
	•	/Library/WebServer/Documents: This is a symbolic link to the MusicMiner webroot.
	•	/Library/WebServer/Documents.musicminer.TIMESTAMP.bak: This is where the installer will backup any previous contents of the /Library/WebServer/Documents directory on first install.
	•	/etc/my.cnf: This the MySQL configuration file is installed or modified to configure the MySQL server.
	•	/etc/stopwords.txt: This the MySQL stopwords file is installed or modified to configure the MySQL server.
	•	/etc/httpd/httpd.conf or /etc/apache2/httpd.conf: This is where the installer expects the Apache configuration file to be located.
	•	/usr/local/php/lib/php.ini or /usr/local/php5/lib/php.ini: This is where the installer expects the PHP configuration file to be located.

Important Links
The following is a list of useful links for Soundminer and MusicMiner:

	•	http://www.soundminer.com: Soundminer home-page.
	•	ftp://smuser:opensesame@69.77.165.14: Latest versions of MusicMiner, Soundminer, and associated utilities.

Written by Jesse morrow

Concept & Design
Jesse Morrow / Justin Drury / Steve Pecile / Doug Bossi

Other Credits

Thanks Jonathan Stoppani for use of the Browscap library
Licensed under GNU LESSER GENERAL PUBLIC LICENSE
MusicMiner/app/libs/browscap/license.txt
http://garetjax.info/projects/browscap/

Thanks Gary Keith for use of browscap.ini
http://browsers.garykeith.com/