Contents

Launching ESB Server

The 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),  browse 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, browse 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 is to start servers in HA mode)

UNIX systems

Icon

In UNIX systems, servers, by default, will start in the Background mode. Pass runtime argument –nobackground to the server startup script to run the server in 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 you make changes to any configuration files. This includes fiorano_vars.bat as well as server.conf.

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 %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 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 you are already logged into it.
  • We recommend shutting down using command line (script files) than from eStudio (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, and using the RMI connection.
  • In case, 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 in order to make use of this functionality.

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 Fiorano Server
  • -passwd: Password of user trying to shutdown Fiorano Server
  • -restart or –r: Restarts the Fiorano Server
  • -ha: Used to shutdown both active and passive servers running in HA.
  • -url: URL of active Fiorano Enterprise Server
  • -mode: mode of the server, that is, fes or fps. Defaults to value fps.
  • -? or –help: Prints help message

Examples:

To shutdown standalone Enterprise Server:

To shutdown both active/passive enterprise servers in HA:

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 following options 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 to shutdown both the servers of ha pair, the address and rmiPort options need to be specified for either the primary or the secondary server. This can be used when you are 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 HA:

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 browse to this location and execute the following script:

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 following script with the profile option as shown below:

The following operations are available when this script is executed from which you may choose the option of your preference:

OperationDescription
1. File BasedDatastoreClears the local cache of the Enterprise server.
2. Admin Datastore Clears the admin objects, that is, 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 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 up to be inserted into an external database while Backlog events are queued up to be handled by various alert handlers. Before this processing happens, events are temporarily stored in persistent database that are created during runtime data 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 to occupy a large amount of disk-space. Option 7, 8, and 9 can be used to delete the temporary persistent datastore of 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 nine of the above.

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


Figure 2: Options to clear datastore

Icon

Ensure that the Enterprise Server is shut down. If not you will get a message prompting to do the same (as in the figure above—"Please shutdown the Fiorano FES Server")

The script can be executed in Quiet Mode as follows (sample):

where, the elements included implies as below:

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

You can provide comma separated option values to the argument (as in the above sample script). Absence of an argument leads assuming the default option—option 11, ‘ALL’.

Adaptavist ThemeBuilder EngineAtlassian Confluence