Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..ea87d30
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,343 @@
+
+=======
+Horizon
+=======
+
+OpenStack dashboard project
+
+Sample pillars
+==============
+
+Packaged version of horizon
+---------------------------
+
+One horizon on server
+
+Simplest horizon setup with managed cloud-archive repo on ubuntu 12.04
+
+ linux:
+ system:
+ name: horizon
+ repo:
+ - cloudarchive-havana:
+ enabled: true
+ source: 'deb http://ubuntu-cloud.archive.canonical.com/ubuntu precise-updates/havana main'
+ pgpcheck: 0
+ horizon:
+ server:
+ manage_repo: true
+ enabled: true
+ secret_key: MEGASECRET
+ host:
+ name: cloud.lab.cz
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_HORIZON'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 2
+ mail:
+ host: '127.0.0.1'
+
+Simple branded horizon
+
+ horizon:
+ server:
+ enabled: true
+ branding: 'OpenStack Company Dashboard'
+ default_dashboard: 'admin'
+ help_url: 'http://doc.domain.com'
+
+Horizon package setup with SSL
+
+ horizon:
+ server:
+ enabled: true
+ secret_key: MEGASECRET
+ version: juno
+ ssl:
+ enabled: true
+ authority: CA_Authority
+ host:
+ name: cloud.lab.cz
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_HORIZON'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 2
+ mail:
+ host: '127.0.0.1'
+
+Multi-regional horizon setup
+
+ horizon:
+ server:
+ enabled: true
+ version: juno
+ secret_key: MEGASECRET
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_HORIZON'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 2
+ mail:
+ host: '127.0.0.1'
+ regions:
+ - name: cluster1
+ address: http://cluster1.example.com:5000/v2.0
+ - name: cluster2
+ address: http://cluster2.example.com:5000/v2.0
+
+Horizon setup with sensu plugin
+
+ horizon:
+ server:
+ enabled: true
+ version: juno
+ sensu_api:
+ host: localhost
+ port: 4567
+ plugins:
+ - name: monitoring
+ app: horizon_monitoring
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-monitoring.git
+ rev: develop
+ - name: api-mask
+ app: api_mask
+ mask_url: 'custom-url.cz'
+ mask_protocol: 'http'
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-api-mask.git
+ rev: develop
+
+Sensu multi API
+
+ horizon:
+ server:
+ enabled: true
+ version: juno
+ sensu_api:
+ dc1:
+ host: localhost
+ port: 4567
+ dc2:
+ host: anotherhost
+ port: 4567
+
+Horizon setup with billometer plugin
+
+ horizon:
+ server:
+ enabled: true
+ version: juno
+ billometer_api:
+ host: localhost
+ port: 9753
+ api_version: 1
+ plugins:
+ - name: billing
+ app: horizon_billing
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-billing.git
+ rev: develop
+
+Horizon setup with contrail plugin
+
+ horizon:
+ server:
+ enabled: true
+ version: icehouse
+ plugins:
+ - name: contrail
+ app: contrail_openstack_dashboard
+ override: true
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-contrail.git
+ rev: develop
+
+Horizon setup with sentry log handler
+
+ horizon:
+ server:
+ enabled: true
+ version: juno
+ ...
+ logging:
+ engine: raven
+ dsn: http://pub:private@sentry1.test.cz/2
+
+Multisite with Git source
+-------------------------
+
+Simple Horizon setup from git repository
+
+ horizon:
+ server:
+ enabled: true
+ app:
+ default:
+ secret_key: MEGASECRET
+ source:
+ engine: git
+ address: https://github.com/openstack/horizon.git
+ rev: stable/havana
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_DEFAULT'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 2
+ mail:
+ host: '127.0.0.1'
+
+Themed multisite setup
+
+ horizon:
+ server:
+ enabled: true
+ app:
+ openstack1c:
+ secret_key: MEGASECRET1
+ source:
+ engine: git
+ address: https://github.com/openstack/horizon.git
+ rev: stable/havana
+ plugin:
+ contrail:
+ app: contrail_openstack_dashboard
+ override: true
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-contrail.git
+ rev: develop
+ theme:
+ app: site1_theme
+ source:
+ type: git
+ address: git@repo1.domain.com:django/horizon-site1-theme.git
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_SITE1'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 2
+ mail:
+ host: '127.0.0.1'
+ openstack2:
+ secret_key: MEGASECRET2
+ source:
+ engine: git
+ address: https://repo1.domain.com/openstack/horizon.git
+ rev: stable/icehouse
+ plugin:
+ contrail:
+ app: contrail_openstack_dashboard
+ override: true
+ source:
+ type: git
+ address: git@repo1.domain.com:django/horizon-contrail.git
+ rev: develop
+ monitoring:
+ app: horizon_monitoring
+ source:
+ type: git
+ address: git@domain.com:django/horizon-monitoring.git
+ rev: develop
+ theme:
+ app: bootswatch_theme
+ source:
+ type: git
+ address: git@repo1.robotice.cz:django/horizon-bootswatch-theme.git
+ rev: develop
+ cache:
+ engine: 'memcached'
+ host: '127.0.0.1'
+ port: 11211
+ prefix: 'CACHE_SITE2'
+ identity:
+ engine: 'keystone'
+ host: '127.0.0.1'
+ port: 5000
+ api_version: 3
+ mail:
+ host: '127.0.0.1'
+
+API versions override
+
+ horizon:
+ server:
+ enabled: true
+ app:
+ openstack_api_overrride:
+ secret_key: MEGASECRET1
+ api_versions:
+ identity: 3
+ volume: 2
+ source:
+ engine: git
+ address: https://github.com/openstack/horizon.git
+ rev: stable/havana
+
+Control dashboard behaviour
+
+ horizon:
+ server:
+ enabled: true
+ app:
+ openstack_dashboard_overrride:
+ secret_key: MEGASECRET1
+ dashboards:
+ settings:
+ enabled: true
+ project:
+ enabled: false
+ order: 10
+ admin:
+ enabled: false
+ order: 20
+ source:
+ engine: git
+ address: https://github.com/openstack/horizon.git
+ rev: stable/juno
+
+Read more
+=========
+
+* https://github.com/openstack/horizon
+* http://dijks.wordpress.com/2012/07/06/how-to-change-screen-resolution-of-novnc-client-in-openstack-essex-dashboard-nova-horizon/
+
+
+Things to improve
+=================
+
+* ALLOWED_HOSTS - do not use * - introduce parameters
+* CACHES - configure caching engine - is it not allowed by default?
+* SESSION_ENGINE - change it from signed cookie to something else
+* policy files - look into these files and think of further configuration/parametrisation