diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/docs/stable/mcc-help/en/draknetprofile.xml | 268 | ||||
-rw-r--r-- | docs/docs/stable/mcc-help/mcc-help.pot | 291 |
2 files changed, 533 insertions, 26 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> diff --git a/docs/docs/stable/mcc-help/mcc-help.pot b/docs/docs/stable/mcc-help/mcc-help.pot index 0d8a8ecb..8b162c9a 100644 --- a/docs/docs/stable/mcc-help/mcc-help.pot +++ b/docs/docs/stable/mcc-help/mcc-help.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Mageia Control Center Help 6.0\n" "Report-Msgid-Bugs-To: doc-discuss@ml.mageia.org\n" -"POT-Creation-Date: 2018-04-10 17:29+0300\n" +"POT-Creation-Date: 2018-07-10 09:01+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -48,7 +48,7 @@ msgid "" msgstr "" #. type: Content of: <section><section><title> -#: en/diskdrake--dav.xml:30 en/diskdrake--nfs.xml:22 en/diskdrake--smb.xml:21 en/drak3d.xml:15 en/drakconnect.xml:16 en/draknetcenter.xml:29 en/draksambashare.xml:18 en/drakvpn.xml:16 en/drakwizard_apache2.xml:27 en/drakwizard_dhcp.xml:41 en/drakwizard_proftpd.xml:27 en/drakwizard_squid.xml:46 en/keyboarddrake.xml:17 en/system-config-printer.xml:21 +#: en/diskdrake--dav.xml:30 en/diskdrake--nfs.xml:22 en/diskdrake--smb.xml:21 en/drak3d.xml:15 en/drakconnect.xml:16 en/draknetcenter.xml:29 en/draknetprofile.xml:18 en/draksambashare.xml:18 en/drakvpn.xml:16 en/drakwizard_apache2.xml:27 en/drakwizard_dhcp.xml:41 en/drakwizard_proftpd.xml:27 en/drakwizard_squid.xml:46 en/keyboarddrake.xml:17 en/system-config-printer.xml:21 msgid "Introduction" msgstr "" @@ -3002,7 +3002,7 @@ msgid "drakinvictus.png" msgstr "" #. type: Content of: <section><para> -#: en/drakinvictus.xml:12 en/draknetcenter.xml:187 en/draknetprofile.xml:12 en/drakups.xml:12 en/drakwizard_bind.xml:12 en/drakxservices.xml:12 +#: en/drakinvictus.xml:12 en/draknetcenter.xml:187 en/drakups.xml:12 en/drakwizard_bind.xml:12 en/drakxservices.xml:12 msgid "" "This page hasn't been written yet for lack of resources. If you think you " "can write this help, please contact <link " @@ -3287,25 +3287,288 @@ msgid "draknetcenter7.png" msgstr "" #. type: Content of: <section><info><title> -#: en/draknetprofile.xml:3 +#: en/draknetprofile.xml:12 msgid "Manage different network profiles" msgstr "" -#. type: Content of: <section><info><subtitle> -#: en/draknetprofile.xml:3 -msgid "draknetprofile" +#. type: Content of: <section><section><section><title> +#: en/draknetprofile.xml:14 en/draknetprofile.xml:46 +msgid "Draknetprofile" msgstr "" -#. type: Attribute 'fileref' of: <section><mediaobject><imageobject><imagedata> -#: en/draknetprofile.xml:8 -msgid "draknetprofile.png" +#. type: Content of: <section><section><para> +#: en/draknetprofile.xml:20 +msgid "" +"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." msgstr "" -#. type: Content of: <section><para> -#: en/draknetprofile.xml:15 +#. type: Content of: <section><section><section><title> +#: en/draknetprofile.xml:31 +msgid "Profiles" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:33 msgid "" -"You can start this tool from the command line, by typing <emphasis " -"role=\"bold\">draknetprofile</emphasis> as root." +"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." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:48 +msgid "" +"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" +msgstr "" + +#. type: Content of: <section><section><section><para><itemizedlist><listitem><para> +#: en/draknetprofile.xml:56 +msgid "" +"switch between profiles - i.e. activate a target profile to become the " +"\"current profile\"," +msgstr "" + +#. type: Content of: <section><section><section><para><itemizedlist><listitem><para> +#: en/draknetprofile.xml:61 +msgid "create a new, additional profile," +msgstr "" + +#. type: Content of: <section><section><section><para><itemizedlist><listitem><para> +#: en/draknetprofile.xml:65 +msgid "delete a profile from the list of defined profiles." +msgstr "" + +#. type: Content of: <section><section><title> +#: en/draknetprofile.xml:73 +msgid "Running Draknetprofile" +msgstr "" + +#. type: Content of: <section><section><section><title> +#: en/draknetprofile.xml:76 +msgid "Defining profiles, profile switching" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:78 +msgid "" +"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):" +msgstr "" + +#. type: Attribute 'fileref' of: <section><section><section><mediaobject><imageobject><imagedata> +#: en/draknetprofile.xml:86 +msgid "./draknetprofile_mcc.png" +msgstr "" + +#. type: Content of: <section><section><section><mediaobject><caption><para> +#: en/draknetprofile.xml:90 +msgid "" +"<emphasis role='bold'>Figure 1: Mageia Control Center: Network & " +"Internet tab</emphasis>" +msgstr "" + +#. type: Content of: <section><section><section><orderedlist><listitem><para> +#: en/draknetprofile.xml:98 +msgid "launch the MCC by hitting the MCC icon in one of the panels of your desktop," +msgstr "" + +#. type: Content of: <section><section><section><orderedlist><listitem><para> +#: en/draknetprofile.xml:103 +msgid "select the \"Network & Internet\" tab," +msgstr "" + +#. type: Content of: <section><section><section><orderedlist><listitem><para> +#: en/draknetprofile.xml:107 +msgid "" +"hit \"Manage different network profiles\" in the \"Personalize and Secure " +"your network\" Section (solid red contour in Figure 1)." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:113 +msgid "" +"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:" +msgstr "" + +#. type: Content of: <section><section><section><informaltable><tgroup><tbody><row><entry> +#: en/draknetprofile.xml:124 +msgid "<literal> draknetprofile </literal>" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:130 +msgid "After the launch, the main page of Draknetprofile will be displayed:" +msgstr "" + +#. type: Attribute 'fileref' of: <section><section><section><mediaobject><imageobject><imagedata> +#: en/draknetprofile.xml:136 +msgid "./draknetprofile_main.png" +msgstr "" + +#. type: Content of: <section><section><section><mediaobject><caption><para> +#: en/draknetprofile.xml:140 +msgid "" +"<emphasis role='bold'>Figure 2: Management actions of " +"Draknetprofile</emphasis>" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:145 +msgid "" +"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:" +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:152 +msgid "" +"\"Activate\" ... establish the selected profile (top zone of the window) as " +"the current profile (and save the properties of the old profile);" +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:158 +msgid "\"New\" ... create a new profile;" +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:162 +msgid "" +"\"Delete\" ... delete the selected profile from the list of defined " +"profiles;" +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:167 +msgid "\"Quit\" ... exit from Draknetprofile." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:171 +msgid "" +"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." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:175 +msgid "" +"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:" +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:188 +msgid "exit from Draknetprofile (hit the \"Quit\" button)," +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:192 +msgid "" +"back in the \"Network & Internet\" tab, you select the tab \"Set up a " +"new network interface (...)\" (marked with dashed red contour in Figure 1)," +msgstr "" + +#. type: Content of: <section><section><section><itemizedlist><listitem><para> +#: en/draknetprofile.xml:198 +msgid "" +"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>." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:206 +msgid "" +"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." +msgstr "" + +#. type: Content of: <section><section><section><title> +#: en/draknetprofile.xml:218 +msgid "Using a system that has more than one profile" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:220 +msgid "" +"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" +msgstr "" + +#. type: Content of: <section><section><section><informaltable><tgroup><tbody><row><entry> +#: en/draknetprofile.xml:231 +msgid "" +"<literal> Select network profile: (1) default (2) " +"roaming* </literal>" +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:238 +msgid "" +"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)." +msgstr "" + +#. type: Content of: <section><section><section><para> +#: en/draknetprofile.xml:243 +msgid "" +"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." +msgstr "" + +#. type: Content of: <section><section><title> +#: en/draknetprofile.xml:252 +msgid "Appendix: Files relevant to Draknetprofile" +msgstr "" + +#. type: Content of: <section><section><para> +#: en/draknetprofile.xml:254 +msgid "" +"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>." +msgstr "" + +#. type: Content of: <section><section><para> +#: en/draknetprofile.xml:258 +msgid "" +"The name of the currently active profile is maintained in the file " +"<emphasis>/etc/netprofile/current</emphasis> ." msgstr "" #. type: Content of: <section><info><title> |