| Calipso.io
| Installation Guide
-Copyright (c) 2017 Koren Lev (Cisco Systems), Yaron Yogev (Cisco Systems) and others
-All rights reserved. This program and the accompanying materials
-are made available under the terms of the Apache License, Version 2.0
-which accompanies this distribution, and is available at
-http://www.apache.org/licenses/LICENSE-2.0
-
|image0|
Project “Calipso” tries to illuminate complex virtual networking with
3.2 Fuel scenarios 7
-1. Pre Requisites
+Pre Requisites
===============
-1.1 Pre Requisites for Calipso “all in one” application
+Pre Requisites for Calipso “all in one” application
----------------------------------------------------
Calipso’s main application is written with Python3.5 for Linux
**sudo pip3 install docker**
-4. Git : https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
+ **sudo pip3 install inflect (>0.2.5)**
+
+1. Git : https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
-5. Docker : https://docs.docker.com/engine/installation/
+2. Docker : https://docs.docker.com/engine/installation/
-1.2 Pre Requisites for Calipso UI application
+Pre Requisites for Calipso UI application
------------------------------------------
Calipso UI is developed and maintained using Meteor Framework
required steps for installing the Calipso UI with several options
are listed below.
-2. Installation Options
+Installation Options
====================
-2.1 Monolithic App
+Monolithic App
---------------
For development use, one might require Calipso to be installed as a
**git clone https://git.opnfv.org/calipso/**
-4. Move to the default install directory: **cd calipso**
+1. Move to the default install directory: **cd calipso**
-5. Setup Python3 environment for calipso:
+2. Setup Python3 environment for calipso:
**export PYTHONPATH=/home/calipso/calipso/app**
-6. Follow quick-start guide on how to use calipso modules for monolithic
+1. Follow quick-start guide on how to use calipso modules for monolithic
scenario, and run each module manually.
-2.2 Micro Services App, single line install
+Micro Services App, single line install
---------------------------------------
For most users, this will be the fastest and more reliable install
1. Follow steps 1- 5 per section 2.1 above.
-2. Install the following python3 libraries using pip3 : docker, pymongo
+2. Install Docker : https://docs.docker.com/engine/installation/
+
+3. Install the following python3 libraries using pip3 : docker, pymongo
-3. Although Calipso installer can download all needed containers, if
- they does not exist locally already, we recommend doing a manual
+4. Although Calipso installer can download all needed containers, if
+ they doesn’t exist locally already, we recommend doing a manual
download of all 7 containers, providing better control and logging:
**sudo docker login** # use your DockerHub username and password to
**sudo docker pull korenlev/calipso:api** # api container for
application integration
- **sudo docker pull korenlev/calipso:sensu** # sensu server container
- for monitoring
+ **sudo docker pull korenlev/calipso:monitor** # sensu server
+ container for monitoring
**sudo docker pull korenlev/calipso:mongo** # calipso mongo DB
container
**sudo docker pull korenlev/calipso:ldap** # calipso ldap container
-4. Check that all containers were downloaded and registered
+1. Check that all containers were downloaded and registered
successfully:
**sudo docker images**
**korenlev/calipso scan 1ee60c4e61d5 6 hours ago 1.1GB**
- **korenlev/calipso sensu a8a17168197a 6 hours ago 1.65GB**
+ **korenlev/calipso monitor a8a17168197a 6 hours ago 1.65GB**
**korenlev/calipso mongo 17f2d62f4445 22 hours ago 1.31GB**
**korenlev/calipso ldap 316bc94b25ad 2 months ago 269MB**
-5. Run the calipso installer using single line arguments:
+1. Run the calipso installer using single line arguments:
**python3 calipso/app/install/calipso-installer.py--command
start-all --copy q**
This should launch all calipso modules in sequence along with all
needed configuration files placed in /home/calipso.
-2.3 Micro Services App, customized single line install
+Micro Services App, customized single line install
--------------------------------------------------
Calipso app includes the following directory in its default
an optional argument, default ‘calipso’ (calipso-mongo container’s
default) is deployed if not used.
-7. **--dbpassword **
-
- Allows to enter a password to be used for mongoDB access on the host,
- an optional argument, default ‘calipso\_default’ (calipso-mongo
- container’s default) is deployed if not used.
-
-8. **--apiport **
- Allows to enter a TCP port to be used for the Calipso API (default=8000)
-
-9. **--uchiwaport **
- Allows to enter a TCP port to be used for the Sensu UI (default=3000)
-
-10. **--rabbitmport **
- Allows to enter a TCP port to be used for the RabbitMQ mgmt (default=15672)
-
-11. **--sensuport **
- Allows to enter a TCP port to be used for the Sensu API (default=4567)
-
-12. **--rabbitport **
- Allows to enter a TCP port to be used for the RabbitMQ BUS (default=5671)
-
-2.4 Micro Services App, customized interactive install
+7. **--dbpassword**
+
+ Allows to enter a password to be used for mongoDB access on the
+ host, an optional argument, default ‘calipso\_default’
+ (calipso-mongo container’s default) is deployed if not used.
+
+1. **--apiport**
+
+ Allows to enter a TCP port to be used for the Calipso API
+ (default=8000)
+
+1. **--uchiwaport**
+
+ Allows to enter a TCP port to be used for the Sensu UI
+ (default=3000)
+
+1. **--rabbitmport**
+
+ Allows to enter a TCP port to be used for the RabbitMQ mgmt
+ (default=15672)
+
+1. **--sensuport**
+
+ Allows to enter a TCP port to be used for the Sensu API
+ (default=4567)
+
+1. **--rabbitport**
+
+ Allows to enter a TCP port to be used for the RabbitMQ BUS
+ (default=5671)
+
+Micro Services App, customized interactive install
--------------------------------------------------
Calipso’s application containers can be initiated and stopped
1. **Action? (stop, start, or 'q' to quit):**
2. **Container? (all, calipso-mongo, calipso-scan, calipso-listen,
- calipso-ldap, calipso-api, calipso-sensu, calipso-ui or 'q' to
+ calipso-ldap, calipso-api, calipso-monitor, calipso-ui or 'q' to
quit):**
3. **create initial calipso DB ? (copy json files from 'db' folder to
those are mandatory configuration files used by calipso containers to
interact with each other!
-2.5 OPNFV Options
+OPNFV Options
=============
Although calipso is designed for any VIM and for enterprise use-cases
APEX scenarios
---------------
-When using apex to install OPNFV, the Triple-O based OpenStack is
-installed automatically and calipso installation can be initiated
-automatically after apex completes the VIM installation process for
-a certain scenario.
-
-In this case setup_apex_environment.py can be used for creating a new environment automatically into mongoDB and UI of Calipso,
-instead of using the calipso UI to do that as typical user would do, then detailed scanning can start immediately,
-the following options are available for setup_apex_environment.py:
- -m [MONGO_CONFIG], --mongo_config [MONGO_CONFIG]
- name of config file with MongoDB server access details
- (Default: /local_dir/calipso_mongo_access.conf)
- -d [CONFIG_DIR], --config_dir [CONFIG_DIR]
- path to directory with config data (Default:
- /home/calipso/apex_setup_files)
- -i [INSTALL_DB_DIR], --install_db_dir [INSTALL_DB_DIR]
- path to directory with DB data (Default:
- /home/calipso/Calipso/app/install/db)
- -a [APEX], --apex [APEX]
- name of environment to Apex host
- -e [ENV], --env [ENV]
- name of environment to create(Default: Apex-Euphrates)
- -l [LOGLEVEL], --loglevel [LOGLEVEL]
- logging level (default: "INFO")
- -f [LOGFILE], --logfile [LOGFILE]
- log file (default:
- "/home/calipso/log/apex_environment_fetch.log")
- -g [GIT], --git [GIT]
- URL to clone Git repository (default:
- https://git.opnfv.org/calipso)
+ When using apex to install OPNFV, the Triple-O based OpenStack is
+ installed automatically and calipso installation can be initiated
+ automatically after apex completes the VIM installation process for
+ a certain scenario.
+
+ In this case setup\_apex\_environment.py can be used for creating a
+ new environment automatically into mongoDB and UI of Calipso
+ (instead of using the calipso UI to do that as typical user would
+ do), then detailed scanning can start immediately, the following
+ options are available for setup\_apex\_environment.py:
+
+ **-m [MONGO\_CONFIG], --mongo\_config [MONGO\_CONFIG]**
+
+ **name of config file with MongoDB server access details**
+
+ **(Default: /local\_dir/calipso\_mongo\_access.conf)**
+
+ **-d [CONFIG\_DIR], --config\_dir [CONFIG\_DIR]**
+
+ **path to directory with config data (Default:**
+
+ **/home/calipso/apex\_setup\_files)**
+
+ **-i [INSTALL\_DB\_DIR], --install\_db\_dir [INSTALL\_DB\_DIR]**
+
+ **path to directory with DB data (Default:**
+
+ **/home/calipso/Calipso/app/install/db)**
+
+ **-a [APEX], --apex [APEX]**
+
+ **name of environment to Apex host**
+
+ **-e [ENV], --env [ENV]**
+
+ **name of environment to create(Default: Apex-Euphrates)**
+
+ **-l [LOGLEVEL], --loglevel [LOGLEVEL]**
+
+ **logging level (default: "INFO")**
+
+ **-f [LOGFILE], --logfile [LOGFILE]**
+
+ **log file (default:**
+
+ **"/home/calipso/log/apex\_environment\_fetch.log")**
+
+ **-g [GIT], --git [GIT]**
+
+ **URL to clone Git repository (default:**
+
+ **https://git.opnfv.org/calipso)**
Fuel scenarios
---------------
Code Review / calipso.git / commitdiff