5.2. Address Types

Home Prev	cOS Stream 4.00.03 Administration Guide	Next

The address book can contain the following Address object types:

IPAddress objects can contain IPv4 and/or IPv6 addresses.
EthernetAddress objects can contain MAC addresses. This can be further grouped together into EthernetAddressGroup objects.

IPAddress Objects

IPAddress objects are used to define symbolic names for various types of IP addresses, either IPv4 or IPv6 or mixed IPv4/IPv6. Depending on how the address is specified, an IP Address object can represent either a single IPv4 or IPv6 address (a specific host), a network or a range of IP addresses and even a DNS name.

Values for the Address Property of an IPAddress

The Address property holds the IP address values of an IPAddress object. The property can be set to a list of addresses which can be any mixture of the following types:

A Single Host

A single host is represented simply by its IP address. This can be either an IPv4 or IPv6 address. For example, 192.168.0.14.

It is also possible to specify a comma separated list of hosts and these can be a mixture of IPv4 and IPv6 addresses. For example, 192.168.0.14,10.15.0.50,2001:DB8::1.
IP Network

An IPv4 Network is represented using Classless Inter Domain Routing (CIDR) form. CIDR uses a forward slash and a number (0-32) to denote the size of the network as a postfix. This number corresponds to the number of binary ones in the netmask.

The suffix /24 corresponds to a class C net with 256 addresses (netmask 255.255.255.0). The suffix /27 corresponds to a 32 address net (netmask 255.255.255.224) and so on.

For IPv6, the IPv6 prefix corresponds to the network. For example, 2001:db8::/32.
IP Ranges

A range of IPv4 addresses is represented with the form a.b.c.d-e.f.g.h.

Note that ranges are not limited to IPv4 netmask boundaries. They may include any span of IP addresses.
For example, 192.168.0.10-192.168.0.15 represents six IPv4 hosts in consecutive order.

A range of IPv6 addresses is specified in the same way. For example, 2001:DB8::1-2001:DB8::6

	Note: A maximum of 256 address items are allowed
	The Address property of a single IPAddress object can hold a maximum of 256 address items, which can be any combination of the types listed above. A range or network is counted as a single item.

Adding and Displaying IPAddress Objects

The CLI command format for adding an IP address is:

System:/> add Address IPAddress <name> Address=<ip-address>

To display the value(s) assigned to an address object:

System:/> show Address IPAddress <name>

Alternatively, the netobjects command can be used:

System:/> netobjects <name>

Using the netobjects command without any options will display all IP address objects in the address book.

Example 5.1. Adding a Single IP Address

This example adds the IP host www_srv1 with IPv4 address 192.168.10.16 to the address book:

Command-Line Interface

System:/> add Address IPAddress www_srv1 Address=192.168.10.16

Example 5.2. Adding an IP Network

This example adds an IP network named wwwsrvnet with address 192.168.10.0/24 to the address book:

Command-Line Interface

System:/> add Address IPAddress wwwsrvnet Address=192.168.10.0/24

Example 5.3. Adding an IP Range

This example adds a range of IPv4 addresses from 192.168.10.16 to 192.168.10.21 and names the range wwwservers:

Command-Line Interface

System:/> add Address IPAddress wwwservers
			Address=192.168.10.16-192.168.10.21

Example 5.4. Deleting an Address Object

To delete an object named wwwsrv1 in the address book, do the following:

Command-Line Interface

System:/> delete Address IPAddress wwwsrv1

Deleting Referenced IP Address Objects

If an IP address object is deleted that is in use by another object, the deletion will appear successful. However, cOS Stream will not subsequently allow the configuration to be deployed and will generate an error message.

The CLI -references option can be used when displaying an IP address to list references to the address. For example, to find all references to the address object if1_ip, the CLI command would be:

System:/> show IPAddress if1_ip -references

EthernetAddress Objects

EthernetAddress objects are used to define symbolic names for MAC addresses. This is useful, for example, when populating the ARP table with static ARP entries, or for other parts of the configuration where symbolic names are preferred over hexadecimal MAC addresses.

When specifying an Ethernet MAC address, the format aa-bb-cc-dd-ee-ff should be used. Ethernet MAC addresses are also displayed using this format.

EthernetAddress objects can be further grouped together into EthernetAddressGroup objects.

Example 5.5. Adding an Ethernet Address

The following example adds an Ethernet Address object named wwwsrv1_mac with the numerical MAC address 08-a3-67-bc-2e-f2.

Command-Line Interface

System:/> add Address EthernetAddress wwwsrv1_mac
				Address=08-a3-67-bc-2e-f2