Overview

The installation procedure is fairly simple, and consists of only a few steps:

• Download the appropriate installer for Fiorano SOA platform.
• Prepare system for installation.
• Run the executable to install the platform.

Minimum System Requirement

Installing Fiorano SOA Platform

Installation Instructions for Windows

To install Fiorano SOA Platform on Windows OS, perform the following steps:

• Download Fiorano SOA installer from http://www.fiorano.com/downloads/fsoa/index.php
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity
• Run the file by double clicking on it. The Fiorano SOA installation wizard page opens to start the installation process.
• Click the Next button. The License Agreement page opens on which you must choose I accept radio button and click Next to continue installation. The Customer Information page appears.
  Note: You can also print the license agreement for future reference.
• Provide the user name and company name in the User Name and Company Name column and click the Next button. The Choose Destination Location page appears. This page allows you to change the Fiorano SOA Platform destination folder.
• Click Next, or click Change button incase you want to change the location of FioranoSOA installation. Provide the destination location where Fiorano SOA has to be installed and click Next to proceed.
• Select the installation type and click the Next button. To install the complete package (Enterprise Server, Peer Server and Tools) select Enterprise option. To install Peer Server and Tools, select WorkStation option. To install custom type, select Custom option.
• Select the Program Folder to which icons of the Fiorano SOA platform should be added and click the Next button.
• Click Install to continue installation.
• Once the installation is complete, select the action which has to be performed.
  • Select the option Yes, I want to view FioranoSOAX.X.Xdocs to view the documentation.
  • Select the option Yes, I want to Launch Fiorano Studio to launch Fiorano Studio.
• Click the Finish button to complete the installation.

For more details on how to start and use the Fiorano ESB Servers and Tools, please refer to FIORANO_INSTALLATION_DIR/GettingStartedGuide.htm

Installation Instructions for Linux

To install Fiorano SOA Platform on Linux OS, perform the following steps:

• Download FioranoSOA X.X.X installer file from http://www.fiorano.com/downloads/fsoa/index.php
  Note: Make sure JAVA_HOME environment variable is set to JDK 1.5.
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity.
• Open terminal at the location where the file fsoaX.X.X_bXXXX_linux.bin is located.
• Give the executable permissions to the file by using the command "chmod +x fsoaX.X.X_bXXXX_linux.bin"
• Execute the bin file using command "./fsoaX.X.X_bXXXX_linux.bin". A wizard opens up where the installation details can be provided.
• Click the Next button. The License Agreement page opens on which you must choose I accept radio button and click Next to continue installation. The Customer Information page appears.
  Note: You can also print the license agreement for future reference.
• Provide the user name and company name in the User Name and Company Name column and click the Next button. The Choose Installation Type page appears.
• Select the installation type and click Next. To install the complete package (Enterprise Server, Peer Server and Tools) select Enterprise Version option. To install Peer Server and Tools, select WorkStation Version option. To install only Tools, select Tools option. This page allows you to change the Fiorano SOA Platform destination folder.
• Click Next or click Browse button incase if you want to change the location of Fiorano SOA installation. Provide the destination location where Fiorano SOA has to be installed and click Next to proceed.
• Click Install to continue installation.
• Click Finish to complete the installation.

Installation Instructions for Unix

To install Fiorano SOA Platform on Windows platform, perform the following steps:

• Download FioranoSOA X.X.X installation zip file from http://www.fiorano.com/downloads/fsoa/index.php. Select Unix while downloading
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity.
• Execute the command tar xvfz fsoaX.X.X_bXXXX.gnu.tar.gz to install Fiorano SOA Platform.

Installation Instructions for Solaris Sparc

To install Fiorano SOA Platform on Solaris Sparc OS, perform the following steps:

• Download FioranoSOA X.X.X installer file from http://www.fiorano.com/downloads/fsoa/index.php
  Note: Make sure JAVA_HOME environment variable is set to JDK 1.5.
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity.
• Open terminal at the location where the file fsoaX.X.X_bXXXX_ sparc.bin is located.
• Give the executable permissions to the file by using the command chmod +x fsoaX.X.X_bXXXX_sparc.bin.
• Execute the bin file using command ./fsoaX.X.X_bXXXX_ sparc.bin. A wizard opens up where the installation details can be provided.
• Click the Next button. The License Agreement page opens on which you must choose I accept radio button and click Next to continue installation. The Customer Information page appears.
  Note: You can also print the license agreement for future reference.
• Provide the user name and company name in the User Name and Company Name column and click the Next button. The Choose Installation Type page appears.
• Select the installation type and click Next. To install the complete package (Enterprise Server, Peer Server and Tools) select Enterprise Version option. To install Peer Server and Tools, select WorkStation Version option. To install only Tools, select Tools option.
• Click Next or click Browse button incase if you want to change the location of Fiorano SOA installation. Provide the destination location where Fiorano SOA has to be installed and click Next to proceed.
• Click Install to continue installation.
• Click the Finish button to complete the installation.

Installation Instructions for Solaris X86

To install Fiorano SOA Platform on Solaris X86 platform, perform the following steps:

• Download FioranoSOA X.X.X installer file from http://www.fiorano.com/downloads/fsoa/index.php.
  Note: Make sure JAVA_HOME environment variable is set to JDK 1.5.
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity.
• Open terminal at the location where the file fsoaX.X.X_bXXXX_ intel.bin is located.
• Give the executable permissions to the file by using the command chmod +x fsoaX.X.X_bXXXX_intel.bin.
• Execute the bin file using command ./fsoaX.X.X_bXXXX_ intel.bin. A wizard opens up where the installation details can be provided.
• Click the Next button. The License Agreement page opens on which you must choose I accept radio button and click Next to continue installation. The Customer Information page appears.
  Note: You can also print the license agreement for future reference.
