diff options
author | Yuri Chornoivan <yurchor@ukr.net> | 2018-07-10 09:03:00 +0300 |
---|---|---|
committer | Yuri Chornoivan <yurchor@ukr.net> | 2018-07-10 09:03:00 +0300 |
commit | 6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e (patch) | |
tree | 8dc42520a1a5c94d574c1c812701b4c0b6fcbc70 /docs/docs/stable/mcc-help/en | |
parent | 000bbaf9e6dde0e9bc0e346d339be65421a51f0d (diff) | |
download | tools-6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e.tar tools-6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e.tar.gz tools-6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e.tar.bz2 tools-6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e.tar.xz tools-6aaf1eb4f4f1471a8eb0867c5cab92923f9f8b0e.zip |
Update draknetprofile page
Diffstat (limited to 'docs/docs/stable/mcc-help/en')
-rw-r--r-- | docs/docs/stable/mcc-help/en/draknetprofile.xml | 268 |
1 files changed, 256 insertions, 12 deletions
diff --git a/docs/docs/stable/mcc-help/en/draknetprofile.xml b/docs/docs/stable/mcc-help/en/draknetprofile.xml index 6bb648b4..1b673172 100644 --- a/docs/docs/stable/mcc-help/en/draknetprofile.xml +++ b/docs/docs/stable/mcc-help/en/draknetprofile.xml @@ -1,18 +1,262 @@ -<?xml version='1.0' encoding='utf-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns="http://docbook.org/ns/docbook" xml:id="draknetprofile" version="5.0"> +<?xml version='1.0' encoding='utf-8'?> + +<section xmlns='http://docbook.org/ns/docbook' + xmlns:ns5='http://www.w3.org/1998/Math/MathML' + xmlns:ns4='http://www.w3.org/2000/svg' + xmlns:ns3='http://www.w3.org/1999/xhtml' + xmlns:ns2='http://www.w3.org/1999/xlink' + xmlns:ns='http://docbook.org/ns/docbook' + xml:id='draknetprofile' version='5.0'> + <info> - <title xml:id="draknetprofile-ti1">Manage different network profiles</title><subtitle>draknetprofile</subtitle> + <title xml:id='draknetprofile-ti1'>Manage different network + profiles</title> + <subtitle>Draknetprofile</subtitle> </info> - <mediaobject> - <imageobject> - <imagedata xml:id="draknetprofile-im1" revision="1" align="center" format="PNG" fileref="draknetprofile.png"/> - </imageobject> - </mediaobject> + <section> + <title>Introduction</title> + + <para>Each network interface of a Mageia system is initially + configured with a fix set of parameters. This corresponds + to what is expected by a user of a desktop computer, but + may not be adequate when the system is moved between various + network environments: having the system run in different + network environments will require that multiple configurations + co-exist for a given network device - otherwise the interface + might need to be re-configured each time the network environment + changes.</para> + + <section> + <title>Profiles</title> + + <para>Linux provides support for multiple configurations + of network devices as a standard feature. The notion + of a <emphasis role='bold'>"network profile"</emphasis> + refers to a set of configurations of network devices, + defined for a specific network environment. Each network + profile has a <emphasis role='bold'>name</emphasis> - + the initial configuration that comes out of system generation + has the name <emphasis>"default"</emphasis>; when a new + profile is created, a name must be specified which is + different from all already existing profile names.</para> + </section> + + <section> + <title>Draknetprofile</title> + + <para>Draknetprofile is a - very simple - component of + the Mageia Control Center (MCC), it provides a Graphical + User Interface (GUI) for managing profiles. This GUI + allows to + + <itemizedlist> + + <listitem> + <para>switch between profiles - i.e. activate a target + profile to become the "current profile",</para> + </listitem> + + <listitem> + <para>create a new, additional profile,</para> + </listitem> + + <listitem> + <para>delete a profile from the list of defined profiles.</para> + </listitem> + </itemizedlist> + </para> + </section> + </section> + + <section> + <title>Running Draknetprofile</title> + + <section> + <title>Defining profiles, profile switching</title> + + <para>Defining/modifying profiles concerns the entire Linux + system and all its users. Running draknetprofile therefore + requires root privileges. Normally, launching is achieved + from within MCC (which already runs as root):</para> + + <mediaobject> + <imageobject> + <imagedata xml:id='draknetprofile-im1' + fileref='./draknetprofile_mcc.png' format='PNG' align='center' + revision='1'/> + </imageobject> + <caption> + <para><emphasis role='bold'>Figure 1: Mageia Control + Center: Network & Internet tab</emphasis></para> + </caption> + </mediaobject> + + <orderedlist> + + <listitem> + <para>launch the MCC by hitting the MCC icon in one + of the panels of your desktop,</para> + </listitem> + + <listitem> + <para>select the "Network & Internet" tab,</para> + </listitem> + + <listitem> + <para>hit "Manage different network profiles" in the + "Personalize and Secure your network" Section (solid + red contour in Figure 1).</para> + </listitem> + </orderedlist> + + <para>Draknetprofile can also be launched by a command-line + instruction from a terminal emulator with root privileges + (this may be helpful when standard-output or error-output + from draknetprofile needs to be consulted - for instance + for debugging). Simply type:</para> + + <informaltable frame='all' colsep='1' rowsep='1'> + <tgroup cols='1'> + <?dbhtml cellpadding='4' ?> + <tbody> + <row><?dbhtml bgcolor='#DDDDDD' ?><?dbfo bgcolor='#DDDDDD' ?> + <entry><literal> draknetprofile </literal></entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>After the launch, the main page of Draknetprofile + will be displayed:</para> + + <mediaobject> + <imageobject> + <imagedata xml:id='draknetprofile-im2' + fileref='./draknetprofile_main.png' format='PNG' + align='center' revision='1'/> + </imageobject> + <caption> + <para><emphasis role='bold'>Figure 2: Management actions + of Draknetprofile</emphasis></para> + </caption> + </mediaobject> + + <para>The upper zone of the window contains the list of + the names of all presently defined profiles. The bottom + zone presents a series of buttons:</para> + + <itemizedlist> + + <listitem> + <para>"Activate" ... establish the selected profile + (top zone of the window) as the current profile (and + save the properties of the old profile);</para> + </listitem> + + <listitem> + <para>"New" ... create a new profile;</para> + </listitem> + + <listitem> + <para>"Delete" ... delete the selected profile from + the list of defined profiles;</para> + </listitem> + + <listitem> + <para>"Quit" ... exit from Draknetprofile.</para> + </listitem> + </itemizedlist> + + <para>Before hitting the "Activate" or the "Delete" button, + you have to select a profile from the list: select it + by a left-button click on the name of the target profile.</para> + + <para>Hitting the "New" button will launch an auxiliary + window where you can type the name of the profile you + want to create; this name must be different from any + already existing profile. This profile will be created + as a precise copy of the currently active profile and + immediately activated as the current profile. You will + probably then need to specify its properties (modify + the automatically created configuration) in a second, + independent action:</para> + + <itemizedlist> + + <listitem> + <para>exit from Draknetprofile (hit the "Quit" button),</para> + </listitem> + + <listitem> + <para>back in the "Network & Internet" tab, you + select the tab "Set up a new network interface (...)" + (marked with dashed red contour in Figure 1),</para> + </listitem> + + <listitem> + <para>you then go through the steps for configuring + the the interface; they are similar to those you + did for configuring the original interface during + system generation - as documented in the <link linkend='drakconnect-ti1'>Drakconnect + manual</link>.</para> + </listitem> + </itemizedlist> + + <para>The middle zone of the window is normally hidden, + hit the "Advanced" button to make it visible. It should + display the list of names of Draknetprofile <emphasis + role='bold'>"modules"</emphasis> (such as "network", + "firewall", "urpmi"), each with a check-button next to + the name; these check-buttons determine whether the properties + controlled by that module are included into the profile + or not. In the present release (Mageia 5), this list + is empty.</para> + </section> + + <section> + <title>Using a system that has more than one profile</title> + + <para>In a system where several profiles are defined, an + additional user interaction is required when the system + boots: at the very end of the bootstrapping activities + - just before the Desktop Environment starts - you will + get a message like</para> + + <informaltable frame='all' colsep='1' rowsep='1'> + <tgroup cols='1'> + <?dbhtml cellpadding='4' ?> + <tbody> + <row><?dbhtml bgcolor='#DDDDDD' ?><?dbfo bgcolor='#DDDDDD' ?> + <entry><literal> Select network profile: + (1) default (2) roaming* </literal></entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <para>Type 1 or 2 to select the "default", respectively + the "roaming" profile, or carriage-return to select the + profile that is marked with an astrisk (the profile that + was active when the system had been shut down).</para> + + <para>Presently (Mageia-5) there appears to be an intermittent + problem: it happens that the system becomes unresponsive + after soliciting the user to select a profile. The only + way out of this situation is to launch another boot. + This problem is under investigation.</para> + </section> + </section> + + <section> + <title>Appendix: Files relevant to Draknetprofile</title> - <para>This page hasn't been written yet for lack of resources. If you think - you can write this help, please contact <link ns2:href="https://wiki.mageia.org/en/Documentation_team"> the Doc team.</link> Thanking you in advance.</para> + <para>The configuration data of network interfaces are stored + in the directory <emphasis>/etc/sysconfig/network-scripts/</emphasis>, + in files with names like <emphasis>ifcfg-xxx</emphasis>.</para> - <para>You can start this tool from the - command line, by typing <emphasis role="bold">draknetprofile</emphasis> as - root.</para> + <para>The name of the currently active profile is maintained + in the file <emphasis>/etc/netprofile/current</emphasis> . + </para> + </section> </section> |