salinashf / admin-showcase

AdminFaces Showcase - https://adminfaces.github.io/admin-showcase/

Admin Showcase

AdminFaces showcase application.

Table of Contents

• 1. Demo
• 2. Running locally
  • 2.1. Using an application server
  • 2.2. WildFly Swarm
  • 2.3. Docker
• 3. Testing
• 4. Documentation

1. Demo

Showcase is available on Openshift here.

❗	The demo runs on the Openshift starter which is a platform used just for testing and not for production. So it’s likely the showcase may be slow or even down.

2. Running locally

There are several ways to run Admin Showcase on your machine. Just clone this repository and use one of the alternatives described below.

2.1. Using an application server

Admin Showcase is compatible with most JavaEE 6 and Java EE 8 application servers.

Just build the application with maven using mvn clean package -DskipTests and deploy the resulting showcase.war into a JavaEE 6 or greater server.

ℹ️	No configuration is needed.

Following is the list of tested servers:

Supported Application Servers

This application is compatible with Java EE 6/7/8 application servers, tested with:

• WildFly 8.2.0 to 13.0.0

• JBoss EAP 6.4

• Tomee 7.0.2 Web profile and 1.7.4 Web

• Payara 4.1.1.164 Web profile

• WebSphere Liberty profile 16.0.0.4

❗	To run on JavaEE 8 application servers such as Wildfly 16 you’ĺl need to upgrade OmniFaces to version 3.x.

2.2. WildFly Swarm

This showcase is Wildfly Swarm compatible, just run the following command:

mvn wildfly-swarm:run  -Pswarm

and access http://localhost:8080/showcase.

2.3. Docker

You can run this showcase via docker through the following command:

docker run -it -p 8080:8080 rmpestano/admin-showcase

💡	use build.and-run.sh to easily run the application via docker.

3. Testing

To execute functional tests you need to activate the tests profile and choose the application server also using a maven profile, ex:

mvn clean package -P tests -P wildfly8-managed

By default tests run on chrome, to change the webdriver you need to use the property browser:

mvn test -Ptomee-remote -Dbrowser=phantomjs

⚠️	See the chrome driver version the tests are using here and update your chrome browser according to this page. (pay attention to the supports chrome label).

4. Documentation

Documentation can be found here: https://adminfaces.github.io/site/#Documentation