Skip to main content
Skip table of contents

ESB Server Configuration

Contents

FES can be configured either in online mode (that is, while the FES server is running) or offline mode (when the FES server is not running) using Fiorano eStudio.

  • Offline mode configuration can be done using the Profile Manager which can be accessed from the Fiorano eStudio. When a configuration is modified and saved, changes persist and are reapplied when the server is restarted.
  • Online mode configuration can be performed using the JMX explorer, which can be accessed from the Fiorano eStudio. Changes made using JMX are applied on the current running server and are persisted as well. However, some of the server configurations (such as server ports, memory settings and others) are applied only after the restart of the server.

For more information on configuring Fiorano Servers, please see section Configuring Servers and Tools .

Server Ports Configuration

FES server communicates with Peer Servers and tools using different ports.

External Ports

Ports that are opened to facilitate the communication between FES and external tools are known as external ports or external server ports. The FES checks these ports for any requests from external tools.

Configuration Steps

Offline Mode 

  1. Open the FES server profile from Profiles node under Profile Management panel (Window > Show View > Other > Fiorano > Profile Manager) in eStudio. 
     
  2. Select the FESTransportManager in the Profile Manager tab by navigating through FES > Fiorano > Esb > Transport. In the Properties of FESTransportManager panel displayed on the right side, change the port number in the ServerUrl property.


    Figure 1: FESExternalPort

    FES clients (such as the Studio and other tools) should connect to this port after the FES is started with this profile saved.

  3. Right-click FES node and select Save (alternatively, click
     button or press CTRL+S) to save the profile as shown in the figure below.

     

    Figure 2: Saving Profile

Online Mode

  1. Connect to the Enterprise Server's JMX interface from Server Connections panel (right-click FES-JMX and select Login) under Connection Management (Window > Show View > Other > Fiorano > Server Connections)  in Fiorano eStudio.


    Figure 3: FES-JMX Server

  2. Select JMX Connection node under FES-JMX node and navigate through Fiorano > Esb > Transport > TransportManager > FESTransportManager > config > FES. In the Properties panel on the right side, change the FES URL property to reflect the new port.
     

    Figure 4: JMX Explorer
     
  3. The server needs to be restarted after the value is set. A message dialog box appears with instructions for the properties that require the Server to be restarted. Click OK to save the configurations


    Figure 5: Save Dialog Box
     
  4. Right-click FES-JMX node and select Save Configurations to save the configurations. These configurations are reflected after the server is restarted.
     

    Figure 6: Save Configuration
Internal Ports

Ports that are opened to facilitate the communication between FES and FPS servers are known as internal ports or internal server ports. The FES checks these ports for any requests from external tools.

Configuration Steps

Offline Mode

  1. Open the server profile in Studio as explained in section External Ports.
  2. Select the ConnectionManager in FES > FioranoaSocketAdaptersaport-1 > ConnetionManager. In the Properties of ConnectionManager panel on the right side, change the Port property.


    Figure 7: FES Internal Port

    The Peer Servers should connect to this port after FES is started with this saved profile.

     

  3. Save the profile as explained in section External Ports.

Online mode

  1. Connect to the Enterprise Server's JMX interface through Fiorano eStudio as shown in External Ports.
  2. After logging into FES-JMX, select config node by navigating through JMX Connection > Fiorano > socketAcceptors > port-1 > ConnectionManager.
  3. In the configuration properties panel on the right-hand side, change the Port property to the new port.


    Figure 8: JMX Explorer
     
  4. The server needs to be restarted after the value is set. A message dialog box appears with instructions for the properties that require the Server to be restarted, as explained in section External Ports.
  5. Click the OK button to save the configurations. These configurations are reflected after the server is restarted as explained in section External Ports.
RMI Ports

Ports that are opened to facilitate the communication between FES with JMX clients are known as RMI Server Port.

Configuration Steps

The RMI ports can be configured in either offline or online mode.

Offline Mode

  1. Open the server profile in Studio, navigate to Profile Management > Enterprise Server and select FES.
  2. Select theRMIBasedJMXConnector from FES > Fiorano > JMX > Connector. In the Properties of RMIBasedJMXConnector panel on the right-hand side, change the RMIServerPort property as required. The default RMI Ports are:
    • FES HA Primary - 2047
    • FES HA Secondary - 2048
       

    • Figure 9: FESRMIPort
       
  3. Save the profile as explained in section External Ports.

Online Mode

  1. Connect to the Enterprise Server's JMX interface through Fiorano eStudio as explained in section External Ports.
  2. Select JMX Connection > Fiorano > jmx > connector > JMXConnector > RMI > RMIBasedJMXConnector. In the Properties of Config panel on the right- hand side, change the RMIServerPort properties as required.


    Figure 10: JMX Explorer
     
  3. The server needs to be restarted after the value is set. A message dialog box appears with instructions for the properties that require the Server to be restarted as explained in section External Ports.
  4. Click the OK button to save the configurations. These configurations are reflected after the server is restarted as explained in section External Ports.
RMI Server Ports

This port will be used by the RMI Registry to export the RmiConnector stubs. If the port number is set to 0, random port will be dynamically assigned at run time. To make the server use specific port, you need to provide that port number to this RmiPortExportObject property.

To change the port number, please follow the steps below.

  1. Stop the servers. Open eStudio and then open the profile of the server for which you want to change the value.
  2. Go to Fiorano-jmx-Connector- RMIBasedJMXConnector and set the value of RmiPortExportObjects.


    Figure 11: FESHAPrimary properties of RmiPortExportObjects

Memory Configurations

Better server performance is possible with proper configuration of JVM parameters, particularly those related to memory usage. The allocation of memory for the JVM is specified using -X options when starting the server.

JVM OptionMeaningDefault ESB Settings

-Xmx

Maximum heap size.

512MB

-Xms

Initial heap size

256MB

-Xss

Stack size for each thread.

JVM default (120k)

The stack size limits the number of threads that you can run in a given JVM. A large stack size may result in memory running short as each thread is allocated more memory than needed.


Configuration steps:

  1. Open the server.conf in %FIORANO_HOME%/esb/server/bin/ and change the values for –Xms and –Xmx argument under <jvm.arg> tag. If no value for –Xss is specified, default value will be used.
  2. Save the file and restart the server.

Java Configurations

Enterprise server requires JRE version 1.5 or above for successful operation. The JAVA_HOME setting can be configured for the Enterprise Server as follows:

On UNIX:
The Enterprise Server by default uses JAVA_HOME value set for the console. This can be overridden by specifying JAVA_HOME value in %FIORANO_HOME%/fiorano_vars.sh file.

On Windows:
By default, JAVA_HOME is set to %FIORANO_HOME%/jre1.6.0_30(shipped with the product) in %FIORANO_HOME%/fiorano_vars.bat file. To make the server use a different JAVA_HOME, modify the settings as required.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.