← Back to branch summary

~springfield-team/charms/precise/vsm/trunk

« back to all changes in this revision

Viewing changes to README.md

  • Committer: Marga Millet
  • Date: 2014-04-18 15:34:12 UTC
  • Revision ID: millet@cisco.com-20140418153412-fmdwf7codngz7mg9
Add more info to README.md file

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.md
16
16
have up to 2 VSM in active/standby mode (generally in two different servers).
17
17
When the active one fails, the standby will take over within bounded time.
18
18
 
 
19
VSM charm is not directly dependent of other OpenStack nodes,
 
20
unlike other Cisco charms like VEM or VXGW (VLAN Extended Gateway), 
 
21
which are subordinate charms. 
 
22
 
 
23
Once the VSM charm is deployed it creates a VSM Virtual Machine (VM)
 
24
in the MaaS node. Hence a requirement for VSM to communicate with other
 
25
Openstack/Cisco charms is to have L3 connectivity with the rest of 
 
26
the MaaS cluster nodes.
 
27
 
19
28
# Usage
20
29
 
21
30
In order to use Cisco Openstack solution we would need to install 
22
31
VSM on a cluster node as well as VEM module that goes into each 
23
 
host. In order to provide High Availability for VSM you'll need
24
 
to deploy two VSMs (one will be the primary and another the secondary)
 
32
host. As today the VSM charm needs to be network reachable to other 
 
33
nodes using the regular mgmt host interface. (This interface is 
 
34
specified by the n1kv-phy-intf-bridge configuration parameter of 
 
35
the charm).
 
36
 
 
37
In order to provide High Availability for VSM you'll need to deploy 
 
38
two VSMs (one will be the primary and another the secondary)
25
39
in two different hosts. 
26
40
 
27
41
In order to deploy the VSMs (both primary and secondary), you will 
31
45
on the configuration file and also you deploy as two different service
32
46
names.
33
47
 
 
48
The VSM charm will automatically create the VSM VM. For that, you'll 
 
49
provide (as a minimum):
 
50
   - a static IP, netmask and gateway address for network reachability
 
51
of this VM (by specifiying the n1kv-vsm-mgmt-ip, n1kv-vsm-mgmt-netmask and
 
52
n1kv-vsm-mgmt-gateway configuration parameters). This VM uses the 
 
53
interface specified in n1kv-phy-intf-bridge as external network 
 
54
interface.
 
55
   - domain id that the VSM operates (by the n1kv-vsm-domain-id configuration parameter)
 
56
   - password for the administrator to ssh to the VSM VM (n1kv-vsm-password)
 
57
   - role which specifies if the VSM will be primary or secondary (n1kv-vsm-role)
 
58
 
34
59
For example, you create a myconfig.yaml configuration file with the 
35
 
following info:
 
60
following the minimal mandatory information:
36
61
 
37
62
    vsm-primary:
38
63
        n1kv-vsm-domain-id: 101
52
77
        .....
53
78
   
54
79
 
 
80
Check the config.yaml file for default configuration values and other 
 
81
configurable parameters of the VSM charm.
 
82
 
55
83
Then you deploy the primary VSM with the following command:
56
84
 
57
85
    juju deploy --config myconfig.yaml vsm vsm-primary