Skip to content
Antonia Engfors edited this page Jan 3, 2018 · 32 revisions

Welcome to our Wiki for Streama v1 of the app!
On this page you will find deployment info (mainly for Linux).
For the FAQs, visit the dedicated FAQs Page.

Up and Running

Here is a video Tutorial of @dularion setting it up: http://www.youtube.com/watch?v=GUcbVTrdNv8
Below you can find a step-by-step.

1. install Java

Get and install Java 8 (JDK or JRE). OpenJDK is a preferred JDK.

2. download the .war and application.yml

Download the latest war from the releases page, for instance by using the terminal command wget https://github.com/dularion/streama/releases/download/v1.4.2/streama-1.4.2.war into the same directory. Suggestion: use /data/streama for the yml and the war and /data/streama/files for the uploaded files.

3. run!

Run the app using sudo ./streama-[version].war or the failsafe option java -jar streama-[version].war. Once you see the console output
Grails application running at http://localhost:8080 in environment: production
you are set to go! just navigate to localhost:8080 and you will see a login screen (default = username:admin, password:admin), and the program is up and running. Enjoy! :)

Upgrading from a previous version?

This is a step-by-step to migrate from a previous version to current.

1. Determine if you're using MySQL or the H2 Java database.

We can tell this a few different ways. If you see "streama.mv.db" and "streama.trace.db" files, prior to downloading the newer version, you're likely using the Java H2 database type (and NOT MySQL).

However if you do not see those files in the same directory as streama, then run: mysql -u <USER> -p <PASSWORD> to log into MySQL console. From there, run: show databases and you should see a streama database. So that means you're using MySQL.

2. Download the newest Streama version AND the application.yml file.

3. Configure application.yml

Configure the application.yml file to use either the flat files (streama.mv.db, etc) OR the MySQL option. If you do need to use MySQL, you must comment out the "org.h2.Driver" section. If you use the MySQL section, you must put in the login and password for Streama.

4. Run Streama.

5. Check settings were ported

Go to the web interface at [IP address]:8080 , and log in. Now check that your settings are appropriately ported. If they are not, stop Streama and verify that the application.yml is pointing at the correct type of Database, and that it can log in.


ℹ️ If something didn't work or you want to improve the workflow, see FAQs below.