- Java JDK 1.8 or higher
- Maven 3.3+ (recommend latest)
- Git (binary packages coming soon
Install Fedora using the instructions found here
Follow the regular instructions for Fedora
Assuming Java JDK 1.8 has already been installed, enter the following commands into a window of the Terminal
application:
$ xcode-select --install
$ brew install maven
$ sudo dnf install -y java-1.8.0-openjdk-devel maven git
$ sudo yum install -y java-1.8.0-openjdk-devel maven git
$ sudo apt-get -y install openjdk-8-jdk maven git
$ sudo apt-get -y install openjdk-8-jdk maven git
Some tests have found with issues Ubuntu 18.04, running this bash command should fix them
sudo /var/lib/dpkg/info/ca-certificates-java.postinst configure
Using the package manager chocolatey:
- Run PowerShell or Command Prompt as an administrator
- Run:
choco install maven git
-
$ mkdir -p ~/git
-
$ cd ~/git
-
$ git clone 'http://gitlab.mccollum.enterprises/icing/media.git'
-
$ cd media
Change to the directory ($ cd ~/git/media
)
Run with:
$ ./icing.sh
(this will create database files named icing-database.h2.db
and icing-database.trace.db
to store your data)
- Open the command prompt
- Use the
cd
command to change to the directory where icing was downloaded - Run with:
mvn wildfly-swarm:run
- For convenience, you could put this command into a
*.bat
file in that directory
Change to the directory ($ cd ~/git/media
)
Create a war for deployment with:
$ mvn clean -DskipTests package
You will now find a file called icing.war
in the target
folder created by performing the package operation. This is the file you will be deploying.
Using the instructions for your app server (we are using Wildfly 10+ for development and testing), perform the following tasks:
-
Create a JPA data source with the JNDI name
java:/icing-media
-
If using MySQL or MariaDB, perform the following database setup in the MySQL/MariaDB console (replace
icing
with the name of your database):ALTER DATABASE icing DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
Deploy the
icing.war
file to your app server using the instructions on its website (different for Wildfly/JBoss, Glassfish/Payara, etc.)
-
Stop icing if it is running
-
Change to the directory where it exists (for example:
$ cd ~/git/media
) -
$ ./icing.sh update
#This will update icing and run it again