deb-murano/doc/source/install/configure_network.rst
Shilla Saebi 3c6440aef2 Clean up the configure network doc
Removed unnecessary capitalizations
Followed doc conventions for service names
Wrapped lines that were over 79 characters
Fixed wording and sentence structure

Change-Id: I72559aa87db737fca7ea557bc19aa2488e673cb0
2016-03-30 04:01:03 +00:00

3.9 KiB

Network Configuration

Murano may work in various networking environments and is capable of detecting the current network configuration and choosing appropriate settings automatically. However, some additional actions are required to support advanced scenarios.

Nova network support

Nova Network is simplest networking solution, which has limited capabilities but is available on any OpenStack deployment without the need to deploy any additional components.

When a new Murano Environment is created, Murano checks if a dedicated networking service (i.e. Neutron) exists in the current OpenStack deployment. It relies on Keystone's service catalog for that. If such a service is not present, Murano automatically falls back to Nova Network. No further configuration is needed in this case, all the VMs spawned by Murano will be joining the same Network.

Neutron support

If neutron is installed, murano enables its advanced networking features that give you the ability to avoid configuring networks for your application.

By default it will create an isolated network for each environment and join all VMs needed by your application to that network. To install and configure the application in a newly spawned virtual machine, murano also requires a router to be connected to the external network.

Automatic neutron network configuration

To create the router automatically, provide the following parameters in the config file:

[networking]

external_network = %EXTERNAL_NETWORK_NAME%
router_name = %MURANO_ROUTER_NAME%
create_router = true

To figure out the name of the external network, perform the following command:

openstack network list --external

During the first deployment, the required networks and router with a specified name will be created and set up.

Manual neutron network configuration

  • Step 1. Create public network
  • First, you need to check for existence of external networks. Login as admin and go to Project -> Network -> Network Topology. And check network type in network details at Admin -> Networks -> Network name page. The same action can be done via CLI by running openstack network list --external. To create new external network examine OpenStack documentation.

image

  • Step 2. Create local network
  • Go to Project -> Network -> Networks.
  • Click Create Network and fill the form.

image

image

  • Step 3. Create router
  • Go to Project -> Network -> Routers
  • Click "Create Router"
  • In the "Router Name" field, enter the murano-default-router

image

If you specify a name other than murano-default-router, it will be necessary to change the following settings in the config file:

[networking]

router_name = %SPECIFIED_NAME%
create_router = false
  • Click on the specified router name
  • In the opened view click “Add interface”
  • Specify the subnet and IP address

image

And check the result in Network Topology tab.

image