User Tools

Site Tools


2_x:datamodel:ip-ranges

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:ip-ranges [2019/12/05 16:02] – [Tabs] cnaud2_x:datamodel:ip-ranges [2024/03/27 11:03] (current) – [Modify an IP Range] cnaud
Line 1: Line 1:
 ====== IP Ranges ====== ====== IP Ranges ======
  
-{{classicon_ipv4range.png  }}  +{{icons8-slice-48.png  }}  
-{{classicon_ipv6range.png  }} +{{icons8-slicev6-48.png  }} 
  
 IP ranges objects in TeemIp represent sets of contiguous IP addresses that belong to a given subnet. Typically, IP ranges are used to reserved IP space for an application (like DHCP) or to group devices that share the same function (like printers). IP ranges objects in TeemIp represent sets of contiguous IP addresses that belong to a given subnet. Typically, IP ranges are used to reserved IP space for an application (like DHCP) or to group devices that share the same function (like printers).
Line 28: Line 28:
 ==== Tabs ==== ==== Tabs ====
 ^  Tab  ^  Description  ^ ^  Tab  ^  Description  ^
 +| Global Settings | Settings defined for the IP Range's organization and values used at creation time |
 | Contacts | All the contacts for this IP Object | | Contacts | All the contacts for this IP Object |
 | Documents | All the documents linked to this IP Object | | Documents | All the documents linked to this IP Object |
 +| DHCP Servers * | List of all DHCP servers attached to the range |
 +| DHCP Options * | List of all DHCP options attached to the range |
 +| Notifications | List of related notifications - Present if a notification trigger exists for that class |
 | Registered IPs | IP addresses belonging to the IP range| | Registered IPs | IP addresses belonging to the IP range|
