User Tools

Site Tools


2_x:datamodel:teemip-network-mgmt

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
2_x:datamodel:teemip-network-mgmt [2019/10/15 17:22] – [Domain] cnaud2_x:datamodel:teemip-network-mgmt [2023/11/03 15:32] (current) – [Network Device Virtual Interface] cnaud
Line 1: Line 1:
-====== Network Management ====== +====== Network ====== 
-The Network Management module is a mandatory module of TeemIp. It groups the CIs that are closely linked to network: existing ones that are inherited from iTop (Network interfaces and VLANs) and new ones available in TeemIp only (WAN links, DNS domains, AS numbers...).+The Network Management module is a mandatory module of TeemIP. It groups the CIs that are closely linked to network: existing ones that are inherited from iTop (Network interfaces and VLANs) and new ones available in TeemIP only (WAN links, DNS domains, AS numbers...).
  
-Overview of all CIs that belong to the module are displayed under the Network group of the Overview menu of the Configuration Management module.+Overview of all CIs that belong to the module are displayed under from the **Network** submenu of the standard **CMDB overview** menu.
  
-{{ overview_group_network.png }}+{{ overview_group_network3x.png }}
  
  
 ===== Network Interface ===== ===== Network Interface =====
-{{classicon_networkinterface.png  }}  +{{icons8-globe-cable.png  }}  
-Three types of network interfaces can be defined: Fiber channel, physical or logical interfaces.+Five types of network interfaces can be defined: **fiber channels****physical** or **logical** interfaces, **virtual interfaces** for network devices and **aggregate links**
  
  
Line 15: Line 15:
 In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new Network Interface". Then select the interface type in the form below: In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new Network Interface". Then select the interface type in the form below:
  
-{{ classcreate_networkinterface.png }}+{{ classcreate_networkinterface3x.png }}
  
  
 ==== Fiber Channel Interface ==== ==== Fiber Channel Interface ====
-{{classicon_fiberchannelinterface.png  }}  +{{icons8-globe-fiber.png  }}  
-Fibre Channel Interface, is a network interface to a high-speed network technology primarily used for connecting shared storage devices (Storage Systems in TeemIp).+Fiber Channel Interface, is a network interface to a high-speed network technology primarily used for connecting shared storage devices (Storage Systems in TeemIP).
  
 === Fiber Channel Interface Properties === === Fiber Channel Interface Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
 +| **General Information** |||
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
 +| Status | Possible values: Active, Inactive | No |
 | Device | Foreign key to a(n) Datacenter Device | Yes | | Device | Foreign key to a(n) Datacenter Device | Yes |
 +| **More Information** |||
 | Speed | Decimal value (could be negative) | No | | Speed | Decimal value (could be negative) | No |
 | Topology | Alphanumeric string | No | | Topology | Alphanumeric string | No |
Line 33: Line 36:
 Once Fiber Channel interface is selected in the interface type selection box, click apply to display the creation form: Once Fiber Channel interface is selected in the interface type selection box, click apply to display the creation form:
  
-{{ classcreate_fiberchannelinterface.png }}+{{ classcreate_fiberchannelinterface3x.png }}
  
  
 ==== Logical Interface ==== ==== Logical Interface ====
-{{classicon_logicalinterface.png  }}+{{icons8-globe-cable.png  }}
 A network interface for a Virtual Machine. A network interface for a Virtual Machine.
  
 === Logical Interface Properties === === Logical Interface Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
 +| **General Information** |||
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
-MAC address Formated alphanumeric string | No | +Status Possible values: Active, Inactive | No |
-| Comment | Multiline character string | No | +
-| Speed | Decimal value (could be negative) | No |+
 | Virtual machine | Foreign key to a(n) Virtual Machine | Yes | | Virtual machine | Foreign key to a(n) Virtual Machine | Yes |
 +| Comment | Multiline character string | No |
 +| **More Information** |||
 +| MAC address | Formated alphanumeric string | No |
 +| Speed | Foreign key to a(n) Interface Speed \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension  | No |
 +| Protocol | Foreign key to a(n) Layer 2 Protocol \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension  | No |
  
 <note tip> <note tip>
