NOTE: This walkthrough is no longer supported. Please refer to the installation Wiki.



Please note that a lot has changed since v1.2.0. There is no longer a separate scanner, no web sharing, and no impersonation. This installation is significantly easier now. Basically you just need to create a virtual directory, create a shared folder for your music, grant permissions to the NETWORK_SERVICE account, and tell the program where it's App_Data folder is and what to scan (watch).

If these instructions are too ambiguous, just contact me for clarification.

You must install the AJAX 1.0 extensions prior to installing the MP3 CMS

** USER INSTRUCTIONS (TESTED IN W2K3 SERVER - NON DOMAIN CONTROLLER) **

Configure the ASP.NET Application

1. Edit the configuration file ~/config/my_settings/AppSettings.config to point to your music collection.
NOTE: I used a shared path \\MyServer\Music and these instructions assume the same setup (a shared folder
on the server with your music).

2. Change the configuration file ~/config/my_settings/NHibernate.config connection.connection_string property key
in the SQLite section to point to your App_Data folder (e.g. c:\Inetpub\wwwroot\Music\App_Data\music.db3)
The music.db3 database will be created by the web site.

Configure the IIS

3. Grant the NETWORK_SERVICE Account Read & Execute, Write, Modify permissions to the App_Data folder
and Read & Execute, List, & Read permissions on your shared collection folder (e.g. \\MyServer\Music)

4. Create an IIS Virtual Directory called Music and point it to your site folder (e.g. c:\Inetpub\wwwroot\Music)
Set IIS Virtual Directory to have Script Source Access, Read, & Write permissions. Set it to use the v2.0 .NET framework
and set the default document called default.aspx

NOTE: IIS 6+ uses AppPools and when you create a new virtual directory it uses the app pool DefaultAppPool which runs under the NETWORK_SERVICE account. You can change this account (in the DefaultAppPool Identity tab) to any account that has permissions to App_data and the scan path. You'll have to uncheck the Idle Timeout setting in the Performance tab of the defaultAppPool (IIS Manager > Application Pools > DefaultAppPool > Properties sheet > Performance) in order to take advantage of the FileSystemWatcher we use to automatically add/delete tracks into the system.

Run the Site!

5. Launch the site. This will kick off the scanner, which keeps a detailed log in the ~/App_Data folder.
Ignore any DROP_TABLE errors. If you get Disk I/O exception errors though, then the program does not
have sufficient rights to either the APP_DATA folder or your music directory so check those. If you get ISession
Session has been closed or disposed of error, then you have not disabled the timeout threshold in the IIS AppPool.



** DEVELOPER INSTRUCTIONS **

You need the source which can be downloaded from the SVN repository

1. Copy the sample_web.config file and paste it into the working directory as Web.Config
2. Create a new folder in ~/config called my_settings
3. Copy the configuration files in ~/config/default to ~/config/my_settings
4. Edit the AppSettings.config file. Set a scan path & turn the scanner on or off
5. Edit the NHibernate.config file. In the SQLite connection.connection_string property.
NOTE: This property must point to the fully qaulified path to your App_Data folder
6. Edit the web.config file and replace all instances of /config/default to /config/my_settings