User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

Adding an HTTP Listener

This simple guide describes how to setup a new HTTP online listener. Listeners handle web service requests and are sometimes referred to as ports.

Listener configuration is maintained in Files > etc > mdm.serverConfig (in your MDM project).

A server usually has at least one HTTP listener configured (named default) to enable access to the administration web console and data providing using native services (assuming a service endpoint is defined). To add a new HTTP listener, edit the proper configuration file by adding a listener element into the HttpDispatcher component like in the definition shown below (use XPath: //component[@class="com.ataccama.dqc.web.HttpDispatcher"]/listeners).

The listener must have a unique name and port in the component definition. The configuration allows other optional attributes enabling SSL, filtering, and buffering requests into workerqueues.

It is a good practice to configure one listener for administration purposes to enable the access to the web console and online command requests (like start batch load, switch to read-only mode and so on) at any time, and to have another port available for data-providing native services with a designated worker configuration.
<component class="com.ataccama.dqc.web.HttpDispatcher">
    <listeners>
        <listener name="default" port="8888" threads="10" ssl="false">
            <handlerSecurity class="com.ataccama.dqc.web.security.KeycloakSecurity">
                <interceptUrls>
                    <interceptUrl pattern="/xmlRpcOverHttp/**" access="permitAll"/>
                    <interceptUrl pattern="/soapOverHttp/**" access="permitAll"/>
                </interceptUrls>
                <deploymentContexts/>
            </handlerSecurity>
        </listener>
    </listeners>
    <filters/>
    <workerQueues>
        <worker name="wq_default"
            maxQueueSize="1000"
            threadNumber="10"
            timeout="60000"
            healthStateRefreshRate="45000"
            healthStateRecoveryTimeout="90000"
            shutdownTimeout="5">
            <mappings>
                <mapping listener="default" urlPattern="/soapOverHttp"/>
            </mappings>
        </worker>
    </workerQueues>
</component>

Was this page useful?