...

Table of Contents
indent 15px style none

...

This is a getting started Guide for the API Management product which provides a platform to build web proxies on top of existing web services to secure them as well as to analyze the footfall to the backend serversFiorano API Management is quick to install and easy to use. To start with the installation apart from JAVA1.7.0_55 and ANT1.9.2 we will need a few prerequisite Third Party installations which include

• Cassandra DB Server - It is used as the base Database to store all information about the API Proxy, its projects and deployment specifications
• PostgreSQL DB Server - This is your analytics database, all analytics data being tracked at the proxy is stored and fetched from here for processing.
  
  

We have created a step by step guide below to assist you with the installation of these and the Fiorano API Management product; this guide also tells you how to access the Fiorano API Dashboard.

Anchor
_Toc396220940 _Toc396220940

Prerequisites

Perform the following before setting up the Product.

1. Install the product with the the .bin or  or .exe installer  installer of the product; run the installer which gives you an intuitive wizard to install the Fiorano setup as per your needs.

   Note
   Further in this document, "$FIORANO_HOME" refers to the Fiorano Setup installation directory.

2. The main prerequisite for the product, apart from JAVA 1.7.0_55 and ANT 1.9.2, are the installation of Install a Cassandra Database Server and PostGre SQL PostgreSQL server.
   
   

   1. Cassandra Database is an open source database that provides unmatched linear scalability and high availability with proven fault tolerance and is used to store details that needs to be looked up on the fly.

      Note
      Please refer http://planetcassandra.org/cassandra/?action=true for directions to install Cassandra. For now the assumption is that both Management Server and Gateway are in same machine with Cassandra installed in it.

   2. Fiorano uses PostGre SQL PostgreSQL for its analytics data store. To configure PostGre SQL PostgreSQL for analytics, perform the following actions:
      1. Install PostGre on PostgreSQL on the machine where you want your Analytics Database to be.
      2. Create your desired username, set the desired password and create the database that you want Fiorano to use for the purpose.
      3. Download the PostGre JDBC PostgreSQL JDBC driver for your JVM and keep it ready for the later steps.
      4. Once Fiorano is installed, some changes need to be done in the Fiorano setup for the Analytics to connect to the PostGre SQLPostgreSQL. To  To do this, open the apidb.cfg file present at $FIORANO_HOME/esb/server/profiles/server1/AMS/conf and make the following changes in the document:
         
         1. Under section 2, change the <ip-address>, <port> and <database> variables to the actual desired settings of the above installed PostGre setup PostgreSQL setup.
         2. Under section 3 and section 4 of this document, provide the username and password credentials needed to connect to the installed database.
         3. Under section 6 and 7, provide the reconnect settings of your choice.
         4. Go to $FIORANO_HOME/esb/server/bin/server.conf and under the <java.classpath> segment, add the path to the above downloaded JDBC driver, so that the driver gets added to the classpath of the JVM.
            
            

Now you are ready for the set up. You may continue with the steps mentioned in the next section.

...

...

Fiorano API Management product provides you with two the below server setups:

• API Management Server (AMS)
• API Gateway Server (AGS)

...

This is the control centre of the API Management product. It is the place from where all the main deployment of your API projects and policies will be controlled. The API Dashboard is also hosted on this server.

To start the AMS server, please execute the following command at $FIORANO_HOME/esb/server/bin

...

This is the server on which the projects get deployed. This server will be the place to which the clients will connect before their traffic is stored for analysis and request is redirected to the backend APItarget URLs. There can be multiple Gateway Servers running on a single network controlled by an API Management Server.

...