11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A" xml:lang="en"><title>Preinstalled |
12 <concept id="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A" xml:lang="en"><title>Preinstalled |
13 Package Upgrades</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 Package Upgrades</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 <p>Packages that are preinstalled using InterpretSIS must follow certain rules |
14 <p>Packages that are preinstalled using InterpretSIS must follow certain rules |
15 while upgrading, as explained in the following sections: </p> |
15 while upgrading, as explained in the following sections: </p> |
16 <section><title>Standard upgrade rules</title> <p>InterpretSIS supports the |
16 <section id="GUID-BCC49EB3-DE9A-4B34-8F6C-644D67663996"><title>Standard upgrade |
17 following upgrade types: </p> <fig id="GUID-E97B0D4F-6B3A-5595-A0C2-B87C1457E80F"> |
17 rules</title> <p>InterpretSIS supports the following upgrade types: </p> <fig id="GUID-E97B0D4F-6B3A-5595-A0C2-B87C1457E80F"> |
18 <image href="GUID-718E1B9F-C05D-559A-AF69-BD9CFAF190FB_d0e30458_href.png" placement="inline"/> |
18 <image href="GUID-718E1B9F-C05D-559A-AF69-BD9CFAF190FB_d0e24740_href.png" placement="inline"/> |
19 </fig> <p>* The base SA and associated upgrades are removed ** The base SA |
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 |
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 |
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> |
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 |
23 <section id="GUID-293CEBCE-78B3-4D3A-90F4-281AD905FE14"><title>Non-removable |
24 table summarises the rules that apply when performing patch upgrade, partial |
24 package upgrade rules</title> <p>The following table summarizes the rules |
25 upgrade or replacement of <i>non-removable</i> packages installed using <codeph>InterpretSIS</codeph>. |
25 that apply when performing patch upgrade, partial upgrade or replacement of <i>non-removable</i> packages |
26 The general rule is that a removable package cannot be made non-removable, |
26 installed using <codeph>InterpretSIS</codeph> with the <codeph>NR</codeph> option |
27 and a non-removable package cannot be made removable. </p> <fig id="GUID-20A6F1E5-45DC-5AC0-92F2-181A5AFB77F0"> |
27 set (<codeph>+nonremovablepkg</codeph>). The general rule is that a removable |
28 <image href="GUID-301CEDFA-6329-56BA-ADA6-8A89BA17E398_d0e30483_href.png" placement="inline"/> |
28 package cannot be made non-removable, and a non-removable package cannot be |
29 </fig> <p>* If the partial upgrade modifies files in the <codeph>SP</codeph>, |
29 made removable.</p> <fig id="GUID-20A6F1E5-45DC-5AC0-92F2-181A5AFB77F0"> |
30 the <codeph>PU(NR)</codeph> is modified when the <codeph>SP</codeph> is removed. </p> <p>** |
30 <image href="GUID-301CEDFA-6329-56BA-ADA6-8A89BA17E398_d0e24772_href.png" placement="inline"/> |
31 The original <codeph>PA</codeph> is removed, including the private directory, |
31 </fig> <p>** The original <codeph>PA</codeph> is removed, including the private |
32 before upgrading. </p><p><b>Notes:</b></p><ul> |
32 directory, before upgrading. </p><p><b>Notes:</b></p><ul> |
|
33 <li><p>If the base package (SA) is removable then patch upgrade (SP) must |
|
34 also be removable.</p></li> |
|
35 <li><p>If base package (SA) is removable but partial upgrade (PU ) is non-removable |
|
36 then both base package and partial upgrades (SA+PU) are non-removable.</p></li> |
33 <li><p><codeph>NR</codeph> upgrades are performed to the same drive as the |
37 <li><p><codeph>NR</codeph> upgrades are performed to the same drive as the |
34 original package. </p></li> |
38 original package. </p></li> |
35 <li><p><codeph>NR </codeph>upgrades or patches delivered on preinstalled media |
39 <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> |
40 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 |
41 <li><p>Back-up and restore is not functional for preinstalled SIS files that |