Running Uberfire Showcase

This guide will help you install an UberFire demo application on your own computer. This will help let you try out an UberFire application and see our show case demo.

Get an app server

The pre-built UberFire Showcase Web App is available for JBoss AS 7.1.1, EAP 6.2, and Tomcat.

If you don’t already have one of these app servers installed on your computer, don’t worry. In all cases, installing is as easy as downloading and unzipping.

Wildfly 8.1 Download
Tomcat 7 Download

Once the file has finished downloading, unzip it wherever you like.

Start the app server

Now start the app server using a command line terminal. Use the cd command to change the working directory of your terminal to the place where you unzipped the application server, then execute one of the following commands, based on your operating system and choice of app server:

Server *nix, Mac OS X Windows
WildFly bin/standalone.sh bin\standalone.bat
Tomcat bin/startup.sh bin\startup.bat

Then visit the URL http://localhost:8080/ and you should see a webpage confirming that the app server is running.

Get the pre-built WAR file

Now download the pre-built WAR file for the server you’ve installed and started.

Wildfly Download
Tomcat 7 Download

Note: If you find that the war file has limited functionality, e.g. some perspectives do not work correctly, please build it from source.

Build from source

You can build your archetype from the lastest source.

$ git clone git@github.com:uberfire/uberfire.git
$ cd uberfire
$ mvn clean install

The war's will be located at:

../uberfire/uberfire-showcase/showcase-distribution-wars/target

Deploy the WAR

Rename the downloaded WAR file to uberfire-showcase.war and copy it into the auto-deployment directory for your app server:

Wildfly 8.1 standalone/deployments/
Tomcat 7 webapps/

Example: Wildfly 8.1 on Unix/Linux/Mac:

$ mv ~/Downloads/showcase-distribution-wars-0.4.0-20131125.172155-223-jboss-as7.0.war standalone/deployments/uberfire-showcase.war

You should notice some disk activity, and if you’re using Wildfly, you will see some logging on the console where you started the server. Tomcat logs only to files by default, so you won’t see logs in your Tomcat terminal at this stage.

See it work!

Now visit http://localhost:8080/uberfire-showcase/ and sign in with username admin, password admin.

showcase

Once you’re logged in, here are some things to try:

  • Try switching perspectives in the perspective menu.

  • On Home Perspective, try dragging a view clicking on TODO List and moving it from one panel to another.

  • Try adding a new location for views by dragging a view near the edge of the screen.

  • See some useful features on Screens menu..

What's next?

Now that you’ve created and deployed an UberFire app and had some hands-on time with it, why not create a more complex App? Our tutorial guide provides a detailed walkthrough to create a Task Manager using Uberfire.

results matching ""

    No results matching ""