[deployment-guide/comm-rel: 56/727] NetConf: complete most of Est. Mobile Broadband sec
Jaromir Hradilek
jhradile at fedoraproject.org
Tue Oct 19 12:28:49 UTC 2010
commit 4e4f9284681327ebed923c9c6bd7481304562a19
Author: Douglas Silas <dhensley at redhat.com>
Date: Sun Jul 18 22:43:31 2010 +0200
NetConf: complete most of Est. Mobile Broadband sec
en-US/Network_Configuration.xml | 263 +++++++++++++++++++++++++--------------
1 files changed, 172 insertions(+), 91 deletions(-)
---
diff --git a/en-US/Network_Configuration.xml b/en-US/Network_Configuration.xml
index 74172dd..b0cd188 100644
--- a/en-US/Network_Configuration.xml
+++ b/en-US/Network_Configuration.xml
@@ -517,60 +517,109 @@ NetworkManager (pid 1527) is running...
<section
id="sec-Establishing_a_Mobile_Broadband_Connection">
<title>Establishing a Mobile Broadband Connection</title>
- <!--<remark>What is a <replaceable><type></replaceable> connection</remark>
- <remark>To establish a wireless connection, you need a computer capable of wi-fi connectivity, a wireless access point to connect to, and the passphrase of the access point unless it is open and unsecured.</remark>
- <para>You can configure a <replaceable><type></replaceable> connection by opening the <guilabel>Network Connections</guilabel> window and selecting the <guilabel>tab</guilabel> tab. For more information on opening the <guilabel>Network Connections</guilabel> window via <application>NetworkManager</application>'s Notification Area applet, or by running a shell command, refer to <xref
- linkend="sec-Configuring_New_and_Editing_Existing_Connections"/>.</para>
- <remark>image editing a <replaceable><type></replaceable> connection; caption: Editing the newly-created <replaceable><type></replaceable> connection 1</remark>
- <bridgehead
- id="bh-Configuring_the_Connection_Name_Auto-Connect_Behavior_and_Availability_Settings-mobile_broadband">Configuring the Connection Name, Auto-Connect Behavior, and Availability Settings</bridgehead>
- <para>Three settings in the <guilabel>Editing</guilabel> dialog are common to all connection types:</para>
+ <para>You can use <application>NetworkManager</application>'s mobile broadband connection abilities to connect to the following <firstterm>2G</firstterm> and <firstterm>3G</firstterm> services:</para>
<itemizedlist>
<listitem>
- <para>
- <guilabel>Connection name</guilabel> — You can customize the name under which this connection is listed in the <guilabel>tab</guilabel> tab of the <guilabel>Network Connections</guilabel> window by entering a descriptive name in the text-entry box.</para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Connect automatically</guilabel> — Check this box if you want <application>NetworkManager</application> to auto-connect to the this connection when it is—or becomes—available. Refer to <xref
- linkend="sec-Connecting_to_a_Network_Automatically"/> for more information.</para>
+ <para>2G — <firstterm>GPRS</firstterm> (<firstterm>General Packet Radio Service</firstterm>) or <firstterm>EDGE</firstterm> (<firstterm>Enhanced Data Rates for GSM Evolution</firstterm>)</para>
</listitem>
<listitem>
- <para>
- <guilabel>Available to all users</guilabel> — check this box to create a connection available to all users on the system. Changing this setting may require root privileges. Refer to <xref
- linkend="sec-User_and_System_Connections"/> for details.</para>
+ <para>3G — <firstterm>UMTS</firstterm> (<firstterm>Universal Mobile Telecommunications System</firstterm>) or <firstterm>HSPA</firstterm> (<firstterm>High Speed Packet Access</firstterm>)
+ </para>
</listitem>
</itemizedlist>
- <bridgehead>Configuring the <replaceable><tab></replaceable> Tab</bridgehead>
- <remark>describe tab-specific settings here</remark>
- <bridgehead
- id="bh-Saving_Your_New_or_Modified_Connection_and_Making_Further_Configurations-mobile_broadband">Saving Your New (or Modified) Connection and Making Further Configurations</bridgehead>
- <para>Once you have finished editing your new <replaceable><type></replaceable> connection, click the <guibutton>Apply</guibutton> button and <application>NetworkManager</application> will immediately save your customized configuration. Given a correct configuration, you can connect to your new or customized connection by selecting it from the <application>NetworkManager</application> Notification Area applet. See <xref
- linkend="sec-Connecting_to_a_Network"/> for information on using your new or altered connection.</para>
- <para>At this point, you have created a new <replaceable><type></replaceable> connection. You can further configure your connection by selecting it in the <guilabel>Network Connections</guilabel> window and clicking <guilabel>Edit</guilabel> to return to the <guilabel>Editing</guilabel> dialog.</para>
- <para>Then, to configure:</para>-->
- <itemizedlist>
- <!--<listitem>
- <para>;</para>
- </listitem>-->
- <listitem>
- <para>IPv4 settings for the connection, click the <guilabel>IPv4 Settings</guilabel> tab and proceed to <xref
- linkend="sec-Configuring_IPv4_Settings"/>; or,
+ <para>Your computer must have a device capable of mobile broadband capability which the system has recognized in order to create the connection. Such a device may be built into your computer (as is the case on many notebooks and netbooks), or may be provided as external hardware (such as a PC card, USB or phone modem).</para>
+ <!--<bridgehead
+ id="bh-Adding_a_New_Mobile_Broadband_Connection">Adding a New Mobile Broadband Connection</bridgehead>-->
+ <procedure
+ id="procedure-Adding_a_New_Mobile_Broadband_Connection">
+ <title>Adding a New Mobile Broadband Connection</title>
+ <para>You can configure a mobile broadband connection by opening the <guilabel>Network Connections</guilabel> window and selecting the <guilabel>Mobile Broadband</guilabel> tab. For more information on opening the <guilabel>Network Connections</guilabel> window via <application>NetworkManager</application>'s Notification Area applet, or by running a shell command, refer to <xref
+ linkend="sec-Configuring_New_and_Editing_Existing_Connections"/>.</para>
+ <step>
+ <para>Click the <guibutton>Add</guibutton> button to open the <guilabel>Set up a Mobile Broadband Connection</guilabel> assistant.</para>
+ </step>
+ <step>
+ <para>Under <guilabel>Create a connection for this mobile broadband device</guilabel>, choose the 2G- or 3G-capable device you want to use with the connection. If the dropdown menu is inactive, this indicates that the system was unable to detect a device capable of mobile broadband. In this case, click <guilabel>Cancel</guilabel>, ensure that you do have a mobile broadband-capable device attached to, and recognized by, the computer, and then retry this procedure.</para>
+ </step>
+ <step>
+ <para>TBD</para>
+ </step>
+ </procedure>
+ <procedure
+ id="procedure-Editing_an_Existing_Mobile_Broadband_Connection">
+ <title>Editing an Existing Mobile Broadband Connection</title>
+ <para>Follow these steps to edit an existing mobile broadband connection.</para>
+ <step>
+ <para>Open the <guilabel>Network Connections</guilabel> window and select the <guilabel>Mobile Broadband</guilabel> tab. For more information on opening the <guilabel>Network Connections</guilabel> window via <application>NetworkManager</application>'s Notification Area applet, or by running a shell command, refer to <xref
+ linkend="sec-Configuring_New_and_Editing_Existing_Connections"/>.</para>
+ </step>
+ <step>
+ <para>Select the connection you wish to edit and click the <guilabel>Edit</guilabel> button.</para>
+ </step>
+ <step>
+ <para>Configure the connection name, auto-connect behavior, and availability settings.</para>
+ <para>Three settings in the <guilabel>Editing</guilabel> dialog are common to all connection types:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Connection name</guilabel> — You can customize the name under which this connection is listed in the <guilabel>Mobile Broadband</guilabel> tab of the <guilabel>Network Connections</guilabel> window by entering a descriptive name in the text-entry box.</para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Connect automatically</guilabel> — Check this box if you want <application>NetworkManager</application> to auto-connect to the this connection when it is—or becomes—available. Refer to <xref
+ linkend="sec-Connecting_to_a_Network_Automatically"/> for more information.</para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Available to all users</guilabel> — check this box to create a connection available to all users on the system. Changing this setting may require root privileges. Refer to <xref
+ linkend="sec-User_and_System_Connections"/> for details.</para>
+ </listitem>
+ </itemizedlist>
+ </step>
+ <step>
+ <para>Edit the mobile broadband-specific settings by referring to <xref
+ linkend="bh-Configuring_the_Mobile_Broadband_Tab"/>.</para>
+ </step>
+ <step>
+ <para>Once you have finished editing your new mobile broadband connection, click the <guibutton>Apply</guibutton> button and <application>NetworkManager</application> will immediately save your customized configuration. Given a correct configuration, you can connect to your new or customized connection by selecting it from the <application>NetworkManager</application> Notification Area applet. See <xref
+ linkend="sec-Connecting_to_a_Network"/> for information on using your new or altered connection.</para>
+ <para>At this point, you have created a new mobile broadband connection. You can further configure your connection by selecting it in the <guilabel>Network Connections</guilabel> window and clicking <guilabel>Edit</guilabel> to return to the <guilabel>Editing</guilabel> dialog.</para>
+ <para>Then, to configure:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Point-to-point settings for the connection, click the <guilabel>PPP Settings</guilabel> tab and proceed to <xref
+ linkend="sec-Configuring_PPP_Point-to-Point_Settings"/>;</para>
+ </listitem>
+ <listitem>
+ <para>IPv4 settings for the connection, click the <guilabel>IPv4 Settings</guilabel> tab and proceed to <xref
+ linkend="sec-Configuring_IPv4_Settings"/>; or,
</para>
- </listitem>
- <listitem>
- <para>IPv6 settings for the connection, click the <guilabel>IPv6 Settings</guilabel> tab and proceed to <xref
- linkend="sec-Configuring_IPv6_Settings"/>.
+ </listitem>
+ <listitem>
+ <para>IPv6 settings for the connection, click the <guilabel>IPv6 Settings</guilabel> tab and proceed to <xref
+ linkend="sec-Configuring_IPv6_Settings"/>.
</para>
- </listitem>
- </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ <!--</step>
+ <step>
+ <para>Proceed to <xref
+ linkend="bh-Saving_Your_New_or_Modified_Connection_and_Making_Further_Configurations-mobile_broadband"/>.</para>
+ </step>-->
+ </step>
+ </procedure>
+ <bridgehead
+ id="bh-Configuring_the_Mobile_Broadband_Tab">Configuring the Mobile Broadband Tab</bridgehead>
+ <para>If you have already added a new mobile broadband connection using the assistant (refer to <xref
+ linkend="procedure-Adding_a_New_Mobile_Broadband_Connection"/> for instructions), you can edit the <guilabel>Mobile Broadband</guilabel> tab to disable roaming if home network is not available, assign a network ID, or instruct <application>NetworkManager</application> to prefer a certain technology (such as 3G or 2G) when using the connection.</para>
<variablelist>
<varlistentry>
<term>
<guilabel>Number</guilabel>
</term>
<listitem>
- <para></para>
+ <!--Number to dial when establishing a PPP data session with the GSM-based mobile broadband network. In most cases, leave the number blank and a number selecting the APN specified in the 'apn' property will be used automatically when required.-->
+ <para>The number that is dialed to establish a PPP connection with the GSM-based mobile broadband network. You can usually leave this field blank and simply enter the <guilabel>APN</guilabel> instead.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -578,7 +627,7 @@ NetworkManager (pid 1527) is running...
<guilabel>Username</guilabel>
</term>
<listitem>
- <para></para>
+ <para>Enter the username used to authenticate with the network. Some providers do not provide a username, or accept any username when connecting to the network.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -586,7 +635,7 @@ NetworkManager (pid 1527) is running...
<guilabel>Password</guilabel>
</term>
<listitem>
- <para></para>
+ <para>Enter the password used to authenticate with the network. Some providers do not provide a password, or accept any password.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -594,7 +643,16 @@ NetworkManager (pid 1527) is running...
<guilabel>APN</guilabel>
</term>
<listitem>
- <para></para>
+ <!--The GPRS Access Point Name specifying the APN used when establishing a data session with the GSM-based network. The APN often determines how the user will be billed for their network usage and whether the user has access to the Internet or just a provider-specific walled-garden, so it is important to use the correct APN for the user's mobile broadband plan.-->
+ <para>Enter the <firstterm>APN</firstterm> (<firstterm>Access Point Name</firstterm>) used to establish a connection with the GSM-based network. Entering the correct APN for a connection is important because it often determines:</para>
+ <itemizedlist>
+ <listitem>
+ <para>how the user is billed for their network usage; and/or</para>
+ </listitem>
+ <listitem>
+ <para>whether the user has access to the Internet or to an intranet or subnetwork.</para>
+ </listitem>
+ </itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
@@ -602,7 +660,8 @@ NetworkManager (pid 1527) is running...
<guilabel>Network ID</guilabel>
</term>
<listitem>
- <para></para>
+ <!--The Network ID (GSM LAI format, ie MCC-MNC) to force specific network registration. If the Network ID is specified, NetworkManager will attempt to force the device to register only on the specified network. This can be used to ensure that the device does not roam when direct roaming control of the device is not otherwise possible.-->
+ <para>Entering a <guilabel>Network ID</guilabel> causes <application>NetworkManager</application> to force the device to register only on a specific network. This can be used to ensure the connection does not roam when it is not possible to control roaming directly.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -610,7 +669,28 @@ NetworkManager (pid 1527) is running...
<guilabel>Type</guilabel>
</term>
<listitem>
- <para></para>
+ <!--Network preference to force the device to only use specific network technologies. The permitted values are: -1: any, 0: 3G only, 1: GPRS/EDGE only, 2: prefer 3G, and 3: prefer 2G. Note that not all devices allow network preference control.-->
+ <para>
+ <guilabel>Any</guilabel> — The default value of <guilabel>Any</guilabel> allows <application>NetworkManager</application>
+ <remark>TBD6: What is Any's behavior? Fastest to slowest? Is it therefore different from "Prefer 3G"?</remark>.
+ </para>
+ <para>
+ <guilabel>3G (UMTS/HSPA)</guilabel> — Force the connection to use only 3G network technologies.</para>
+ <para>
+ <guilabel>2G (GPRS/EDGE)</guilabel> — Force the connection to use only 2G network technologies.</para>
+ <para>
+ <guilabel>Prefer 3G (UMTS/HSPA)</guilabel> — First attempt to connect using a 3G technology such as HSPA or UMTS, and fall back to GPRS or EDGE only upon failure.</para>
+ <para>
+ <guilabel>Prefer 2G (GPRS/EDGE)</guilabel> — First attempt to connect using a 2G technology such as GPRS or EDGE, and fall back to HSPA or UMTS only upon failure.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Allow roaming if home network is not available</guilabel>
+ </term>
+ <listitem>
+ <!--see: "Avoiding the Roaming Shaft" at http://blogs.gnome.org/dcbw/2010/04/22/qualified-to-satisfy-you/-->
+ <para>Uncheck this box if you want <application>NetworkManager</application> to terminate the connection if you transition from the home network to a roaming one, thereby avoiding possible roaming charges. If the box is checked, <application>NetworkManager</application> will maintain the connection when it transitions from the home network to a roaming one, and vice versa.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -618,7 +698,8 @@ NetworkManager (pid 1527) is running...
<guilabel>PIN</guilabel>
</term>
<listitem>
- <para></para>
+ <!--If the SIM is locked with a PIN it must be unlocked before any other operations are requested. Specify the PIN here to allow operation of the device.-->
+ <para>If your device's <firstterm>SIM</firstterm> (<firstterm>Subscriber Identity Module</firstterm>) is locked with a <firstterm>PIN</firstterm> (<firstterm>Personal Identification Number</firstterm>), enter the PIN so that <application>NetworkManager</application> can unlock the device. <application>NetworkManager</application> must unlock the SIM if it requires a PIN in order to use the device for any purpose.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -626,53 +707,53 @@ NetworkManager (pid 1527) is running...
<section
id="sec-Establishing_a_VPN_Connection">
<title>Establishing a VPN Connection</title>
- <!--<remark>What is a <replaceable><type></replaceable> connection</remark>
- <remark>To establish a wireless connection, you need a computer capable of wi-fi connectivity, a wireless access point to connect to, and the passphrase of the access point unless it is open and unsecured.</remark>
- <para>You can configure a <replaceable><type></replaceable> connection by opening the <guilabel>Network Connections</guilabel> window and selecting the <guilabel>tab</guilabel> tab. For more information on opening the <guilabel>Network Connections</guilabel> window via <application>NetworkManager</application>'s Notification Area applet, or by running a shell command, refer to <xref
- linkend="sec-Configuring_New_and_Editing_Existing_Connections"/>.</para>
- <remark>image editing a <replaceable><type></replaceable> connection; caption: Editing the newly-created <replaceable><type></replaceable> connection 1</remark>
- <bridgehead
- id="bh-Configuring_the_Connection_Name_Auto-Connect_Behavior_and_Availability_Settings-vpn">Configuring the Connection Name, Auto-Connect Behavior, and Availability Settings</bridgehead>
- <para>Three settings in the <guilabel>Editing</guilabel> dialog are common to all connection types:</para>
- <itemizedlist>
- <listitem>
- <para>
- <guilabel>Connection name</guilabel> — You can customize the name under which this connection is listed in the <guilabel>tab</guilabel> tab of the <guilabel>Network Connections</guilabel> window by entering a descriptive name in the text-entry box.</para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Connect automatically</guilabel> — Check this box if you want <application>NetworkManager</application> to auto-connect to the this connection when it is—or becomes—available. Refer to <xref
- linkend="sec-Connecting_to_a_Network_Automatically"/> for more information.</para>
- </listitem>
- <listitem>
- <para>
- <guilabel>Available to all users</guilabel> — check this box to create a connection available to all users on the system. Changing this setting may require root privileges. Refer to <xref
- linkend="sec-User_and_System_Connections"/> for details.</para>
- </listitem>
- </itemizedlist>
- <bridgehead>Configuring the <replaceable><tab></replaceable> Tab</bridgehead>
- <remark>describe tab-specific settings here</remark>
- <bridgehead
- id="bh-Saving_Your_New_or_Modified_Connection_and_Making_Further_Configurations-vpn">Saving Your New (or Modified) Connection and Making Further Configurations</bridgehead>
- <para>Once you have finished editing your new <replaceable><type></replaceable> connection, click the <guibutton>Apply</guibutton> button and <application>NetworkManager</application> will immediately save your customized configuration. Given a correct configuration, you can connect to your new or customized connection by selecting it from the <application>NetworkManager</application> Notification Area applet. See <xref
- linkend="sec-Connecting_to_a_Network"/> for information on using your new or altered connection.</para>
- <para>At this point, you have created a new <replaceable><type></replaceable> connection. You can further configure your connection by selecting it in the <guilabel>Network Connections</guilabel> window and clicking <guilabel>Edit</guilabel> to return to the <guilabel>Editing</guilabel> dialog.</para>
- <para>Then, to configure:</para>
- <itemizedlist>
- <listitem>
- <para>;</para>
- </listitem>
- <listitem>
- <para>IPv4 settings for the connection, click the <guilabel>IPv4 Settings</guilabel> tab and proceed to <xref
- linkend="sec-Configuring_IPv4_Settings"/>; or,
+ <para>Connecting to a Virtual Private Network (VPN) enables you to communicate securely between your computer or Local Area Network, and another, remote LAN.</para>
+ <remark>To establish a wireless connection, you need a computer capable of wi-fi connectivity, a wireless access point to connect to, and the passphrase of the access point unless it is open and unsecured.</remark>
+ <para>You can configure a VPN connection by opening the <guilabel>Network Connections</guilabel> window and selecting the <guilabel>tab</guilabel> tab. For more information on opening the <guilabel>Network Connections</guilabel> window via <application>NetworkManager</application>'s Notification Area applet, or by running a shell command, refer to <xref
+ linkend="sec-Configuring_New_and_Editing_Existing_Connections"/>.</para>
+ <remark>image editing a VPN connection; caption: Editing the newly-created VPN connection 1</remark>
+ <bridgehead
+ id="bh-Configuring_the_Connection_Name_Auto-Connect_Behavior_and_Availability_Settings-vpn">Configuring the Connection Name, Auto-Connect Behavior, and Availability Settings</bridgehead>
+ <para>Three settings in the <guilabel>Editing</guilabel> dialog are common to all connection types:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Connection name</guilabel> — You can customize the name under which this connection is listed in the <guilabel>tab</guilabel> tab of the <guilabel>Network Connections</guilabel> window by entering a descriptive name in the text-entry box.</para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Connect automatically</guilabel> — Check this box if you want <application>NetworkManager</application> to auto-connect to the this connection when it is—or becomes—available. Refer to <xref
+ linkend="sec-Connecting_to_a_Network_Automatically"/> for more information.</para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Available to all users</guilabel> — check this box to create a connection available to all users on the system. Changing this setting may require root privileges. Refer to <xref
+ linkend="sec-User_and_System_Connections"/> for details.</para>
+ </listitem>
+ </itemizedlist>
+ <bridgehead>Configuring the <replaceable><tab></replaceable> Tab</bridgehead>
+ <remark>describe tab-specific settings here</remark>
+ <bridgehead
+ id="bh-Saving_Your_New_or_Modified_Connection_and_Making_Further_Configurations-vpn">Saving Your New (or Modified) Connection and Making Further Configurations</bridgehead>
+ <para>Once you have finished editing your new VPN connection, click the <guibutton>Apply</guibutton> button and <application>NetworkManager</application> will immediately save your customized configuration. Given a correct configuration, you can connect to your new or customized connection by selecting it from the <application>NetworkManager</application> Notification Area applet. See <xref
+ linkend="sec-Connecting_to_a_Network"/> for information on using your new or altered connection.</para>
+ <para>At this point, you have created a new VPN connection. You can further configure your connection by selecting it in the <guilabel>Network Connections</guilabel> window and clicking <guilabel>Edit</guilabel> to return to the <guilabel>Editing</guilabel> dialog.</para>
+ <para>Then, to configure:</para>
+ <itemizedlist>
+ <listitem>
+ <para>;</para>
+ </listitem>
+ <listitem>
+ <para>IPv4 settings for the connection, click the <guilabel>IPv4 Settings</guilabel> tab and proceed to <xref
+ linkend="sec-Configuring_IPv4_Settings"/>; or,
</para>
- </listitem>
- <listitem>
- <para>IPv6 settings for the connection, click the <guilabel>IPv6 Settings</guilabel> tab and proceed to <xref
- linkend="sec-Configuring_IPv6_Settings"/>.
+ </listitem>
+ <listitem>
+ <para>IPv6 settings for the connection, click the <guilabel>IPv6 Settings</guilabel> tab and proceed to <xref
+ linkend="sec-Configuring_IPv6_Settings"/>.
</para>
- </listitem>
- </itemizedlist>-->
+ </listitem>
+ </itemizedlist>
<variablelist>
<varlistentry>
<term>
More information about the docs-commits
mailing list