--- a
+++ b/personalization-manager/README.md
@@ -0,0 +1,42 @@
+Swagger: http://alfred.eu:8080/personalization-manager/swagger-ui.html
+Raw JSON definition file (used for client generation): http://alfred.eu:8080/personalization-manager/v2/api-docs
+
+Service startup config: sudo mcedit /etc/default/tomcat7
+To restart Tomcat: sudo service tomcat7 restart
+Tomcat config: /var/lib/tomcat7/conf
+
+Logs: /var/log/tomcat7
+
+===== DEPLOYMENT on alfred.eu:
+Via GUI: http://alfred.eu:8080/manager/html (ask TIE for credentials)
+or via maven: mvn tomcat7:redeploy (sometimes gets stuck, need to restart the tomcat service)
+
+For the latter you need to provide authentication details in the C:\Users\your_account\.m2\settings.xml, like:
+<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
+ <servers>
+ <server>
+ <id>alfred-tomcat</id>
+ <username>ask_TIE</username>
+ <password>ask_TIE</password>
+ </server>
+ </servers>
+</settings>
+
+===== To generate the REST client:
+
+Description of the tool: https://github.com/swagger-api/swagger-codegen
+
+Download the tool: http://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.1.4/swagger-codegen-cli-2.1.4.jar
+
+Command to generate the client (create a .bat file in the same folder as swagger-codegen.jar):
+
+java -jar swagger-codegen-cli-2.1.4.jar generate ^
+ -i http://alfred.eu:8080/personalization-manager/v2/api-docs ^
+ -l java ^
+ -o alfred/client/personalization-manager/java
+
+See the languages the generator supports: java -jar swagger-codegen-cli-2.1.4.jar langs
+