66 lines
2.0 KiB
ReStructuredText
66 lines
2.0 KiB
ReStructuredText
..
|
|
Copyright 2010 OpenStack Foundation
|
|
All Rights Reserved.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
==============================================
|
|
Welcome to Tabula, the Keero Project Web UI!
|
|
==============================================
|
|
|
|
Tabula is a project that provides Web UI to Keero Project.
|
|
|
|
This document describes Tabula for contributors of the project, and assumes
|
|
that you are already familiar with Portas from an `end-user perspective`_.
|
|
|
|
.. _`end-user perspective`: http://keero.mirantis.com/
|
|
|
|
This documentation is generated by the Sphinx toolkit and lives in the source
|
|
tree.
|
|
|
|
Installation Guide
|
|
==================
|
|
Install
|
|
-------
|
|
1. Check out sources to some directory (<home>/keero)::
|
|
|
|
user@work:~/$ git clone ssh://<user>@gerrit.mirantis.com:29418/keero/keero.git
|
|
|
|
2. Install virtualenv::
|
|
|
|
user@work:~/$ cd keero/tabula && sudo python ./tools/install_venv.py
|
|
|
|
Configure
|
|
---------
|
|
1. Copy configuration file from template::
|
|
|
|
user@work:~/$ cp keero/tabula/tabula/local/local_settings.py.example keero/tabula/tabula/local/local_settings.py
|
|
|
|
2. Open configuration file for editing::
|
|
|
|
user@work:~/$ cd keero/tabula/tabula/local/ && nano local_settings.py
|
|
|
|
2. Configure according to you environment::
|
|
|
|
...
|
|
SECRET_KEY = 'some_random_value'
|
|
...
|
|
OPENSTACK_HOST = "localhost"
|
|
...
|
|
|
|
Run
|
|
----
|
|
Run Tabula in virtualenv::
|
|
|
|
user@work:~/$ cd keero/tabula && sudo ./tools/with_venv.sh python manage.py runserver 0.0.0.0:8080
|