File: install.rst

package info (click to toggle)
openstack-trove 2014.1.3-8
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 10,752 kB
  • ctags: 6,663
  • sloc: python: 37,317; xml: 1,485; sh: 281; makefile: 49
file content (107 lines) | stat: -rw-r--r-- 2,636 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.. _install:

==================
Trove Installation
==================

Trove is constantly under development. The easiest way to install
Trove is using the Trove integration scripts that can be found in
github in the `Trove Integration Repository`_.


Steps to set up a Trove Developer Environment
=============================================

----------------------------
Installing trove-integration
----------------------------

* Install a fresh Ubuntu 12.04 (Precise Pangolin) image (preferably a
  virtual machine)

* Make sure we have git installed::

    # apt-get update
    # apt-get install git-core -y

* Add a user named ubuntu if you do not already have one::

    # adduser ubuntu

* Set the ubuntu user up with sudo access::

    # visudo

  Add *ubuntu  ALL=(ALL) NOPASSWD: ALL* to the sudoers file.

* Login with ubuntu::

    # su ubuntu
    # cd ~

* Clone this repo::

    # git clone https://github.com/openstack/trove-integration.git

* cd into the scripts directory::

    # cd trove-integration/scripts/


---------------------------------
Running redstack to install Trove
---------------------------------

Redstack is the core script that allows you to install and interact
with your developer installation of Trove. Redstack has the following
options that you can run.

* Get the command list with a short description of each command and
  what it does::

    # ./redstack

* Install all the dependencies and then install Trove. This brings up
  trove (rd-api rd-tmgr) and initializes the trove database::

    # ./redstack install

* Kick start the build/test-init/build-image commands. Add mysql as a
  parameter to set build and add the mysql guest image::

    # ./redstack kick-start mysql

* You probably need to add this iptables rule, so be sure to save it!::

    # sudo iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j
    MASQUERADE


------------------------
Running the trove client
------------------------

* rd-client sets of the authorization endpoint and gets a token for you::

    # ./redstack rd-client


-----------------------
Running the nova client
-----------------------

* nova-client sets of the authorization endpoint and gets a token for you::

    # ./redstack nova-client


More information
================

For more information and help on how to use redstack and other
trove-integration scripts, please look at the `README documentation`_
in the `Trove Integration Repository`_.


.. _Trove Integration Repository: https://www.github.com/openstack/trove-integration
.. _README documentation: https://github.com/openstack/trove-integration/blob/master/README.md