Installation manual

Home > Installation and configuration manuals > Installation manual

---

The present document describes how to install the whole OFELIA Control Framework package, including Expedient, Opt-in manager, VT AM (and its XEN agent).

Requirements

Please meet the following requirements strictly, or you may find several and unknown problems (e.g. in Ubuntu 12.04):

• One (or more) GNU/Linux Debian-based distros (see Note1)

  • Developed and ensured to work under Debian 6.0 (Squeeze)

• One (or more) GNU/Linux Debian-based distros to be virtualized by XEN (Virtualization Manager installations only)

• FlowVisor (Opt-in Manager installations only) (automatically installed)

• The following packages:

  • Python 2.6
  • Django 1.2.3 (automatically installed)
  • MySQL server (automatically installed)

  Note1: the OCF upgrading system (OFVER) [1] supports Debian-based distros only. For other distros you shall install the components manually.

Installing

1. Clone the OCF repository under folder /opt:

   git clone https://github.com/fp7-ofelia/ocf.git /opt/ofelia
   

   Alternatively you can download the tarball and uncompress it there

2. For Expedient, Opt-in, VT manager: choose the components to install as a root user. This will implicitly trigger OFVER:

   cd /opt/ofelia/deploy
   python install.py
   

   The following actions will take place:

   • Install dependencies
   • Build Certificates (see Note 2)
   • Configure Apache
   • Set file permissions
   • Modify the localsettings.py or mySettings.py depending on the component being installed
   • Populate database

   When installation starts, ofver will ask if it is an OFELIA project installation or not. Select No (N) for non OFELIA testbeds.

   Note2: When installing the component, you will need to create the certificates for the Certification Authority (CA) first and for the server later. Do not use the same Common Name (CN) for both of them, and make sure that the CN you use in the server later certificate (you can use an IP) is the same you then set in the SITE_DOMAIN field in the localsettings.py file.

3. For OXAD (XEN agent for virtualization purposes):

   Create the directory and clone the repository:

   mkdir -p /opt/ofelia/oxa
   git clone https://github.com/fp7-ofelia/ocf.git /opt/ofelia/oxa/repository
   

   The tree should look like:

   marc@foix:/opt/ofelia/oxa$ tree . -L 1
   └── repository    
   

   Trigger OFVER[1] install by performing the following as a root user (see Note 3):

   cd /opt/ofelia/oxa/repository/vt_manager/src/python/agent/tools
   ./ofver install
   

   Finally, the tree should look like:

   marc@foix:/opt/ofelia/oxa$ tree . -L 1  
   ├── bin -> /opt/ofelia/oxa//repository/vt_manager/src/python/agent/
   ├── cache
   ├── log
   ├── remote (see Note 4)
   └── repository
   
   

   Note3: When installation starts, ofver will ask if it is an OFELIA project installation or not, and accordingly ofver will download the VMs templates from the proper storage.

   Note4: A Network File System (NFS) can be mounted on the remote folder, replacing it. This is useful if you have limited disk space on your server, since any VM image not being currently used by users is stored under that path.

Additional notes

Please have a look to Manuals for further component configuration.

You can use -f force flag on OFVER to force installations/upgrades. Take a look at ./ofver -h for more details.

References

• [1] https://github.com/fp7-ofelia/pypelib/wiki/