Section 1
Introduction

Section 2
Configuring for First Use

Section 3
Changing Admin Password

Section 4
Creating Accounts

Section 5
Global Component Settings

Section 6
Backups

Section 7
Log Files

Section 8
User Interface Settings

Section 9
Database Connections

Section 10
Non-Standard Ports

Section 11
Firewalls

Section 12
SSL

Section 13
Tracking and Recipient Profiles

Section 14
Editing INI Files

Section 15
Distributed Components

Section 16
User Interface Branding

Section 17
International Character Sets

Appendix A
Standard Default Ports

Section 10
Using Non-Standard Ports

The components of LISTSERV® Maestro use a number of ports to communicate with each other and with the external world. The ports used are standard ports and will work well under most circumstances. Under certain conditions it may be desirable to change one or several of the ports to other ports, for example, if another application installed on the same server already uses one of the ports LISTSERV® Maestro wants to use. Changing ports may require editing certain INI files. For more information on editing LISTSERV® Maestro INI files see Section 14 Editing LISTSERV® Maestro INI Files.

10.1 Ports used by LISTSERV® Maestro

This list contains the individual ports used by each of the LISTSERV® Maestro components.

10.1.1 Ports used by the Administration Hub

The Administration Hub uses three different ports:

For HTTP access to the Administration Hub user interface (via a web browser), the Administration Hub uses the standard HTTP port 80.

For internal communication with the other components, the Administration Hub uses port 1099.

For shutdown of the application server, the Administration Hub uses port 8007.

10.1.2 Ports used by the Maestro User Interface

The Maestro User Interface uses five different ports:

For HTTP access to the Maestro User Interface (via a web browser), the Maestro User Interface uses the standard HTTP port 80.

For internal communication with the Administration Hub, the Maestro User Interface uses port 1099.

To receive the tracking events collected by Maestro Tracker, the Maestro User Interface uses port 7000.

For the internal database connection, the Maestro User Interface uses port 3306.

For shutdown of the application server, the Maestro User Interface uses port 8007.

10.1.3 Ports used by Maestro Tracker

Maestro Tracker uses three different ports:

To collect the tracking events from mailings sent with the Maestro User Interface, Maestro Tracker uses the standard HTTP port 80.

For internal communication with the Administration Hub, the Maestro User Interface uses port 1099.

For shutdown of the application server, Maestro Tracker uses port 8007.

10.2 Configuring Port Usage

If any of the ports described in the previous sections are already in use on the server where the LISTSERV® component is installed, it is possible to change the use of this port. Note that some components make use of the same port as other components. This is not a problem between the different components of LISTSERV® Maestro. If there are several components on the same server, then these components share usage of these ports (port 80 for HTTP access and port 1099 for internal communication for example). It is not necessary or even possible to configure one component to use a different port than the other while the components are on the same server.

10.2.1 Configuring the HTTP Port

To configure the HTTP port, edit the following file:

\Program Files\L-Soft\Application Server\conf\server.xml

