Get started with the Fiorano ESB Community Edition project in a few minutes following the below sections:

Installing Fiorano ESB Community Edition platform

  1. Download the Fiorano ESB Community Edition binary distribution available in Zip format (Windows) or tar.gz format (*nix).
     
  2. Extract it to your preferred location on the disk drive.

    Icon
    • The root folder to which the installer is extracted is referred as FIORANO_HOME here on.
    • The path of the folder into which it is extracted should not have any spaces in it.
    Icon

    Refer the System Requirements section to understand the minimum system requirements.

  3. Copy the license file (provided to you) to the FIORANO_HOME/licenses folder.

    Icon

    In case you have not received a license file, please contact licensing@fiorano.com

  4. Install Java 8, and set JAVA_HOME using one of the two ways mentioned below:

    1. as an Environment Variable.

    2. edit the script file as follows:

      1. Navigate through the extracted files to the FIORANO_HOME/bin directory.

      2. Add the location of the specific Java version in the respective script files (open using a text editor to edit) in the following manner:

        • Windows
          Add the following line of script under @echo off in the fiorano.bat file:

        • Linux
          Add the following line of script under #!/bin/sh in the fiorano.sh file:

    Icon
    • Only Java 8 and higher versions are supported.
    • 32-bit Java architecture is recommended.
  5. In the FIORANO_HOME/bin directory, execute the following command to launch the server:

    Windows
    Linux
    Icon

    The Fiorano server starts along with its dependent modules.

Launching Fiorano eStudio

Fiorano eStudio is an Orchestration tool used to create microservice application flows.

To launch the eStudio application, perform the following actions:

  1. Navigate to FIORANO_HOME/eStudio/bin and run the eStudio executable file.

    Icon

    Ensure not to leave any spaces while providing the installed folder path.

    Icon

    Refer to the Starting Fiorano eStudio section to set different JDK versions and Launch eStudio using 64-bit JVM. These steps illustrated in the documentation for the Fiorano ESB Core (Enterprise edition) holds good for Fiorano eStudio as well.

    Icon

    The following screen bearing the copyright information appears while the eStudio starts up.


    Figure 1: Fiorano eStudio logo with copyright info 


  2. Choose your preferred Workspace Directory and click OK.


    Figure 2: Setting the Workspace Directory 

    Icon

    Fiorano eStudio landing screen appears.


    Figure 3: Fiorano eStudio Landing page

     

  3. To log on to the EnterpriseServer, perform any of the following actions:
    1. Double-click the EnterpriseServer node
    2. Right-click the EnterpriseServer node and click Login.


      Figure 4: Loggin on to the server

      Icon

      While logging on for the first time, a Server Authentication Dialog pops up prompting to provide the eStudio credentials; provide the credentials as below:

      • User Name: admin
      • Password: passwd

      Figure 5: Providing log in credentials
  4. Notice that an Event Process Repository node appears under the EnterpriseServer node and the list of microservices appear in the Microservice Repository and Micro Service palette.


    Figure 6: Fiorano eStudio with the pre-built microservices appearing after logging on to the server
     
  5. Expand the Event Process Repository node to find the Basic sample event processes available to illustrate the core functionality of each pre-built microservice present under the Micro Service palette


    Figure 7: Basic Sample Event Processes

Launching a Sample Event Process

To launch a sample event process present under the Event Process Repository node, perform the following actions:

  1. Open the Event Process by performing any one of the following actions:
    1. Double-click the preferred sample event process.
    2. Right-click the preferred sample event process and click Open; the event process appears on the editor screen called Fiorano orchestrator.
       

    Figure 8: Aggregator sample opened

  2. Click the Resource and Connectivity icon   (ALT+SHIFT+C) present above the orchestrator to check the resources and connectivity and then click the Run Event Process icon  (ALT+SHIFT+R) to execute the event process.


    Figure 9: Resource and Connectivity and Run Event Process icons

    Icon

    The windows corresponding to the microservices involved in the executed event process get popped up (see the figure below).

  3. To go through the Help content pertaining to the
    1. Sample Event Process: Click anywhere on the Fiorano Orchestrator, but not on the microservices or the routes connecting them, and Press F1


      Figure 10: Event Process Help content

       

    2. Microservice: Click the preferred microservice and press F1.

      Icon

      It opens the respective Pre-built Microservices documentation link for the Fiorano ESB Core, which explains all the features that the Fiorano Microservices provide.

  4. Click the Stop Event Process icon to stop the running event process.


    Figure 11: Event Process running with the activated Stop icon
     
Icon
  • The above operations can be managed from the Fiorano Management Console too.
  • To understand how to add a pre-built microservice to compose your own Event Process and do more with the microservices, follow the links in next section which leads to the respective content.

Working with Fiorano eStuido

If you want to explore more on Fiorano eStudio, refer the following subsections under the eStudio section present in the Fiorano Enterprise Edition documentation.

Icon

Note that a few sections which are not mentioned above but visible in the documentation to which the links lead to are Enterprise Edition specific.

Useful sections based on eStudio workflow

Icon
Adaptavist ThemeBuilder EngineAtlassian Confluence