summaryrefslogtreecommitdiff
path: root/docs/system/host-information.rst
diff options
context:
space:
mode:
authorRobert Göhler <github@ghlr.de>2021-01-24 22:14:00 +0100
committerGitHub <noreply@github.com>2021-01-24 22:14:00 +0100
commitc25c40dfa96dfeb022b203280c607c1f1835417b (patch)
treeed05f81d48c65639e621ee3a067f435cb204ea9e /docs/system/host-information.rst
parentce9f2016218f0c162bd48457a41a18db15e52749 (diff)
downloadvyos-documentation-c25c40dfa96dfeb022b203280c607c1f1835417b.tar.gz
vyos-documentation-c25c40dfa96dfeb022b203280c607c1f1835417b.zip
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
Diffstat (limited to 'docs/system/host-information.rst')
-rw-r--r--docs/system/host-information.rst175
1 files changed, 0 insertions, 175 deletions
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 <hostname>
-
-.. 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 <hostname>
-
-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 <domain>
-
-.. 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 <domain>
-
-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 <hostname> inet <IP address>
-
-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 <hostname> alias <alias>
-
-Show aliases:
-
-.. code-block:: none
-
- show system static-mapping
-
-Delete alias:
-
-.. code-block:: none
-
- delete system static-host-mapping host-name <hostname> alias <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 <IP 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 <gateway ip>
-
-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