|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-AFE0238A-D6A4-5D07-BB99-85E8CF97BD26" xml:lang="en"><title>Secure |
|
13 Software Install SIS Tools Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The <b>Secure Software Install SIS Tools</b> enable you to create, sign, |
|
15 decompile and preinstall SIS files. </p> |
|
16 <section id="GUID-7FDA2D06-5E36-4757-BC83-E78A206FF64B"><title>Description</title> <p>The Secure Software Install SIS Tools |
|
17 component comprises the following PC-side command-line tools: </p> <ul> |
|
18 <li id="GUID-08851BF3-9C9B-5B82-A231-6B18773E7411"><p>The <xref href="GUID-4BDC9F63-83A1-53A5-91A0-B092AA821755.dita">MakeSIS</xref> tool |
|
19 creates unsigned SIS files based on the information provided in an input package |
|
20 (PKG) file. </p> </li> |
|
21 <li id="GUID-9A4C3909-108E-50F0-A50B-23D95537F56A"><p>The <xref href="GUID-B20EE8A3-D7B2-5872-AF43-001A88C1A46E.dita">SignSIS</xref> tool |
|
22 signs SIS files using a certificate and private key. </p> </li> |
|
23 <li id="GUID-951A5574-4C25-5EC4-A024-76907FF2A4C6"><p>The <xref href="GUID-AA555CC1-5CFF-5609-9191-8970F32BA255.dita">CreateSIS</xref> tool |
|
24 is a wrapper around the MakeSIS, SignSIS, and MakeKeys tools, which automates |
|
25 the process of generating and signing SIS files. It supports creating new |
|
26 SIS files from package (PKG) files, signing existing package files and generating |
|
27 private-public key pair and certificate requests for signing. </p> </li> |
|
28 <li id="GUID-F1D3CFEF-7562-5E6C-B2CC-7801DF4D642C"><p>The <xref href="GUID-42CF6D55-CAD2-5049-A1B6-35479404C273.dita">DumpSIS</xref> tool |
|
29 decompiles input SIS file and extracts the corresponding PKG and source files. </p> </li> |
|
30 |
|
31 </ul> </section> |
|
32 <section id="GUID-5B284ADE-E9D1-437F-9610-78F20CDD2697"><title>Required background</title> <p>Before you start, you must |
|
33 be familiar with the following: </p> <ul> |
|
34 <li id="GUID-74F7883B-84E6-5CEF-8B17-90554A3F6048"><p><xref href="GUID-FB2CAA46-8EBB-5F76-847C-F3B953C9D31C.dita">Public |
|
35 Key Cryptography</xref> </p> </li> |
|
36 <li id="GUID-F3A86986-12F1-5E93-9DD8-DB21EFC84885"><p><xref href="GUID-911E9F7E-D0AD-55EC-A3F4-1D427F803780.dita">Digital |
|
37 Certificates</xref> </p> </li> |
|
38 </ul> </section> |
|
39 <section id="GUID-CF573733-60C3-4EBA-9A87-11A12E06EA4E"><title>Key concepts and terms</title> <dl> |
|
40 <dlentry> |
|
41 <dt>PKG File</dt> |
|
42 <dd><p>A package (PKG) file contains information required by the SIS file |
|
43 creation tools to create a SIS file. </p> </dd> |
|
44 </dlentry> |
|
45 <dlentry> |
|
46 <dt>SIS File</dt> |
|
47 <dd><p>A Symbian Installation Source (SIS) file is a collection of executables |
|
48 and data files, packaged in a way that the software installer can install |
|
49 them onto a device. SIS files can be preinstalled on a device. </p> </dd> |
|
50 </dlentry> |
|
51 <dlentry> |
|
52 <dt>Signing</dt> |
|
53 <dd><p>A SIS file must be signed with a digital signature, which is used in |
|
54 verifying the identity of the vendor of an installation file. This ensures |
|
55 that the file has not been tampered with since it was signed. For details |
|
56 see, <xref href="GUID-AFBD4ED6-9588-531C-8EDF-566DB1D03088.dita">Signing</xref>. </p> </dd> |
|
57 </dlentry> |
|
58 <dlentry> |
|
59 <dt>Eclipsing</dt> |
|
60 <dd><p>Eclipsing is a mechanism to upgrade files existing on the ROM drive, |
|
61 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> |
|
62 </dlentry> |
|
63 |
|
64 |
|
65 </dl> </section> |
|
66 <section id="GUID-B5A78585-05EF-4763-8C70-33AE5882F1EA"><title>Typical Uses</title> <p>The SIS tools can be used to perform |
|
67 the following: </p> <ul> |
|
68 <li id="GUID-0E5E3BED-B678-54E1-98F0-09672A5BDA8C"><p> <b>Create and sign |
|
69 an installation file</b> </p> <p>Symbian application developers can create |
|
70 installation packages using <codeph>MakeSIS</codeph> and sign them using <codeph>SignSIS</codeph>. |
|
71 Alternatively, the <codeph>CreateSIS</codeph> tool, which is a wrapper around <codeph>MakeSIS</codeph> and <codeph>SignSIS</codeph>, |
|
72 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 |
|
73 File</xref> </p> </li> |
|
74 <li id="GUID-E5CAFFB6-7396-5220-942D-2406C39D8E01"><p> <b>Upgrade OS components</b> </p> <p>The |
|
75 software installer enables a device manufacturer to replace binaries and data |
|
76 files in ROM, for example, to fix a software issue, by means of eclipsing. |
|
77 For details, see <xref href="GUID-7F65B69A-6AC1-509C-91E8-9E49ED0BFEC0.dita">Upgrading |
|
78 an OS Component</xref>. </p> </li> |
|
79 |
|
80 </ul> </section> |
|
81 </conbody><related-links> |
|
82 <link href="GUID-C55D1D74-B764-5DD1-8C43-5A5138578EAC.dita"><linktext>Secure Software |
|
83 Install SIS Tools Concepts</linktext></link> |
|
84 <link href="GUID-A4C26317-9F76-587E-A4B6-D94892ACF11B.dita"><linktext>Secure Software |
|
85 Install SIS Tools Tutorials</linktext></link> |
|
86 <link href="GUID-100F41B4-67BE-5978-99DA-C9B6DE8760F7.dita"><linktext>Secure Software |
|
87 Install SIS Tools Reference</linktext></link> |
|
88 </related-links></concept> |