In this file there is an XML-entry for the "Normal HTTP" connector (this is close to the end of the file, immediately following the

<!-- ====== Connectors ======= -->" header). An example of this entry is shown below:

<!-- Normal HTTP -->
<Connector className="org.apache.tomcat.service.PoolTcpConnector">
<Parameter name="handler" value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
<Parameter name="port" value="80"/>
</Connector>

The standard HTTP port "80" is used. Simply change this value to any port not currently in use by another application.

If there are several LISTSERV® Maestro components installed on the same server, then they will all be affected by this change. It is not possible to use different HTTP ports for each of the components if the components are installed on the same server. However, if the components are installed on different servers, they can use different HTTP ports. It is important to note that these changes will only be effective after a restart of the component in question.

When changing the HTTP port, there are a few issues to be aware of: If the HTTP port is changed on a particular server where it affects the Maestro Tracker component (where this component is installed), then it is also necessary to change the Tracking URL - HTTP Port settings in the Administration Hub, either by editing the global component settings or on the group or single user level.

If the HTTP port is changed on the server where it affects the Administration Hub component, then it is necessary to edit the Maestro User Interface INI file. One the server where the Maestro User Interface component is installed edit the file:

\Program Files\L-Soft\Application Server\lui\lui.ini

Edit or add the entry "HubHTTPPort" (if the entry is not present or is commented out, it defaults to port 80).

The Maestro User Interface and the Administration Hub User Interface are both accessed via this HTTP port. This implies that if this port were to be changed, it would no longer be possible to access these interfaces by entering their plain URL into the location field of a browser. Instead, it is necessary to add the port number :") to the URL. For example, if the HTTP port is changed to 8080, then the access URL will need to include the port number as shown below:

"http://your_host:8080/lui".

The shortcuts to access the Maestro User Interface and the Administration Hub User Interface that are installed in the Windows start menu do not include any port information. They expect the user interfaces to be accessible on the standard port 80. If this port is changed, then it is necessary to edit these shortcuts and add ":yourPort" to the URL, as described above.

If LISTSERV® Maestro is installed behind a firewall (which is advisable) and the Maestro User Interface and/or the Administration Hub User Interface needs to be accessible from a computer outside the firewall, the firewall must be configured to allow access on the configured port instead of the standard HTTP port.

Similarly, if the Maestro Tracker component is installed behind a firewall, then the firewall must be configured to give all outside users access to the server where Maestro Tracker is installed on the port that is configured for HTTP access. This is normally port 80, or can be a different port, if the port was changed as described above.

The whole tracking mechanism of LISTSERV® Maestro will not work if the Maestro Tracker component is installed behind a firewall in a way that outside clients do not have access to its configured HTTP port.

10.2.2 Configuring the Internal Communication Port

This port can be configured independently for each component. However, if the components are installed on the same server, than they must all use the same internal communications port.

To configure the communication port for the Administration Hub component, edit the following file:

    \Program Files\L-Soft\Application Server\hub\hub.ini

    Edit or add the entry "RMIPort". If the entry is not present or is commented out, the component defaults to port 1099. For example: RMIPort=5310. In addition, it is necessary to edit the INI-file of each component that works together with this Administration Hub component. This is usually one Maestro User Interface and one Maestro Tracker component.

    For the Maestro User Interface, edit the file:

    \Program Files\L-Soft\Application Server\lui\lui.ini

    Edit or add the entry "HubRMIPort". If the entry is not present or is commented out, the component defaults to port 1099.

    For Maestro Tracker, edit the file:

    \Program Files\L-Soft\Application Server\trk\tracker.ini

    Similarly, in this example, edit the entry "HubRMIPort" in the same way as described above for the Maestro User Interface component.

To configure the communication port for the Maestro User Interface, edit the following file:

    \Program Files\L-Soft\Application Server\lui\lui.ini

    Edit or add the entry "RMIPort". If the entry is not present or is commented out, the component defaults to port 1099. Example: RMIPort=5310

To configure the communication port for Maestro Tracker, edit the following file:

    \Program Files\L-Soft\Application Server\trk\tracker.ini

    Edit or add the entry "RMIPort". If the entry is not present or is commented out, the component defaults to port 1099. Example: RMIPort=5310

    In addition, edit the Maestro User Interface INI file that communicates with the Maestro Tracker component. On the server where the Maestro User Interface is installed, edit the file:

    \Program Files\L-Soft\Application Server\lui\lui.ini

    Edit or add the entry "TrackerRMIPort"

10.2.3 Configuring the Tracking Event Notification Port

This port is only used by the Maestro User Interface component. It can easily be configured via the Administration Hub. Simply enter the Administration Hub and click the Global Component Settings link, then the Maestro User Interface link, and finally the General Settings link. It is possible to edit the port from here. Click OK to save. The change will be effective immediately.

10.2.4 Configuring the Internal Database Connection Port

This port is only used by the Maestro User Interface component. To configure it, edit the following file:

\Program Files\L-Soft\Application Server\lui\my.ini

In this file, find the entry "port" both in the "[client]" and "[mysqld]" sections. Edit the value of both of these entries to change the database connection port. In addition, edit the following file:

\Program Files\L-Soft\Application Server\lui\lui.ini

Edit the "MySQLDriverPlugin.databasePort" entry to point to the same port number. These changes will only be effective after restarting the Maestro User Interface component.

10.2.5 Configuring the Application Server Shutdown Port

To configure the application server shutdown port, edit the following file:

\Program Files\L-Soft\Application Server\conf\server.xml

This file contains an XML-entry similar to the following example, close to the end of the file.

<!-- Apache AJP12 support. This is also used to shut down tomcat. -->
<Connector className="org.apache.tomcat.service.PoolTcpConnector">
<Parameter name="handler" value="org.apache.tomcat.service.connector.Ajp12ConnectionHandler"/>
<Parameter name="port" value="8007"/>
</Connector>

If port 8007 is already in use on the system, set the port number to a different value in this file.