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.
For trial users:
- If you haven’t already, sign up for BuildVu trial.
- Open the email you receive when you signed up.
- Follow the download link found in the Docker section.
- Visit the Customer download page.
- Click on ‘Download Latest Customer WAR’.
- Submit your username and password.
Build a copy of our BuildVu Microservice Example project.
Instructions can be found on the GitHub page.
- Download and install Tomcat. (Versions tested: 8.5.x, 9.0.x, 10.0.x)
- Copy the built .war file into the
apache-tomcat-x.x.x/webapps-javaee/for Tomcat 101).
- Tomcat will then automatically deploy the application upon startup, using the name of the .war file as the context path.
- Open a command line/terminal window and navigate to apache-tomcat-x.x.x and run the command
bin/startupwhich will start the server on port 8080.
- Check the
RUNNING.txtfile supplied with Tomcat for detailed instructions.
- Check the
- You can check if the web app has successfully deployed by navigating to its URL in your browser e.g.
http://localhost:8080/buildvu-microservice. The page displayed should be blank white with
BuildVu Microservice Examplewritten in the centre.
1 Tomcat 10 has moved from Java EE 8 to Jakarta EE 9. Upon startup Tomcat 10 will then automatically convert war files in webapps-javaee to a Jakarta web application and deploy it, using the name of the .war file as the context path.
You can interact with the BuildVu Microservice Example using the REST API (See the GitHub page for details).
For specific languages, see our tutorials.
Note: Viewing / downloading the converted output may not work on the first try - this is usually because Tomcat has not yet registered the new directories created by the web app. To fix this, simply restart your Tomcat server.
Still need help? Send us your questions.