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
extensions:teemip-network-mgmt-extended [2023/10/06 09:05] – [Network Device] cnaudextensions:teemip-network-mgmt-extended [2024/04/04 14:46] (current) – [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.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.1  |  2022-09-09  |  Obsolete   2.7.0  |  3.0.1  | Adopt 3.x icon style \\ Add TeemIp core modules as a dependency | 
-|  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 | +|  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.0.0  |  2020-12-11  |  Obsolete  |  2.7.0  |  2.7.0  | Initial revision |+|  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.0.0  |  2020-12-11  |  Obsolete  |  2.7.0  |  2.7.0  | Initial revision |
  
 ===== Features ===== ===== Features =====
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 | 
- 
-=== 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 Device Component ===== ===== Network Device Component =====
Line 216: 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 221: 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 285: 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 305: 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 343: 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.1696575903.txt.gz · Last modified: 2023/10/06 09:05 by cnaud