Installing on Apache Tomcat

You can install QMF for WebSphere® on Apache Tomcat Java servlet container.

About this task

Perform the following steps to install QMF for WebSphere on Apache Tomcat.

Procedure

  1. Stop the Tomcat server and add the qmfadmin and the qmfuser roles in the <TOMCAT_INSTALL_DIR>/conf/tomcat-users.xml file.
    Example:
    <role rolename="qmfadmin"/>
    <role rolename="qmfuser"/>
    <user username="admin user" password="admin password" roles="admin-gui,manager-gui,qmfadmin,qmfuser" />
    <user username="websphere user" password="websphere  password" roles="qmfuser"/>
  2. Increase the max-file-size and max-request-size values in the <TOMCAT_INSTALL_DIR>/webapps/manager/WEB-INF/web.xml file to accommodate the size of the installation file that you wish to deploy.
    Example:
    <max-file-size>90000000</max-file-size>
    <max-request-size>90000000</max-request-size>
  3. Start the Tomcat server and launch the manager page using the http://<<domain-name>>/manager/html URL.
  4. Under WAR file to deploy, choose the QMF for WebSphere WAR file and click Deploy.

What to do next

If you want to hide the Tomcat version and name from the response error page, you can hide it by performing the following steps:
  1. Navigate to <Tomcat_INSTAL_DIR>/lib.
  2. Create org\apache\catalina\util\ folder structure and navigate to the util folder.
  3. Create ServerInfo.properties text file.
  4. Add the message text in the ServerInfo.properties file and Save the file. For example: You can add the message text as server.info=Not Available.
  5. Stop and start the Tomcat service.
Note: This configuration can be handled at the customer server level and no changes are required at the QMF code level.