Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Fiorano 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
...
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 | ||||
---|---|---|---|---|
|
Install the product with the .bin or .exe 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.
- Install a Cassandra Database Server and PostgreSQL server.
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=truefor directions to install Cassandra.
- Fiorano uses PostgreSQL for its analytics data store. To configure PostgreSQL for analytics, perform the following actions:
- Install PostgreSQL on the machine where you want your Analytics Database to be.
- Create your desired username, set the desired password and create the database that you want Fiorano to use for the purpose.
- Download the PostgreSQL JDBC driver for your JVM and keep it ready for the later steps.
- Once Fiorano is installed, some changes need to be done in the Fiorano setup for the Analytics to connect to the PostgreSQL. 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:
- Under section 2, change the <ip-address>, <port> and <database> variables to the actual desired settings of the above installed PostgreSQL setup.
- Under section 3 and section 4 of this document, provide the username and password credentials needed to connect to the installed database.
- Under section 6 and 7, provide the reconnect settings of your choice.
- 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.
Anchor | ||||
---|---|---|---|---|
|
The following steps will provide you with step by step instructions on how to go about using the product.
Anchor | ||||
---|---|---|---|---|
|
The Fiorano API installers work with the same license as used by the main Fiorano Platform.
Note |
---|
Please contact Fiorano Support at presales@fiorano.com in case you face license issues. |
Anchor | ||||
---|---|---|---|---|
|
Fiorano API Management product provides you with the below server setups:
- API Management Server (AMS)
- API Gateway Server (AGS)
Anchor | ||||
---|---|---|---|---|
|
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
Linux
Code Block $ ./server.sh -mode ams -profile server1 –nobackground
Windows
Code Block # sever.bat -mode ams -profile server1
Anchor | ||||
---|---|---|---|---|
|
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 target URLs. There can be multiple Gateway Servers running on a single network controlled by an API Management Server.
To start the AGS server, execute the following command at $FIORANO_HOME/esb/server/bin:
Linux
Code Block $ ./server.sh -mode ags -profile server1 –nobackground
Windows
Code Block # sever.bat -mode ags -profile server1
Fiorano also provides you with a pre-configured second Gateway Server Profile which can also be started by executing the following command at $FIORANO_HOME/esb/server/bin:
Linux
Code Block $ ./server.sh -mode ags -profile server2 –nobackground
Windows
Code Block # sever.bat -mode ags -profile server2
...
After logging in with the User name and Password credentials, the Dashboard Home page looks as in the following figure.
Info |
---|
Default user name and password are 'admin' and 'passwd' respectively). |
Figure 1: Fiorano API Management Dashboard Home page