Deploy BuildVu with Jetty

Table of contents

1. Download or Build the WAR file
   1. Download the WAR file
   2. Build the WAR file
2. Deploying the web app
3. Usage

---

Download or Build the WAR file

Before getting started you need the WAR file which you can either download or build yourself.
This WAR file is required for the BuildVu service to work.

Download the WAR file

For trial users:

1. If you haven’t already, sign up for BuildVu trial.
2. Open the email you receive when you signed up.
3. Follow the download link found in the Docker section.

For customers:

1. Visit the Customer download page.
2. Click on ‘Download Latest Customer WAR’.
3. Submit your username and password.

Build the WAR file

Build a copy of our BuildVu Microservice Example project.
Instructions can be found on the GitHub page.

Deploying the web app

1. Download and install the latest version of Jetty 10 (Please note Jetty 11 and above is not supported due to their move to using Jakarta).
2. Create a new environment variable called JETTY_HOME for the Jetty home directory.
3. Create a directory to hold the jetty base content and enter that directory.
4. Set up the required modules using the following command.
   java -jar JETTY_HOME/start.jar --add-module=server,http,deploy,jsp
5. Move the war file into the webapps folder created in your jetty base directory.
   The name of the war file will be the base of your web app. For example, if the webserver is hosted at localhost:8080, buildvu-microservice.war will be deployed at localhost:8080/buildvu-microservice.
6. Start the Jetty server and navigate to the admin console in your browser.
   java -jar start.jar will start the server on localhost:8080

You can check if the web app has successfully deployed by navigating to its URL in your browser - you should see a blank white page with BuildVu Microservice Example written in the centre.

Usage

You can interact with the BuildVu Microservice Example using the REST API (See the GitHub page for details).

For specific languages, see our tutorials.