Configuring ports for AX Server

In order for the ACL Analytics Exchange Geronimo service to start successfully on the AX Server server or AX Engine Node, you must ensure that the ports required by the Geronimo application server are not being used by other services or applications. Depending on your network configuration, your system administrator may also need to configure your firewall to allow connections from AX Client.

Ports required by the Geronimo application server

AX Server and AX Engine Node are installed with the default port settings used by the ACL Analytics Exchange Geronimo service. The ports listed in Table 1 are the default ports used by Geronimo components and must be available for the ACL Analytics Exchange Geronimo service to start successfully. The purpose of each port is briefly described.

**Table 1.** ACL Analytics Exchange Geronimo default ports
Port Number	Component Name	Description
1099	RMI Naming	Port used by Geronimo for finding internal structures managed by the application.
1527	Derby Connector	Port used to connect to the Derby database included with and used by the Geronimo framework.
4201	OpenEJB Daemon	Port used by Geronimo for communication with the application modules.
8009	Tomcat Connector AJP	Port used to connect to the Tomcat web server that is integrated into the Geronimo framework.
80	Tomcat Connector HTTP	Port used for unencrypted HTTP communication with the server.
443 or 8443	Tomcat Connector HTTPS	Port used for encrypted HTTP (HTTPS) communication with the server. If you are performing a new installation of AX Server, the default port is 443. If you are upgrading an earlier version of AX Server, the default port is 8443.
9999	JMX Remoting Connector	Port used for managing the Geronimo services and installed modules.
61613	ActiveMQ-Stomp	Port used for the asynchronous messaging system Geronimo uses.
61616	ActiveMQ Transport Connector	Port used for the asynchronous messaging system Geronimo uses.

If you are installing AX Server or AX Engine Node for the first time on a server, you should verify that the ports required by Geronimo are not in use before you run the installer.

Port required for PostgreSQL

The PostgreSQL service, which manages communications to the AX Server database, is installed on port 5432 by default. If this port is in use, you can specify a different port in the AX Server setup wizard. If you specify a different port you must ensure that it is not being used by another service. Also, if you are configuring a dual-server installation, you must ensure that the PostgreSQL database server and AX Server application server can communicate on this port.

Port required for AX Connector

By default the AX Connector service, used primarily to access AX Server tables that have been exported to ACL Analytics projects, is installed on port 10000. If this port is in use, you can specify a different open port in the Destination Folder and Settings page in the AX Server setup wizard. If you specify a different port you must ensure that it is not being used by another service.

Checking ports in use

To determine which ports are in use, type the following command on the command line and review the port numbers displayed:

NETSTAT -a

If any of the required ports are being used by another service, you need to either reconfigure the service to use a different port, or temporarily disable the service in Windows Services while you install AX Server. If necessary, you can modify some of the ports used by AX Server after the installation process is complete. For information on configuring port settings, see the ACL Analytics Exchange Server Administrator Guide

Configuring your firewall to allow AX Client and AX Web Client connections

If users are going to connect to AX Server from outside your network firewall, you need to configure the firewall to allow inbound connections on the specific ports required by the Geronimo application server and the AX Connector service. The following ports must be open in order for users to connect from outside the firewall:

Tomcat Connector HTTPS – This port is used to enable HTTPS connections to the web server for the AX Web Client and AX Server Configuration web applications, and for secure file transfers to and from AX Server. The default value for new installations is 443. The default value for servers upgraded from versions prior to 5.0.0 is 8443.
OpenEJB Daemon – This port is used to enable secure authentication of user credentials. The default value is 4201.
AX Connector – This port is used to enable access to AX Server tables from client computers through ACL Analytics. The default value is 10000.

Each client computer that connects to AX Server must also have the corresponding ports open for outbound communication.