From Fedora Project Wiki

(Created page with "{{QA/Test_Case |description=A brief description of the functionality being tested. |setup=Optionally include information on preparing the test environment |actions= Be as specifi...")
 
No edit summary
 
(21 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{QA/Test_Case
{{QA/Test_Case
|description=A brief description of the functionality being tested.
|description=Set up Floating IPs with OpenStack
|setup=Optionally include information on preparing the test environment
|setup=
Follow [[QA:Testcase_launch_an_instance_on_OpenStack]]
 
Make sure that nova is configured with the correct public network interface.
$> ifconfig em1
    em1: flags=...
$> sudo openstack-config --set /etc/nova/nova.conf DEFAULT public_interface em1
$> sudo systemctl restart openstack-nova-network.service
 
Ensure that ICMP (ping) and SSH are allowed to your instances.
 
$> nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0
$> nova secgroup-add-rule default tcp 22 22 0.0.0.0/0
 
|actions=
|actions=
Be as specific as required for the target audience.
 
# Start here ...
If you've followed all of the test cases, the private network used for OpenStack instances is 10.0.0.0/24.  The purpose of this functionality is to be able to assign a pool of floating public IP addresses to instances, as well.
# Next do this ...
 
# Finally click that
The details of this test case are a bit specific to the environment you are using to test.  For this documentation, we're going to assume that the the OpenStack server's public interface is on the 172.31.0.0/24 subnet.  We are going to take an unused address range (172.31.0.241-172.31.0.254) from this subnet and define it as a floating IP address range to be used by OpenStack.
 
$> sudo nova-manage floating create 172.31.0.240/28
$> sudo nova-manage floating list
None 172.31.0.241 None nova em1
None 172.31.0.242 None nova em1
...
 
Allocate an address to use for an instance:
 
$> nova floating-ip-create
<nowiki>+--------------+-------------+----------+------+</nowiki>
<nowiki>|      Ip    | Instance Id | Fixed Ip | Pool |</nowiki>
<nowiki>+--------------+-------------+----------+------+</nowiki>
<nowiki>| 172.31.0.241 |    None    |  None  | nova |</nowiki>
<nowiki>+--------------+-------------+----------+------+</nowiki>
 
Associate the allocated address with a running instance:
 
$> INSTANCE=<instance name>
$> nova add-floating-ip $INSTANCE 172.31.0.241
 
|results=
|results=
The following must be true to consider this a successful test run. Be brief ... but explicit.  
 
# Step #1 completes without error
Verify that the public IP address got assigned to your public network interface on the OpenStack server.
# The system boots into runlevel 5
 
# Program completes wth exit code 0
$> ip addr
...
2: em1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
    link/ether 00:13:20:f5:f9:8d brd ff:ff:ff:ff:ff:ff
    inet 172.31.0.107/24 brd 172.31.0.255 scope global em1
    inet 172.31.0.241/32 scope global em1
    inet6 fe80::213:20ff:fef5:f98d/64 scope link
        valid_lft forever preferred_lft forever
 
Also see the IP address reported as associated with the instance:
 
$> <nowiki>nova show $INSTANCE | grep network</nowiki>
<nowiki>|  testnet network  |  10.0.0.2, 172.31.0.241  |</nowiki>
 
Verify that you can now ssh into the instance using the newly assigned address:
 
$> cd ~/novacreds
$> ssh -i nova_key.priv -o UserKnownHostsFile=/dev/null root@172.31.0.241
 
{{admon/note|VM limitations|Note if running openstack within a VM, then the floating address will not be accessible from outside (probably due to the iptables NAT being bypassed by the bridge (ebtables) rules within the VM)}}
 
Check for new errors in the logs:
$> grep -i error /var/log/nova/*.log
 
If you would like, you can now disassociate and release the address assigned for testing.
 
$> nova remove-floating-ip $INSTANCE 172.31.0.241
$> nova floating-ip-delete 172.31.0.241
 
}}
}}


[[Category:OpenStack Test Cases]]
[[Category:OpenStack Test Cases]]
[[Category:Cloud SIG]]

Latest revision as of 15:38, 18 September 2012

Description

Set up Floating IPs with OpenStack

Setup

Follow QA:Testcase_launch_an_instance_on_OpenStack

Make sure that nova is configured with the correct public network interface.

$> ifconfig em1
   em1: flags=...
$> sudo openstack-config --set /etc/nova/nova.conf DEFAULT public_interface em1 
$> sudo systemctl restart openstack-nova-network.service

Ensure that ICMP (ping) and SSH are allowed to your instances.

$> nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0
$> nova secgroup-add-rule default tcp 22 22 0.0.0.0/0 

How to test

If you've followed all of the test cases, the private network used for OpenStack instances is 10.0.0.0/24. The purpose of this functionality is to be able to assign a pool of floating public IP addresses to instances, as well.

The details of this test case are a bit specific to the environment you are using to test. For this documentation, we're going to assume that the the OpenStack server's public interface is on the 172.31.0.0/24 subnet. We are going to take an unused address range (172.31.0.241-172.31.0.254) from this subnet and define it as a floating IP address range to be used by OpenStack.

$> sudo nova-manage floating create 172.31.0.240/28
$> sudo nova-manage floating list
None	172.31.0.241	None	nova	em1
None	172.31.0.242	None	nova	em1
...

Allocate an address to use for an instance:

$> nova floating-ip-create
+--------------+-------------+----------+------+
|       Ip     | Instance Id | Fixed Ip | Pool |
+--------------+-------------+----------+------+
| 172.31.0.241 |     None    |   None   | nova |
+--------------+-------------+----------+------+

Associate the allocated address with a running instance:

$> INSTANCE=<instance name>
$> nova add-floating-ip $INSTANCE 172.31.0.241

Expected Results

Verify that the public IP address got assigned to your public network interface on the OpenStack server.

$> ip addr
...
2: em1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
    link/ether 00:13:20:f5:f9:8d brd ff:ff:ff:ff:ff:ff
    inet 172.31.0.107/24 brd 172.31.0.255 scope global em1
    inet 172.31.0.241/32 scope global em1
    inet6 fe80::213:20ff:fef5:f98d/64 scope link 
       valid_lft forever preferred_lft forever

Also see the IP address reported as associated with the instance:

$> nova show $INSTANCE | grep network
|  testnet network  |  10.0.0.2, 172.31.0.241  |

Verify that you can now ssh into the instance using the newly assigned address:

$> cd ~/novacreds
$> ssh -i nova_key.priv -o UserKnownHostsFile=/dev/null root@172.31.0.241
VM limitations
Note if running openstack within a VM, then the floating address will not be accessible from outside (probably due to the iptables NAT being bypassed by the bridge (ebtables) rules within the VM)

Check for new errors in the logs:

$> grep -i error /var/log/nova/*.log

If you would like, you can now disassociate and release the address assigned for testing.

$> nova remove-floating-ip $INSTANCE 172.31.0.241
$> nova floating-ip-delete 172.31.0.241