Forschungs- und Informationsplattform: Online-Propaganda

by Mirko Scherf (Johannes Gutenberg University Mainz) and Dr. Jens-Martin Loebel (bitGilde IT Solutions UG)

Apache 2.0 License

Table of Content

• Local installation (using software as end user) - Windows
• Local installation (using software as end user) - Linux
• First Steps (Windows + Linux)
• Server installation (for development and web based usage)

Getting started (for further development)

git clone https://github.com/mirkoscherf/FIPOP/ new-project

Local installation (using software as end user) - Windows

• Download the repository and extract the source code to a folder of your choice
• Download and install XAMPP-Stack
  • Start Apache and MySQL (via Control Panel)
• Open PHPMyAdmin in your browser and create a database 'FIPOP' and make sure the collation is set to 'utf8mb4_general_ci'
  • Create a user account and set a password for this database
  • Import the fipop.sql file located at \src\resources\
    • Disable 'Enable foreign key checks' flag
• Download and install ffmpeg
  • ffmpeg is used to convert video and audio files and to create preview thumbnails for the video progress bar. This feature is not implemented for Windows as it is currently only triggered via cron.job on Linux. This Software works without, as the original medium file is used when uploaded as long as the converted files are not available, but there are no preview thumbnails available.
• Download and install maven
  • Run mvn package in console while in the root folder of the extracted source code
    • This creates a TIMAAT.war file located in \target subfolder
  • Copy the war-file to the 'webapps' folder of your tomcat installation (e.g. C:\xampp\tomcat\webapps)
• Copy 'timaat-default.properties' from \src\resources\ and save it as 'timaat.properties' in a new folder named '.timaat' in '%HOMEDRIVE%%HOMEPATH%'
• Edit and adjust timaat.properties parameters:
  • Remember to use \ instead of \ when determining directory paths
  • Set 'storage.location' to the path where you want your uploaded media files to be stored
  • Set your 'database.user' and 'database.password' credentials
  • Adjust your 'database.url' if your database is not called FIPOP
  • Set 'app.ffmpeg.location' to the path of your ffmpeg installation's bin folder (e.g. C:\ffmpeg\bin\)
• Start Tomcat (via Control Panel)
  • Tomcat will extract the TIMAAT.war file and creates a TIMAAT folder in the tomcat's webapps folder. This will take a couple of seconds.

Local installation (using software as end user) - Linux

• Download the repository and extract the source code to a folder of your choice
• Download and install LAMPP-Stack
  • Start Apache and MySQL services
• Create a database 'FIPOP' and make sure the collation is set to 'utf8mb4_general_ci'
  • Create a user account and set a password for this database
  • Import the fipop.sql file located at /src/resources
• Download and install ffmpeg
  • ffmpeg is used to convert video and audio files and to create preview thumbnails for the video progress bar.
• Download and install maven
  • Run mvn package in the root folder of the extracted source code
    • This creates a TIMAAT.war file located in /target subfolder
  • Copy the war-file to the 'webapps' folder of your tomcat installation
• Copy 'timaat-default.properties' from /src/resources and save it as 'timaat.properties' in '/root/.timaat'
• Edit and adjust timaat.properties parameters:
  • Set 'storage.location' to the path where you want your uploaded media files to be stored
  • Set your 'database.user' and 'database.password' credentials
  • Adjust your 'database.url' if your database is not called FIPOP
  • Set 'app.ffmpeg.location' to the path of your ffmpeg installation's bin folder
• Start Tomcat service
  • Tomcat will extract the TIMAAT.war file and creates a TIMAAT folder in the tomcat's webapps folder. This will take a couple of seconds.

First Steps (Windows + Linux)

• Open http://localhost:8080/TIMAAT in web browser
• Log in as 'admin' with password 'ChangeMeAfterYourFirstLogin!'
• Change admin password
• Create a new user
• Log out and log in as the newly created user

Server installation (for development and web based usage)

• git clone the project
• You need to install
  • Apache2
  • Tomcat 10
  • MySQL or MariaDB
  • ffmpeg
  • maven
• Create a database 'FIPOP' and make sure the collation is set to 'utf8mb4_general_ci'
  • Create a user account and set a password for this database
  • Import the fipop.sql file located at /src/resources
• Copy 'timaat-default.properties' from /src/resources and save it as 'timaat.properties' in '/root/.timaat'
• Edit and adjust timaat.properties parameters:
  • Set 'storage.location' to the path where you want your uploaded media files to be stored
  • Set your 'database.user' and 'database.password' credentials
  • Adjust your 'database.url' if your database is not called FIPOP
  • Set 'app.ffmpeg.location' to the path of your ffmpeg installation's bin folder
• Build your war file with mvn package
  • Make sure that tomcat knows where to look for the war file
• In /src/resources/scripts you can find two scripts for converting uploaded files to HTML5 compatible mp4 files and to create batch screenshots
  • you can use cron.job to run scripts regularly to check for finish any pending processes