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-474A9F80-2B3E-5D11-8D2E-95E217BEB84A" xml:lang="en"><title>Preinstalled

    13 Package Upgrades</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>Packages that are preinstalled using InterpretSIS must follow certain rules

    15 while upgrading, as explained in the following sections: </p>

    16 <section><title>Standard upgrade rules</title> <p>InterpretSIS supports the

    17 following upgrade types: </p> <fig id="GUID-E97B0D4F-6B3A-5595-A0C2-B87C1457E80F">

    18 <image href="GUID-718E1B9F-C05D-559A-AF69-BD9CFAF190FB_d0e24274_href.png" placement="inline"/>

    19 </fig> <p>* The base SA and associated upgrades are removed ** The base SA

    20 is removed prior to the installation of the SA upgrade. </p> <p>InterpretSIS

    21 returns an error if the rules are violated during an upgrade. It supports

    22 variants of file names and usage of wildcards for Stub SIS files. </p> </section>

    23 <section><title>Non-removable package upgrade rules</title> <p>The following

    24 table summarises the rules that apply when performing patch upgrade, partial

    25 upgrade or replacement of <i>non-removable</i> packages installed using <codeph>InterpretSIS</codeph>.

    26 The general rule is that a removable package cannot be made non-removable,

    27 and a non-removable package cannot be made removable. </p> <fig id="GUID-20A6F1E5-45DC-5AC0-92F2-181A5AFB77F0">

    28 <image href="GUID-301CEDFA-6329-56BA-ADA6-8A89BA17E398_d0e24299_href.png" placement="inline"/>

    29 </fig> <p>* If the partial upgrade modifies files in the <codeph>SP</codeph>,

    30 the <codeph>PU(NR)</codeph> is modified when the <codeph>SP</codeph> is removed. </p> <p>**

    31 The original <codeph>PA</codeph> is removed, including the private directory,

    32 before upgrading. </p><p><b>Notes:</b></p><ul>

    33 <li><p><codeph>NR</codeph> upgrades are performed to the same drive as the

    34 original package. </p></li>

    35 <li><p><codeph>NR </codeph>upgrades or patches delivered on preinstalled media

    36 cards are rejected as invalid. Any invalid upgrade generates a <codeph>KErrInvalidUpgrade</codeph> error. </p></li>

    37 <li><p>Back-up and restore is not functional for preinstalled SIS files that

    38 are in the system drive. </p></li>

    39 <li><p>Preinstalled SIS files that are in the system drive can be uninstalled

    40 if <codeph>DeletePreinstalledFilesOnUninstall</codeph> is set in <filepath>swipolicy.ini</filepath> file.

    41 For details see, <xref href="GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D.dita#GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D/GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D">Secure

    42 Software Install Reference</xref>. </p></li>

    43 </ul> </section>

    44 </conbody><related-links>

    45 <link href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita"><linktext>InterpretSIS</linktext>

    46 </link>

    47 <link href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita"><linktext>Preinstalling

    48 Packages</linktext></link>

    49 <link href="GUID-7FD72D9F-D65E-5248-A296-F2196F1DF5CF.dita"><linktext>Upgrade Types</linktext>

    50 </link>

    51 <link href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita"><linktext>Eclipsing</linktext>

    52 </link>

    53 </related-links></concept>