Doc: Move build and migration docs to documentation/

documentation/BUILD.md

@@ -0,0 +1,92 @@
+<!--
+# BUILD.md
+# Libresonic/libresonic
+-->
+Requirements
+------------
+
+  * Recent version of [Maven](http://maven.apache.org/).
+  * A JDK installation. 1.8.x series of OpenJDK or Oracle JDK 8+ should work.
+  * Optional: lintian and fakeroot, for .deb package
+  * Optional: rpm and rpmlint, for .rpm package
+  * Test as follows:
+
+```
+$ which mvn
+/usr/local/bin/mvn
+$ echo $JAVA_HOME
+/usr/lib/jvm/java-1.8.0-openjdk.x86_64
+$
+```
+
+Now you can clone a copy of this repository:
+
+```
+$ git clone git://github.com/Libresonic/libresonic.git
+$ cd libresonic
+$
+```
+
+Standalone WAR
+--------------
+
+At this point you are ready to build the basic Libresonic WAR. This is required for all the other build targets, so you should do it before proceeding.
+
+```
+$ mvn package
+<lots of buildspam>
+[INFO] Building war: /path/to/repo/libresonic/libresonic-main/target/libresonic.war
+<more buildspam>
+$
+```
+
+Tomcat Installation
+-------------------
+
+The WAR may be copied directly to a Tomcat server's webapps/ directory and deployed.
+
+```
+$ cp libresonic-main/target/libresonic.war /var/lib/tomcat6/webapps/
+$
+```
+
+
+Packaged .deb
+-------------
+
+You can furthermore go ahead to create a .deb suitable for installation on
+Debian or Ubuntu.
+
+```
+$ mvn -P full -pl libresonic-booter -am install
+$ mvn -P full -pl libresonic-installer-debian -am install
+$ sudo dpkg -i ./libresonic-installer-debian/target/libresonic-*.deb
+```
+
+Packaged RPM
+------------
+
+Building a RPM package is very similar :
+
+```
+$ mvn -P full -pl libresonic-booter -am install
+$ mvn -P full,rpm -pl libresonic-installer-rpm -am install
+$ sudo rpm -ivh libresonic-installer-rpm/target/libresonic-*.rpm
+```
+
+Additional release archives
+---------------------------
+
+Additional release archives can be built using the following commands :
+
+```
+$ mvn -Pfull -pl libresonic-assembly assembly:single
+```
+
+These archives are built in `libresonic-assembly/targets` and include :
+
+* The source distribution
+* The standalone archive (for use without a WAR container)
+* The WAR archive (for WAR containers)
+
+Good luck!

documentation/MIGRATE.md

@@ -0,0 +1,36 @@
+Upgrade to Libresonic from Subsonic
+================
+
+This guide helps you to migrate your data from Subsonic to Libresonic. It has been tested with Subsonic 5 to Libresonic 6.
+
+Install Libresonic as described in INSTALL.md. The author of this guide used the standalone solution without Java Tomcat.
+
+After installation of Libresonic, the database needs to be migrated. In preperation for that, stop the Libresonic service
+
+    sudo service libresonic stop
+
+If you ran Subsonic before, your data will be (by default) stored in `/var/subsonic`. Assuming you did not use Libresonic before, we will delete all data from Libresonic
+
+    sudo rm -r /var/libresonic # WARNING: DELETES all Libresonic data (Subsonic data will be kept)
+
+We then copy Subsonic data to Libresonic location. Be aware that a couple of files need to be renamed:
+
+    sudo cp -a /var/subsonic /var/libresonic
+    sudo mv /var/libresonic/subsonic_sh.log libresonic_sh.log
+    sudo mv /var/libresonic/subsonic.log libresonic.log
+    sudo mv /var/libresonic/subsonic.properties libresonic.properties
+    sudo mv /var/libresonic/db/subsonic.backup /var/libresonic/db/libresonic.backup
+    sudo mv /var/libresonic/db/subsonic.data /var/libresonic/db/libresonic.data
+    sudo mv /var/libresonic/db/subsonic.lck /var/libresonic/db/libresonic.lck
+    sudo mv /var/libresonic/db/subsonic.log /var/libresonic/db/libresonic.log
+    sudo mv /var/libresonic/db/subsonic.properties /var/libresonic/db/libresonic.properties
+    sudo mv /var/libresonic/db/subsonic.script /var/libresonic/db/libresonic.script
+  
+Then start Libresonic service again.
+
+    sudo service libresonic start
+
+Your old settings will be there. If you wish, you can delete subsonic data
+
+    sudo rm -r /var/subsonic # Optional, THIS WILL DELETE SUBSONIC DATA
+