<commit_before># IOTP Orchestrator [![Build Status](http://ci-iot-deven-01/jenkins/job/IOTP-Orchestrator-Package/badge/icon)](http://ci-iot-deven-01/jenkins/job/IOTP-Orchestrator-Package/)

Orchestrator tries to group all provision operations for IoT platform that tipically implies several steps or several systems interaction.
Orchestrator exposes an API and provide scripts commands to perform all these operations. Script commands simplifies the inherent usage of keystone, such as usage of long identifiers no so easy to remember and to use, using names al resolving internally to deal with keystone.
Orchestrator Script commands can interact with any remote Keystone and Keypass, since related host and port should be provideed as argument to earch script.
Orchestrator is used maninly by [IoT Portal](https://pdihub.hi.inet/fiware/iotp-portal) and operation team

A tipical scenario for IoT Platform can be [scenario_test](https://pdihub.hi.inet/ep/fiware-components/wiki/Keystone-scenario-test) or [these](https://github.com/telefonicaid/orchestrator/blob/develop/src/tests/scenarios/SCENARIOS.md)

- Create/List/Update/Delete services
- Create/List/Update/Delete subservices
- Create/List/Update/Delete users in a service
- Create/List/Update/Delete roles in a service
- Assign/unassign roles to users in a service
- Create/List Trust Tokens
- Activate / deactivate IoT Modules
- Retrieve statistics about API usage

Orchestrator is based mainly on:
- Python
- Django / DjangoRestFramework
- httplib

Orchestrator relies on these other IoT parts:
- Identity Manager (Keystone)
- Access Control (Keypass)
- Context Broker (Orion)
- IoTAgent (IoTA)
- CEP (Perseo)

These are all dependencies [requirements.txt](https://github.com/telefonicaid/orchestrator/blob/develop/requirements.txt)

Orchestrator needs a WSGI server like Apache, Lighttpd or NGIX. [wsgi.py](https://github.com/telefonicaid/orchestrator/blob/develop/src/wsgi.py)

Orchestrator interacts mainly with Identity Manager [Keystone](https://github.com/telefonicaid/fiware-keystone-scim) and Access Control [Keypass](https://github.com/telefonicaid/fiware-keypass).
Since ContextBroker and IotAgent are secured elements (by [PepProxy](https://github.com/telefonicaid/fiware-pep-steelskin)) orchestrator can interact directly with tem using user provided credencials. If credencials or access control level is not enoght then orchestrator operation will not be performed.

In this README document you will find how to get started with the application and basic concepts. For a more detailed information you can read the following docs:

* [API](http://docs.orchestrator2.apiary.io)
* [scripts](SCRIPTS.md)
* [Logs and Alarms](TROUBLESHOOTING.md)
* [Installation guide](INSTALL.md)
* [Configuration](CONFIG.md)
* [IoTModules](IOTMODULES.md)
<commit_msg>add entry for docker in README<commit_after># IOTP Orchestrator [![Build Status](http://ci-iot-deven-01/jenkins/job/IOTP-Orchestrator-Package/badge/icon)](http://ci-iot-deven-01/jenkins/job/IOTP-Orchestrator-Package/)

Orchestrator tries to group all provision operations for IoT platform that tipically implies several steps or several systems interaction.
Orchestrator exposes an API and provide scripts commands to perform all these operations. Script commands simplifies the inherent usage of keystone, such as usage of long identifiers no so easy to remember and to use, using names al resolving internally to deal with keystone.
Orchestrator Script commands can interact with any remote Keystone and Keypass, since related host and port should be provideed as argument to earch script.
Orchestrator is used maninly by [IoT Portal](https://pdihub.hi.inet/fiware/iotp-portal) and operation team

A tipical scenario for IoT Platform can be [scenario_test](https://pdihub.hi.inet/ep/fiware-components/wiki/Keystone-scenario-test) or [these](https://github.com/telefonicaid/orchestrator/blob/develop/src/tests/scenarios/SCENARIOS.md)

- Create/List/Update/Delete services
- Create/List/Update/Delete subservices
- Create/List/Update/Delete users in a service
- Create/List/Update/Delete roles in a service
- Assign/unassign roles to users in a service
- Create/List Trust Tokens
- Activate / deactivate IoT Modules
- Retrieve statistics about API usage

Orchestrator is based mainly on:
- Python
- Django / DjangoRestFramework
- httplib

Orchestrator relies on these other IoT parts:
- Identity Manager (Keystone)
- Access Control (Keypass)
- Context Broker (Orion)
- IoTAgent (IoTA)
- CEP (Perseo)

These are all dependencies [requirements.txt](https://github.com/telefonicaid/orchestrator/blob/develop/requirements.txt)

Orchestrator needs a WSGI server like Apache, Lighttpd or NGIX. [wsgi.py](https://github.com/telefonicaid/orchestrator/blob/develop/src/wsgi.py)

Orchestrator interacts mainly with Identity Manager [Keystone](https://github.com/telefonicaid/fiware-keystone-scim) and Access Control [Keypass](https://github.com/telefonicaid/fiware-keypass).
Since ContextBroker and IotAgent are secured elements (by [PepProxy](https://github.com/telefonicaid/fiware-pep-steelskin)) orchestrator can interact directly with tem using user provided credencials. If credencials or access control level is not enoght then orchestrator operation will not be performed.

In this README document you will find how to get started with the application and basic concepts. For a more detailed information you can read the following docs:

* [API](http://docs.orchestrator2.apiary.io)
* [scripts](SCRIPTS.md)
* [Logs and Alarms](TROUBLESHOOTING.md)
* [Installation guide](INSTALL.md)
* [Configuration](CONFIG.md)
* [IoTModules](IOTMODULES.md)
* [Docker configuraton](DOCKER.md)

{'fraction_non_alphanumeric': 0.08886547242711626, 'fraction_numerical': 0.0017562346329469617, 'mean_word_length': 5.217248908296943, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 16, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5840577', 'n_tokens_mistral': 1725, 'n_tokens_neox': 1675, 'n_words': 555}