<?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 reference

  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference id="GUID-8B91B12A-2275-52BF-B747-914550E225D0" xml:lang="en"><title>Console-based

SWI Tool Reference</title><abstract><p>Console-based SWI tool is used to install or uninstall native

software on the device using an EShell interface. </p><p> <b>Note</b>: The

following sections are applicable only for S60 emulator.</p></abstract><prolog><metadata><keywords/></metadata></prolog><refbody>

<section><title>Installing a SIS file using console-based SWI example</title><p>If

you want to install <filepath>simple.sis</filepath> file on the device then,

place this file at <codeph>epoc32\winscw\c</codeph> and perform the following

steps: </p> <ol id="GUID-FB6A5CA8-7882-54D5-962E-E0FADCDB27EB">

<li id="GUID-B8571A5E-A306-5157-8380-CDCAA53724EE"><p>Launch EShell within

the S60 emulator and enter <codeph>swiconsole /i                 c:\simple.sis</codeph>.

The following screenshot appears which displays the application details and

provides the following options: </p> <fig id="GUID-66ADA2C6-F1C2-5ACE-9434-F18D0BC7D6C1">

<image href="GUID-6B231E96-CD4B-5D8E-9AAC-D533784E0E3B_d0e20509_href.jpg" placement="inline"/>

</fig> </li>

<li id="GUID-D31262D9-A59B-5461-9A72-A7E6E93B6AA5"><p>Press <b>y</b>, the

signature is validated and installation continues only if the signature is

valid. The following screenshot shows that the signature has been validated

successfully and allows the user to continue with the installation. </p> <fig id="GUID-90086889-B023-572E-9BFB-4D518BDCF4C0">

<image href="GUID-66CF7E30-010D-5A7A-95EF-41620CD49BF9_d0e20522_href.jpg" placement="inline"/>

</fig> </li>

<li id="GUID-75750A14-4358-5683-8054-5AAB16F31B55"><p>Press <b>y</b> to continue

installation and select the drive you want to install. </p> <fig id="GUID-537B05D6-9F31-5461-B212-8E3168572831">

<image href="GUID-8C5F32CC-CA2A-586A-B3B1-339494255042_d0e20535_href.jpg" placement="inline"/>

</fig> </li>

<li id="GUID-68BAE41E-C692-5559-B7D2-38C7C1D1ACEA"><p>Press <b>n</b> to continue

with the installation. The following screenshot shows that the installation

is completed successfully. </p> <fig id="GUID-B487223A-9EB8-5A27-82CA-6F6308F8DA11">

<image href="GUID-8C826292-C8DC-55CA-A79F-3254A417BF64_d0e20548_href.jpg" placement="inline"/>

</fig> </li>

</ol> <p> <b>Result</b>: The <filepath>simple.sis</filepath> file is successfully

installed on the device. </p>  </section>

<section><title>Uninstalling a SIS file using console-based SWI example</title> <p>If

you want to uninstall <filepath>simple.sis</filepath> file from the device

then, enter the following command on eshell:</p><p><userinput>swiconsole /u

/uid 80008880 /pkg testrun_exe /vendor &lt;Unique Vendor Name&gt;</userinput> </p> <p> <b>Result</b>:

The <filepath>simple.sis</filepath> file is successfully uninstalled from

the device. </p> </section>

</refbody><related-links>

<link href="GUID-DA8908E9-28C7-5200-A5B2-EC1ED60ABE90.dita"><linktext>Using Console-based

SWI</linktext></link>

</related-links></reference>