wiki:BMLC2Web

Web BMLC2GUI

The purpose of the Web BMLC2GUI is to provide a Web front end for BML documents. It is an extension of the original BMLC2GUI. Clients on both desktop and mobile browsers may use the interface to:

  1. Review and edit an order
  2. Post an order to an SBMLServer.
  3. View geographical information from the order on a map

Download

The Web BMLC2GUI may be checked out from the Subversion repository at  https://netlab.gmu.edu/svn-m/OpenBML/BMLC2GUI/branches/BMLC2Web/

Requirements

The following software is required:

  1. Java EE 6
  2.  Apache Tomcat
  3.  JAXFront

Installation

The directions below indicate how to install the Web BMLC2GUI server on Windows.

  1. Download and install Apache Tomcat if you have not already done so. Navigate to  http://tomcat.apache.org, select "Tomcat 7.0" under "Download", and find the appropriate installer under "Core."

We will refer to the top-level directory of the Tomcat installation as CATALINA_HOME. On Windows, using the installer, the default location of this directory is C:\Program Files (x86)\Apache Software Foundation\Apache Tomcat 7.0.

  1. Get the latest version of BMLC2Web by checking out the SVN repository at  https://netlab.gmu.edu/svn-m/OpenBML/BMLC2GUI/branches/BMLC2Web/
  1. Create a directory under CATALINA_HOME/webapps called BMLC2Web. Take the build/web directory from the checkout of BMLC2Web and place all of its files and folders into the directory you just created.
  1. To configure the application, edit webapps/BMLC2Web/WEB-INF/web.xml under CATALINA_HOME. The most important setting is the web-app/servlet/init-param with name 'sbmlServerName'. This is the IP address of the SBML server. It should be able to support SOAP requests; i.e., if your server is called bml-server, then  http://bml-server:8080/SBMLServer/SBMLServices?wsdl should successfully bring up a WSDL file. Note that administrative privileges may be required to save the updated file.

You may need to restart Tomcat for some of the changes to take effect.

  1. Make sure Tomcat is running. On the Windows installer, you can check this by going to Start -> All Programs -> Apache Tomcat -> Configure Tomcat. Press "Start" if it is not grayed out.

You should see a page telling you that Tomcat installation is successful when navigating to the URL  http://localhost:8080 on that machine.

  1. Bring up the directory /BMLC2Web on Tomcat; e.g., navigate to the URL  http://localhost:8080/BMLC2Web

After a few seconds, you should see a form for inputting an operation order via JAXFront, as well as a map. There should also be a Push Order button.

The OPORD that is loaded and pushed can be changed by editing the file OPORD_GMU_NATO.xml under CATALINA_HOME/webapps/BMLC2Web.