-History | History of all changes made to the Ip range |+Activity panel | History of all changes made to the IP range |
  
 +<note>
 +(*) These tabs are only visible on ranges that are flagged as DHCP ones.
 +  * Each server listed in the **DHCP Servers** tab may have a specific role: Active, Primary, Secundary, Single or Split Scope. CIs listed in that tab can be if class **NAS**, **Network Device**, **Server** or **Virtual Machine**.
 +  * The **DHCP Options** tab is actually managed by the "TeemIp DHCP Management" extension where [[extensions:teemip-dhcp-mgmt#pool_options|Pool Options]] are managed.
 +</note>
 ==== Listing IP Ranges ==== ==== Listing IP Ranges ====
-The IP Ranges shortcuts of the IP Management module on the explorer menu display all the IPv4 or IPv6 Ranges of the selected organization or all IPv4 or IPv6 ranges if no organization is selected.+The IP Ranges shortcuts under the **IP Management** menu display all the IPv4 or IPv6 Ranges of the selected organization or all IPv4 or IPv6 ranges registered in the application if no organization is selected. 
 + 
 +{{ classlist_ipv4range-3x.png }}
  
-{{ classlist_ipv4range.png }} +{{ classlist_ipv6range-3x.png }}
-{{ classlist_ipv6range.png }}+
  
 The "Registered IPs" column gives the percentage of the IP Range that is already consumed by all the IPs within the  range. The "Registered IPs" column gives the percentage of the IP Range that is already consumed by all the IPs within the  range.
Line 45: Line 55:
 </note> </note>
 ==== Creating a new IP Range ==== ==== Creating a new IP Range ====
-From the listing view, click on the “New…” menu to display the creation form. +From the listing view or from any create action of a subnet range badge, click on the {{plus-button.png?nolink|Edit icon}} to display the creation form. 
  
-{{ classcreate_ipv6range.png }}+ 
 +{{ classcreate_ipv6range-3x.png }}
    
 An implicit but intuitive set of rules must be followed when an IP range is created: An implicit but intuitive set of rules must be followed when an IP range is created:
Line 56: Line 67:
  
  
 +==== Display an IP Range ====
 +From the list of ranges, select the one you'd like to consider. DHCP ranges may be associated to DHCP servers (of class NAS, Network Device, Server or Virtual Machine):
 +
 +
 +{{ classdetails_ipv4range-3x.png }}
 +
 +<note>
 +When linking a server to a DHCP range, you may specify its role: Active, Primary, Secundary, Single or Split Scope.
 +</note>
 ==== Modify an IP Range ==== ==== Modify an IP Range ====
-From the detailed view of an IP Range, click on the “Modify” button.+From the detailed view of an IP Range, click on the {{pen-icon.png?nolink|Edit icon}} button.
  
 The parameters that can be changed here are: Name, First and Last IPs, Usage, DHCP range, Note, Requestor as well as the lists of Contacts and Documents attached to the IP Range. The parameters that can be changed here are: Name, First and Last IPs, Usage, DHCP range, Note, Requestor as well as the lists of Contacts and Documents attached to the IP Range.
  
 +==== Navigating between adjacent Ranges ====
 +TeemIp provides an easy and efficient way to navigate between adjacent ranges. If the action is enabled, the left and rights arrows of the object menu {{navigate-icon.png?nolink|Navigate icon}} will bring you to the previous or next registered range in TeemIp. This action is driven by default parameters that can be overwritten in the configuration file.
 +
 +<code>
 + 'teemip-ip-mgmt' => array (
 + ...
 + 'range_navigation' => array (
 +   'enabled' => true,
 +   'within_subnet_only' => false,
 + ),
 +                ...
 +        ),
 +
 +</code>
 +
 +^  Parameter  ^  Description  ^
 +| enabled| Enable or disable the function |
 +| within_subnet_only| Limit the navigation to the subnet that the range belongs to or not |
 ==== Other Actions ==== ==== Other Actions ====
-Next to standard actions, a set of specific actions can be applied to IP Ranges. These can be found in the Other Actions” menu available from the details page.+Next to standard actions, a set of specific actions can be applied to IP Ranges. These can be found in the **Other Actions** menu available from the details page.
  
-{{ details-popup-menu-iprangeotheractions.png }}+{{ details-popup-menu-iprangeotheractions-3x.png }}
  
 These specific actions are described in below chapters. These specific actions are described in below chapters.
Line 70: Line 108:
  
 ==== List & Pick IPs ==== ==== List & Pick IPs ====
-The List & Pick IPs action simply lists, in numerical order, all the IP addresses hosted within an IP Range. It lists as well the free IP addresses and provides the possibility to directly register one of them.+The List & Pick IPs action simply lists, in numerical order, all the IP addresses hosted within an IP Range. It lists as well the free IP addresses and provides the possibility to directly register them.
  
-<note>+<note tip>
 The list is limited to 4096 IPs. Should the subnet contain more IPs, then a preliminary screen asks the user to shorten subnet boundaries so that less than 4096 IPs are displayed. The list is limited to 4096 IPs. Should the subnet contain more IPs, then a preliminary screen asks the user to shorten subnet boundaries so that less than 4096 IPs are displayed.
 </note>  </note> 
  
-{{ classlistips1_ipv4range.png }}+{{ classlistips1_ipv4range-3x.png }}
  
 All free IPs can be created by clicking the appropriate {{ipmini-add-xs.png}} button. This will open a popup window where all IP details can be registered. If you don’t wish to proceed, the top right menus will lead you to your next page. All free IPs can be created by clicking the appropriate {{ipmini-add-xs.png}} button. This will open a popup window where all IP details can be registered. If you don’t wish to proceed, the top right menus will lead you to your next page.
  
 +<note>
 +The highlighted status (like Unassigned, here) and the PING, LOOKUP or SCAN labels are set by the IP discovery process. Please, refer to the [[extensions:teemip-ip-discovery-extension#view_results_in_teemip|TeemIp IP Discovery extension]] for a detailed view on that subject. 
 +</note>
 ==== CSV Export IPs ==== ==== CSV Export IPs ====
 This function exports in a text format all IPs of a given subnet: IPs that are registered (regardless their status: allocated, reserved, released or unassigned) and IPs that are not registered and that don’t exit as an object in TeemIp data base. This function exports in a text format all IPs of a given subnet: IPs that are registered (regardless their status: allocated, reserved, released or unassigned) and IPs that are not registered and that don’t exit as an object in TeemIp data base.
  
-<note>+<note tip>
 The list is limited to 4096 IPs. Should the subnet contain more IPs, then a preliminary screen asks the user to shorten subnet boundaries so that less than 4096 IPs are displayed. The list is limited to 4096 IPs. Should the subnet contain more IPs, then a preliminary screen asks the user to shorten subnet boundaries so that less than 4096 IPs are displayed.
 </note>  </note> 
  
-{{ classcsvips1_ipv6range.png }}+{{ classcsvips1_ipv6range-3x.png }}
  
 Clicking on “Apply” will generate the list.  Clicking on “Apply” will generate the list. 
  
-{{ classcsvips2_ipv6range.png }}+{{ classcsvips2_ipv6range-3x.png }}
  
 Next to the attributes of an IP address, additional information fields are exported with each IP address: Next to the attributes of an IP address, additional information fields are exported with each IP address:
  
-^  Field ^  Possible values ^  Comment  ^+^  Field  ^  Possible values  ^  Comment  ^
 | Registered | yes / no | True if registered in data base | | Registered | yes / no | True if registered in data base |
 | Id | Number | Id of object in data base | | Id | Number | Id of object in data base |
2_x/datamodel/ip-ranges.1575558130.txt.gz · Last modified: 2019/12/05 16:02 by cnaud