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.
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
- Open the FES server profile from Profiles node under Profile Management panel (Window > Show View > Other > Fiorano > Profile Manager) in eStudio.
- 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 - 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
- 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 - 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
- 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
- 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
- Open the server profile in Studio as explained in section External Ports.
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- Save the profile as explained in section External Ports.
Online mode
- Connect to the Enterprise Server's JMX interface through Fiorano eStudio as shown in External Ports.
- After logging into FES-JMX, select config node by navigating through JMX Connection > Fiorano > socketAcceptors > port-1 > ConnectionManager.
- In the configuration properties panel on the right-hand side, change the Port property to the new port.
Figure 8: JMX Explorer
- 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.
- 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
- Open the server profile in Studio, navigate to Profile Management > Enterprise Server and select FES.
- 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
- Save the profile as explained in section External Ports.
Online Mode
- Connect to the Enterprise Server's JMX interface through Fiorano eStudio as explained in section External Ports.
- 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
- 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.
- 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.
- Stop the servers. Open eStudio and then open the profile of the server for which you want to change the value.
- 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 Option | Meaning | Default ESB Settings |
---|---|---|
-Xmx | Maximum heap size. | 512MB |
-Xms | Initial heap size | 256MB |
-Xss | Stack size for each thread. | JVM default (120k) |
Configuration steps:
- 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.
- 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.