From c25c40dfa96dfeb022b203280c607c1f1835417b Mon Sep 17 00:00:00 2001 From: Robert Göhler Date: Sun, 24 Jan 2021 22:14:00 +0100 Subject: Migrate new file structure to crux (#435) * order workflows and add submodule * rename gitmodules file * delete docs/.gitignore * add vyos custom linter * correct __pycache__ in gitignore * add test-coverage.py * move draw.io folder * arrange changelog, install history and about * arrange: firewall * arrange: highavailability * arrange: loadbalancing * arrange: nat * arrange: services * sort configexamples and configuration interfaces * wireles: rename wireless * rearrange: Protocols and Policy * rearrange: Firewall and Zone Policy * rearrange: Interfaces * rearrange: Interfaces * rearrange: dynamic DNS * hostinfo: add page to index * rearrange: appendix * venv: add Pipfile * rearrange: contributing * index: remove debugging * rearrange: fix all figure and refs * rearrange: commandtree * fix: cli, openvpn, install headline level * protocols: change headline * firewall: move mss clamping * ip: separate ipv4 and ipv6 * arp: move to static page * igmp: rename multicast page * Update to year 2021 --- docs/system/host-information.rst | 175 --------------------------------------- 1 file changed, 175 deletions(-) delete mode 100644 docs/system/host-information.rst (limited to 'docs/system/host-information.rst') diff --git a/docs/system/host-information.rst b/docs/system/host-information.rst deleted file mode 100644 index 71209412..00000000 --- a/docs/system/host-information.rst +++ /dev/null @@ -1,175 +0,0 @@ -.. _host-information: - -Host Information ----------------- - -This section describes the system's host information and how to configure them, -it covers the following topics: - -* Host name -* Domain -* IP address -* Default gateway -* Aliases - -Host Name -^^^^^^^^^ - -A hostname is the label (name) assigned to a network device (a host) on a -network and is used to distinguish one device from another on specific networks -or over the internet. - -Set a system host name: - -.. code-block:: none - - set system host-name - -.. note:: Only letters, numbers and hyphens are allowed. - -Show host name: - -.. code-block:: none - - show system host-name - -Delete host name: - -.. code-block:: none - - delete system host-name - -Example: Set system hostname to 'RT01': - -.. code-block:: none - - set system host-name RT01 - commit - show system host-name - host-name RT01 - -Domain Name -^^^^^^^^^^^ - -A domain name is the label (name) assigned to a computer network and is thus -unique. - -Set the system's domain: - -.. code-block:: none - - set system domain-name - -.. note:: Only letters, numbers, hyphens and periods are allowed. - -Show domain: - -.. code-block:: none - - show system domain-name - -Remove domain name: - -.. code-block:: none - - set system delete domain-name - -Example: Set system domain to example.com: - -.. code-block:: none - - set system domain-name example.com - commit - show system domain-name - domain-name example.com - -Static host mappings -^^^^^^^^^^^^^^^^^^^^ - -How to assign IPs to interfaces is described in chapter -:ref:`interfaces-addresses`. This section shows how to statically map a system -IP to its host name for local (meaning on this VyOS instance) DNS resolution: - -.. code-block:: none - - set system static-host-mapping host-name inet - -Show static mapping: - -.. code-block:: none - - show system static-host-mapping - -Example: Create a static mapping between the system's hostname `RT01` and -IP address `10.20.30.41`: - -.. code-block:: none - - set system static-host-mapping host-name RT01 inet 10.20.30.41 - commit - show system static-host-mapping - host-name RT01 { - inet 10.20.30.41 - } - -Aliases -******* - -One or more system aliases (static mappings) can be defined: - -.. code-block:: none - - set system static-host-mapping host-name alias - -Show aliases: - -.. code-block:: none - - show system static-mapping - -Delete alias: - -.. code-block:: none - - delete system static-host-mapping host-name alias - -Example: Set alias `router1` for system with hostname `RT01`: - -.. code-block:: none - - set system static-host-mapping host-name RT01 alias router1 - commit - show system static-host-mapping - host-name RT01 { - alias router1 - inet 10.20.30.41 - } - -Default Gateway/Route -^^^^^^^^^^^^^^^^^^^^^ - -In the past (VyOS 1.1.8) used a gateway-address configured in the system tree -(`set system gateway-address `) this is no longer supported and -existing configurations are migrated to the new CLI commands. - -It is replaced by inserting a static route into the routing table using: - -.. code-block:: none - - set protocols static route 0.0.0.0/0 next-hop - -Delete the default route from the system - -.. code-block:: none - - delete protocols static route 0.0.0.0/0 - -Show default route: - -.. code-block:: none - - vyos@vyos$ show ip route 0.0.0.0 - Routing entry for 0.0.0.0/0 - Known via "static", distance 1, metric 0, best - Last update 3d00h23m ago - * 172.16.34.6, via eth1 -- cgit v1.2.3