Install - SuperWEB2

These instructions explain how to install and set up the web server for SuperWEB2. If you are an end user of SuperWEB2 then you do not need to follow these steps–your system administrator will already have set up SuperWEB2; all you need to connect is your web browser. See the SuperWEB2 User Guide for more information.

These are the instructions for installing just SuperWEB2. Alternatively, you can install the SuperSTAR Suite, which installs all the SuperSTAR applications, including SuperWEB2, as part of a single install process.

• These instructions are for Microsoft Windows only.
• For full details of the system requirements for SuperSTAR, refer to Installation Requirements, Compatibility and Supported Platforms.
• SuperWEB2 requires the following third party software:
  • Apache Tomcat
  • Java Runtime Environment (JRE) 6 or 7

Step 1 - Install Tomcat

Before you can install SuperWEB2 you need to install Tomcat. You can either use an existing Tomcat installation, or you can use the Tomcat deployment that is supplied with SuperWEB2.

Space-Time Research recommends that you independently assess the security requirements for any network exposed computer application and take appropriate steps to protect it. The official Tomcat security FAQ is at http://wiki.apache.org/tomcat/FAQ/Security

For more information, see http://www.unidata.ucar.edu/Projects/THREDDS/tech/reference/TomcatSecurity.html

To install the Tomcat deployment supplied with SuperWEB2:

1. Extract the SuperWEB2 ZIP file.
2. Copy the Tomcat directory from the extracted files to the location where you want to install Tomcat and SuperWEB2.
   
   The standard installation location is C:\ProgramData\STR\SuperWEB2\Tomcat (this is the location used if you install SuperWEB2 using the SuperSTAR Suite installer), but you can choose a different location if you prefer.
   

   

Step 2 - Install SuperWEB2

1. Extract the SuperWEB2 ZIP file if you have not already done so.
2. Copy War Files\webapi.war from the extracted files to <tomcat_home>\webapps
   
   The location of <tomcat_home>\webapps will depend on where you have installed Tomcat on your system, but if you are using the standard installation location it will be C:\ProgramData\STR\Tomcat\webapps:
   

   

   
   webapi.war contains all the SuperWEB2 files. Its contents will be extracted to <tomcat_home>\webapps\webapi when you start Tomcat.
3. Copy tomcatLibs\spring-agent.jar from the extracted files to <tomcat_home>\lib
4. Go back to the files you extracted from the SuperWEB2 ZIP and locate the tomcatScripts directory.
5. Copy the four files from this directory (sw2.bat, sw2-install-service.bat, sw2-service.bat and sw2-uninstall-service.bat) to <tomcat_home>\bin:
   

   

6. If you are not using the standard SuperWEB2 installation location, you need to make a change to sw2.bat, sw2-install-service.bat and sw2-uninstall-service.bat.
   
   In each file, locate the following line:

   CODE

   set CATALINA_HOME=C:\ProgramData\STR\SuperWEB2\Tomcat

   Change the value of CATALINA_HOME to match the location of <tomcat_home> on your system.

7. Check that sw2.bat, sw2-install-service.bat and sw2-uninstall-service.bat specify the correct location of the Java Runtime Environment (JRE) on your system.
   
   In each file, locate the following line:

   CODE

   set JRE_HOME=C:\Program Files\Java\jre6

   Make sure this value matches the location of the JRE installed on your system.

Step 3 - Start Tomcat/SuperWEB2

You are now ready to start Tomcat and SuperWEB2. You can either start Tomcat manually or install it as a Windows Service that will start automatically when the machine starts.

Start Tomcat Manually

Go to <tomcat_home>\bin and execute sw2.bat. This script sets some standard environment variables and runs Tomcat.

If you do not want to use the supplied batch file, or you want to configure the environment variables, you can create your own script for running Tomcat.

Install the Windows Service

1. Go to <tomcat_home>\bin and execute sw2-install-service.bat. This will install a Windows service called SuperWEB2.

   

   You must execute sw2-install-service.bat with administrator permissions, otherwise it will not be able to install the Windows service.

   

2. Go to the Windows Services console and start the service.
   

   

Step 4 - Verify the Installation

Verify that SuperWEB2 is installed by opening a web browser. The default URL for SuperWEB2 is http://<hostname>/webapi or http://<hostname>:<port>/webapi (where <hostname> is the server running the SuperWEB2 application and <port> is the port to connect on).

By default, you should be able to connect to SuperWEB2 using http://localhost:8080/webapi

Verify that you can login to SuperWEB2 and open a database.

If this is a new installation you can login using the default user1 test account. Learn more about the default user accounts.

If you have installed SuperWEB2 on a different machine to SuperSERVER, you must configure the SuperWEB2 connection to SuperSERVER.

Step 5 - Post Install Configuration

Once you have completed the installation, there are a number of additional steps you may wish to take to complete the setup.

• Configure the User Data Repository. This is used to save user customisations to tables. By default, these are saved to an in-memory database. Although this is adequate for demonstration and testing purposes, it should be replaced with another RDBMS system such as MySQL or Oracle for production use. Learn More...
• If you anticipate that SuperWEB2 users will build and populate very large tables, consider implementing the Job Queue Manager. Learn More...
• Customise the SuperWEB2 interface for your branding requirements. Learn More...

Before going into production, you must set the facelets.DEVELOPMENT parameter in <tomcat_home>\webapps\webapi\WEB-INF\web.xml to false. Learn more...