Dev stacklabguide

1. DevStack
Hands-­‐On
Installation
and
Lab
Guide
Presenters:
Anne
McCormick
–
amccormi@cisco.com
Cisco
Live!
San
Diego
2015

2. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
2
Table
of
Contents
Lab
Information
....................................................................................................................................
3
Ubuntu
14.04.2
Desktop
VM
.......................................................................................................................
3
DevStack
Horizon
...........................................................................................................................................
3
Lab
Topology
.........................................................................................................................................
4
VMware
Setup
.......................................................................................................................................
5
VirtualBox
Setup
..................................................................................................................................
7
Overall
Objectives
................................................................................................................................
9
Task
1
–
Bring
up
Ubuntu
VM
.........................................................................................................
10
Task
2
–
Install
DevStack
from
stable
Kilo
branch
.................................................................
12
Task
3
–
Bring
up
DevStack
Horizon
............................................................................................
13
Task
4
–
Configure
demo
tenant
network
..................................................................................
15
Task
5
–
Configure
demo
tenant
router
......................................................................................
20
Task
6
–
Configure
demo
tenant
instance
..................................................................................
26
Task
7
–
Add
access
rules
to
allow
ping/ssh
to
instance
......................................................
31
Task
7
–
Add
floating
IP
for
instance
...........................................................................................
36
Task
9
–
Much
fanfare
and
hoopla
................................................................................................
41

3. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
3
Lab
Information
Ubuntu
14.04.2
Desktop
VM
Username:
demo
Password:
demo
DevStack
Horizon
Access
the
web
server
using
a
web
browser
on
Ubuntu
VM:
http://localhost
Username:
admin
Password:
openstack
Username:
demo
Password:
openstack

4. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
4
Lab
Topology

5. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
5
VMware
Setup
These
instructions
are
based
on
VMware
Fusion
7.1.1
Pro,
but
should
apply
to
other
versions
of
VMware
Fusion
(Mac)
and
VMware
Workstation
(PC).
VMware
configuration
and
enablement
If
you
haven’t
already
done
so,
download
and
install
VMware
Fusion.
By
default
VMware
will
configure
two
networks:
1. Shared
with
my
Mac
(or
PC)
(Effectively
NAT
Overload
on
the
laptop
IP)
2. Private
to
my
Mac
(Internal
L2
segment
with
no
default
routing
capabilities).
There
is
only
a
need
to
have
a
single
interface,
specifically
the
“Shared
with
my
Mac”
{or
on
a
PC}
NAT
network,
this
being
the
default
NAT
network
It
is
necessary
to
ensure
that
the
Shared
with
my
Mac
adapter
has
the
same
address
as
the
VM
being
deployed
in
order
for
the
VM
to
function
properly.
To
change
the
address
on
a
Mac,
pull
up
a
terminal
window
and
edit
the
VMware
Fusion
network
definition
file:
sudo
nano
/Library/Preferences/VMware
Fusion/networking
The
file
should
have
a
set
of
VNET_8
clauses
that
looks
like
(there
may
be
more
config
lines
as
well,
but
these
are
the
critical
ones):
•answer
VNET_8_DHCP
yes
•answer
VNET_8_HOSTONLY_NETMASK
255.255.255.0
•answer
VNET_8_HOSTONLY_SUBNET
192.168.56.0
•answer
VNET_8_VIRTUAL_ADAPTER
yes
•answer
VNET_8_NAT
yes
To
change
the
address
on
a
PC,
changing
the
network
address
for
the
“NAT”
interface
can
be
done
via
the
User
Interface:

6. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
6

7. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
7
VirtualBox
Setup
If
you
do
not
have
VirtualBox
installed,
the
software
components
have
been
provided
for
your
convenience
in
the
VirtualBox
Installation
directory.
Note
that
in
addition
to
the
installer
itself
(.exe,
.dmg,
.rpm
or
.deb),
there
is
an
extension
pack
that
should
be
installed
after
the
base
VirtualBox
platform
is
installed,
but
prior
to
starting
any
virtual
machines.
Additional
information
is
available
at:
http://virtualbox.org.
Virtualbox
configuration
and
enablement
If
you
haven’t
already,
leverage
the
appropriate
installer
on
the
USB
stick,
and
install
Virtual
Box,
followed
by
the
Virtual
Box
extension
pack.
For
this
system,
you
will
need
to
associate
2
networks
with
your
imported
OVA
(the
next
step
is
to
import
the
OVA):
Adapter
1:
HostOnly
network
with
or
with
DHCP
with
a
base
address
space
of
192.168.56.0/24,
and
if
DHCP
is
enabled
the
range
should
start
above
20
(e.g.
192.168.56.20-­‐192.168.56.100).
Adapter
2:
NAT
network,
this
being
the
default
NAT
network
If
you
don’t
have
host
only
networks
defined,
or
the
networks
you
have
do
not
match
the
addresses
listed
above,
you
can
create
new
networks
from
the
systems
level
preferences.
On
a
Mac,
you
should
see
screen
shots
like
this:

8. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
8
And
for
the
vboxnet0
adapter
settings
similar
to:
On
a
PC,
you
should
see
screen
shots
like:
And
for
vboxnet0
adapter
settings
similar
to:

9. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
9
Overall
Objectives
The
lab
will
be
segmented
into
logical
tasks,
each
having
several
steps
to
be
completed
to
help
you
become
familiar
with
DevStack
installation
and
usage.
1. Task
1
–
Bring
up
Ubuntu
VM
2. Task
2
–
Install
DevStack
from
stable
Kilo
branch
3. Task
3
–
Bring
up
DevStack
Horizon
4. Task
4
–
Configure
demo
tenant
network
5. Task
5
–
Configure
demo
tenant
router
6. Task
6
–
Configure
demo
tenant
instance
7. Task
7
–
Add
access
rules
to
allow
ping/ssh
to
instance
8. Task
8
–
Add
floating
IP
to
instance
9. Task
8
–
Much
fanfare
and
hoopla

10. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
10
Task
1
–
Bring
up
Ubuntu
VM
Prerequisite:
Have
either
VirtualBox
or
VMware
Fusion
installed
on
laptop
1. On
the
USB
stick,
locate
the
Ubuntu
14.04.2
image
for
either
VirtualBox
or
VMware
Fusion,
depending
on
your
configuration:
USB
-­‐>
CiscoLive
-­‐>
Ubuntu-­‐14.04
-­‐>
[VMware
or
VirtualBox]
2. Import
the
Ubuntu
OVA
file
into
Fusion
or
VirtualBox
3. Start
the
Ubuntu
VM

11. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
11
4. Log
in
as
demo
user
(password:
demo)

12. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
12
Task
2
–
Install
DevStack
from
stable
Kilo
branch
1. Bring
up
Terminal
window
in
Ubuntu
VM
2. cd
/home/demo/CiscoLive
3. edit
(vi
or
emacs)
localrc,
comment
out
this
line:
#
Logging
LOGFILE=$DEST/logs/stack.sh.log
VERBOSE=True
#OFFLINE=True
ßadd
#
in
front
of
this
line
LOG_COLOR=False
SCREEN_LOGDIR=$DEST/logs/screen
4. cd
/home/demo
5. git
clone
–b
stable/kilo
https://github.com/openstack-­‐dev/devstack.git
6. cp
/home/demo/CiscoLive/localrc
/home/demo/devstack
7. cd
/home/demo/devstack
8. ./stack.sh
9. Get
a
cup
of
coffee,
make
a
few
phone
calls
….

13. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
13
Task
3
–
Bring
up
DevStack
Horizon
1. Bring
up
Firefox
on
Ubuntu
VM
2. Go
to
DevStack
Horizon:
http://localhost
Username:
admin
Password:
openstack
Username:
demo
Password:
openstack

14. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
14
3. Play
around
with
Horizon
for
a
bit
as
admin
user

15. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
15
Task
4
–
Configure
demo
tenant
network
1. Log
in
to
Horizon
as
demo
user
(password:
openstack)
2. Bring
up
“Network
Topolgy”
UI
3. Select
“+Create
Network”
4. Create
“testnet”

16. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
16
5. Select
“Next”
and
configure
test-­‐subnet
as
follows:

17. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
17
6. Select
“Next”
and
configure
subnet
details
as
follows:

18. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
18
7. Select
“Create”
and
voila!

19. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
19

20. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
20
Task
5
–
Configure
demo
tenant
router
1. From
“Network
Topology”
UI,
select
“+Create
Router”
and
create
test-­‐router,
attach
to
public
network:
2. Select
“Create
Router”

21. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
21
3. Hoover
over
the
router
in
“Network
Topology”,
click
on
“View
Router
Details”

22. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
22
4. Select
“Interfaces”
tab

23. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
23
5. Select
“+Add
Interface”
6. From
Subnet
pulldown,
select
“testnet”
subnet

24. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
24
7. Select
“Add
Interface”
8. From
“Network
Topology”,
the
router
should
be
attached
to
both
the
public
network
and
testnet

25. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
25

26. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
26
Task
6
–
Configure
demo
tenant
instance
1. From
“Network
Topology”
UI,
select
“Launch
Instance”
2. From
Ubuntu
Terminal
window,
run
‘ssh-­‐keygen
–t
rsa
–f
cloud.key’
in
/home/demo/.ssh
(empty
passphrase
is
fine
for
now):

27. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
27
3. Copy
contents
of
cloud.key.pub
to
clipboard
4. From
Horizon,
click
on
“Access
&
Security”
tab,
click
“+”
to
add
a
keypair,
create
keypair
“test-­‐keypair”
and
copy
public
key
contents:

28. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
28
5. Select
“Import
Key
Pair”
6. From
“Launch
Instance”
UI,
select
“Networking”
tab
7. Make
sure
testnet
is
in
selected
networks
list:

29. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
29
8. Select
“Launch”

30. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
30

31. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
31
Task
7
–
Add
access
rules
to
allow
ping/ssh
to
instance
1. Bring
up
“Compute
-­‐>
Access
&
Security”
UI
2. For
default
security
group,
select
“Manage
Rules”

32. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
32
3. Select
“+Add
Rule”
4. Add
an
ingress
“All
ICMP”
rule
as
follows:

33. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
33
5. Add
an
egress
“All
ICMP”
rule,
also
6. Finally,
add
a
rule
to
allow
ssh
to
the
instance:

34. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
34
7. Your
rules
now
should
look
like
this:

35. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
35

36. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
36
Task
7
–
Add
floating
IP
for
instance
1. From
“Compute
-­‐>
Instances”
UI,
under
“test-­‐instance”
select
“Associate
Floating
IP”
2. From
“Manage
Floating
IP
Associations”
UI,
select
“+”

37. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
37
3. From
“Allocate
Floating
IP”
UI,
select
“Allocate
IP”

38. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
38
4. Select
“Associate”

39. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
39
5. From
“Instances”
UI,
you’ll
now
see
local
IP
and
floating
IP
for
the
instance

40. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
40
6. Try
to
ping
and
ssh
to
your
instance:

41. CiscoLive
2015
©
Cisco
and/or
its
affiliates.
All
rights
reserved.
41
Task
9
–
Much
fanfare
and
hoopla