Changing default port numbers
Table 4‑1 lists the ports for which you can change the value, if necessary, after installing BIRT iHub. These port numbers are defined in acserverconfig.xml, the configuration file that all nodes in a BIRT iHub cluster share.
Although the permissible range for these port numbers is 1-65535, a best practice is to use a port range of 1024-65535. For example, Linux does not allow non-root applications to open ports under 1024. Also, many ports lower than 1024 are for common protocols such as ftp and e-mail.
Table 4‑1 iHub ports appearing in acserverconfig.xml
Name
Description
Default
Range
AppContainerPort
Application container process listen port
8700
1 ‑ 65535
CustomEventServicePort
Custom Event Service Port
8700
1 ‑ 65535
ProvisioningSOAPPort
Provisioning service port
8010
1 ‑ 65535
ProvisioningSOAPSSLPort
Provisioning service SSL port
8011
1 ‑ 65535
SOAPDispatchSOAPPort
Message Distribution service port
8000
1 ‑ 65535
SOAPDispatchSOAPSSLPort
Message distribution service SSL port
8001
1 ‑ 65535
How to change a port number
1 Stop iHub processes. For information on stopping and starting iHub processes for a cluster or for a standalone iHub installation, see Stopping and starting iHub processes.
2 Open AC_CONFIG_HOME\acserverconfig.xml using a text editor.
3 Change any port number appearing in Table 4‑1 as necessary. Save and exit.
If you are changing the value of the message distribution service port, SOAPDispatchSOAPPort, perform the next step. Otherwise, skip the next step.
4 If you specify a new port number for SOAPDispatchSOAPPort in acserverconfig.xml, perform the following tasks on every node in the cluster.
1 Navigate to the following file:
AC_SERVER_HOME\web\iportal\WEB-INF\volumeProfile.xml
2 As a best practice, create a copy of volumeProfile.xml. Then, edit volumeProfile.xml, and specify the new port number in the URL that the <ServerUrl> element specifies. For example, in Listing 4‑1, the port number in the URL that <ServerUrl> specifies has been changed from 8000 to 8200.
Listing 4‑1 Changing the port number that <ServerUrl> specifies
...
<VolumeProfiles>
...
<Profile>
<Default>true</Default>
<ProfileName>Default Volume</ProfileName>
<RepositoryType>enterprise</RepositoryType>
<ServerUrl>http://URUP:8200</ServerUrl>
<Volume>Default Volume</Volume>
</Profile>
</VolumeProfiles>
Save and exit.
5 Start iHub processes. For information on stopping and starting iHub processes for a cluster or for a standalone iHub installation, see “Stopping and starting iHub processes,” later in this chapter.