User Tools

Site Tools


extensions:teemip-network-mgmt-extended

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
Last revisionBoth sides next revision
extensions:teemip-network-mgmt-extended [2023/10/06 08:52] – [Network Device] cnaudextensions:teemip-network-mgmt-extended [2024/03/22 14:11] – [Revision History] cnaud
Line 7: Line 7:
 level_hidden        : 1 level_hidden        : 1
 collector_hidden    : no collector_hidden    : no
-version             : 3.1.1 +version             : 3.1.2 
-release_dt          : 2023-09-13+release_dt          : 2023-12-14
 TeemIp              : 3.1+ TeemIp              : 3.1+
 iTop                : 3.1+ iTop                : 3.1+
Line 19: Line 19:
 keyword_tags        : CMDB, Network keyword_tags        : CMDB, Network
 dependencies_s      : teemip-ip-mgmt, teemip-network-mgmt, teemip-config-mgmt-adaptor dependencies_s      : teemip-ip-mgmt, teemip-network-mgmt, teemip-config-mgmt-adaptor
-download_wiki       : [[https://sourceforge.net/projects/teemip/files/teemip%20-%20extensions/Network%20Management%20Extended/3.1.1/teemip-network-mgmt-extended-3.1.1-207.zip/download|teemip-network-mgmt-extended-3.1.1-207.zip]]+download_wiki       : [[https://sourceforge.net/projects/teemip/files/teemip%20-%20extensions/Network%20Management%20Extended/3.1.2/teemip-network-mgmt-extended-3.1.2-208.zip/download|teemip-network-mgmt-extended-3.1.2-208.zip]]
 github_wiki         : [[https://github.com/TeemIp/teemip-network-mgmt-extended|teemip-network-mgmt-extended]] github_wiki         : [[https://github.com/TeemIp/teemip-network-mgmt-extended|teemip-network-mgmt-extended]]
 php-max             : 8.1 php-max             : 8.1
 ---- ----
- 
- 
- 
- 
  
 This extension adds to TeemIp data model a few advanced classes dedicated to the network world. This extension adds to TeemIp data model a few advanced classes dedicated to the network world.
Line 36: Line 32:
 ===== Revision History ===== ===== Revision History =====
 ^  Version  ^  Release Date  ^  Status  ^  iTop \\ Min  ^  IPAM for iTop \\ Min  ^  Comments  ^ ^  Version  ^  Release Date  ^  Status  ^  iTop \\ Min  ^  IPAM for iTop \\ Min  ^  Comments  ^
-|  **3.1.1**  |  2023-09-13  |  Supported  |  3.1.0  |  3.1.0  | Add a "replacement date" attribute to Network Devices and Cluster Networks \\ Add Network Flow class with flaw drawing \\ Add SNMP Credentials class | +|  **3.1.2**   2023-12-14  |  Supported  |  3.1.0  |  3.1.0  | Add Chinese (simplified) translation \\ Data samples have been added | 
-|  3.1.0  |  2023-06-21  |  Stable   3.0.0  |  3.1.0  | Location and organization fields inherited from Device have been added to Aggregate links \\ Some objects have been redispatched to Overview / Networking menu \\ XML structure has moved to 3x | +|  3.1.1   2023-09-13  |  Supported  |  3.1.0  |  3.1.0  | Add a "replacement date" attribute to Network Devices and Cluster Networks \\ Add Network Flow class with flaw drawing \\ Add SNMP Credentials class | 
-|  3.0.1  |  2022-09-09  |  Stable   2.7.0  |  3.0.1  | Adopt 3.x icon style \\ Add TeemIp core modules as a dependency |+|  3.1.0  |  2023-06-21  |  Obsolete   3.0.0  |  3.1.0  | Location and organization fields inherited from Device have been added to Aggregate links \\ Some objects have been redispatched to Overview / Networking menu \\ XML structure has moved to 3x | 
 +|  3.0.1  |  2022-09-09  |  Obsolete   2.7.0  |  3.0.1  | Adopt 3.x icon style \\ Add TeemIp core modules as a dependency |
 |  3.0.0  |  2022-01-11  |  Obsolete  |  2.7.0  |  3.0.0  | TeemIp / iTop 3.x compatible version  \\ Status of IPs is now handled when attached to or detached from a Network Cluster | |  3.0.0  |  2022-01-11  |  Obsolete  |  2.7.0  |  3.0.0  | TeemIp / iTop 3.x compatible version  \\ Status of IPs is now handled when attached to or detached from a Network Cluster |
 |  1.1.0  |  2021-04-01  |  Obsolete  |  2.7.0  |  2.7.0  | Sample data have been added to the extension. \\  VLAN model has been enhanced with new attributes - Tag is now an integer: beware when migrating ! \\ Align extension structure with new guidelines | |  1.1.0  |  2021-04-01  |  Obsolete  |  2.7.0  |  2.7.0  | Sample data have been added to the extension. \\  VLAN model has been enhanced with new attributes - Tag is now an integer: beware when migrating ! \\ Align extension structure with new guidelines |
Line 155: Line 152:
  
 {{ classdisplay_clusternetwork_impact3x.png }} {{ classdisplay_clusternetwork_impact3x.png }}
-===== Network Device ===== 
  
-{{icons8-switch.png  }} 
-This class of CIs is brought by iTop CMDB. It models any type of network device: router, switch, hub, load balancer, firewall… TeemIp Network Management Extended enriches it with additional attributes and relations as shown below. 
- 
-=== Network Device additional Properties === 
-^  Name  ^  Type  ^  Mandatory?  ^ 
-| **General Information** ||| 
-| Cluster network | Foreign key to a(n) Cluster Network | No | 
-| Cluster role | Possible values: Active, Standby | No | 
-| **More Information** ||| 
-| SNMP Credentials | Foreign key to a(n) SNMP Credentials | No |  
-| **Dates** ||| 
-| Replacement date | Date (year-month-day) | No | 
- 
-=== Tabs === 
-^  Tab  ^  Description  ^ 
-| Components | List of all network device components attached to this device | 
-| Aggregat links | List of all aggregate links attached to this device | 
 ===== Network Device Component ===== ===== Network Device Component =====
 {{icons8-slave-48.png  }}  {{icons8-slave-48.png  }} 
Line 210: Line 189:
  
 {{ classdisplay_networkdevicecomponent3x.png }} {{ classdisplay_networkdevicecomponent3x.png }}
 +
 +===== Network Device =====
 +{{icons8-switch.png  }}
 +This class of CIs is brought by iTop CMDB. It models any type of network device: router, switch, hub, load balancer, firewall… TeemIp Network Management Extended enriches it with additional attributes and relations as shown below.
 +
 +=== Network Device additional Properties ===
 +^  Name  ^  Type  ^  Mandatory?  ^
 +| **General Information** |||
 +| Cluster network | Foreign key to a(n) Cluster Network | No |
 +| Cluster role | Possible values: Active, Standby | No |
 +| **More Information** |||
 +| SNMP Credentials | Foreign key to a(n) SNMP Credentials | No | 
 +| **Dates** |||
 +| Replacement date | Date (year-month-day) | No |
 +
 +=== Tabs ===
 +^  Tab  ^  Description  ^
 +| Components | List of all network device components attached to this device |
 +| Aggregat links | List of all aggregate links attached to this device |
 +
 +=== Displaying a Network Device ===
 +In the Overview menu of the Configuration Management module, find the Network Device dashlet, click on it and select the item you are interested in:
 +
 +{{ classdisplay_networkdevice_extended.png }}
  
 ===== Network Flow ===== ===== Network Flow =====
Line 215: Line 218:
 {{icons8-flow.png  }} {{icons8-flow.png  }}
  
 +Network Flows will help you to document the key flows that go through your network and to visualize them in a diagram.
  
-FIXME+=== Network Flow Properties === 
 +^  Name  ^  Type  ^  Mandatory? 
 +| **General Information** ||| 
 +| Common Name | Alphanumeric string | Yes | 
 +| Organization | Foreign key to a(n) Organization | Yes |  
 +| Status| Possible values: Implementation, Obsolete, Production  | No | 
 +| Business criticality | Possible values: Low, Medium; High | No | 
 +| Move to production date | Date (year-month-day) | No | 
 +| Description | Multiline character string  | No | 
 +| **Flow Details** ||| 
 +| Protocol | Possible values: UDP, TCP, UDP/TCP, Other | No | 
 +| Source CI| Foreign key to a(n) FunctionalCI | No | 
 +| Source port | Alphanumeric string | No | 
 +| Destination CI | Foreign key to a(n) FunctionalCI | No | 
 +| Destination port | Alphanumeric string | No | 
 +| Capacity | Foreign key to a(n) Flow Capacity | No | 
 + 
 +<note> 
 +Name of the object is automatically computed as the concatenation of Protocol - Name of the Source CI / Source port - Name of the Destination CI / Destination port 
 +</note> 
 +<note tip> 
 +Access to this class of objects is protected by the [[extensions:teemip-network-mgmt-extended#network_security_manager_profile|Network Security Manager]] profile. 
 +</note> 
 + 
 +=== Displaying a Network Flow === 
 +In the Network dashboard that is accessible from a submenu of the standard CMDB overview menu, find the Network Flow dashlet, click on it and select the item you are interested in: 
 + 
 +{{ classdisplay_networkflow.png }} 
 + 
 + 
 +=== Outgoing Flow === 
 +Once network flows between CIs are documented, the logical path that connects them all can be visualized through the menu **Outgoing Flow…** displayed under the **Other Actions** menu of Network Flow or Functional CI (see above). 
 + 
 +{{ network_outgoingflow1.png }} 
 +{{ network_outgoingflow2.png }} 
 + 
 +<note tip> 
 +Only outgoing flows, i.e. flows from a source CI to a destination CI can be documented. Incoming flows cannot be drawn. 
 +</note>
 ===== VLAN ===== ===== VLAN =====
 {{icons8-hierarchy.png  }}   {{icons8-hierarchy.png  }}  
Line 279: Line 321:
 | Devices | List of all the devices using these credentials | | Devices | List of all the devices using these credentials |
  
-<note> +<note tip
-The passphrases are stored encrypted (one way) in the TeemIp database, and therefore cannot be reconstructed from the content of the database.+Access to this class of objects is protected by the [[extensions:teemip-network-mgmt-extended#network_security_manager_profile|Network Security Manager]] profile.
 </note> </note>
  
Line 299: Line 341:
 {{icons8-new-item-48.png }}  {{icons8-new-item-48.png }} 
  
-Three new typological elements are brought by the extension:+Four new typological elements are brought by the extension:
  
 ^  Name  ^  Description  ^  Attributes  ^  Example  ^ ^  Name  ^  Description  ^  Attributes  ^  Example  ^
 +| Interface Speed | Speed available on a network interface | Name, Description, List of network interfaces using it | 10 Gb/s |
 +| Layer 2 Protocol | Layer 2 protocol used on a network interface | Name, Description, List of network interfaces using it | Ethernet, Trunking |
 | Interface Connector | Physical connector used on a physical interface | Name, Description, List of physical interfaces using it | RJ45 | | Interface Connector | Physical connector used on a physical interface | Name, Description, List of physical interfaces using it | RJ45 |
-Layer 2 Protocol Layer 2 protocol used on a network interface | Name, Description, List of network interfaces using it | Ethernet, Trunking | +Flow Capacity Capacity provided by a network Flow | Name, Description, List of Network Flows using it | 256 Mb/s |
-| Interface Speed | Speed available on a network interface | Name, Description, List of network interfaces using it | 10 Gb/s | +
  
 The extension groups network specific typological elements in a dedicated dashlet. The extension groups network specific typological elements in a dedicated dashlet.
Line 337: Line 379:
 {{ classdisplay_physicalinterface3x.png }}  {{ classdisplay_physicalinterface3x.png }} 
  
 +===== Network Security Manager profile =====
 +Next to the CIs described here above, the extension brings a new User Profile: **Network Security Manager** which enables R/W access to Flow capacity, Network flow and SNMP Credentials objects. All persons in charge of network security should endorse this profile.
  
 +<note tip> 
 +Not that the profile mus be used in conjunction with **Configuration Manager** profile.  
 +</note>
extensions/teemip-network-mgmt-extended.txt · Last modified: 2024/04/04 14:46 by cnaud