Configuring the Tomcat Server

Extracting the Tomcat Server

You can only extract the Tomcat server after you manually install Tez. Tez has a built-in Tomcat Server archive with the latest version. You can find the archive at:

$TEZ_HOME/tomcat/tomcat.tar.gz

To extract the Tomcat server, use these commands in the command line:

cd $TEZ_HOME/tomcat/
sudo tar -zxvf tomcat.tar.gz -C $TEZ_HOME/tomcat

Change the permissions for the /tomcat directory to the user who will be running the Tomcat server:

sudo chown -R <$USER>:<$USER_GROUP> $TEZ_HOME/tomcat

Configuring the Timeline Server Base URL and Resource Manager WEB URL

To set the timelineBaseUrl and RMWebUrl, update the Tez configuration file.

For EEP 6.2.0 and earlier, the file location is:

nano $TEZ_HOME/tomcat/apache-tomcat-<version>/webapps/tez-ui/config/configs.env

For EEP 6.3.0 and later, the file location is:

nano $TEZ_HOME/tomcat/apache-tomcat-<version>/webapps/tez-ui/config/configs.js

To configure the Timeline Server Base URL and Resource Manager WEB URL:

Replace TIME_LINE_BASE_URL with the real URL, for example:
- For a non-secure configuration:
```
'http://localhost:8188'
```
- For a secure configuration:
```
'https://localhost:8190'
```
Replace RM_WEB_URL with the real URL, for example:
- For a non-secure configuration:
```
'http://localhost:8088'
```
- For a secure configuration:
```
'https://localhost:8090'
```
- For a proxy server, specify the user-defined URL in the yarn-site.xml file, as shown:
```
<property>
   <name>yarn.web-proxy.address</name>
   <value><hostname>:<port></value>
</property>
```
  Replace RM_WEB_URL with the value specified as the yarn.web-proxy.address property.

Configuring SSL for the Tomcat Server on a Secure Cluster

To start the Tomcat server with the exposed SSL port, edit the following properties in the $TEZ_HOME/tomcat/apache-tomcat-<version>/conf/server.xml file, replacing <ssl-keystore-password> with the real SSL keystore password.

Find the default configuration of the exposed port:

<Connector port="9383" 
  protocol="HTTP/1.1"
  connectionTimeout="20000"
  redirectPort="8443" />

Change the configuration for SSL:

<Connector port="9393" 
SSLEnabled="true"
maxThreads="150" 
scheme="https" 
secure="true" 
clientAuth="false" 
sslProtocol="TLS"
keystoreFile="/opt/mapr/conf/ssl_keystore"
keystorePass="<ssl-keystore-password>"/>

Starting and Stopping the Tomcat Server

To start the Tomcat server, run this script:

$TEZ_HOME/tomcat/apache-tomcat-<version>/bin/startup.sh

To stop the Tomcat server, run this script:

$TEZ_HOME/tomcat/apache-tomcat-<version>/bin/shutdown.sh

NOTE The timelineBaseUrl maps to the YARN Timeline Server, and the RMWebUrl maps to the YARN Resource Manager. For default port information, see Ports Used by MapR Data Platform Software.