== Installation ==

=== PredictionIO 

For a trial follow exactly the process for source based install described at the official documentation page.

https://predictionio.apache.org/install/install-sourcecode/

{{{
# this is necessary if running sbt producess error message 
# NumberFormatException 0x100
export TERM=xterm-color
}}}

=== Running the Eventserver ===

{{{
JAVA_OPTS="$JAVA_OPTS -Djava.io.tmpdir=TMPPATH"
PATH=$PATH:predictioniopath/bin
export PATH
export JAVA_OPTS

JAVA_OPTS="$JAVA_OPTS -Xmx1g" pio eventserver &
}}}

=== Test Applications

Based on the Universal Recommender template at:

https://github.com/apache/incubator-predictionio-template-recommender.git

Modifications are made for file format CSV with separator "::" and to also import dates of the events.

Each application is run at a separate http port.

{{{
JAVA_OPTS="$JAVA_OPTS -Djava.io.tmpdir=TMPPATH"
PATH=$PATH:predictioniopath/bin
export PATH
export JAVA_OPTS

pio app new APPNAME

# put APPNAME in engine.json

pio build

python data/import_eventserver.py --file CSVFILE --access_key PIOAPPACCESSKEY

#extend stack size and driver memory for training to prevent stack overflow
pio train -- --driver-java-options -Xss512m --driver-memory 1g

pio deploy --port PORTFORAPP &
}}}