<?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-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26" xml:lang="en"><title>Secure

Software Install SIS Tools Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>The <b>Secure Software Install SIS Tools</b> enable you to create, sign,

decompile and preinstall SIS files. </p>

<section id="GUID-7FDA2D06-5E36-4757-BC83-E78A206FF64B"><title>Description</title> <p>The Secure Software Install SIS Tools

component comprises the following PC-side command-line tools: </p> <ul>

<li id="GUID-08851BF3-9C9B-5B82-A231-6B18773E7411"><p>The <xref href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita">MakeSIS</xref> tool

creates unsigned SIS files based on the information provided in an input package

(PKG) file. </p> </li>

<li id="GUID-9A4C3909-108E-50F0-A50B-23D95537F56A"><p>The <xref href="GUID-B20EE8A3-D7B2-5872-AF43-001A88C1A46E.dita">SignSIS</xref> tool

signs SIS files using a certificate and private key. </p> </li>

<li id="GUID-951A5574-4C25-5EC4-A024-76907FF2A4C6"><p>The <xref href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita">CreateSIS</xref> tool

is a wrapper around the MakeSIS, SignSIS, and MakeKeys tools, which automates

the process of generating and signing SIS files. It supports creating new

SIS files from package (PKG) files, signing existing package files and generating

private-public key pair and certificate requests for signing. </p> </li>

<li id="GUID-F1D3CFEF-7562-5E6C-B2CC-7801DF4D642C"><p>The <xref href="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita">DumpSIS</xref> tool

decompiles input SIS file and extracts the corresponding PKG and source files. </p> </li>

<li id="GUID-CEC7BC9C-9E67-58AA-AB48-FBEA773FEEA2"><p>The <xref href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita">InterpretSIS</xref> tool

enables device creators to preinstall SIS files on a device system drive or

memory card image. The InterpretSIS tool can be invoked either through the

BUILDROM tool when creating a data drive image, or as a stand-alone tool. </p> </li>

</ul> </section>

<section id="GUID-5B284ADE-E9D1-437F-9610-78F20CDD2697"><title>Required background</title> <p>Before you start, you must

be familiar with the following: </p> <ul>

<li id="GUID-74F7883B-84E6-5CEF-8B17-90554A3F6048"><p><xref href="GUID-FB2CAA46-8EBB-5F76-847C-F3B953C9D31C.dita">Public

Key Cryptography</xref>  </p> </li>

<li id="GUID-F3A86986-12F1-5E93-9DD8-DB21EFC84885"><p><xref href="GUID-911E9F7E-D0AD-55EC-A3F4-1D427F803780.dita">Digital

Certificates</xref>  </p> </li>

</ul> </section>

<section id="GUID-CF573733-60C3-4EBA-9A87-11A12E06EA4E"><title>Key concepts and terms</title> <dl>

<dlentry>

<dt>PKG File</dt>

<dd><p>A package (PKG) file contains information required by the SIS file

creation tools to create a SIS file. </p> </dd>

</dlentry>

<dlentry>

<dt>SIS File</dt>

<dd><p>A Symbian Installation Source (SIS) file is a collection of executables

and data files, packaged in a way that the software installer can install

them onto a device. SIS files can be preinstalled on a device. </p> </dd>

</dlentry>

<dlentry>

<dt>Signing</dt>

<dd><p>A SIS file must be signed with a digital signature, which is used in

verifying the identity of the vendor of an installation file. This ensures

that the file has not been tampered with since it was signed. For details

see, <xref href="GUID-AFBD4ED6-9588-531C-8EDF-566DB1D03088.dita">Signing</xref>. </p> </dd>

</dlentry>

<dlentry>

<dt>Eclipsing</dt>

<dd><p>Eclipsing is a mechanism to upgrade files existing on the ROM drive,

by installing a new version of the same on the RAM drive. For details see, <xref href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita">Eclipsing</xref>. </p> </dd>

</dlentry>

<dlentry>

<dt>System Upgrade Packages</dt>

<dd><p>System upgrade packages allow device manufacturers to overcome the

restriction of having a stub SIS file in the ROM drive for eclipsing. For

details see, <xref href="GUID-CD5907AE-B439-5F76-AE19-9C9491832CB4.dita">System

Upgrade Packages</xref>. </p> </dd>

</dlentry>

<dlentry>

<dt>Auto-propagation</dt>

<dd><p>Auto-propagation is a process of automatically installating software

packages from the media card when it is inserted into the Symbian device.

For details, see <xref href="GUID-0250833D-7358-57AB-8CB8-956DF4310EFA.dita">Package

Propagation</xref>. </p> </dd>

</dlentry>

</dl> </section>

<section id="GUID-B5A78585-05EF-4763-8C70-33AE5882F1EA"><title>Typical Uses</title> <p>The SIS tools can be used to perform

the following: </p> <ul>

<li id="GUID-0E5E3BED-B678-54E1-98F0-09672A5BDA8C"><p> <b>Create and sign

an installation file</b>  </p> <p>Symbian application developers can create

installation packages using <codeph>MakeSIS</codeph> and sign them using <codeph>SignSIS</codeph>.

Alternatively, the <codeph>CreateSIS</codeph> tool, which is a wrapper around <codeph>MakeSIS</codeph> and <codeph>SignSIS</codeph>,

can be used to create and sign an installation file. For details see <xref href="GUID-03BBEA31-3266-5B1C-9017-4EE7EA4AF1A8.dita">Creating and Signing an Installation

File</xref>  </p> </li>

<li id="GUID-E5CAFFB6-7396-5220-942D-2406C39D8E01"><p> <b>Upgrade OS components</b>  </p> <p>The

software installer enables a device manufacturer to replace binaries and data

files in ROM, for example, to fix a software issue, by means of eclipsing.

For details, see <xref href="GUID-7F65B69A-6AC1-509C-91E8-9E49ED0BFEC0.dita">Upgrading

an OS Component</xref>. </p> </li>

<li id="GUID-F782386D-DB8D-5448-BBB3-31E7DA216ABB"><p> <b>Preinstall

applications</b>  </p> <p>Device creators can preinstall applications on device

system drive or memory card image. For details, see <xref href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita">Preinstalling

Applications</xref>. </p> </li>

</ul> </section>

</conbody><related-links>

<link href="GUID-C55D1D74-B764-5DD1-8C43-5A5138578EAC.dita"><linktext>Secure Software

Install SIS Tools Concepts</linktext></link>

<link href="GUID-A4C26317-9F76-587E-A4B6-D94892ACF11B.dita"><linktext>Secure Software

Install SIS Tools Tutorials</linktext></link>

<link href="GUID-100F41B4-67BE-5978-99DA-C9B6DE8760F7.dita"><linktext>Secure Software

Install SIS Tools Reference</linktext></link>