This guide gets you started with the Fiorano SOA 9. It lists the procedures for starting and shutting down the various Fiorano SOA 9 servers and tools, and provides links to documents containing detailed information on all aspects of Fiorano SOA 9.
For more information on latest changes in this release, see the Fiorano SOA 9 Release Notes and for information on the product, see the Fiorano SOA 9 User Guide.
Starting the Fiorano Event Manager
Shutting Down the Fiorano ESBServer
Shutting Down a Fiorano ESBPeer
Contact InformationFiorano SOA 9 is available in two editions:
Enterprise Edition
Workstation Edition
The Enterprise Edition is a comprehensive suite consisting of all the servers and tools in the Fiorano SOA 9. The servers included with Fiorano SOA 9 are:
Fiorano ESB Server
Fiorano ESB Peer
The Enterprise Edition also includes a rich set of tools that make the tasks of configuring and administering a Fiorano Network, and developing distributed applications using Fiorano SOA 9 remarkably easy. Some of the widely used tools shipped with the Fiorano SOA 9 are:
Fiorano netBeans Studio and eStudio
Fiorano Event Manager
Fiorano Services and Security Manager
The Workstation Edition includes all components of the Enterprise Edition except Fiorano ESB Server. Therefore, the Workstation Edition expects the Enterprise Edition to be installed on the network.
Note: For instructions on how to add a Peer Server to an existing ESB network, please refer to section 2.4.4.3 Changing to different ESB Network in the online documentation for the product.
Fiorano SOA 9 Servers work with Java version 1.6 or higher. The installation for Windows comes bundled with Java jre1.6.0_30 and the environment variable JAVA_HOME in the fiorano_vars file is set to this JRE.
To point to a JRE other than the one bundled with Fiorano SOA 9, simply edit the fiorano_vars script file in the installation directory and set the JAVA_HOME variable to point to the root directory of the desired JRE installation (not the bin directory). For example: JAVA_HOME=C:\jre1.6.0_30.
Fiorano SOA 9 Servers/Tools work with Java version 1.6 or higher. The installation for Windows comes bundled with Java jre1.6.0_30.
To point to a JRE other than the one bundled with Fiorano SOA 9:
Edit %FIORANO_HOME%\fiorano_vars.bat (fiorano_vars.sh) and set 'JAVA_HOME' variable to point to the root directory of the desired JRE installation. For example: JAVA_HOME=C:\jre1.6.0_30.
Edit %FIORANO_HOME%\Studio\etc\Studio.conf and set 'jdkhome' variable to point to the root directory of the desired JRE installation.
Copy 'sunjce_provider.jar' and 'sunpkcs11.jar' from %JAVA_HOME%\lib\ext to %FIORANO_HOME%\esb\lib\ext.
The Fiorano ESB Server can be launched from the Start menu (for Windows) or by directly executing the script file:
For Windows:
To start Fiorano ESB Server from the Start group of the Windows machine, select Start > Programs > Fiorano > FioranoSOA9.5.0 > Fiorano Servers > Fiorano ESB Server.
Using script files
Fiorano ESB Server can also be launched using the script server.bat -mode fes located in %FIORANO_HOME%\esb\server\bin directory.
Please read the comments in the server.conf file to configure the startup parameters.
For UNIX:
Run the shell script server.sh -mode fes available in the folder $FIORANO_HOME/esb/server/bin. Ensure that JAVA_HOME within the $FIORANO_HOME/Fiorano_vars.sh file points to Java version 1.6 or above.
Example:
JAVA_HOME=/usr/java/jre1.6.0_30
Fiorano ESB Peer can be launched from the Start menu (for Windows) or by directly executing the script file:
For Windows:
To start Fiorano ESB Peer from the Start menu, select Start > Programs > Fiorano > FioranoSOA9.5.0 > Fiorano Servers > Fiorano ESB Peer.
Using script files
Fiorano ESB Peer can also be launched using the script
server.bat -mode fps located in %FIORANO_HOME%\esb\server\bin directory.
Please read the comments in the server.conf file to configure
the startup parameters.
For UNIX:
Run the shell script server.sh -mode fps available at the $FIORANO_HOME /esb/server/bin.
Once you have started Fiorano ESBServer and Fiorano ESBPeer, you can start any of the tools. The following are some of the tools that will be widely used and are provided with both editions of Fiorano SOA 9:
Fiorano netBeans Studio and eStudio
Fiorano Event Manager
Fiorano Services and Security Manager
All Fiorano SOA 9 Tools require a JRE that is compliant with JavaSoft JRE version 1.6 or higher. Before launching any Fiorano SOA 9 tool, ensure that the JAVA_HOME variable in the fiorano_vars.bat file which is located in the installation directory of the Fiorano SOA 9, points to the root directory of the desired JRE installation.
The Fiorano Studio enables you to compose an Event Process visually, deploy it instantly, monitor it, and debug it. The Fiorano Studio provides an easy to use GUI, which allows you to develop event processes simply by dragging and dropping components that meets your business or technical requirements.
The Fiorano Studio also provides various other features in addition to visual process creation, like administration of the servers and configuring the server profiles.
Note: Fiorano Studio comes in two flavors, netBeans (Fiorano Studio) and eclipse (Fiorano eStudio).
For Windows:
Click Start > Programs > Fiorano > FioranoSOA9.5.0> Fiorano Tools > Fiorano Studio.
Using script files
The Fiorano Studio can also be launched using the script Studio.exe located in %FIORANO_HOME%\Studio\bin directory.
For UNIX:
Set the variable jdkhome in $FIORANO_HOME/Studio/etc/Studio.conf to point to Java version 1.6 or above.
Run the script Studio.sh located in $FIORANO_HOME/Studio/bin directory.
Fiorano eStudio has been developed on eclipse giving you the capability to compose event process without connecting to any server. The EPLCM (Event Process Life Cycle Management) allows an user to move an Event Process in different labeled environments that is, Testing, Staging, QA, and Production at the click of a button.
For Windows:
Click Start > Programs > Fiorano > FioranoSOA9.5.0> Fiorano Tools > Fiorano eStudio.
For UNIX:
Run the script eclipse located in $FIORANO_HOME/eStudio/eclipse directory.
You can use Fiorano Event Manager to:
View business service event process events
Monitor the states of various Document Tracking
View normal business service events such as business service failure, launch, and kill
View business service-level activities remotely
Track the status of an activity or document across a distributed workflow
The Fiorano Event Manager can be launched from the Windows Start menu or by directly executing a script file.
You can start the Fiorano Studio by performing the following steps:
For Windows:
Click Start -> Programs -> Fiorano -> FioranoSOA9.5.0 -> Fiorano Tools -> Fiorano Event Manager.
Using script files
The Fiorano Event Manager can also be launched using the script evst.bat
located in the %FIORANO_HOME%\esb\tools\evst\bin directory.
For UNIX:
Please run the shell script, evst.sh available at the %Fiorano_Home%/esb/tools/evst/bin to launch the Fiorano Event Manager.
Fiorano Service and Security Manager (FSSM) enables you to create and register business components and manage the security of the Fiorano network. The tool is used to assign rights to users and groups. Rights may be understood as rules associated with the Fiorano Network granted to users and groups. They allow users and groups to perform specific tasks on a Fiorano Network. The
Fiorano SOA 9 has a well-defined security policy to protect your network against data loss or corruption due to malicious or accidental access. This policy is implemented by assigning appropriate permissions to groups and users which prevents illegal access to the Fiorano Network.
The Fiorano Services and security Manager can be launched from the Windows Start menu or by directly executing a script file.
For Windows:
To start the Fiorano Services and security Manager from the Start menu in Windows, select Start > Programs > Fiorano > FioranoSOA9.5.0 > Fiorano Tools > Fiorano Services and Security Manager.
Using Script files
The Fiorano Services and security Manager can also be launched using the script fssm.bat located in the %FIORANO_HOME%\esb\tools\fssm\bin directory.
For UNIX:
Run the shell script fssm.sh available at the $FIORANO_HOME/esb/tools/fssm/bin.
To start ESB Web Console, start Fiorano Enterprise Server (FES) and then open link http://localhost:1980/ESBDashboard. Alternatively, the user can access the same from the link present in the welcome page at http://localhost:1980. The user can login to the Fiorano Web Console by entering user name and password that is configured for the FES.
Stopping a Fiorano SOA 9 server by pressing CRTL+C may result in the persistent store losing data. Fiorano SOA 9 comes bundled with shutdown scripts. The Fiorano SOA 9 administrator should use these scripts to shutdown the servers.
The script to shutdown the Fiorano ESBServer shutdown-fes.bat (shutdownFES.sh for UNIX) is located in the %FIORANO_HOME%/esb/fes/bin directory. To view the usage description of this script, navigate to the aforementioned path and execute the following command:
shutdown-fes.bat -?
For UNIX: shutdown-fes.sh -?
The script to shutdown the Fiorano ESBPeer shutdown-fps.bat (shutdownFPS.sh for UNIX) is located in the %FIORANO_HOME%/esb/fps/bin directory. To view the usage description of this script, navigate to the aforementioned path and execute the following command:
shutdown-fps.bat -?
For UNIX: shutdown-fps.sh -?
Fiorano SOA 9 includes a comprehensive set of API's as indicated in the following table.
|
Document |
Description |
|
|
API Documentation of the Business Component Development Kit which can be used to create new Fiorano JCA components externally. |
|
API Documentation of the EDBC Framework which helps you in creating new EDBC components. |
If you have any questions and/or comments on Fiorano SOA 9, please feel free to contact us at:
Fiorano Software Technologies Pvt. Ltd.
Our Website - http://www.fiorano.com
Our Support - http://support.fiorano.com
Evaluation Support – presales@fiorano.com
Check out our Developer Zone at http://www.fiorano.com/devzone/dev_zone.php
Copyright © 2008-2012, Fiorano Software Pte. Ltd. and affiliates. All rights reserved.
This software is the confidential and proprietary information of Fiorano Software ("Confidential Information"). You shall not disclose such Confidential Information and shall use it only in accordance with the terms of the license agreement enclosed with this product or entered into with Fiorano.