~jk0/nova/xs-ipv6

« back to all changes in this revision

Viewing changes to docs/getting.started.rst

  • Committer: Jesse Andrews
  • Date: 2010-05-28 06:05:26 UTC
  • Revision ID: git-v1:bf6e6e718cdc7488e2da87b21e258ccc065fe499
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
..
 
2
      Copyright [2010] [Anso Labs, LLC]
 
3
 
 
4
      Licensed under the Apache License, Version 2.0 (the "License");
 
5
      you may not use this file except in compliance with the License.
 
6
      You may obtain a copy of the License at
 
7
 
 
8
          http://www.apache.org/licenses/LICENSE-2.0
 
9
 
 
10
      Unless required by applicable law or agreed to in writing, software
 
11
      distributed under the License is distributed on an "AS IS" BASIS,
 
12
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
13
      See the License for the specific language governing permissions and
 
14
      limitations under the License.
 
15
 
 
16
Getting Started with Nova
 
17
=========================
 
18
 
 
19
 
 
20
GOTTA HAVE A nova.pth file added or it WONT WORK (will write setup.py file soon)
 
21
 
 
22
DEPENDENCIES
 
23
------------
 
24
 
 
25
* RabbitMQ: messaging queue, used for all communication between components
 
26
* OpenLDAP: users, groups (maybe cut)
 
27
* Tornado: scalable non blocking web server for api requests
 
28
* Twisted: just for the twisted.internet.defer package
 
29
* boto: python api for aws api
 
30
* M2Crypto: python library interface for openssl
 
31
* IPy: library for managing ip addresses
 
32
* ReDIS: Remote Dictionary Store (for fast, shared state data)
 
33
 
 
34
Recommended
 
35
-----------------
 
36
* euca2ools: python implementation of aws ec2-tools and ami tools
 
37
* build tornado to use C module for evented section
 
38
 
 
39
 
 
40
Installation
 
41
--------------
 
42
::
 
43
 
 
44
    # ON ALL SYSTEMS
 
45
    apt-get install -y python-libvirt libvirt-bin python-setuptools python-dev python-pycurl python-m2crypto python-twisted
 
46
    apt-get install -y aoetools vlan
 
47
    modprobe aoe
 
48
 
 
49
    # ON THE CLOUD CONTROLLER
 
50
    apt-get install -y rabbitmq-server dnsmasq      
 
51
    # fix ec2 metadata/userdata uri - where $IP is the IP of the cloud
 
52
    iptables -t nat -A PREROUTING -s 0.0.0.0/0 -d 169.254.169.254/32 -p tcp -m tcp --dport 80 -j DNAT --to-destination $IP:8773
 
53
    iptables --table nat --append POSTROUTING --out-interface $PUBLICIFACE -j MASQUERADE     
 
54
    # setup ldap (slap.sh as root will remove ldap and reinstall it)   
 
55
    auth/slap.sh     
 
56
    /etc/init.d/rabbitmq-server start
 
57
 
 
58
    # ON VOLUME NODE:
 
59
    apt-get install -y vblade-persist 
 
60
 
 
61
    # ON THE COMPUTE NODE:
 
62
    apt-get install -y kpartx kvm
 
63
 
 
64
    # optional packages
 
65
    apt-get install -y euca2ools 
 
66
                                   
 
67
    # Set up flagfiles with the appropriate hostnames, etc.                                     
 
68
    # start api_worker, s3_worker, node_worker, storage_worker
 
69
    # Add yourself to the libvirtd group, log out, and log back in
 
70
    # Make sure the user who will launch the workers has sudo privileges w/o pass (will fix later)