Installation3

This document explains how to install IRIS on top of your server, desktop, notebook, etc.

Prerequisite

You should install MongoDB somewhere in the network that you can access. We do not cover the detail of the MongoDB installation.

download

You can download the complete source tree by ‘download ZIP’ or ‘clone in desktop’. Whatever method you choose, it’s OK. After unpacking the downloaded package, you will find two different projects: Torpedo, and Torpedo-controllers. Torpedo-controllers project is to develop IRIS controller instance which would be plugged into Torpedo (the IRIS controller). You will find the usage of Torpedo-controllers project later, so now let’s focus on Torpedo directory, and go into that.

you will always find a Torpedo.jar under the root folder. Just check there is a ‘controller’ folder, ‘lib’ folder, and ‘web’ folder under the same directory. You should also check that there are two default bundle controller implementations under the ‘controller’s directory with following names. (Actually, these two bundle controllers are from the Torpedo-controllers project, which are exported as jar files.)

• etri.sdn.controller.app.basic.BasicOFController.jar
• etri.sdn.controller.app.simple.SimpleOFController.jar

Before starting the IRIS controller, you should also check the configuration file. Under the root directory, you can easily find the configuration file named ‘torpedo.properties’. By opening the file, you can see following codes.

watcher-num = 2
storage-ip = X.X.X.X
storage-port = YYYY
storage-default-db = mydb
etri.sdn.controller.app.simple.SimpleOFController.instance-num = 6
etri.sdn.controller.app.simple.SimpleOFController.role = MASTER
etri.sdn.controller.app.simple.SimpleOFController.run = true
etri.sdn.controller.app.basic.BasicOFController.instance-num = 6
etri.sdn.controller.app.basic.BasicOFController.role = MASTER
etri.sdn.controller.app.basic.BasicOFController.run = false

With the above basic configuration, you probably have no problem in executing IRIS in most circumstances. But you should beware to enter the correct MongoDB IP Address and port number in this configuration. After that, you are free to go. Of course some part of this configuration you probably don’t understand, but that’s OK. You will later find the document which explains all the details of this file.

Kick IRIS to start

There are two different methods to execute IRIS. One is to run IRIS within Eclipse, which is a good method when you are a developer who searchers for a way to use IRIS in your environment. For that, you should import the whole source tree as a part of your workspace by Import –> General –> Existing Projects into Workspace.

However, in most cases, you can run IRIS by typing the following command:

java -jar Torpedo.jar

Then you can see some diagnostic (debugging) messages coming up on your terminal screen. If something goes wrong, that’s probably because your classpath and JAVA_HOME is wrongfully set.

By typing the above command, you have run the SimpleOFController located in ‘controllers’ directory. That’s because of the following line in ‘torpedo.properties’.

etri.sdn.controller.app.simple.SimpleOFController.run = true