Manage Container Server Networks

On May 26, 2020, according to CoreOS reaching End of Life, container servers in OnApp also reached End of Life. Please contact support or your account manager on amteam@onapp.com for more details and further assistance. 

The Networking menu in the Container Servers menu enables you to manage network interfaces, allocate IP addresses and set firewall rules for virtual servers. In this document you can find information on how to manage Container Server networks. 

  • To run the container server, at least one network interface with an assigned IP address (or addresses) is required! 
  • To allocate another physical network, add a new network interface.


Configure Container Server Network Interface


The Networking > Network Interfaces menu shows the virtual network interfaces allocated to this container server. Network interfaces join the physical network to the container server. 

When you create a container server a network interface is added automatically. This network interface will be assigned to the existing physical network using a spare IP (IPv4) and will be set primary by default.
OnApp supports IPv4 and IPv6. Since not every application supports IPv6, at least one IPv4 address must be allocated to a container server's primary network interface. 
To see the list of all network interfaces allocated to the container server:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you're interested in.
  3. Click the Networking tab, then click Network Interfaces.
  4. On the page that follows you will see the following fields:
  • Interface – optional label of the network interface.
  • Network join – name of the network and a Compute resource or Compute zone this network is joined to.
  • Port speed – the speed set to the interface.
  • Primary interface – indication whether the interface is primary or not.

Here you can also view Interface Usage, Edit and Delete network interface (using icon controls) and Add a new network interface using the button at the bottom of the screen.
To add a network interface:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you're interested in.
  3. Click the Networking tab, then click Network Interfaces.
  4. Click the Add New Network Interface button at the bottom of the screen.
  5. On the screen that appears, input values for the following parameters:
    • Label – a human-friendly name for the new interface.
    • Physical Network – choose a network join from the drop-down menu, which lists network joins assigned to the Compute resource/Compute zone on which the container server runs).
    • Port speed – set port speed in Mbps, or make it unlimited.

  6. Click the Submit button.

To edit network interface label, port speed or set it as primary (if none is marked as primary), click Edit icon next to the appropriate network interface. After editing the port speed, the container server should be power cycled for the change to take effect.
To delete a network interface, click the Delete icon next to the interface you want to delete.


Rebuild Container Server Network



To rebuild a network join, added to the container server (required after allocating new IP addresses):

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of a required server.
  3. On the screen that appears, click the Tools button, then click Rebuild Network.
  4. In the pop-up window, move the Force Reboot slider to the right, then select the container server shutdown type.

    During rebuild network, the system tries to reach container server's network interface without rebooting server. Then, if it is not possible,transactionwill quit. Force reboot action allowsto rebuildcontainer server network with reboot action iflive rebuildis impossible. In case the force reboot option is disabled andsystemcan not enter the container server, the network rebuild operation will fail.

  5. Move the Required Startup slider to the right to start up a container server when you're rebuilding network of a powered off server.
  6. Click the Rebuild Network button.


Set Container Server Firewall Rules



With OnApp you can set firewall rules for the network interfaces of container servers. There are two types of firewall rule:

  • ACCEPT – defines the packets that will be accepted by the firewall
  • DROP – defines the packets that will be rejected by the firewall

Ensure that the following permissions are enabled before setting firewall rules for your container server:

  • Create own firewall rules
  • Destroy own firewall rules
  • Read own firewall rules
  • Update own firewall rules
  • Update own container server
  • Read own container server

You cannot apply firewall rules to container servers which are parts of a blueprint.

You can set the following:

Add a specific firewall rule

To configure a firewall rule:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the servers for which you want to configure a firewall rule.
  3. Click the Networking tab, then click Firewall.
  4. On the page that appears, set the following:
    1. Choose the network interface.
    2. Specify if the rule defines requests that should be accepted or dropped.
    3. Set the IP address for which this rule is active.
      • Leave the empty field to apply this rule to all IPs
      • Enter hyphen-separated IPs to apply the rule to an IP range (e.g. 192.168.1.1-192.168.1.10)
      • Enter the IPs with slash to apply the rule to CIDR (e.g. 192.168.1.1/24)
    4. Set the port for which this rule is effective.
      • Leave the empty field to apply the rule to all ports
      • Enter colon-separated ports to apply the rule to a port range (e.g. 1024:1028)
      • Enter comma-separated ports to apply the rule to the list of ports (e.g. 80,443,21)
    5. Protocol type (for ICMP protocol only) - indicate a type of the ICMP protocol (range from 0 to 255)
    6. Choose the protocol (TCP, UDP, DCCP, SCTP or ICMP). 
    7. Enter a comment to the firewall rule.
  5. Save the rule by clicking the Add Rule button. The rule will be saved in the UI, but the transaction won't be started until you click the Apply Firewall Rules button.
  6. To start the transaction which runs firewall rules for a container server, click Apply firewall rules button.
  7. Use Up and Down arrow buttons in the left column to change firewall rule position.
  8. To edit or delete a firewall rule click the appropriate icon in the last column.

Default firewall rules

To set default firewall rules for a network interface:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the container server for which you want to configure a firewall rule.
  3. Click the Networking tab, then click Firewall.
  4. On the page that appears, go to Default firewall rules section.
  5. Choose ACCEPT or DROP command next to the network interface and click Save Default Firewall Rules. The rule will be saved in the UI, but the transaction won't be started until you click the Apply Firewall Rules button.

Example:

The Int1 ACCEPT 122.158.111.21 22 TCP firewall rule means that the Int1 network interface will accept all requests and packets addressed from 122.158.111.21 using the TCP protocol on port 22.
The Int2 DROP 122.158.111.21 22 UDP firewall rule means that the Int2 network interface will reject all requests and packets from 122.158.111.21 using the UDP protocol on port 22.

If you reboot a Xen-based container server from the console, the firewall rules for this container server will be lost, and you will need to update the firewall rules again.


Protocols:

For IPv4, only the ICMP, IPV6-ICMP, TCP, UDP, DCCP, SCTP protocols are available by default. However, if required, you can enable other protocols for IPv4.

  1. Go to the /onapp/interface/config/network_protocols.yml file.
  2. The list contains all protocols available (IPv4). Set 'true' for the required protocols.
  3. Restart httpd by running one of the following commands:

    service httpd restart

    or

    /etc/init.d/httpd restart
  4. The protocols you have enabled are now available at Control Panel > Container Servers > Label > Networking tab > Firewall while adding new firewall rules.

The following protocols can be enabled in the /onapp/interface/config/network_protocols.yml file:

  • IP

  • HOPOPT

  • ICMP

  • IGMP

  • GGP

  • IP-ENCAP

  • ST

  • TCP

  • CBT

  • EGP

  • IGP

  • BBN-RCC-MON

  • NVP-II

  • PUP

  • ARGUS

  • EMCON

  • XNET

  • CHAOS

  • UDP

  • MUX

  • DCN-MEAS

  • HMP

  • PRM

  • XNS-IDP

  • TRUNK-1

  • TRUNK-2

  • LEAF-1

  • LEAF-2

  • RSVP-E2E-IGNORE
  • FC
  • SCTP
  • IPLT
  • RDP

  • IRTP

  • ISO-TP4

  • NETBLT

  • MFE-NSP

  • MERIT-INP

  • DCCP

  • 3PC

  • IDPR

  • XTP

  • DDP

  • IDPR-CMTP

  • TP

  • IL

  • SDRP

  • IDRP

  • RSVP

  • GRE

  • DSR

  • BNA

  • ESP

  • AH

  • I-NLSP

  • SWIPE

  • NARP

  • MOBILE

  • HIP
  • manet
  • MPLS-in-IP
  • UDPLite
  • PIPE
  • SSCOPMCE
  • TLSP

  • SKIP

  • CFTP

  • SAT-EXPAK

  • KRYPTOLAN

  • RVD

  • IPPC

  • SAT-MON

  • VISA

  • IPCV

  • CPNX

  • CPHB

  • WSN

  • PVP

  • BR-SAT-MON

  • SUN-ND

  • WB-MON

  • WB-EXPAK

  • ISO-IP

  • VMTP

  • SECURE-VMTP

  • VINES

  • TTP

  • NSFNET-IGP

  • DGP, TCF

  • EIGRP

  • OSPFIGP

  • Sprite-RPC

  • LARP

  • MTP

  • SPS
  • CRUDP
  • AX.25

  • IPIP

  • MICP

  • SCC-SP

  • ETHERIP

  • ENCAP

  • GMTP

  • IFMP

  • PNNI

  • PIM

  • ARIS

  • SCPS

  • QNX

  • A/N

  • IPComp

  • SNP

  • Compaq-Peer

  • IPX-in-IP

  • VRRP

  • PGM

  • L2TP

  • DDX

  • IATP

  • STP

  • SRP

  • UTI

  • SMP

  • SM

  • PTP

  • ISIS

  • FIRE

  • CRTP



Container Server IP Addresses



In the Networking > IP Addresses tab you can find the list of assigned IP addresses, allocate new IP addresses and rebuild a network.
To allocate a new IP Address to the container server:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you're interested in.
  3. Click the Networking tab > IP Addresses.
  4. Click the Allocate New IP Address button.
  5. Select a network interface from the drop-down menu (only the network interfaces you added to the container server will be available). The IP Address will be allocated automatically.
  6. As an alternative you can manually select an IP address from the IP Pool associated with the network interface. To enable this option move the Specify IP Address slider to the right and choose IP Address from the drop-down list. You may select an IP address that's already assigned to a container server, but only one container server should be online at a time. Use Please show me used IP PoolShow only my IPs and Show only IPv6 checkboxes to narrow the list of IP in the drop-down list.
  7. Click the Add IP Address button.
  8. Click the Rebuild Network button to rebuild the network.
You must rebuild the network after making changes to IP address allocations.

To remove an IP address from a container server:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you're interested in.
  3. Click the Networking > IP Addresses tab.
  4. Click the Delete icon next to the IP address you want to delete.
  5. In the pop up window that appears:
    • Choose Delete with Reboot option if you want to reboot a container server and rebuild the network immediately after deleting the IP address. After choosing the Delete with Reboot option you will be redirected to the container server's Overview page.
    • Choose Delete without Reboot option if you don't want to reboot a container server. In this case to apply the changes, you will have to the reboot the container server additionally.
You can't delete an IP address that is in use.



Display Network Speed for Network Interfaces on Container Server Page



The main Container Servers screen displays the network speed of each container server's primary network interface. To see the speed of all interfaces assigned to a container server:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you are interested in.
  3. Click the Networking tab > Network Interfaces.
  4. On the screen that appears, the Port Speed column shows the network speed of the network interface.


Edit Container Server Network Speed



To edit a container server's network speed:

  1. Go to your Control Panel > Cloud > Container Servers menu.
  2. Click the label of the server you want to change .
  3. Go to the Network tab > Network Interfaces.
  4. In the last column click the Edit button.
  5. Change the port speed.
  6. Click the Submit button to save changes.