This documentation applies to the 8.1 version of BMC Atrium Core, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Understanding port numbers for an upgrade

 

 

Port numbers identify the TCP ports where the BMC Remedy AR System server and the plug-in server will run. The TCP port number for the BMC Remedy AR System server and the port number for the plug-in server cannot be the same.

In this topic:

Registering with a portmapper

A portmapper is a service that runs independently of the BMC Remedy AR System server and serves as a directory of port numbers.

When users log on to BMC Remedy AR System:

  • If a server is registered with a portmapper, users do not need to specify the port number in the client because the portmapper can locate the port and direct clients to the appropriate location.
  • If a server is not registered with a portmapper, or if a Port 111 firewall blocks the portmapper port, users must specify the port.

When you start the server, it opens a port to listen to. You can specify a port for the server or let the server obtain an available port dynamically.

You can register a server with a portmapper and assign a port number. For example, if you do this and do not expose the portmapper outside a firewall, clients within the firewall do not need to be configured to access the specified port number. They can access the portmapper, which directs them to the port. Clients outside the firewall must be configured to access the specified port number.

Note

The BMC Remedy AR System server does not have a default port or specific range of ports. The operating system randomly assigns ports. To make sure that the portmapper always uses the same port for the BMC Remedy AR System server, specify a port during installation or use the BMC Remedy AR System Administration Console to configure the server after you install it.

Portmapper and multiple servers

If you use portmapper for one server on the computer, you must assign TCP and plug-in port numbers to all the servers on the computer. (Only one BMC Remedy AR System server on any server can register with portmapper.) If you configure two or more servers to use portmapper by mistake, the last server to start is the only one registered and available for login without identifying a TCP port from the Login window.

If you want to configure two or more servers on one Microsoft Windows computer, make sure that all the servers on the computer have unique port numbers and are not registered with portmapper.

Note

If you plan to use the portmapper with a server group installation, indicate Yes for the Register with the Portmapper prompt during the AR System server installation. If you do not specify Yes for Register with the Portmapper prompt, then the AR System server does not use portmapper.

Detecting a portmapper

On Microsoft Windows, the AR System installer searches for an existing portmapper. If a portmapper is installed and running and you choose to register with a portmapper, the BMC Remedy AR System registers the server with that portmapper. If the installer does not detect a running portmapper and you chose to register with portmapper, the installer installs the portmapper and registers the AR System server with that portmapper.

Note

By default, Microsoft Windows 2008 comes with a portmapper installation. If you want to use the BMC Remedy AR System portmapper, you must uninstall the portmapper provided by Microsoft and then continue with the BMC Remedy AR System installation; otherwise you can continue with the BMC Remedy AR System installation without the BMC Remedy AR System portmapper.

Assigning port numbers

If you do not register with a portmapper, you must assign a port number to any AR System server that you want clients to access directly, and to the plug-in server.

Important

Do not assign port numbers that conflict with port numbers used by other applications or other programs running on your system. To find out which port numbers are already in use, use the netstat -na command (UNIX) or the netstat -a command (Windows) at the command prompt.

Assign port numbers greater than 1024 because:

  • Port numbers within the range 1 – 1024 are available for use only by the superuser, and many of these numbers are reserved.
  • BMC Remedy AR System clients earlier than version 5.0 cannot access port numbers lower than 1024.

Important

When installing on Linux, the installation program crashes if you enter port 12333 for any port parameter, such as the Java Plug-in Server TCP Port Number or the AR System Server TCP Port Number. This a known JVM issue in version Java 2 Runtime Environment, Standard Edition, 1.5.0_05.

Note

You can also add the ports to the TCD-Specific-Port and Plugin-Port parameters in the ar.cfg (ar.conf) file.


For more information about port numbers, go to http://www.iana.org/assignments/port-numbers.

Default port numbers

Following are the default port numbers that are assigned during BMC Remedy AR System installation:

Note

For BMC Remedy AR System version 8.1.00, the installer automatically selects the port numbers for the different components during installation.

Module

Port usage description

BMC Remedy AR System 7.1.00 and later

BMC Remedy AR System 7.5.00 and later

BMC Remedy AR System 8.1.00

Email Engine

RMI

1100

1100

1100 - 1149

Flashboards

RMI

1099

1099

1150 - 1199

Mid tier

Standard Tomcat ports

  • 8005 (shutdown)
  • 8443 (SSL)
  • 8009 (AJP13 connector)
  • 8082 (proxy)
  • 8080 (standalone http)
  • 8005 (shutdown)
  • 8443 (SSL)
  • 8009 (AJP13 connector)
  • 8082 (proxy)
  • 8080 (standalone http)
  • 8005 (shutdown)
  • 8443 (SSL)
  • 8009 (AJP13 connector)
  • 8082 (proxy)
  • 8080 (standalone http)


ServletExec

8888 (admin)


8888 (admin)

Plug-in server

TCP port

Uses portmapper

Uses portmapper

Uses portmapper

Java plug-in

Note: If you are planning to install the CMDB, see the following note.

TCP port

9999

9999

9999

Carte (Pentaho) server port (for Atrium Integrator

TCP

Not applicable

20000 (version 8.x and later)

20000 - 20050

FTS Java plugin server

TCP

Not applicable

9998 (version 7.6.03 and later)

9988 - 9998 (primary)
9977 - 9982 (secondary)

Important

  • Before proceeding to the BMC Remedy AR System server installation, make sure that the port range for Email Engine, Flashboards, Carte (Pentaho), and FTS is available on the system and the ports are not blocked.
  • If you are planning to install the CMDB and the Java plug-in port number is not 9999 in the following files, change the values to 9999 before installing the CMDB. The CMDB must use port 9999 for its web service.
    • Plugin-Port value in the ar.cfg (ar.conf) file
    • Java plug-in default port number in pluginsvr_config.xml file

The server does not have any default ports.

BMC Atrium Core ports

This table lists the default port number of all BMC Atrium Core features.

Component

Default Port Number

Is the port number configurable?

Supported port number

NE Plugin port

9555

Yes

any

Atrium Plug-in port

9556

Yes

any

Tomcat HTTP Port

blank

Yes

any

Tomcat HTTPS Port

blank

Yes

any

Note

If you are using a pre-installed Tomcat, the Tomcat HTTP Port and the Tomcat HTTPS Port fields are populated with the default port numbers. You cannot change the value of these fields.

Atrium Integrator ports

This table lists the default port number for Atrium Integrator.

Component

Default Port Number

Is the port number configurable?

Supported port number

MS SQL Server

1433

Yes

any

Oracle server

1521

Yes

any

 

 

Related topics

Portmapper service introduction
Setting ports and RPC numbers
ar.cfg or ar.conf
Configuring the Java plug-in server

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments