Network/tutorials/install

= Installing Web Services = All Cubeia Network web service components are packaged as web archives (war) and should be deployed in a web container (e.g. Tomcat, Jetty etc.). The installation below is for Tomcat and MySQL, these are interchangeable technologies but they are the ones recommended and used internally (together with Jetty). The names for schema etc below are for the user-service, the same pattern applies to other services as well but you will need to change the name accordingly, i.e. for accounting service the schema should be accounting_schema.

Steps to get a web service up and running:


 * Install Apache Tomcat
 * Install MySQL

Configure MySQL
 * Add user 'userservice'
 * Add DB schema 'user_service'
 * Make sure user 'userservice' has read/write rights to the 'user_service' schema

Configure Tomcat
 * Installing MySQL drivers:
 * Download the MySQL JDBC drivers from http://www.mysql.com/downloads/connector/ (Connector/J).
 * After unpacking the file you have downloaded, you'll find a file called something like mysql-connector-java-3.0.10-stable-bin.jar.
 * Copy this file into the common/lib directory of your Tomcat installation. Be aware that this directory may be just lib for Tomcat version 6 and beyond (i.e. /lib rather than /common/lib).

Example, add this in conf/context.xml: 
 * Add a JNDI datasource with name='jdbc/usersDS'. Use the created user and password.

Install WAR


 * Copy user-service.war to $TOMCAT_HOME$/webapps/
 * Start Tomcat
 * Make sure no errors are thrown in the logs.