Contents

Launching Peer Server

The FPS can be launched from the Windows Startup menu or by directly executing a script file.

When the peer server is launched, the enterprise server must be running on a preconfigured machine for successful peer server startup. Please refer to the section Configuring Enterprise and Peer Servers in different Networks for instructions on how to configure the Enterprise Server URL as a Peer Server. If the Enterprise Server is not reachable by the Peer Server or if it is not running, the Peer Server waits until it can reach the Enterprise Server on a specific connection URL. The Enterprise Server starts successfully when the Peer Server is able to establish a connection with the Enterprise Server.

From Start Menu in Windows

Click Start > Programs > Fiorano > Fiorano Platform > Fiorano Servers > Fiorano ESB Peer

Using Script Files

Default Profile

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

Icon

By default, the server starts in FPS mode if the 'mode' argument is not specified. Use the script below to start the fps server:

Specific Profile

To start the FPS 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 is to start servers in HA mode)

UNIX systems

Icon

In UNIX systems, servers by default 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 servers are not to be run in the background mode, modify the file %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 FPS as a Windows NT service, run the command:

Icon

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

To remove FPS as a Windows NT service, run the command:

UNIX Systems

Icon

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

Shutting Down the Peer Server

The FPS can be stopped from the Fiorano eStudio or by directly executing a script file. Shutting down the Peer Server automatically invokes a shutdown hook in the peer server’s JVM which clears previous resources and connections used by the server’s JVM.

Using Fiorano eStudio

To shut down the peer server, perform the actions below:

  1. Open the Server Explorer panel by navigating to Window > Show View > Other > Fiorano > Server Explorer.
  2. Expand the Peer Repository, right-click the fps node and click Shutdown.


    Figure 1: Shutting down the FPS Server
Icon
  • The Peer Server can be shut down only when logged into it.
  • Shut down the peer server using the command line (script files) instead of via eStudio (Please refer the section below).

Using Script Files

The Peer 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 the shared HA mode simultaneously using an RMI connection.
  • If HA profiles from previous versions are migrated to the latest version of the product, these profiles will need to be re-configured to specify BackupRMIServerPort properties.

This script can be used to:

  • Shut down a standalone peer server.
  • Shut down both the primary and secondary HA servers simultaneously.

Options that can be specified within the script are:

  • -user: Name of the User trying to shutdown the Fiorano server.
  • -passwd: Password of the 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.
  • -mode: Mode of the server (fes or fps). The default value is "fps".
  • -url: URL of the active Fiorano Enterprise Server to which the Peer Server is connected.
  • -fpsname: Fiorano ESB Peer name.
  • -? or –help: Prints help message.

Examples:

To shut down a standalone Peer Server
To shut down both active/passive Peer Servers running in the HA mode
Icon

The default credentials are:

  • User name: admin
  • Password: passwd

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

The following options can also be specified if a User wants to shutdown the Peer Server using a RMI connection. This involves connecting directly to the Peer Server to initiate the shutdown.

  • -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 used to shutdown both the servers of an ha pair, the address and rmiPort options can be specified as either the Primary or the Secondary server. Use this option when it is uncertain which server in the HA pair is active.

Examples:

To shut down the Standalone Server
To shut down both active/passive servers in the HA mode
Icon

The default credentials are:

  • User name: admin
  • Password: passwd

Clearing Peer Server Database

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

Icon

The script by default clears the database of the Peer Server if the "mode" argument is not provided.

To clear the Peer 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 go to this location and execute the script below specifying the profile name:

The operations listed below are available when this script is executed.

OperationDescription
1. File BasedDatastoreClears the local cache of the Peer server.
2. Security DatastoreClears the Peer server ACLs (Access Control Lists). ACLs are recreated when the peer server restarts.
3. Admin Datastore Clears the admin objects which includes the JMS connection factories queues and topic destinations.
4. Cached Component Store Clears all the cached components stored in the Peer Server‘s runtime storage.
5. FPS Schemas DatastoreClears all schemas stored in the repository.
6. AllClears all five of the above.
7. QuitExits from the Options screen.

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


Figure 2: Options to clear datastore

Icon

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

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

  • -mode - clears fps 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 can be separated by commas (as shown in the script above). In the absence of an argument, the default option—option 5 ‘ALL’. is assigned.

Adaptavist ThemeBuilder EngineAtlassian Confluence