This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
extensions:teemip-dhcp-mgmt [2019/03/06 18:33] – cnaud | extensions:teemip-dhcp-mgmt [2024/03/22 14:07] (current) – [Revision History] cnaud | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{ picto_dhcpmanagement.png}} | ||
====== DHCP Management ====== | ====== DHCP Management ====== | ||
---- dataentry summary ---- | ---- dataentry summary ---- | ||
Line 5: | Line 6: | ||
index_hidden | index_hidden | ||
level_hidden | level_hidden | ||
- | version | + | collector_hidden |
- | release_dt | + | version |
- | TeemIp | + | release_dt |
+ | TeemIp | ||
+ | iTop : 3.x | ||
code : teemip-dhcp-mgmt | code : teemip-dhcp-mgmt | ||
- | state : | + | localization |
+ | state : | ||
diffusion_hidden | diffusion_hidden | ||
- | product_hidden | + | product_hidden |
module-lists_hidden : | module-lists_hidden : | ||
keyword_tags | keyword_tags | ||
- | dependencies_s | + | dependencies_s |
- | download_url | + | download_wiki |
+ | github_wiki | ||
+ | php-max | ||
---- | ---- | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
Line 24: | Line 35: | ||
</ | </ | ||
===== Revision History ===== | ===== Revision History ===== | ||
- | ^ Version | + | ^ Version |
- | | 0.1.0 | 2018-11-30 | + | | **3.1.1** |
+ | | 3.1.0 | 2023-06-21 | ||
+ | | 3.0.1 | 2022-09-09 | ||
+ | | 3.0.0 | 2022-01-05 | ||
+ | | 0.2.1 | 2021-04-01 | ||
+ | | 0.2.0 | 2020-11-08 | ||
+ | | 0.1.1 | 2019-01-29 | ||
+ | | 0.1.0 | 2018-11-30 | ||
===== Features ===== | ===== Features ===== | ||
Line 41: | Line 59: | ||
| Host | PhysicalDevice | No | | | Host | PhysicalDevice | No | | ||
- | Once registered in the application, | + | Once registered in the application, |
+ | |||
+ | ===== Licensing ===== | ||
+ | The TeemIp DHCP Management extension is licensed under the terms of the GNU Affero General Public License Version 3 as published by the Free Software Foundation. This gives you legal permission to copy, distribute and/or modify TeemIp DHCP Management under certain conditions. Read the ’license.txt’ file in the TeemIp distribution. TeemIp DHCP Management is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, | ||
+ | |||
===== Limitations ===== | ===== Limitations ===== | ||
The extension just allows DHCP Managers to store DHCP Options within TeemIp. It doesn' | The extension just allows DHCP Managers to store DHCP Options within TeemIp. It doesn' | ||
Line 47: | Line 70: | ||
There is no specific requirements with TeemIp standalone. TeemIp DHCP Management is anyway already embedded in it starting with TeemIp 2.4. | There is no specific requirements with TeemIp standalone. TeemIp DHCP Management is anyway already embedded in it starting with TeemIp 2.4. | ||
- | When installed on an iTop application, | + | When installed on an iTop application, |
===== Installation ===== | ===== Installation ===== | ||
Installation on a TeemIp standalone is done with the application itself, through the setup. | Installation on a TeemIp standalone is done with the application itself, through the setup. | ||
- | When adding the module on an iTop application, the process will depends on the iTop version: | + | When adding the module on an iTop application, |
- | * For iTop 2.4.0 and higher, use the new [[https:// | + | |
- | * For iTop versions older than 2.3.x, use the [[https:// | + | |
===== Configuration ===== | ===== Configuration ===== | ||
No specific configuration is required for this extension. | No specific configuration is required for this extension. | ||
===== DHCP Management Menu ===== | ===== DHCP Management Menu ===== | ||
- | Once installed, the module | + | Once installed, the extension |
- | {{ details_menu_dhcpmgmt.png }} | + | {{ details_menu_dhcpmgmt3x.png? }} |
+ | |||
+ | <note warning> | ||
+ | The DHCP management menu is hidden to the users that don't have the **administrator** profile, the **DHCP manager** profile or r/w privileges on the DHCP Options. | ||
+ | </ | ||
+ | |||
+ | The DHCP Space menu provides some information on the DHCP infrastucture and summarizes the different registered options under 7 badges: | ||
+ | |||
+ | {{ dashboard_dhcpmgmt3x.PNG? | ||
+ | |||
+ | |||
+ | ===== Infrastructure ===== | ||
+ | The infrastructure dashlets list: | ||
+ | * the servers that act as DHCP servers, | ||
+ | * the IP pools flaged as DHCP ranges. | ||
- | The DHCP Space menu summarizes the different registered options under 7 badges: | ||
- | * Global DHCP Option | ||
- | * Shared Network DHCP Option | ||
- | * Subnet DHCP Option | ||
- | * Pool DHCP Option | ||
- | * Class DHCP Option | ||
- | * SubClass DHCP Option | ||
- | * Host DHCP Option | ||
- | |||
- | {{ dashboard_dhcpmgmt.PNG }} | ||
===== DHCP options ===== | ===== DHCP options ===== | ||
Line 88: | Line 114: | ||
==== Global Options ==== | ==== Global Options ==== | ||
- | {{classicon_globaloption.png }} | + | {{icons8-city-buildings-48.png }} |
This object is used to document the Global DHCP Options. It has no other attributes than the ones listed above. | This object is used to document the Global DHCP Options. It has no other attributes than the ones listed above. | ||
Line 94: | Line 120: | ||
Details of a DHCP Global Option can be accessed from the specific " | Details of a DHCP Global Option can be accessed from the specific " | ||
- | {{ classdetails_globaloption.png }} | + | {{ classdetails_globaloption3x.png? |
==== Shared Network Options ==== | ==== Shared Network Options ==== | ||
- | {{classicon_sharednetworkoption.png }} | + | {{icons8-hierarchy.png }} |
This object is used to document the Shared Network DHCP Options. Shared networks in TeemIp are implemented through the VLAN object. | This object is used to document the Shared Network DHCP Options. Shared networks in TeemIp are implemented through the VLAN object. | ||
Line 108: | Line 134: | ||
A new DHCP Shared Network Option may be created from the specific “Shared Network Options” shortcut menu of the DHCP Management module. It refers to an organization and to a VLAN within that organization. | A new DHCP Shared Network Option may be created from the specific “Shared Network Options” shortcut menu of the DHCP Management module. It refers to an organization and to a VLAN within that organization. | ||
- | {{ classcreate_sharednetworkoption.png }} | + | {{ classcreate_sharednetworkoption3x.png? |
==== Subnet Options ==== | ==== Subnet Options ==== | ||
- | {{classicon_subnetoption.png }} | + | {{icons8-subnet-48.png }} |
This object is used to document the Subnet DHCP Options. The Subnet scope in TeemIp is implemented through the IP Subnet object. | This object is used to document the Subnet DHCP Options. The Subnet scope in TeemIp is implemented through the IP Subnet object. | ||
Line 122: | Line 148: | ||
Details of a DHCP Subnet Option can be accessed from the specific “Subnet Options” shortcut menu of the DHCP Management module. It refers to an organization and to an IP Subnet within that organization. | Details of a DHCP Subnet Option can be accessed from the specific “Subnet Options” shortcut menu of the DHCP Management module. It refers to an organization and to an IP Subnet within that organization. | ||
- | {{ classdetails_subnetoption.png }} | + | {{ classdetails_subnetoption3x.png? |
==== Pool Options ==== | ==== Pool Options ==== | ||
- | {{classicon_pooloption.png }} | + | {{icons8-slice-48.png }} |
This object is used to document the Pool DHCP Options. The Pool scope in TeemIp is implemented through the IP Range object. | This object is used to document the Pool DHCP Options. The Pool scope in TeemIp is implemented through the IP Range object. | ||
Line 131: | Line 157: | ||
Next to all common attributes listed above: | Next to all common attributes listed above: | ||
^ Name ^ Type ^ Mandatory? | ^ Name ^ Type ^ Mandatory? | ||
- | | Subnet| Foreign key to a(n) IP Range | Yes | | + | | IP Range | Foreign key to a(n) IP Range | Yes | |
=== Details === | === Details === | ||
Details of a DHCP Pool Option can be accessed from the specific “Pool Options” shortcut menu of the DHCP Management module. It refers to an organization and to an IP Range within that organization. | Details of a DHCP Pool Option can be accessed from the specific “Pool Options” shortcut menu of the DHCP Management module. It refers to an organization and to an IP Range within that organization. | ||
- | {{ classdetails_pooloption.png }} | + | {{ classdetails_pooloption3x.png? |
==== Class Options ==== | ==== Class Options ==== | ||
- | {{classicon_classoption.png }} | + | {{icons8-folder-48.png }} |
This object is used to document the Class DHCP Options. It refers to a new typological TeemIp object that models DHCP classes. | This object is used to document the Class DHCP Options. It refers to a new typological TeemIp object that models DHCP classes. | ||
=== DHCP Class object === | === DHCP Class object === | ||
This is a typological object defined through the Typology configuration menu in the Data administration chapter. | This is a typological object defined through the Typology configuration menu in the Data administration chapter. | ||
- | {{ classdetails_class.png }} | + | |
+ | {{ classdetails_class3x.png? | ||
=== Properties === | === Properties === | ||
Next to all common attributes listed above: | Next to all common attributes listed above: | ||
^ Name ^ Type ^ Mandatory? | ^ Name ^ Type ^ Mandatory? | ||
- | | Subnet| Foreign key to a(n) DHCP Class | Yes | | + | | Class | Foreign key to a(n) DHCP Class | Yes | |
=== Details === | === Details === | ||
A new DHCP Class Option may be created from the specific “Class Options” shortcut menu of the DHCP Management module. It refers to an organization and to a DHCP Class. | A new DHCP Class Option may be created from the specific “Class Options” shortcut menu of the DHCP Management module. It refers to an organization and to a DHCP Class. | ||
- | {{ classcreate_classoption.png }} | + | {{ classcreate_classoption3x.png? |
==== Sub Class Options ==== | ==== Sub Class Options ==== | ||
- | {{classicon_subclassoption.png }} | + | {{icons8-file-submodule-48.png }} |
This object is used to document the SubClass DHCP Options. It refers to a new typological TeemIp object that models DHCP sub-classes. | This object is used to document the SubClass DHCP Options. It refers to a new typological TeemIp object that models DHCP sub-classes. | ||
=== DHCP SubClass object === | === DHCP SubClass object === | ||
This is another typological object defined through the Typology configuration menu of the Data administration chapter. | This is another typological object defined through the Typology configuration menu of the Data administration chapter. | ||
- | {{ classdetails_subclass.png }} | + | |
+ | {{ classdetails_subclass3x.png? | ||
=== Properties === | === Properties === | ||
Next to all common attributes listed above: | Next to all common attributes listed above: | ||
^ Name ^ Type ^ Mandatory? | ^ Name ^ Type ^ Mandatory? | ||
- | | Subnet| Foreign key to a(n) DHCP SubClass | Yes | | + | | Class | Foreign key to a(n) DHCP Class | Yes | |
+ | | SubClass | ||
=== Details === | === Details === | ||
Details of a DHCP SubClass Option can be accessed from the specific “SubClass Options” shortcut menu of the DHCP Management module. It refers to an organization and to a DHCP SubClass. | Details of a DHCP SubClass Option can be accessed from the specific “SubClass Options” shortcut menu of the DHCP Management module. It refers to an organization and to a DHCP SubClass. | ||
- | {{ classdetails_subclassoption.png }} | + | {{ classdetails_subclassoption3x.png? |
==== Host Options ==== | ==== Host Options ==== | ||
- | {{classicon_hostoption.png }} | + | {{classicon_server.png }} |
This object is used to document the Host DHCP Options. The Host scope in TeemIp is implemented through the Physical Device object. | This object is used to document the Host DHCP Options. The Host scope in TeemIp is implemented through the Physical Device object. | ||
Line 181: | Line 210: | ||
Next to all common attributes listed above: | Next to all common attributes listed above: | ||
^ Name ^ Type ^ Mandatory? | ^ Name ^ Type ^ Mandatory? | ||
- | | Subnet| Foreign key to a(n) Physical Device | Yes | | + | | Host | Foreign key to a(n) Physical Device | Yes | |
=== Details === | === Details === | ||
Details of a DHCP Hosts Option can be accessed from the specific “Host Options” shortcut menu of the DHCP Management module. It refers to an organization and to a Physical Device within that organization. | Details of a DHCP Hosts Option can be accessed from the specific “Host Options” shortcut menu of the DHCP Management module. It refers to an organization and to a Physical Device within that organization. | ||
- | {{ classdetails_hostoption.png }} | + | {{ classdetails_hostoption3x.png? |
+ | |||
+ | ===== DHCP Options tabs on CIs ===== | ||
+ | A "DHCP Options" | ||
+ | The same tab has been added to the Physical devices that have an IP but for them, the tab is visible **only** with **Administrator** and **DHCP Manager** profiles. Aim of this restriction is to not pollute the display to profiles that don't need such information, | ||
+ | |||
+ | {{classdetails_dhcpvlan3x.png? | ||
+ | |||
+ | |||
+ | {{classdetails_dhcpiprange3x.png? | ||
===== User Profiles ===== | ===== User Profiles ===== | ||
The TeemIp DHCP Management extension brings a new profile dedicated to the management of DHCP objects: "DHCP Manager", | The TeemIp DHCP Management extension brings a new profile dedicated to the management of DHCP objects: "DHCP Manager", | ||
- | {{ classdetails_DHCPprofile.png }} | + | {{ classdetails_DHCPprofile3x.png? |
- | This profile extends capabilities and must be used together with other profiles like ConfigurationManager. | + | This profile extends capabilities and must be used together with other profiles like Configuration Manager. |
- | <note warning> | + | ===== Questions & Answers ===== |
- | The DHCP management menu is hidden to the users that don't have the administrator or the DHCP manager profile. | + | |
- | </ | + | |
+ | **Question: How can I document static leases in a DHCP pool?** \\ | ||
+ | Answer: Best practice is to create an IP with the " | ||