User Tools

Site Tools


2_x:datamodel:ip-addresses

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-addresses [2023/10/03 11:15] – [Allocate Address to CI] cnaud2_x:datamodel:ip-addresses [2024/04/04 16:10] (current) cnaud
Line 79: Line 79:
 By definition, FQDNs are absolute domain names. They specify the exact location of domain names in the tree hierarchy of the Domain Name System (DNS). This is why they end up with a dot.\\ By definition, FQDNs are absolute domain names. They specify the exact location of domain names in the tree hierarchy of the Domain Name System (DNS). This is why they end up with a dot.\\
 \\ \\
 +According to configuration parameter **Allow Duplicate Names**, unicity of the FQDN is checked:
 +  * Duplicates may exist in different organizations,
 +  * Within an organization, duplicates may exist in different [[extensions:teemip-zone-mgmt#views|DNS views]],
 +  * If parameter is set to:
 +    * **No**, all other cases of duplicates are rejected, 
 +    * **Dual stack**, duplicates may exist between IPv4 and IPv6 spaces,
 +    * **Yes**, unicity of FQDN is not verified.
 +
 According to configuration parameter **Compute FQDN when short name is empty**, the FQDN may be computed regardless the content of the Short Name and DNS Domain. According to configuration parameter **Compute FQDN when short name is empty**, the FQDN may be computed regardless the content of the Short Name and DNS Domain.
 </note> </note>
Line 91: Line 99:
 For v6 IPs, a simple autocompletion mechanism is used to help typing the IP: its first 64 bits are copied from the subnet IP… which can, of course, be manually changed by the user.  For v6 IPs, a simple autocompletion mechanism is used to help typing the IP: its first 64 bits are copied from the subnet IP… which can, of course, be manually changed by the user. 
 </note> </note>
-==== Modify an IP Address ====+==== Modifying an IP Address ====
 From the detailed view of an IP Address, click on the {{pen-icon.png?nolink|Edit icon}} button. From the detailed view of an IP Address, click on the {{pen-icon.png?nolink|Edit icon}} button.
  
Line 97: Line 105:
  
 ==== Navigating between adjacent IPs ==== ==== Navigating between adjacent IPs ====
-FIXME+TeemIp provides an easy and efficient way to navigate between adjacent IPs. 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 IP in TeemIp. This action is driven by default parameters that can be overwritten in the configuration file. 
 + 
 +<code> 
 + 'teemip-ip-mgmt' => array ( 
 + ... 
 + 'ip_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 IP belongs to or not |
 ==== Other Actions ==== ==== Other Actions ====
 Next to standard actions, a set of specific actions can be applied to IP Addresses. 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 Addresses. These can be found in the **Other Actions** menu available from the details page.
Line 139: Line 163:
  
  
 +==== Management of DNS RRS ====
 +<note tip>
 +The management of the DNS resource records is available if the [[extensions:teemip-zone-mgmt#link_with_ip_addresses1|DNS Zone Management]] extension has been installed.
 +</note>
 +=== Create / Update DNS RRs ===
 +This action will create the **A / AAAA**, **PTR** and **CNAME** DNS resource records that may be linked to the IP. A few criteria need to be met for this to happen: 
 +  * A zone corresponding to the IP's **DNS Domain** and belonging to the right **DNS view** must exist to create the A or AAAA records,
 +  * A reverse zone corresponding to the IP must exist to create the PTR record,
 +  * Each alias must belong to an existing zone in order to create a CNAME record.
  
-==== Links between IP Addresses and CIs ====+=== Delete DNS RRs === 
 +This action will just delete all resource records linked to the IP. 
 + 
 +====== Links between IP Addresses and CIs ======
 TeemIp has been designed to provide a comprehensive modelization and documentation of the link(s) that a CI and an IP address may share together.  TeemIp has been designed to provide a comprehensive modelization and documentation of the link(s) that a CI and an IP address may share together. 
  
Line 146: Line 182:
   * A unique IP can be attached to them,   * A unique IP can be attached to them,
   * An IP address must be in the status Released or Unassigned to be attached to a CI,   * An IP address must be in the status Released or Unassigned to be attached to a CI,
-  * IPs that are in state Allocated cannot be set as IP attribute and reserved IPs are... reserved, +  * IPs that are in state Allocated cannot be set as IP attribute unless IP setting **Allow attachment of already allocated IPs to CIs** is set to **Yes**, 
-  * Once CI is created or updated, status of attached IP is automatically changed to Allocated,+  * Reserved IPs are... reserved, 
 +  * Once CI is created or updated, the status of its attached IP is automatically changed to Allocated,
   * If a Management IP is removed from the CI, its status becomes Unassigned unless it is still linked to another CI.   * If a Management IP is removed from the CI, its status becomes Unassigned unless it is still linked to another CI.
  
Line 153: Line 190:
   * One or more IPs (with no limitation of quantity) can be attached to them,    * One or more IPs (with no limitation of quantity) can be attached to them, 
   * An IP can be attached to them, regardless their status,    * An IP can be attached to them, regardless their status, 
-  * Once CI is created or updated, status of attached IP is automatically changed to Allocated,+  * Once an interface is created or updated, the status of its attached IPs is automatically changed to Allocated,
   * If a link with an IP address is removed, status of IP moves back to Unassigned unless it is still linked to another CI.   * If a link with an IP address is removed, status of IP moves back to Unassigned unless it is still linked to another CI.
  
Line 160: Line 197:
 </note> </note>
  
-=== Impact of CIs' life cycle to IPs ===+==== Impact of CIs' life cycle to IPs ====
 Changes on CIs may have an impact on IPs. Here is what happens when... Changes on CIs may have an impact on IPs. Here is what happens when...
-== - A Functional CI is created ==+=== - A Functional CI is created ===
   * It is checked if the CI has IP Attributes,   * It is checked if the CI has IP Attributes,
   * For each of these that do point to an IP:   * For each of these that do point to an IP:
Line 168: Line 205:
     * Short name attribute is computed.     * Short name attribute is computed.
  
-== - A Functional CI is updated ==+=== - A Functional CI is updated ===
   * It is checked if the CI has IP Attributes,   * It is checked if the CI has IP Attributes,
   * For each of these:   * For each of these:
Line 174: Line 211:
     * Short name is changed if the CI name has changed.     * Short name is changed if the CI name has changed.
  
-== - A Functional  CI is deleted ==+=== - A Functional  CI is deleted ===
   * It is checked if the CI had IP Attributes,   * It is checked if the CI had IP Attributes,
   * For each of these that do point to an IP:   * For each of these that do point to an IP:
Line 180: Line 217:
     * Short name attribute is reset to empty string.     * Short name attribute is reset to empty string.
  
-== - A functional CI becomes obsolete == +=== - A functional CI becomes obsolete === 
-  * Its IPs may automatically be released from it, as described in the related [[2_x:datamodel:teemip_cmdb#obsoleting_cis_with_ips|CMDB chapter]].+  * Its IPs may automatically be released from it, if IP Setting **Release IPs from CIs that become obsolete** is set.
  
  
-=== Releasing IPs ===+==== Releasing IPs ====
 When an IP is set to the status "Released", it is automatically removed from all CIs and all interfaces. When an IP is set to the status "Released", it is automatically removed from all CIs and all interfaces.
  
-=== Continuous IP status coherency check === +==== Automation ==== 
-TeemIp may automatically and periodically check the status of IPs and their coherency with the CIs they are attached to, if any. This behaviour is driven by a set of parameters defined in [[2_x:datamodel:ip-settings|Global IP Settings]]. For any given organization, should the configuration parameter... : +When linking an IP together with a CI, one must insure that both the CI's and the IP's status are consistent. TeemIp may automatically and periodically check the status of IPs and their coherency with the CIs they are attached to, if any. This behaviour is driven by a set of parameters defined in [[2_x:datamodel:ip-settings|Global IP Settings]]. For any given organization, should the configuration parameter... : 
-   "Allocate IPs attached to production CIsbe set, TeemIp will make sure that IPs attached to CIs are "Allocated"+ 
-   "Release IPs from CIs that become obsoletebe set, TeemIp will release all IPs that are still allocated to obsolete CIs, +   **Allocate IPs attached to production CIs** (*) be set to **Yes**, TeemIp will make sure that IPs attached to CIs are "Allocated"
-   "Release IPs from subnets that are releasedbe set, TeemIp will release all IPs that belong to released subnets.+   **Release IPs from CIs that become obsolete** (*) be set to **Yes**, TeemIp will release all IPs that are still allocated to obsolete CIs, 
 +   **Un-allocate IPs that are not attached to a CI** (*) be set to **Yes**, TeemIp will unassign the IPs that are no longer attached to a CI, 
 +   * **Release IPs from subnets that are released** be set to **Yes**, TeemIp will release all IPs that belong to released subnets
 +   * **Allow attachment of already allocated IPs to CIs** be set to **Yes**, TeemIp will allow, from the CI details screen, the attachment of an allocated IP to a CI. 
 + 
 +The 3 first actions (*) are handled by background tasks which default parameters can be overwritten in the configuration file.  
 + 
 +<code> 
 + 'teemip-ip-mgmt' => array ( 
 + ... 
 + 'ip_allocate_on_ci_status' => array ( 
 +   'enabled' => true, 
 +   'debug' => true, 
 +   'periodicity' => 3600, 
 +   'status_list' => array ( 
 +     0 => 'implementation', 
 +     1 => 'production', 
 +   ), 
 + ), 
 + 'ip_release_on_ci_status' => array ( 
 +   'enabled' => true, 
 +   'debug' => true, 
 +   'periodicity' => 3600, 
 +   'status_list' => array ( 
 +     0 => 'obsolete', 
 +   ), 
 + ), 
 + 'ip_unassign_on_no_ci' => array ( 
 +   'enabled' => true, 
 +   'debug' => true, 
 +   'periodicity' => 3600, 
 +   'target_status' => 'unassigned', 
 + ), 
 +                ... 
 + ), 
 + 
 +</code> 
 + 
 +^  Parameter  ^  Description 
 +| enabled| Enable or disable the function | 
 +| debug | Add verbosity to the process | 
 +| periodicity | Periodicity of the background task | 
 +| status_list | List of status that trigger the action | 
 +| target_status | Status of the IP once the action is done |
  
 +Please, refer to the [[2_x:datamodel:configuration|Configuration File]] chapter for further details.
2_x/datamodel/ip-addresses.1696324507.txt.gz · Last modified: 2023/10/03 11:15 by cnaud