~charmers/charms/precise/vsm/trunk

« back to all changes in this revision

Viewing changes to README.md

  • Committer: cwchang
  • Date: 2014-03-13 01:01:33 UTC
  • Revision ID: git-v1:b98a2db8da695aef96aee578f3d0d266bb9d605a
modified README, README.md and added copyright

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
juju-vsm
2
 
========
 
1
Overview
 
2
--------
 
3
There are two major components in a Cisco Nexus1000V 
 
4
environment : VSM and VEM (Virtual Ether Module). VSM 
 
5
is a virtual machine on a baremetal server. VEM runs 
 
6
inside each host. VSM, as the name goes, supervises and 
 
7
manages multiple VSMs.  
 
8
In the OpenStack deployment environment, VSM prepares north 
 
9
bound REST APIs that communicate with OpenStack Nova Cloud 
 
10
Controller for network profile configuration, policy profile 
 
11
notification, network creation, subnet creation, and virtual 
 
12
machine workload administration.
 
13
VSM charm installs the Nexus 1000V virtual switch Supervisor 
 
14
Module virtual machine  onto a MaaS cluster node. A cluster can 
 
15
have up to 2 VSM in active/standby mode. When the active one 
 
16
fails, the standby will take over within bounded time.
 
17
 
 
18
Usage
 
19
-----
 
20
In order to use Cisco Openstack solution we would need to install 
 
21
VSM on a cluster node as well as VEM module that goes into each 
 
22
host. 
 
23
 
 
24
In the config.yaml you can provide general config that will be 
 
25
common to all VSM hosts in environement. To differentiate the 
 
26
different primary and secondary VSM configuration, we create 
 
27
seperate sections for them, for example:
 
28
vsm-primary:
 
29
    n1kv-vsm-domain-id: 101
 
30
    n1kv-vsm-password: password
 
31
    n1kv-vsm-name: vsm-p
 
32
    n1kv-vsm-role: primary
 
33
    n1kv-vsm-ip: 10.10.10.10
 
34
    n1kv-vsm-mgmt-netmask: 255.255.255.0
 
35
    n1kv-mgmt-gateway: 10.10.10.1
 
36
    .....
 
37
vsm-secondary:
 
38
    n1kv-vsm-domain-id: 101
 
39
    n1kv-vsm-password: password
 
40
    n1kv-vsm-name: vsm-s
 
41
    n1kv-vsm-role: secondary
 
42
    n1kv-vsm-ip: 0.0.0.0
 
43
    n1kv-vsm-mgmt-netmask: 0.0.0.0
 
44
    n1kv-mgmt-gateway: 0.0.0.0
 
45
    .....
 
46
   
 
47
At deployment time, for primary:
 
48
   juju deploy --config=<vsm-config> vsm vsm-primary
 
49
At deployment time, for secondary:
 
50
   juju deploy --config=<vsm-config> vsm vsm-secondary
 
51
 
 
52
To put VEM into VSM supervision, user needs to do the following:
 
53
   juju add-relation vsm vem
 
54
 
 
55
Contact Information
 
56
-------------------
 
57
Author: Marga Millet Sorolla <millet@cisco.com>
 
58
Report bugs at: http://bugs.launchpad.net/charms/+source/vsm
 
59
Location: http://jujucharms.com/charms/distro/vem
 
60
 
 
61