Line 62: Line 69:
 === Tabs === === Tabs ===
 ^  Tab  ^  Description  ^ ^  Tab  ^  Description  ^
 +| VLANs | VLANs that the interface is connected to |
 +| VRFs | VRFs that the interface is connected to |
 | IP Addresses | IP Addresses (v4 or v6) that are hosted on the interface | | IP Addresses | IP Addresses (v4 or v6) that are hosted on the interface |
  
 There is no limitation in the number of IPv4s and / or IPv6s that a logical interface can host. There is no limitation in the number of IPv4s and / or IPv6s that a logical interface can host.
  
-=== Creating new Logical Interface === +=== Displaying a Logical Interface === 
-Once Logical interface is selected in the interface type selection boxclick apply to display the creation form:+In a list of logical interfacesselect the one you are interested in:
  
-{{ classcreate_logicalinterface.png }}+{{ classdetails_virtualinterface3x.png }}
  
  
 ==== Physical Interface ==== ==== Physical Interface ====
-{{classicon_physicalinterface.png  }} +{{icons8-globe-wire.png  }} 
-A physical network interface on a physical server, as opposed to virtual interfaces that are defined at the sofware level either in operating systems or virtual machines.+A physical network interface on a physical server, as opposed to virtual interfaces that are defined at the software level either in operating systems or virtual machines.
  
 === Physical Interface Properties === === Physical Interface Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
 +| **General Information** |||
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
 +| Status | Possible values: Active, Inactive, Obsolete, Stock | No |
 | Device | Foreign key to a(n) Connectable CI | Yes | | Device | Foreign key to a(n) Connectable CI | Yes |
-| MAC address | Formated alphanumeric string | No | 
 | Comment | Multiline character string | No | | Comment | Multiline character string | No |
