]>
Commit | Line | Data |
---|---|---|
357723e9 | 1 | = network-zone(8) |
357723e9 MT |
2 | |
3 | == NAME | |
4 | network-zone - Manage network zones | |
5 | ||
6 | == SYNOPSIS | |
7 | [verse] | |
8 | 'network zone [new|destroy]' ZONE | |
9 | 'network zone' ZONE ... | |
10 | ||
11 | == DESCRIPTION | |
12 | With help of the 'zone' command, it is very easy to configure network zones. | |
13 | ||
14 | It is possible to create zones and remove them. Zones may also be brought up | |
15 | and down and reconfigured. Their status may be viewed as well. | |
16 | ||
17 | == COMMANDS | |
18 | The following commands are understood: | |
19 | ||
20 | 'new ZONE HOOK OPTIONS':: | |
21 | A new zone may be created by the 'create' command. | |
22 | There are at least two arguments required. | |
23 | + | |
24 | ZONE must be valid name for a zone which does not already exist. | |
25 | HOOK is a valid zone hook which may require additional options. | |
26 | ||
27 | 'destroy ZONE':: | |
28 | A zone can be destroyed with this command. | |
29 | + | |
30 | There are two possible ways to remove a zone. The case is when the zone is | |
31 | not up. Then, it will be removed immediately. When the zone is current up | |
32 | and used, it will tagged to be remove later, after it has been brought down. | |
33 | ||
34 | For all other commands, the name of the zone needs to be passed first: | |
35 | ||
36 | 'edit OPTIONS':: | |
37 | The settings of a zone may be edited after it has been created. | |
38 | The options that can be passed depend on the hook that is used for the zone. | |
39 | Run 'network zone ZONE edit --help' to learn more about that. | |
40 | + | |
41 | It usually is required to restart/reload the zone until the new settings | |
42 | are taken into account. | |
43 | ||
44 | '[up|down]':: | |
45 | These commands will bring the zone up/down. This is done without control | |
46 | of systemd, therefore not intended to be done in a productive environment. | |
47 | However, these commands may be used for debugging. | |
48 | ||
49 | '[enable|disable]':: | |
50 | These commands will enable or disable the zone. An enabled zone will | |
51 | automatically be started either during the boot process or a hotplug event | |
52 | of an associated port or other device. | |
53 | ||
54 | 'status':: | |
55 | This will show some detailed information about the state if the specified zone. | |
56 | ||
57 | include::include-color.txt[] | |
58 | ||
59 | include::include-description.txt[] | |
60 | ||
61 | 'identify':: | |
62 | This command will make all ports of the zone flash for a few seconds so | |
63 | that you can identify the correct network adapters in the system. | |
64 | ||
65 | 'rename' NAME:: | |
66 | Renames the zone to NAME. | |
67 | + | |
68 | The command will shut down the zone if it is up and start it again with | |
69 | the new name. If the zone is not up it won't be started. | |
70 | ||
6b1e7474 MT |
71 | == AUTHORS |
72 | Michael Tremer | |
73 | ||
357723e9 MT |
74 | == SEE ALSO |
75 | link:network[8] |