Contents

Popular
 Contents

Launching ESB Server

The (Fiorano Enterprise Server)  FES can be launched from the Windows Start menu or by directly executing a script file.

From Start Menu in Windows

Click Start > Programs > Fiorano > Fiorano Platform > Fiorano Servers > Fiorano ESB Server.

Using Script Files

Default Profile

To start the FES server with the default profile (profile1), go to the location <fiorano_installation_dir>\esb\server\bin folder and execute the following script:

Specific Profile

To start the FES server with a specific profile other than the default profile, go to the location <fiorano_installation_dir>\esb\server\bin and execute the following script with the profile option as shown below:

Example: <profileName>=haprofile1/primary or <profileName>=haprofile1/secondary (this starts servers in the HA mode)

UNIX systems

Icon

In UNIX systems, servers start in the Background mode. Pass the runtime argument –nobackground to the server startup script to run the server in the console mode. If the Background mode is not to be run, then run %FIORANO_HOME%/launcher/server.sh so that nobackground=“” is changed to nobackground=“true”.

Installing as Service

The batch/shell scripts required to run the Fiorano Servers as services are present at FIORANO_HOME/esb/server/bin/service. 

To install FES as a Windows NT service, run the command:

Icon

NT services will have to be re-installed if changes to any configuration files are made. This includes fiorano_vars.bat as well as server.conf files.

To remove the FES NT service, run the command:

UNIX systems

Icon

To install/uninstall FES as a service on UNIX, refer to ReadMeWrapperService.txt present under the %INSTALL_DIR%/Fiorano/esb/server/bin/service directory.

Shutting Down the ESB Server

The FES can be stopped from the Fiorano eStudio or by directly executing a script file located under %INSTALL_DIR%/esb/server/bin directory. Shutting down the Enterprise Server automatically invokes a shutdown hook in the Enterprise Server’s JVM which cleans up any resources and connections used by the server’s JVM.

Using Fiorano eStudio

To shutdown the Enterprise Server, perform the following actions:

  1. Open Server Explorer panel by navigating through Window > Show View > Other > Fiorano > Server Explorer.
  2. Right-click Enterprise Server node and click Shutdown.


    Figure 1: Stopping Enterprise Server
Icon
  • Enterprise Server can be shut down only when logged into it.
  • We recommend shutting down by using the command line (script files) than shutting down via eStudio (please refer the section below).

Using Script Files

The Enterprise Server can be shutdown using the shutdown-server script present in <fiorano_installation_dir>/esb/server/bin folder.

Icon
  • Shutdown scripts cannot be used to shutdown both primary and secondary servers running in a shared HA mode simultaneously while using the RMI connection.
  • If HA profiles from previous versions are migrated to the current version of the product, these profiles need to be re-configured to specify the BackupRMIServerPort property.

This script can be used to:

  • Shutdown a Standalone Enterprise Server.
  • Shutdown both the Primary and the Secondary HA servers simultaneously.

Options that can be specified to the script are:

  • -user: Name of user trying to shutdown the Fiorano Server
  • -passwd: Password of user trying to shutdown the Fiorano Server
  • -restart or –r: Restarts the Fiorano Server
  • -ha: Used to shutdown both active and passive servers running in the HA mode.
  • -url: The URL of active Fiorano Enterprise Server
  • -mode: Mode of the server (fes or fps). Defaults to value fps.
  • -? or –help: Prints the help message

Examples:

To shutdown the standalone Enterprise Server:

To shutdown both active/passive enterprise servers running in the HA mode:

Icon

The default credentials are:

  • User name: admin
  • Password: passwd

The above examples of shutting down the Enterprise Server(s) involve connecting to an Active Enterprise Server, whose URL is specified using the -url parameter.   

The options below can also be specified if a User wants to shutdown the Enterprise Server using the RMI connection.

  • -connectorType: Connection type to server.Pass "RMI" for shutting down servers using RMI connection.
  • -address: IP Address of server.
  • -rmiPort: RMI port of server.
Icon

If the -ha option is given for shutting down both servers of the ha server pair, the address and rmiPort options need to be specified for either the primary or the secondary server. Use when not sure which server of the HA pair is active.

Examples:

For shutting down the Standalone Server:

For shutting down both active/passive servers in the HA mode:

Icon

The default credentials are:

  • User name: admin
  • Password: passwd

Clearing ESB Server Database

To clear the FES server database of the default profile (that is profile1), double-click the clearDBServer.bat file present in the <fiorano_installation_dir>\esb\server\bin folder or go to this location and execute the script below:

To clear the FES server database of a specific profile (other than the default profile), double-click the clearDBServer.bat file present in the <fiorano_installation_dir>\esb\server\bin folder or browse to this location  and execute the script below which specifies the profile name:

The operations listed below gets displayed when the above script is executed. Choose the preferred option:

OperationDescription
1. File BasedDatastoreClears the local cache of the Enterprise server.
2. Admin Datastore Clears the admin objects which includes the JMS Connection factories, queue and topic destinations, status of running Event Processes and component instances.
3. Peer RepositoryClears all the fetched peer server profiles from the Enterprise Server runtimedata.
4. Events DatabaseClears the Events Database using the configurations provided in eventsdb.cfg file present under: <fiorano_installation_dir>/esb/server/profiles/<profilename>/FES/conf directory.
5. SBW Database

Clears the SBW database using the configurations provided in the sbwdb.cfg file present under: <fiorano_installation_dir>/esb/server/profiles/<profilename>/FES/conf directory.
The Enterprise Server processes System events, SBW events and Backlog events and takes appropriate actions. System events and SBW events are queued to be inserted into an external database while Backlog events are queued up to be handled by various alert handlers. Before this processing takes place, events are temporarily stored in persistent databases that are created during runtime of the Enterprise Server. After an event has been processed, it gets deleted from the temporary store. If these events are not able to be processed, the temporary datastore may grow and occupy a large amount of disk-space. Option 7, 8, and 9 can be used to clear the temporary persistent datastore pertaining to different events.

6. Events Persistent Database CacheClears the temporary persistent datastore of System events.
7. SBW Persistent DatabaseCacheClears the temporary persistent datastore of SBW events.
8. SBW Call Out Persistent DatabaseCacheClears the temporary persistent datastore of SBW Callout events.
9. Backlog Persistent DatabaseCacheClears the temporary persistent datastore of Backlog events.
10. YAWL DatabaseClears the YAWL Database for the Enterprise Servers.
11. AllClears all ten of the above.
12. QuitExits from the Options screen.

Select the preferred number (from 1 to 12) corresponding to the datastore that needs to be cleared.


Figure 2: Options to clear the datastore

Icon

Ensure that the Enterprise Server is shut down. If not, a message prompting to shut down the peer server is generated (as in the figure above—"Please shutdown the Fiorano FES Server")

The script can be executed in Quiet Mode as shown below:

The elements included are:

  • -mode - clears fps or fes runtimedata
  • -dbPath - runtime data directory of the profile
  • -profile - profile name for which runtimedata is to be cleared
  • -q - runs the script in quiet mode.
Icon

Values to the argument may be added separated by commas (as shown in the script above). In the absence of an argument the default option— 11 ‘ALL’ is assigned.

Adaptavist ThemeBuilder EngineAtlassian Confluence