week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License
"Eclipse Public License v1.0" which accompanies this distribution,
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
Nokia Corporation - initial contribution.
Contributors:
-->
<!DOCTYPE concept
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-88E89E94-7C9E-5583-827C-84FADD50F97E" xml:lang="en"><title>Modifying
your current setup for ethernet</title><shortdesc>Set up ethernet to incorporate ethernet with comms database settings.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>You can also use the <xref href="GUID-3C6935E1-66C9-5115-901E-D3B1D0C2E783.dita">Quick
ethernet configuration</xref>. </p>
<ol id="GUID-F0D337D1-1E90-5FB9-B1BC-676042F792C7">
<li id="GUID-3C2F7DF5-62C6-5B4E-8B66-CCAE76BBE96A"><p> <xref href="GUID-CDD1E761-6B28-5F69-BBEF-756DF45E59A2.dita">Install
WinPcap</xref> </p> <p> <i>WinPcap</i> is used by Symbian platform to send
and receive ethernet frames to Windows OS. We recommend version 4.0 of this
program </p> </li>
<li id="GUID-7D079E8F-BDFC-5E96-959D-2DA53DFDB294"><p>Edit your current comms
database as described in the following section. The <i>CED</i>, <i>CEDDUMP</i> and
tools should be used to securely modify comms database entries; see Comms
database configuration tools. </p> </li>
<li id="GUID-9730B75A-0278-5D8E-BA95-DB123691E70A"><p>Run the <xref href="GUID-7B114A67-356A-5FCE-B57B-761F5477A2B2.dita">Configchange.pl</xref> script. </p> </li>
</ol>
<section id="GUID-21ED581C-3623-4BC9-A00F-A7D46C1AC59C"><title>Editing comms
database settings for Ethernet</title> <p>Symbian platform stores many communication
settings in its communications database. This database is used both in the
emulator and real devices. It is primarily used by the communication subsystems
within Symbian platform. </p> <p>The comms database is made up of a number
of tables. Several tables are required to connect the emulator to the Internet
via ethernet. </p> <p>Edit your current comms database as described below.
The <i>CED</i> and <i>CEDDUMP</i> tools should be used to securely modify
comms database entries; see Comms database configuration tools. </p> </section>
<section id="GUID-191C55A1-B55C-4311-B956-C3AF2957A69F"><title>LAN Bearer table</title><p>The LAN bearer table contains information
about physical connections to networks. The start of the LAN bearer table
is indicated by the text <codeph>[LANBearer]</codeph>. It may be followed
by a number of connections. One may be suitable for the emulator, otherwise
add a new connection in a new <codeph>ADD_SECTION...END_ADD</codeph> section. </p> <p>If
you are using Symbian platform with the EKA1 kernel then there should be a
connection like the one below: </p> <codeblock id="GUID-DF5AB7B9-2D29-52C7-97F5-4EE568422901" xml:space="preserve">ADD_SECTION
Name=EKA1 Emulator Ethernet
Agent=nullagt.agt
IfName=ethint
LDDFilename=ethercard
LDDName=Ethercard
PDDFilename=etherwins
PDDName=Ethercard.wins
PacketDriverName=EtherPkt.drv
LastSocketActivityTimeout=-1
LastSessionClosedTimeout=-1
LastSocketClosedTimeout=-1
FIELD_COUNT=11
END_ADD</codeblock> <p>If you are using EKA2 kernel then there should be a
connection like this: </p> <codeblock id="GUID-AE57D4FA-90FE-5A74-BB85-0B7DB2398280" xml:space="preserve">ADD_SECTION
Name=EKA2 Emulator Ethernet
Agent=nullagt.agt
IfName=ethint
LDDFilename=enet
LDDName==Ethernet
PDDFilename=ethernet
PDDName=Ethernet.Wins
PacketDriverName=EtherPkt.drv
LastSocketActivityTimeout=-1
LastSessionClosedTimeout=-1
LastSocketClosedTimeout=-1
FIELD_COUNT=11
END_ADD</codeblock> <p>The Symbian platform version number will tell you which
kernel you are using. Version 7 or less indicates EKA1. Versions 8.0 and 8.1
are written with a letter after them. An '<i>a</i>' indicates EKA1 and a '<i>b</i>'
indicates EKA2. Versions 9.0 and later are EKA2. The version number is commonly
available in <filepath>/epoc32/data/BuildInfo.txt</filepath>. </p></section>
<section id="GUID-07D8E6DB-8E5A-4D24-B404-16D470B422F6"><title>LAN Service table</title><p>The LAN Service table contains
address information. The start of the LAN service table is indicated by the
text <codeph>[LANService]</codeph>. This may be followed by address information
for one or more networks. You will need information for each network to which
you want to connect. </p> <ul>
<li id="GUID-0B6C8959-BDA2-5D5F-84C9-DA93BFD677F3"><p> <b>Ethernet with dynamic
IP address</b> </p> <p>Use this when your network uses DHCP. It allows the
network to automatically allocate an IP address for the emulator every time
it connects. Your network administrator will tell you whether you can use
DHCP. </p> <p>In the <codeph>[LANService]</codeph> table, make sure there
is a <codeph>ADD_SECTION...END_ADD</codeph> section in the table identical
to the following. In particular, set the <codeph>IpAddrFromServer</codeph> and <codeph>IpDNSAddrFromServer</codeph> fields
to <codeph>TRUE</codeph>, and set the two <codeph>ConfigDaemon</codeph> fields
as shown in the following: </p> <codeblock id="GUID-F3D835BE-796B-5422-9072-299409D030A9" xml:space="preserve">ADD_SECTION
Name=Ethernet using DCHP
IfNetworks=ip
IpNetMask=
IpGateway=
IpAddrFromServer=TRUE
IpAddr=
IpDNSAddrFromServer=TRUE
IpNameServer1=
IpNameServer2=
ConfigDaemonManagerName=NetCfgExtnDhcp
ConfigDaemonName=DhcpServ
FIELD_COUNT=11
END_ADD</codeblock> <p>Note: before v9.0, the value of <codeph>ConfigDaemonManagerName</codeph> was <codeph>ConfigDaemonManager</codeph>. </p> </li>
<li id="GUID-0DA3C4DC-4951-59A1-9D23-3FABEC3D93DC"><p> <b>Ethernet with static
IP address on networks without DHCP</b> </p> <p>This describes how to set
all your network settings manually. This will be necessary on networks that
do not use DHCP. If your network uses DHCP then you can still set your settings
manually if you wish. </p> <p>In the <codeph>[LANService]</codeph> table,
make sure there is a <codeph>ADD_SECTION...END_ADD</codeph> section in the
table similar to the one below: </p> <ul>
<li id="GUID-5FE2A935-0F33-5223-ABB2-6D2A4540F81E"><p>Set the <codeph>IpAddrFromServer</codeph> and <codeph>IpDNSAddrFromServer</codeph> fields
to <codeph>FALSE</codeph>, and leave the two <codeph>ConfigDaemon</codeph> fields
empty </p> </li>
<li id="GUID-55441AA2-8F31-5A81-8580-A5414E87D4E2"><p>Set the fields in the
following table to suitable values: </p> <table id="GUID-AE300CB8-55DC-5A20-8E1C-E2F7B7A8586B">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>Field</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p>IpAddr </p> </entry>
<entry><p>IP address </p> </entry>
</row>
<row>
<entry><p>IpNetMask </p> </entry>
<entry><p>IP subnet mask </p> </entry>
</row>
<row>
<entry><p>IpGateway </p> </entry>
<entry><p>Gateway IP address </p> </entry>
</row>
<row>
<entry><p>IpNameServer1 and IpNameServer2 </p> </entry>
<entry><p>Primary and secondary DNS server addresses </p> </entry>
</row>
</tbody>
</tgroup>
</table> <p>Your network administrator may be able to supply you with an IP
address. It must be in the same range of addresses as the other computers
on the network, and it must not be in use already. </p> <p>For the other parameters,
you can normally use the same values that Windows uses on your PC. To show
Window's configuration, type the following from a command prompt: </p> <p><userinput>ipconfig
/all</userinput> </p> </li>
</ul> <p>Here is an example table: </p> <codeblock id="GUID-F2B36B36-09F9-5B5C-BEC5-BE29E7A39EBA" xml:space="preserve">ADD_SECTION
Name=Ethernet Static IP
IfNetworks=ip
IpNetMask=255.255.255.0
IpGateway=10.23.162.254
IpAddrFromServer=FALSE
IpAddr=10.23.162.200
IpDNSAddrFromServer=FALSE
IpNameServer1=10.16.59.515
IpNameServer2=10.23.58.12
ConfigDaemonManagerName=
ConfigDaemonName=
FIELD_COUNT=11
END_ADD</codeblock> </li>
<li id="GUID-C32365C7-E4E9-5FE1-8AA8-7A6515C50ACD"><p> <b>Ethernet with static
IP address on DHCP networks</b> </p> <p>This describes how to choose your
own IP address, but to set all the other network settings (subnet mask, gateway
and DNS servers) automatically when you connect. Your network must use DHCP
for this. </p> <p> <note> Some DHCP servers do not support this configuration.
Before using it, please ensure that your network's DHCP server supports the
'<i>INFORM</i>' message. </note></p>In the <codeph>[LANService]</codeph> table,
make sure there is a <codeph>ADD_SECTION...END_ADD</codeph> section in the
table similar to the one in the following: <ul>
<li id="GUID-3B0120F9-63F0-5759-9673-B56C87B2C06E"><p>Set the <codeph>IpDNSAddrFromServer</codeph> fields
to <codeph>FALSE</codeph> and set the two <codeph>ConfigDaemon</codeph> fields
as shown in the example below </p> </li>
<li id="GUID-A7F1091C-E88F-51A0-B3D6-795DCEC5351B"><p>Set the <codeph>IpAddrFromServer</codeph> to <codeph>TRUE</codeph> and
set <codeph>IpAddr</codeph> to an IP address for the emulator. Your network
administrator may be able to supply you with an IP address. It must be in
the same range of addresses as the other computers on the network, and it
must not be in use already. </p> </li>
</ul> <p>Here is an example table: </p> <codeblock id="GUID-374BD714-F158-52E8-BCDB-FCC5A46E8D52" xml:space="preserve">ADD_SECTION
Name=Ethernet Static IP
IfNetworks=ip
IpNetMask=
IpGateway=
IpAddrFromServer=FALSE
IpAddr=192.168.20.13
IpDNSAddrFromServer=TRUE
IpNameServer1=
IpNameServer2=
ConfigDaemonManagerName=NetCfgExtnDhcp
ConfigDaemonName=DhcpServ
FIELD_COUNT=11
END_ADD</codeblock> <p>Note: before v9.0, the value of <codeph>ConfigDaemonManagerName</codeph> was <codeph>ConfigDaemonManager</codeph>. </p> </li>
</ul></section>
<section id="GUID-E46108D2-03E9-4B6C-A004-61A0A983EFE8"><title>Internet Access Point table</title><p>In the previous two
sections you created a physical connection in the <codeph>[LANBearer]</codeph> table
for either the EKA1 or EKA2 kernel, and you created your network's address
information in the LAN Service table. Now you must link the two together in
an <i>Internet Access Point (IAP)</i>. The combination of the two is all the
emulator needs to connect to the network. </p> <p>The IAP table defines a
number of IAPs. You must ensure that there is one suitable for the emulator
on your network. The start of the IAP table is indicated by the text <codeph>[IAP]</codeph>.
After this there will be a number of sections defining IAPs. If there is not
a suitable IAP already then you must create one similar to the following: </p> <codeblock id="GUID-66CD685D-1193-54C8-85EC-9EED9E56E54F" xml:space="preserve">[IAP]
ADD_SECTION
Name=Emulator Lan IAP
IAPService=2
IAPServiceType=LANService
IAPBearer=4
IAPBearerType=LANBearer
IAPNetwork=1
IAPNetworkWeighting=0
Location=1
FIELD_COUNT=8
END_ADD</codeblock> <p>In each IAP, the <codeph>IAPBearer</codeph> and <codeph>IAPService</codeph> parameters
define the sections to link. You need to enter a number in each of these fields: </p> <ul>
<li id="GUID-CFB52AF7-B05E-5D5B-A8C2-CBB22F9B3B95"><p>Go to the LAN Service
table and find the address information for your network. It will be in an <codeph>ADD_SECTION...END_ADD</codeph> table
entry. Count the number of table entries from the beginning of the table until
you reach your entry. Enter this number in the IAP's <codeph>IAPService</codeph> field. </p> <p>Note:
the first entry in the table is number one, not zero. </p> </li>
<li id="GUID-C7F2A24B-3491-59A5-8BCE-F430F9A1F74D"><p>Repeat the same for
your network connection in the <codeph>[LANBearer]</codeph> table, entering
the number into the <codeph>IAPBearer</codeph> field of the IAP. </p> </li>
</ul> <p>The example above links the second network address section in the
LAN Service table with the fourth physical connection in the <codeph>[LANBearer]</codeph> table. </p> <p>Copy
the rest of the fields as shown above. </p></section>
<section id="GUID-A1AF1DD2-C20E-4301-A210-307CAB47A41F"><title>Connection Preferences table</title><p>The Internet Access
Point (IAP) table defines a number of method to connect to networks and the
Internet. When a phone or the emulator wants to connect to a network, the
Connection Preferences table defines how a IAP is chosen. </p> <p>The start
of the connection preferences table is indicated by the text <codeph>[ConnectionPreferences]</codeph>.
After this there will be a number of sections defining your preferences. </p> <p>You
have two options: </p> <ul>
<li id="GUID-1D0F662E-B4F3-57FE-8FA2-EED2E8F1ADFB"><p> <b>Ask which IAP to
use each time you connect</b> </p> <p>If the table contains a section like
the one below then Symbian platform will ask you to choose an IAP before it
connects. A dialog box will be displayed allowing you to make your choice.
This is useful if you often connect to more than one network. </p> <p>You
can ignore the <codeph>BearerSet</codeph> and <codeph>IAP</codeph> fields,
but you must copy the others as shown: </p> <codeblock id="GUID-B9C41F22-30C6-5F11-831B-6F0C97179C1D" xml:space="preserve">ADD_SECTION
Ranking=1
Direction=OUTGOING
DialogPref=PROMPT
BearerSet=LAN
IAP=1
FIELD_COUNT=5
END_ADD</codeblock> <p>Note the <codeph>Ranking=1</codeph> field. This indicates
that this is the highest priority connection preference. </p> <p>Any sections
with <codeph>Ranking=0</codeph> are ignored. Think of setting <codeph>Ranking=0</codeph> as
'commenting out' a connection preference. </p> </li>
<li id="GUID-2F7DFB97-C0A6-563B-B41D-9337749C9525"><p> <b>Always connect with
the same IAP</b> <b>Define the IAP to use</b> </p> <p>You can define the
default IAP in the connection preferences table. When Symbian platform wants
to connect, it always uses the IAP that you define here. No dialog box will
appear on screen and you will not be able to choose an IAP before you connect. </p> <p>This
is useful when you always connect to the same network. </p> <p>Add a section
to the table like this: </p> <codeblock id="GUID-5DA76D4E-7305-5EFD-AD85-928B241C0BC0" xml:space="preserve">ADD_SECTION
Ranking=1
Direction=OUTGOING
DialogPref=DONOTPROMPT
BearerSet=LAN
IAP=1
FIELD_COUNT=5
END_ADD</codeblock> <p>where the <codeph>IAP</codeph> field must be set to
the desired IAP number. In this example we connect to the first IAP, which
is the first <codeph>ADD_SECTION...END_ADD</codeph> after the text <codeph>[IAP]</codeph>.
Copy the other fields as shown. </p> <p>You can specify a second, backup connection
preference. If the first connection attempt fails then the backup connection
is tried. Define a backup connection in a section similar to the following: </p> <codeblock id="GUID-7BBEE6A6-F723-56B1-A54E-8FC2C3E30469" xml:space="preserve">ADD_SECTION
Ranking=2
Direction=OUTGOING
DialogPref=DONOTPROMPT
BearerSet=LAN
IAP=3
FIELD_COUNT=5
END_ADD</codeblock> <p>Note the <codeph>Ranking=2</codeph> field. This indicates
that this is the second highest priority connection preference after the section
with <codeph>Ranking=1</codeph>. Any sections with <codeph>Ranking=0</codeph> are
ignored by Symbian platform. </p> </li>
</ul></section>
</conbody></concept>