Installing

Installation

Initial steps - most are one-time

If you already have a JDK (Java Development Kit) and a Java application server installed and you've downloaded or built a self-contained package with all the required libraries inside (the default), you can skip this step.

To install the requirements:

1. Install a Java Development Kit,
2. Install a chosen Java Enterprise application server or a so-called servlet container,
3. Add the JAR files listed in the pom.xml file in the Fronsetia package in the versions given there (and their dependencies) to your server's CLASSPATH.
   The exact location depends on your server. Examples:
   • Apache Tomcat: apache-tomcat-x.y.z/lib,
   • Eclipse Jetty: perhaps $JETTY_BASE/webapps, but it seems better to build a self-contained WAR file,
   • WildFly: wildfly-x.y.z/standalone/lib/
   • Eclipse GlassFish: glassfishX/glassfish/domains/<domain name>/lib/
4. Restart the server after installing the JAR libraries.

JakartaEE/JavaEE server configuration

Consult your JakartaEE/JavaEE server manual about how to configure your particular server for deployment of applications, like creating a domain (if needed), creating managed servers (if needed), etc.

For Eclipse Jetty, you need to create a base directory you will be deploying the application to. To do that (in bash syntax):

• unpack the Jetty distribution
• run cd jetty-home-x.y.z
• run export JETTY_HOME=$(pwd)
• run mkdir base-dir (or use your chosen name)
• run cd base-dir
• run export JETTY_BASE=$(pwd)
• run java -jar $JETTY_HOME/start.jar --add-module=server,http,deploy,ee-webapp,ee10-jsp,ee10-deploy (in versions earlier than 12: java -jar $JETTY_HOME/start.jar --add-module=server,http,deploy,webapp,jsp) to create the server configuration
• run java -jar $JETTY_HOME/start.jar to start the server

Fronsetia installation

To install Fronsetia, just deploy the fronsetia-web-x.y.z.war file on your application server. The exact method depends on your server.
Examples:

• Apache Tomcat: copy the WAR file to apache-tomcat-x.y.z/webapps (or deploy manually using the server console)
• Eclipse Jetty: copy the WAR file to $JETTY_BASE/webapps
• WildFly: copy the WAR file to wildfly-x.y.z/standalone/deployments (or deploy manually using the server console)
• Eclipse GlassFish: copy the WAR file to glassfishX/glassfish/domains/<domain name>/autodeploy/ (or deploy manually using the server console)