Changes

no edit summary
Line 7: Line 7:  
  }}
 
  }}
 
}}
 
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} LAN (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
+
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} LAN (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} LAN (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
+
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} LAN (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
 
__TOC__
 
__TOC__
 
==Summary==
 
==Summary==
Line 29: Line 29:  
The Static Lease list is empty by default. To add a new Static Lease click the 'Add' button.
 
The Static Lease list is empty by default. To add a new Static Lease click the 'Add' button.
   −
[[File:Networking_rutos_manual_dhcp_static_leases_add_button.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_dhcp_static_leases_add_button_v1.png|border|class=tlt-border]]
    
Appears static lease, which should look similar to this:
 
Appears static lease, which should look similar to this:
   −
[[File:Networking_rutos_manual_dhcp_static_leases.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_dhcp_static_leases_v1.png|border|class=tlt-border]]
    
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 44: Line 44:  
       <td>MAC</td>
 
       <td>MAC</td>
 
       <td>mac; default: <b>none</b></td>
 
       <td>mac; default: <b>none</b></td>
       <td>MAC address of a device that will connect to this network interface.</td>
+
       <td>MAC address of a device that will connect to this network interface. Possible variants: MAC address: 01:23:45:56:78:9a, Wildcard: 01:23:45:56:*:*</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
Line 52: Line 52:  
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Description</td>
+
     <td>Hostname</td>
 +
        <td>string; default: <b>none</b></td>
 +
        <td>Name of static lease.</td>
 +
    </tr>
 +
</table>
 +
 
 +
Additionally there is a IPv6 tab for IPv6 static leases.
 +
 
 +
[[File:Networking rutos manual dhcp static leases ipv6 v1.png|border|class=tlt-border]]
 +
 
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
      <th>Value</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>DUID</td>
 +
      <td>DUID; default: <b>none</b></td>
 +
      <td>DHCP unique identifier is used by DHCPv6 to identify device. Similar to MAC that is used by DHCPv4.</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Host ID</td>
 +
        <td>ipv6; default: <b>none</b></td>
 +
        <td>Used to define IPv6 address that will be statically leased. To get it from the IPv6 address remove the IPv6 prefix and all semicolons.</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Hostname</td>
 
         <td>string; default: <b>none</b></td>
 
         <td>string; default: <b>none</b></td>
 
         <td>Name of static lease.</td>
 
         <td>Name of static lease.</td>
Line 59: Line 86:     
After you click 'Save & Apply' static leases will be saved.
 
After you click 'Save & Apply' static leases will be saved.
 +
 +
==DHCP server configuration==
 +
----
 +
A <b>DHCP</b> (<b>Dynamic Host Configuration Protocol</b>) server is a service that can automatically configure the TCP/IP settings of any device that requests such a service. If you connect a device that has been configured to obtain an IP address automatically, the DHCP server will lease out an IP address from the available IP pool and the device will be able to communicate within the private network.
 +
 +
[[File:Networking_rutx_manual_lan_static_dhcp_server_scheme_v1.png]]
 +
 +
===IPv4===
 +
----
 +
To edit lan interface DHCPv4 settings click the 'Edit' button.
 +
 +
[[File:Networking_rutos_manual_dhcpv4_server.png|border|class=tlt-border]]
 +
 +
====DHCPv4 general setup====
 +
The <b>General Setup</b> section is used to set up the main operating parameters of the DHCP server.
 +
 +
[[File:Networking_rutos_manual_dhcpv4_server_general_setup.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Enable</td>
 +
        <td>on | off; default: <b>on</b></td>
 +
        <td>Turns the DHCPv4 server on or off.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>DHCPv4 mode</td>
 +
        <td><span style="color:red">Server</span> | <span style="color:blue">Relay</span><span class="asterisk">*</span>; default: <b>Server</b></td>
 +
        <td>Specifies DHCPv4 mode
 +
        <li>Possible variants:</li>
 +
        <li>Server: This device will be used to handle IP assigning</li>
 +
        <li>Relay: Specified server will be used to handle IP assigning</li></td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:red">Start IP</span></td>
 +
        <td>integer [1..255]; default: <b>100</b></td>
 +
        <td>Type an IP address to serve as the start of the IP range that DHCP will use to assign IP addresses.</td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:red">End IP</span></td>
 +
        <td>integer [1..255]; default: <b>254</b></td>
 +
        <td>Type an IP address to serve as the end of the IP range that DHCP will use to assign IP addresses.</td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:red">Lease time</span></td>
 +
        <td>integer [1..999999] | infinite<span class="asterisk">*</span>; default: <b>12</b>integer [2..999999]<span class="asterisk">**</span>integer [120..999999]<span class="asterisk">***</span></td>
 +
        <td>A DHCP lease will expire after the amount of time specified in this field and the device that was using the lease will have to request a new one. However, if the device stays connected, its lease will be renewed after half of the specified amount of time passes (e.g., if lease time is 12 hours, then every 6 hours the device will ask the DHCP server to renew its lease).The minimal amount of time that can be specified is 2 minutes.<br><span class="asterisk">*</span>Infinite option DHCP address will never expire.<br><span class="asterisk">**</span>If selected Units is Minutes.<br><span class="asterisk">***</span>If selected Units is seconds.</td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:blue">DHCP server</span></td>
 +
        <td>ip; default: <b>none</b></td>
 +
        <td>LSpecifies DHCP server's IP address, which directs any requests into server.</td>
 +
    </tr>
 +
</table>
 +
====Advanced settings====
 +
Refer to the table below for information on the <b>Advanced Settings</b> section.
 +
 +
[[File:Networking_rutos_manual_dhcpv4_server_advanced_settings.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Dynamic DHCP</td>
 +
        <td>off | on; default: <b>on</b></td>
 +
        <td>Dynamically allocate DHCP addresses for clients. If disabled, only clients having static leases will be served.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Force</td>
 +
        <td>off | on; default: <b>off</b></td>
 +
        <td>Force DHCP on this network even if another server is detected.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>IPv4-Netmask</td>
 +
        <td>netmask; default: <b>none</b></td>
 +
        <td>Override the netmask sent to clients. Normally it is calculated from the subnet that is served.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Custom DHCP Options</td>
 +
        <td>-(interactive button)</td>
 +
        <td>Custom DHCP options are number and value pairs used to configure advanced DHCP functionality. It does not configure DHCP ipv6!</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Force DHCP options</td>
 +
        <td>off | on; default: <b>off</b></td>
 +
        <td>Force DHCP options to be sent even if it's not requested.</td>
 +
    </tr>
 +
</table>
 +
=====Custom DHCP options=====
 +
Custom DHCP options are number and value pairs used to configure advanced DHCP functionality. It does not configure DHCP ipv6!. The <b>DHCP options</b> modal is used to 'Add', 'Delete', 'Save' multiple options.
 +
 +
[[File:Networking_rutos_manual_dhcpv4_server_advanced_settings_dhcp_options.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Add</td>
 +
        <td>-(interactive button)</td>
 +
        <td>To add custom DHCP options.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Option code</td>
 +
        <td>Custom | Time offset (2) | Router (3) | DNS (6) | Domain name (15) | NTP server (42) | +Add new; default: <b>Time offset (2)</b></td>
 +
        <td>Standartized DHCP option code.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Option value</td>
 +
        <td>integer; default: <b>none</b></td>
 +
        <td>Value that will be set for selected option.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Do not send</td>
 +
        <td>off | on; default: <b>off</b></td>
 +
        <td>Force this value to not be sent.</td>
 +
    </tr>
 +
</table>
 +
 +
===IPv6===
 +
----
 +
To edit lan interface DHCPv6 settings click the 'Edit' button.
 +
 +
[[File:Networking_rutos_manual_dhcpv6_server_v1.png|border|class=tlt-border]]
 +
 +
====DHCP Server: IPv6 Settings====
 +
----
 +
Refer to the table below for information on the <b>IPv6 Settings</b> section.
 +
 +
[[File:Networking_rutos_manual_dhcpv6_server_configuration.png|border|class=tlt-border]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>Field</th>
 +
        <th>Value</th>
 +
        <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
        <td>Enable</td>
 +
        <td>off | on: <b>on</b></td>
 +
        <td>Turns the DHCPv6 server on or off.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Router Advertisement Service</td>
 +
        <td>Disabled | <span style="color:blue">Server mode</span> | Reley mode | <span style="color:blue">Hybrid mode</span>; default: <b>Server mode</b></td>
 +
        <td><li>Possible variants:</li>
 +
        <li><b>Disabled:</b> Do not advertise any devices as router</li>
 +
        <li><b>Server:</b> Advertise this device as a router</li>
 +
        <li><b>Relay:</b> Advertise the parent interface as a router</li>
 +
        <li><b>Hybrid:</b> Normally works as 'Relay' with automatic fallback to 'Server' if there is no active parent interface</li></td>
 +
    </tr>
 +
    <tr>
 +
        <td>DHCPv6-Service</td>
 +
        <td>Disabled | <span style="color:brown">Server mode</span> | Relay mode | <span style="color:brown">Hybrid mode</span>; default: <b>Server mode</b></td>
 +
        <td><li>Possible variants:</li>
 +
        <li><b>Disabled:</b> Do not automatically assign IPv6 addresses</li>
 +
        <li><b>Server:</b> This device assigns IPv6 addresses</li>
 +
        <li><b>Relay:</b> Forward IPv6 assigning requests between network devices and parent interface</li>
 +
        <li><b>Hybrid:</b> Normally works as 'Relay' with automatic fallback to 'Server' if there is no active parent interface</li></td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:brown">DHCPv6-Mode</span></td>
 +
        <td>Stateless + stateful | Relay mode | Stateful-only; default: <b>Stateless + stateful</b></td>
 +
        <td>Specifies whether NDP should be relayed or disabled.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>NDP Proxy</td>
 +
        <td>Disabled | Relay mode | Hybrid mode; default: <b>Disabled</b></td>
 +
        <td><li>Possible variants:</li>
 +
        <li><b>Disabled:</b> Do not proxy any NDP packets</li>
 +
        <li><b>Relay:</b> Forward NDP packets between network devices and the parent interface</li>
 +
        <li><b>Hybrid:</b> Normally works as 'Relay' with automatic fallback to 'Disabled' if there is no active parent interface</li></td>
 +
    </tr>
 +
    <tr>
 +
        <td><span style="color:blue">Always announce default router</span></td>
 +
        <td>off | on; default: <b>off</b></td>
 +
        <td>Announce as default router even if no public prefix is available.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Announced DNS server</td>
 +
        <td>strin; default: <b>none</b></td>
 +
        <td>Supplements DHCP-assigned DNS server entries with ones specified in this field.</td>
 +
    </tr>
 +
    <tr>
 +
        <td>Announced DNS domains</td>
 +
        <td>string; default: <b>none</b></td>
 +
        <td>DNS domain handed out to DHCP clients.</td>
 +
    </tr>
 +
</table>
 +
 +
<span class="asterisk">*</span> When an interface is set to act as a DHCP Relay, it redirects all received DHCP request messages to another specified DHCP server:
 +
 +
[[File:Networking_rutx_manual_lan_static_dhcp_server_relay_scheme_v2.png]]
    
[[Category:{{{name}}} Network section]]
 
[[Category:{{{name}}} Network section]]