Managing Tomcat web applications
Bankoi WebHost Panel supports deploying and managing Tomcat web application in order to enable users to set up hosting with JSP support. Click the TOMCAT button to access the Tomcat Web Applications Management page. At this page you can activate/deactivate the Tomcat service, upload the Tomcat web application archive files (.WAR files), start/stop/restart web applications, access and remove them.
IMPORTANT
Users can only manage the Tomcat web application through Bankoi WebHost Panel interface. Managing the web application through the Tomcat manager was disabled in order to maintain coherence of Bankoi WebHost Panel Tomcat configuration.
The status of Tomcat service and the status of Tomcat web application are represented by the following icons:
Table 13.3. The Tomcat service/web applications status icons
| Icon |
Meaning |
| The Tomcat service status |
|
|
means that the Tomcat service is activated |
|
|
means that the Tomcat service for the domain is presently deactivated. |
| The Tomcat web application status |
|
|
means that the web application is activated |
|
|
means that this web application is presently deactivated and inaccessible. |
|
|
means that web application is inaccessible. |
Activating/deactivating the Tomcat service
In order to disable the support of Tomcat web applications the Tomcat service can be deactivated. When the Tomcat service is deactivated, all active Tomcat web applications also change their status to 'inaccessible' while all inactive web applications remain unchanged.
Activation of the Tomcat service enables access to active web applications.
NOTE
When the Tomcat service is activated, the status icon will change to ![[ON]](img/on.gif)
, and so will the status icons of the Tomcat web applications at this domain that were active before deactivating the Tomcat service.
To activate/deactivate the Tomcat service:
- Click the ON/OFF button. The confirmation will appear querying whether you actually wish to change the status of the Tomcat service.
- Click OK to proceed with changing the status. Clicking Cancel will leave the Tomcat service status unchanged.
NOTE
It may take some time for the Tomcat service to get activated because of dependence between Tomcat and Apache services. The Tomcat service will be activated next time Apache is restarted.
Uploading Tomcat web application archive files
To upload a new Tomcat web application archive file, follow these steps:
- Select the web application archive file. Use the Browse button to locate the desired file.
NOTE
Only .war format (Web-application archive) files can be uploaded. The application file cannot be named as manager.war
- Click ADD. The new web application will be uploaded and added to the Tomcat web applications list.
Restarting the web applications
You can restart the Tomcat web applications directly from the control panel. In order to stop, start or restart a web application follow these steps:
- Select the web application at the Tomcat web applications list on the Tomcat Web Applications Management page.
- To start the web application: click on the
![[UP]](img/up.gif)
icon (Start the web application).To stop the web application: click on the ![[DOWN]](img/down.gif)
icon (Stop the web application).
To restart the web application: click on the ![[RESTART]](img/restart.gif)
icon (Restart the web application).
The current web application state will be marked by an icon: (ON) for the web application running, and ![[ON]](img/off.gif)
(OFF) for the web application stopped.
Accessing the Tomcat web applications
A Tomcat web application can be accessed simply by clicking on its name in the Tomcat web applications list. The selected application will be opened in a new browser window.
NOTE
If a web application is disabled, it cannot be accessed, an therefore, the link to it is also disabled.
Removing web applications
You can remove one or several web applications at the same time. To remove a web application(s):
- Check the checkboxes in the Sel column of the Tomcat web applications list corresponding to the web applications you wish to remove.
- Click on REMOVE SELECTED. The Web Application Removal page appears.
- If you are certain that the displayed information is correct and wish to proceed with deleting, check the "Yes, I wish to remove these tomcat web applications." checkbox. Then click SUBMIT. If you decide to not delete these web applications or wish to modify the list of web applications chosen for deletion, click the CANCEL button.
Both buttons will return you to the Tomcat Web Applications Management page, one committing the changes, the other one leaving everything unchanged.
![[ ! ]](img/att.gif)
