Fiorano 11 has a concept of profile based server such as profile1, profile2, and haprofile. All these profiles can be run either as Fiorano Enterprise Server or Fiorano Peer Server by specifying their mode as 'fes' or 'fps' respectively.
These profiles can be run as NT services on Windows NT, Windows 2000, Windows XP, and Windows Server 2003/2008 operating systems. Any profile present under %FIORANO_HOME%/esb/server/profiles can be run as an NT service.
Configuring Server JVM Settings for running as NT-Service
The 'server.conf' file located under %FIORANO_HOME%/esb/server/bin contains various settings related to the JVM such as bootclasspath, classpath, server memory, and system properties. This file is used while creating configuration files required to run the server as a nt-service.
The configuration files are generated under the following directories:
- For Enterprise Servers: %FIORANO_HOME%/runtimedata/EnterpriseServers/%PROFILE_NAME%/service/
- For Peer Servers: %FIORANO_HOME%/runtimedata/PeerServers/%PROFILE_NAME%/service/
Once the server is installed as a service, future changes to the file 'server.conf' will have no effect on the server as the configuration files will not be regenerated. The server profile needs to be uninstalled and then installed again for the changes to take effect.
On how to change the memory settings for the server, refer to Question 1 in section FAQs section in this page.
Configuring Email Alerts for Server JVM Restart/Sudden Exit/JVM Hung Events
The Wrapper binary which is used to run the server as a service can generate email alerts when the server either restarts, exits unexpectedly or becomes hung.
Please refer to the file 'server.conf' located under '%FIORANO_HOME%/launcher' for the configurations.
Once the server is installed as a service, future changes to the file 'server.conf' will have no effect on the server. The server profile needs to be uninstalled and then installed again for the changes to take effect.
How to install/uninstall a StandAlone (Non-HA) Profile as an NT Service
To install a StandAlone (Non-High Availability)Profile as an NT Service, open a command prompt from %FIORANO_HOME%/esb/server/bin/service directory and follow the below-mentioned steps accordingly:
To install the FES profile as an NT service, run the following command:
To install the FPS profile as an NT service, run the following command:
After installation, the NT service installed is displayed as:
| Fiorano ESB Server <%PROFILE_NAME%> NT service or Fiorano Peer Server <%PROFILE_NAME%> |
To uninstall a StandAlone (Non-High Availability) Profile as NT Service, perform the steps below:
To remove the FES NT service, run the command:
To remove the FPS NT service, run the command:
Uninstall should stop and remove the NT service for the given profile from the services list.
How to install/uninstall a Profile as NT Service with HA Profile
While running the servers in HA mode, the servers need to access network shares.
To access the network share, the server needs to configure with the user credentials of a User Account of the system.
- Specify the credentials in the file %FIORANO_HOME%/launcher/server.conf
Uncomment the following lines in the file and specify the user account name and password.
- Grant 'Logon as Service' permission to the user account whose credentials have been provided.
To set the "Logon as Service" attribute, perform the actions below:
- Go to the "Administrative Tools" folder in the control panel.
- Open the "Local Security Policy" applet.
- Expand "Local Policy" and then click "User Rights Assignment".
- Right-click or double-click the logon as a service policy on the right side to access its Properties window.
- Add the user to run the service.
Figure 1: Setting the "Logon as Service" policy
To install FES/FPS(Replicated HA Profile) as an NT service, open a command prompt, go to %FIORANO_HOME%/esb/server/bin/service directory, and run the command:
To install FES/FPS(Shared HA Profile) as an NT service, run the command
After installation, the NT service installed is displayed as:
- Fiorano ESB Server <%PROFILE_NAME%>
- Fiorano Peer Server <%PROFILE_NAME%>
To remove FES/FPS NT service, run the command:
Uninstall should stop and remove the NT service for the given profile from the services list.
Viewing Server Logs
Once started, console Logs for FES & FPS service can be viewed in the log files listed below:
- %FIORANO_HOME%/runtimedata/EnterpriseServers/%PROFILE_NAME%/service/service.log.
- %FIORANO_HOME%/runtimedata/PeerServers/%PROFILE_NAME%/service/service.log.
Other logs pertaining to the server can be found under:
- For Enterprise Server: %FIORANO_HOME%/runtimedata/EnterpriseServers/%PROFILE_NAME%/FES/run/logs
- For Peer Server: %FIORANO_HOME%/runtimedata/PeerServers/%PROFILE_NAME%/FPS/run/logs
FAQs
Question 1: How to change Memory Settings (Xms & Xmx) of the Server while it is running as a service?
Answer:
Uninstall the service.
Open 'server.conf' located under %FIORANO_INSTALLATION_HOME%/esb/server/bin and change the Xms & Xmx values.
Save the file and proceed to install the service again using the script.
Question 2: Certain Components such as FTP-Put, FileReader, and File Writer that are launched in-Memory are not able to access network shares?
Answer: Since the components are launched in-memory they are part of the peer server. The server needs to have user credentials of the System to access network shares when run as a nt-service. Refer to the How to install/uninstall a Profile as NT Service with HA Profile section (Steps 1 and 2).
Question 3: Feeder and Display Components (components with Graphical User Interface) do not show up on Windows server 2003, 2008, and Vista, but they appear green from Fiorano eStudio?
Answer: This is due to security restrictions put in place by the Operating System. The components will be visible on Desktop 0, which is a background desktop to be switched to so as to be able to view the service interface.
To view the components display, perform the steps below:
- Start the Interactive service detection service. When a flow containing the components such as feeder and display are launched, a dialog box is displayed.
Figure 2: Starting the Interactive service detection service - Click on Show me the message. This leads to the Desktop 0 of the system.
Figure 3: Switching to to Desktop 0 - To get back to the original desktop, click the Return Now option. It is possible to move back and forth between the desktops using the Interactive Services Desktop dialog box.