Change the Name of the WAR File
By default, SuperWEB2 is deployed as a .war file called webapi.war.
When this is installed on Tomcat, it will extract to a directory called webapi, meaning that the URL to your SuperWEB2 deployment will contain /webapi/. For example:
You may wish to change the name of the SuperWEB2 .war file so that the URL of your instance reflects your branding and the name you have given to your data analytics and dissemination platform:
- If you are installing a new instance of SuperWEB2, simply rename the webapi.war file to your preferred name (for example superweb2.war) before copying it to the <tomcat_home>\webapps directory. When you start the SuperWEB2 or Tomcat service, the .war file will automatically be expanded to a directory with the same name as the .war. For example <tomcat_home>\webapps\superweb2
- If you have an existing SuperWEB2 installation, stop the Tomcat or SuperWEB2 service, then rename both the <tomcat_home>\webapps\webapi.war file and the current <tomcat_home>\webapps\webapi directory to match your preferred name. For example: <tomcat_home>\webapps\superweb2.war and <tomcat_home>\webapps\superweb2
There are a number of places in the SuperWEB2 configuration files where the /webapi/ part of the URL is hard-coded, so you will also need to make the following changes:
File | Changes Required |
---|---|
\help\metadataRedirect.html | If you are using static metadata pages, change webapi part of the Metadata base URL definition: var metadataBaseUrl = "/webapi/metadata/"; |
\WEB-INF\classes\configuration.properties |
|
\WEB-INF\web.xml |
|
In addition, if you are using the user registration system, change the base URL for links in registration emails. See Configure User Registration for more details.
When you have finished making these changes, restart SuperWEB2 or the Tomcat service.