The Fiorano 10 has a concept of profile based server, for example, profile1, profile2, haprofile, and so on. All these profiles can be run either as a Fiorano Enterprise Server or a 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 and Windows XP, 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 like bootclasspath, classpath, server memory, system properties, and so on. 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 be effective. Make sure you have made the entire server JVM settings before installing the profile as a service.
On how to change the memory settings for the server, refer to Question 1 in section FAQs.
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 be effective. Make sure you have made all the settings before installing the profile as a service.
How to install/uninstall a StandAlone (Non-HA) Profile as NT Service
To install a StandAlone (Non-High Availability)Profile as NT Service, open a command prompt browsing to the location %FIORANO_HOME%/esb/server/bin/service directory and follow the below-mentioned steps accordingly:
To install FES profile as an NT service, run the following command:
To install FPS profile as an NT service, run the following command:
After installation, you should be able to see the following NT service installed:
| 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 following steps:
To remove FES NT service, run the following command:
To remove FPS NT service, run the following 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 following actions:
- Go to the "Administrative Tools" folder in your control panel.
- Open the "Local Security Policy" applet.
- Expand "Local Policy" and then click "User Rights Assignment".
- On the right side, you can find a "logon as service policy". Right-click or double-click to access its properties dialog.
- Add the user that you wish to allow to run the service.
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 following command:
To install FES/FPS(Shared HA Profile) as an NT service, run the command
After installation, you should be able to see the following NT service installed:
- Fiorano ESB Server <%PROFILE_NAME%>
- Fiorano Peer Server <%PROFILE_NAME%>
To remove FES/FPS NT service, run the following 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 following log files:
- %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 Server while running as a service?
Answer: Uninstall the service (refer section How to install/uninstall a StandAlone (Non-HA) Profile as NT Service and How to install/uninstall a Profile as NT Service with HA Profile)
Open 'server.conf' located under %FIORANO_INSTALLATION_HOME%/esb/server/bin and change the Xms & Xmx values. (Refer section Configuring Server JVM Settings for Running as NT-Service.)
Save the file and proceed to install the service again using the script.
Question 2: Certain Components like FTP-Put / FileReader / 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 Section How to install/uninstall a Profile as NT Service with HA Profile (Steps 1 and 2).
Question 3: Feeder / Display Components (Components with Graphical User Interface) do not show up on Windows server 2003, 2008 & Vista but they appear green from Fiorano eStudio?
Answer: This is due to security restrictions put in place by the OS. The components will be visible on Desktop 0, which is a background desktop that you have to switch to see the service interface.
To see the components display, perform the following steps:
- Start the service Interactive service detection. When we launch a flow containing the components like feeder/display, a pop-up should appear.
- Click on Show me the message. This should take you to the Desktop 0 of system.
- To get back to the original desktop, click the Return Now option. You can move back and forth the desktops using the interactive services desktop popup dialog.