Changing Tomcat web server settings

Steps to change the IP address for client connections to DSE Search.

To configure security for DSE Search, change the IP address for client connections to DSE Search using the HTTP and Solr Admin interfaces in the Tomcat web server.xml file.

cassandra.yaml

The location of the cassandra.yaml file depends on the type of installation:

Package installations
Installer-Services installations

/etc/dse/cassandra/cassandra.yaml

Tarball installations
Installer-No Services installations

installation_location/resources/cassandra/conf/cassandra.yaml

Tomcat server.xml

The default location of the Tomcat server.xml file depends on the installation type:

Package installations
Installer-Services installations

/etc/dse/tomcat/conf/server.xml

Tarball installations
Installer-No Services installations

installation_location/resources/tomcat/conf/server.xml

Procedure

Make configuration changes in the Tomcat server.xml file:

  1. Change the IP address for client connections to DSE Search.
    The default IP address that the HTTP and Solr Admin interface uses to access DSE Search is defined with rpc_address in the cassandra.yaml file.
    • The default rpc_address value localhost enables Tomcat to only listen on the localhos.
    • To enable Tomcat to listen on all configured interfaces, set rpc_address to 0.0.0.0.

    To change the IP address for client connections to DSE Search using the HTTP and Solr Admin interfaces, change the client connection in the following ways rpc_address in the cassandra.yaml file or create a Tomcat connector.

    Create a Tomcat connector:
    In the <Service name="Solr"> section of the server.xml file:
    <Connector 
        port="PORT" 
        protocol="HTTP/1.1" 
        address="IP_ADDRESS"
        connectionTimeout="20000" 
        redirectPort="8443" 
    />
    Change the rpc_address
    Change rpc_address in the cassandra.yaml file. The rpc_address is read on startup only.
  2. For advanced users only: In the Tomcat server.xml file, specify a client connection port other than the default port 8983. However, when specifying a non-default connection port, the automatic SSL connection configuration performed by DataStax Enterprise is not done. You must provide the valid connector configuration, including keystore path and password. See the DataStax Support article Configuring the DSE Solr HTTP/HTTPS port.
  3. After making changes, restart the node.