-| Speed | Decimal value (could be negative) | No |+| **Wiring Information** ||| 
 +| Please, refer to the [[extensions:teemip-cable-mgmt|Cable Management]] extension ||| 
 +| **More Information** ||| 
 +| MAC address | Formated alphanumeric string | No | 
 +| Speed | Foreign key to a(nInterface Speed \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension | No | 
 +| Protocol | Foreign key to a(n) Layer 2 Protocol \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension | No | 
  
 <note tip> <note tip>
Line 89: Line 105:
  
 <note> <note>
-TeemIp replaces the IP Address field that appears in iTop data model by a list of IPs that may contain several pointers to IPs defined in TeemIP data model. The list appears in the following tab.+TeemIP replaces the IP Address field that appears in iTop data model by a list of IPs that may contain several pointers to IPs defined in TeemIP data model. The list appears in the following tab.
 </note> </note>
  
Line 101: Line 117:
 | VRFs | VRFs to which this interface is connected | | VRFs | VRFs to which this interface is connected |
 | IP Addresses | IP Addresses (v4 or v6) that are hosted on the interface | | IP Addresses | IP Addresses (v4 or v6) that are hosted on the interface |
 +| Cable | Cable connected to the interface \\ Brought by the [[extensions:teemip-cable-mgmt|Cable Management]] extension |
  
 There is no limitation in the number of IPv4s and / or IPv6s that a logical interface can host. There is no limitation in the number of IPv4s and / or IPv6s that a logical interface can host.
Line 107: Line 124:
 Once Physical interface is selected in the interface type selection box, click apply to display the creation form: Once Physical interface is selected in the interface type selection box, click apply to display the creation form:
  
-{{ classcreate_physicalinterface.png }}+{{ classcreate_physicalinterface3x.png }} 
 + 
 +==== Network Device Virtual Interface ==== 
 +{{icons8-globe-ndvi.png  }} 
 +A virtual interface on a (physical) network devices. This type of interface coexists with physical interfaces on such devices. 
 + 
 +=== Physical Interface Properties === 
 +^  Name  ^  Type  ^  Mandatory? 
 +| **General Information** ||| 
 +| Name | Alphanumeric string | Yes | 
 +| Status | Possible values: Active, Inactive, Obsolete, Stock | No | 
 +| Network Device | Foreign key to a(n) Network Device | Yes | 
 +| Comment | Multiline character string | No | 
 +| **More Information** ||| 
 +| MAC address | Formated alphanumeric string | No | 
 +| Speed | Foreign key to a(n) Interface Speed \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension | No | 
 +| Protocol | Foreign key to a(n) Layer 2 Protocol \\ Brought by the [[extensions:teemip-network-mgmt-extended|Network Management Extended]] extension | No | 
 + 
 +<note tip> 
 +MAC address can be entered following 01:23:45:67:89:ab or 01-23-45-67-89-ab or 0123.4567.89ab format but is displayed according to choice made in Global IP Settings for the organization. 
 +</note> 
 + 
 +<note important> 
 +IPs can be attached to an interface regardless their status, even if already allocated. This is to reflect the situation where, for instance, an IP address is set on different router interfaces. 
 +</note> 
 + 
 +=== Tabs === 
 +^  Tab  ^  Description 
 +| VLANs | VLANs to which this interface is connected | 
 +| VRFs | VRFs to which this interface is connected | 
 +| IP Addresses | IP Addresses (v4 or v6) that are hosted on the interface | 
 + 
 +There is no limitation in the number of IPv4s and / or IPv6s that a network device virtual interface can host. 
 + 
 +=== Displaying a Network Device Virtual Interface === 
 +In a list of Network Device Virtual Interface, select the one yo are interested in. 
 + 
 +{{ classcreate_networkdevicevirtualinterface3x.png }} 
  
  
 ===== VLAN ===== ===== VLAN =====
-{{classicon_vlan.png  }} +{{icons8-hierarchy.png  }} 
 A Virtual LAN is used to group together in a logical way networks Subnets and Physical Interfaces that participate in the same VLAN. A Virtual LAN is used to group together in a logical way networks Subnets and Physical Interfaces that participate in the same VLAN.
  
 === VLAN Properties === === VLAN Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
-VLAN Tag | Alphanumeric string | Yes |+| Tag | Integer | Yes | 
 +| Name | Alphanumeric string | No |
 | Organization | Foreign key to a(n) Organization | Yes | | Organization | Foreign key to a(n) Organization | Yes |
 +| Status | Possible values: Reserved, Unused, Used | Yes |
 +| Type | Possible values: MAC address based, Network based, Port based, Protocol based | Yes |
 | Description | Multiline character string | No | | Description | Multiline character string | No |
  
Line 124: Line 182:
 | Subnets | Subnets (v4 or v6) which are part of this VLAN | | Subnets | Subnets (v4 or v6) which are part of this VLAN |
 | Physical network interfaces | Physical interfaces which are part of this VLAN | | Physical network interfaces | Physical interfaces which are part of this VLAN |
 +| Logical network interfaces | Logical interfaces which are part of this VLAN |
 +| Network device virtual interfaces | Network device virtual interfaces which are part of this VLAN |
 +| Interfaces' IPs | IPs of all logical and physical interfaces attached to the VLAN |
  
-=== Creating new VLAN === +=== Displaying a VLAN === 
-In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new VLAN" to display the creation form:+In the **Networking** overview of the **Configuration Management** module, list the VLANs from the dedicated badge and select the item that you are interested in.
  
-{{ classcreate_vlan.png }}+{{ classdetails_vlan-3x.png }}
  
  
  
 ===== WAN Link ===== ===== WAN Link =====
-{{classicon_wanlink.png  }}  +{{icons8-line-48.png  }}  
-Wide Area Network link are used to connect to remote locations. +Wide Area Network links are used to connect remote locations together
  
 === WAN Link Properties === === WAN Link Properties ===
Line 141: Line 202:
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
 | Organization | Foreign key to a(n) Organization | Yes |  | Organization | Foreign key to a(n) Organization | Yes | 
-| Description | Multiline character string  | No | 
 | Status| Possible values: implementation, obsolete, production, stock  | No | | Status| Possible values: implementation, obsolete, production, stock  | No |
 +| Description | Multiline character string  | No |
 | **Administrative Information** ||| | **Administrative Information** |||
 | Carrier | Foreign key to a(n) Organization | No | | Carrier | Foreign key to a(n) Organization | No |
Line 161: Line 222:
 | Move to production date | Date (year-month-day) | No | | Move to production date | Date (year-month-day) | No |
 | Renewal date | Date (year-month-day) | No | | Renewal date | Date (year-month-day) | No |
-| Decommissioning | Date (year-month-day) | No |+| Decommissioning date | Date (year-month-day) | No |
  
 === Tabs === === Tabs ===
Line 168: Line 229:
 | Documents | All the documents linked to this configuration item | | Documents | All the documents linked to this configuration item |
 | Application solutions |All the application solutions for this configuration item | | Application solutions |All the application solutions for this configuration item |
-| Provider contracts* | All the provider contracts for this configuration item | 
 | Active Tickets | All the tickets for this configuration item  | | Active Tickets | All the tickets for this configuration item  |
  
-* In TeemIp as an iTop module only. +=== Displaying a WAN Link === 
- +In the **Networking** overview of the **Configuration Management** module, list the WAN links from the dedicated badge and select the item that you are interested in 
-=== Creating new WAN Link === +{{ classdisplay_wanlink-3x.png }}
-In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new WAN lInk" to display the creation form: +
- +
-{{ classcreate_wanlink.png }}+
  
  
 ===== Domain ===== ===== Domain =====
-{{classicon_domain.png  }}  +{{icons8-active-directory-48.png  }}  
-These objects modelize the well known domains from the Domain Name Service. +This class modelizes the well known domains from the Domain Name Service. 
  
 === Domain Properties === === Domain Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
 | **General Information** ||| | **General Information** |||
-| Organization | Foreign key to a(n) Organization | Yes | +| Organization | Foreign key to a(n) Organization | Yes 
 +| Delegated from | Foreign key to a(n) Organization | No |
 | Parent | Foreign key to a(n) Domain| No | | Parent | Foreign key to a(n) Domain| No |
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
Line 200: Line 258:
 === Tabs === === Tabs ===
 ^  Tab  ^  Description  ^ ^  Tab  ^  Description  ^
-| Hosts | All the hosts that belong to the domain |+| Hosts | Hosts that belong to the domain (see detail below) |
 | Child domains | All sub domains directly below in the domain tree | | Child domains | All sub domains directly below in the domain tree |
 +| Related Zones | All the zones related to the domain |
  
-=== Creating a new Domain === +=== Listing Domains === 
-In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new Domain" to display the creation form:+The Domain badge available in the **Networking** overview or the shortcut under the **DNS Management** menu display all the domains of the selected organization or all domains registered in the application if no organization is selected.
  
-{{ classcreate_domain.png }}+{{ classlist_domain-3x.png }}
  
-=== Specific actions === +<note tip> 
-== Display Tree == +The Search tab will shorten the list according to the filtering elements you'll define in it. 
-The Display Tree action is visible when list of domains is displayed.+</note> 
 + 
 +=== Displaying Tree === 
 +Display can be switched from the listing view to tree view through the **Display Tree** action in the **Other Actions** menu. 
 + 
 +When no default organization is selected, a tree per existing organization is displayed. Otherwise, only the tree that corresponds to the selected organization is displayed. 
 + 
 +{{ classtree_domain-3x.png }} 
 + 
 +Display can be switched back to the listing view through the **Display List** action available in the **Other Actions** menu. 
 + 
 +{{ details-popup-menu-subnetdisplaylist-3x.png }} 
 + 
 +=== Displaying a Domain === 
 +From the list or the tree view, just click on the item that you are interested in: 
 + 
 +{{ classdetails_domain-3x.png }} 
 + 
 +The **Hosts** tab displays the hosts that are directly or indirectly attached to the domain. Three filters can be applied to that list. Display may contain: 
 +  * the hosts that belong to the domain and its children, 
 +  * the hosts attached to child domains only, 
 +  * the hosts directly attached to the domain only 
 +These filters are selected directly in the Hosts tab: 
 + 
 +{{ classdetails_domain_hosts_tab-3x.png }} 
 + 
 +=== Delegate === 
 +A domain belonging to an organization can be delegated to another organization. This can only be done if the domain already exists. Delegation is not available at creation time. Conditions to delegate domain are: 
 +  * The domain doesn't contain any host nor sub-domain, 
 +  * The domain is not associated to a DNS zone.
  
-{{ details-popup-menu-domaindisplaytree.png }}+By default, a domain can only be delegated to a child organization. However, this restriction can be lifted by the **Delegate domains to children organizations only** parameter defined in the [[2_x:datamodel:ip-settings|Global IP Settings]].
  
-This action is used to switch display from domain lists to trees. When no default organization is selected, a domain tree per existing organization is displayed. Otherwise, only the domain tree that corresponds to the selected organization is displayed. 
  
-== Display List == +In order to delegate a domain, click on the **Delegate** action of the **Other Actions** menuThe following display appears:
-The Display List action is visible when domain trees are displayed.+
  
-{{ details-popup-menu-domaindisplaylist.png }}+{{ classdelegate_domain-3x.png }}
  
-This action brings the display back to the standard list.+If all delegation conditions are met, domain is effectively delegated once the **Apply** button is pressed.
  
-== Un-Delegate == 
-A delegated domain can be returned to its original owner organization with the "Un-delegate" action. Condition to remove a delegation on a domain is that the domain has **no** host, **no** sub-domain and **no** zone associated zone. 
  
-In order to un-delegate a domain, just click on the Un-delegate” action of the “Other Actions” menu. If above condition is met, delegation will be removed straight away.+=== Un-Delegate === 
 +A delegated domain can be returned to its original owner organization with the **Un-delegate** action. Condition to remove a delegation on a domain is that the domain has **no** host, **no** sub-domain and **no** zone associated zone. If these conditions are met, delegation is removed straight away.
  
 ===== AS Number ===== ===== AS Number =====
-{{classicon_asnumber.png  }} +{{icons8-connect-48.png  }} 
 Autonomous System (AS) Number used by various routing protocols. Autonomous System (AS) Number used by various routing protocols.
  
Line 253: Line 338:
  
 === Creating a new AS Number === === Creating a new AS Number ===
-In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new AS Numberto display the creation form:+In the **Networking overview** of the **Configuration Management** module, click on the {{plus-button.png?nolink|Edit icon}} of the **AS Number** badge to display the creation form
  
-{{ classcreate_asnumber.png }}+{{ classcreate_asnumber-3x.png }}
  
  
 ===== VRF ===== ===== VRF =====
-{{classicon_vrf.png  }} +{{icons8-router-48.png  }} 
 These items modelize VRF (Virtual Routing and Forwarding) objects used within routing protocols. These items modelize VRF (Virtual Routing and Forwarding) objects used within routing protocols.
  
 === VRF Properties === === VRF Properties ===
 ^  Name  ^  Type  ^  Mandatory?  ^ ^  Name  ^  Type  ^  Mandatory?  ^
 +| **General Information** |||
 | Organization | Foreign key to a(n) Organization | Yes |  | Organization | Foreign key to a(n) Organization | Yes | 
 | Name | Alphanumeric string | Yes | | Name | Alphanumeric string | Yes |
Line 273: Line 359:
 ^  Tab  ^  Description  ^ ^  Tab  ^  Description  ^
 | Subnets | All the subnets attached to this configuration item | | Subnets | All the subnets attached to this configuration item |
-| Physical network interfaces | All the physical netwrok interfaces attached to this configuration item +| Physical network interfaces | Physical network interfaces attached to the VRF | 
-| Active Tickets | All the tickets for this configuration item  |+| Logical network interfaces | Logical interfaces attached to the VRF |  
 +| Interfaces' IPs | IPs of all logical and physical interfaces attached to the VRF 
 +| Active Tickets | All the tickets for this VRF  |
  
 === Creating a new VRF === === Creating a new VRF ===
-In the Overview menu of the Configuration Management module, find the Network group and click on "Create a new VRF" to display the creation form:+In the **Networking** overview of the **Configuration Management** module, list the VRFs from the dedicated badge and select the item that you are interested in.
  
-{{ classcreate_vrf.png }}+{{ classdisplay_vrf-3x.png }}
  
  
2_x/datamodel/teemip-network-mgmt.1571152949.txt.gz · Last modified: 2019/10/15 17:22 by cnaud