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

HTTP Server Configuration

This guide describes how to set up a new HTTP server port. Server ports handle web service requests and were previously referred to as listeners.

Default configuration

Port configuration is maintained in mdm-server > etc > application.properties (for more information, see MDM Server Application Properties).

An MDM server usually has one HTTP port configured (named default).

Default HTTP port configuration

#MDM HTTP server
ataccama.server.http.default.port=8051

The configuration allows other optional properties enabling SSL authentication.

All MDM endpoints are exposed on the same port by default, which means the listeners attribute of the HttpDispatcher component needs to be set to all, for example:

<component listeners="all" disabled="false" class="com.ataccama.dqc.online.OnlineServicesComponent">

If used in the Runtime Server context, the property can still be used.

Advanced configuration

You can add another HTTP server port by adding the property ataccama.server.http.{listener_name}.port to MDM Server Application Properties.

Endpoints can be distributed among different server ports using path.exclude and path.include options as shown in the following example. Server port values and names must be unique.

Using multiple ports has its drawbacks:

It is usually not needed to define more HTTP ports since all MDM endpoints are exposed on the same port by default.
Other related settings do not expect more server ports:
- SSL is set for all server ports.
- If you are defining other advanced properties, all server ports are affected.
- High availability can forward requests just to one server port.

Advanced HTTP port configuration

#MDM HTTP server
ataccama.server.http.default.port=8051
ataccama.server.http.default.path.exclude=/,/console/**,/api/rest/**,/ha/console/**,/ha/rest/**
ataccama.server.http.console.port=8052
ataccama.server.http.console.path.include=/,/console/**,/sso/**,/health
ataccama.server.http.rest.port=8053
ataccama.server.http.rest.path.include=/api/rest/**
ataccama.server.http.ha-console.port=8054
ataccama.server.http.ha-console.path.include=/ha/console
ataccama.server.http.ha-rest.port=8055
ataccama.server.http.ha-rest.path.include=/ha/rest

#MDM HA configuration
ataccama.one.mdm.ha.load-balancer.port=8058
ataccama.one.mdm.ha.local-target-server.name=rest

Was this page useful?