• Provide the user name and company name in the User Name and Company Name column and click the Next button. The Choose Installation Type page appears.
• Select the installation type and click Next. To install the complete package (Enterprise Server, Peer Server and Tools) select Enterprise Version option. To install Peer Server and Tools, select WorkStation Version option. To install only Tools, select Tools option.
• Click Next or click Browse button incase if you want to change the location of Fiorano SOA installation. Provide the destination location where Fiorano SOA has to be installed and click Next to proceed.
• Click Install to continue installation.
• Click the Finish button to complete the installation.

Installation Instructions for Mac OS

To install Fiorano SOA Platform on Mac OS platform, perform the following steps:

• Download FioranoSOA X.X.X installation zip file from http://www.fiorano.com/downloads/fsoa/index.php. Select Mac while downloading.
• Once the file is downloaded, its integrity can be checked by following the steps in section Verifying Installer Integrity.
• Execute the command tar xvfz fsoaX.X.X_bXXXX_macosx-carbon.tar.gz or double click on the file to install the Fiorano SOA Platform.

Verifying Installer Integrity

It is essential that you verify the integrity of the downloaded installer files to ensure the file you downloaded is not currupt. Fiorano provides pre-calculated hash values using SHA1 and MD5 Algorithms for each installer. One can use the Fiorano provided checksum utility or other command line programs like md5sum/sha1sum/md5/sha1 to check the integrity.

How to check:

The simple way is download the 'Fiorano checksum utility', provide the values for the properties specified in checksum.properties file and run the 'ant' command. You will directly receive the result of the downloaded installer file's integrity check.

OR

Run the command md5sum/sha1sum or md5/sha1.
Let's say you want to check the file fsoa_***.exe using MD5, type the command below in the terminal.

$ md5sum fsoa_***.exe

After running this command, md5sum prints out the 128-bit hash value. Compare this string you obtained with the hash value provided at the product downloads link. If both are identical, then the download is accurate else the download is corrupt, Please download the installer again. Similarly one can perform the above steps after executing the following command using 'sha1sum', that prints out 160-bit hash value for fsoa_***.tar.gz file.

$ sha1sum fsoa_***.tar.gz

Note: The 'Fiorano checksum' utility uses java 1.5 or above and ANT 1.6.5 or above.

• Unix programs called md5sum/sha1sum or md5/sha1 are included in many unix distributions.
• Windows users can get binary md5 programs from http://www.fourmilab.ch/md5/ and http://www.pc-tools.net/win32/freeware/console/.
• fsum - 'File Integrity Checker' can be used to calculate both SHA1 and MD5 hash values.

Uninstalling Fiorano SOA Platform

Uninstallation Instructions for Windows

To uninstall Fiorano SOA Platform, perform the following steps:

• Click the Start menu – All Programs – Fiorano – FioranoSOAX.X.X – Uninstall Fiorano SOA X.X.X.
• Click Yes to start the un-installation.
• Click Finish to complete un-installation.

Or

• Open command prompt window in FIORANO_INSTALLATION_DIR and select uninstall.bat file, follow the 2nd and 3rd steps as mentioned above.

After un-installation the following folders will be present in FIORANO_INSTALLATION_DIR

• esb
  • esb/server folder contains subfolders bin, jetty, and profiles.
• _uninstall
• eStudio folder containing subfolders Configuration and P2.
• licenses
• runtimedata – contains all the Event Processes, Services etc.

Note: Retain a backup of this folder if the data has to migrated to a different Fiorano installation.

Uninstallation Instructions for Linux

To uninstall the Fiorano SOA Platform, open terminal at $Fiorano_Home/_uninstall and execute the command ./uninstaller.bin to get the wizard page.

• Select Uninstall to uninstall the FioranoSOA
• Click Finish to complete the uninstallation.

After un-installation the following folders will be present in FIORANO_INSTALLATION_DIR

• esb
  • esb/server folder contains subfolders bin, jetty, and profiles.
• _uninstall
• eStudio folder containing subfolders Configuration and P2.
• licenses
• runtimedata

Note: Retain a backup of this folder if the data has to migrated to a different Fiorano installation.

Uninstallation Instructions for Solaris Sparc

To uninstall the Fiorano SOA Platform, open terminal at $Fiorano_Home/_uninstall and execute the command ./uninstaller.bin to get the wizard page.

• Select Uninstall to uninstall the FioranoSOA
• Click Finish to complete the uninstallation.

After un-installation the following folders will be present in FIORANO_INSTALLATION_DIR

• esb
  • esb/server folder contains subfolders bin, jetty, and profiles.
• _uninstall
• eStudio folder containing subfolders Configuration and P2.
• licenses
• runtimedata

Note: Retain a backup of this folder if the data has to migrated to a different Fiorano installation

Uninstallation Instructions for Solaris X86

To uninstall the Fiorano SOA Platform, open terminal at $Fiorano_Home/_uninstall and execute the command ./uninstaller.bin to get the wizard page.

• Select Uninstall to uninstall the FioranoSOA
• Click Finish to complete the uninstallation.

After un-installation the following folders will be present in FIORANO_INSTALLATION_DIR

• esb
  • esb/server folder contains subfolders bin, jetty, and profiles.
• _uninstall
• eStudio folder containing subfolders Configuration and P2.
• licenses
• runtimedata

Note: Retain a backup of this folder if the data has to migrated to a different Fiorano installation

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.