aboutsummaryrefslogtreecommitdiffstats
path: root/system/doc/design_principles
diff options
context:
space:
mode:
authorSiri Hansen <[email protected]>2014-04-03 12:25:27 +0200
committerSiri Hansen <[email protected]>2014-04-03 12:25:27 +0200
commitab334b945b8ac7c159dec5aa5df9a4d3cc418cb6 (patch)
treeeebc7e3276361cc6c86341347ce164feac7ad21e /system/doc/design_principles
parentd02c41a4d7b2cf93ba82fa25eb7ef619b8ea3cf8 (diff)
parentc65821b677b4ebbc05192da9b8a48d32e53b3cfe (diff)
downloadotp-ab334b945b8ac7c159dec5aa5df9a4d3cc418cb6.tar.gz
otp-ab334b945b8ac7c159dec5aa5df9a4d3cc418cb6.tar.bz2
otp-ab334b945b8ac7c159dec5aa5df9a4d3cc418cb6.zip
Merge branch 'siri/doc-upgrade/OTP-11717'
* siri/doc-upgrade/OTP-11717: Add documentation about upgrade Add info about upgrade of core applications
Diffstat (limited to 'system/doc/design_principles')
-rw-r--r--system/doc/design_principles/release_handling.xml17
1 files changed, 15 insertions, 2 deletions
diff --git a/system/doc/design_principles/release_handling.xml b/system/doc/design_principles/release_handling.xml
index 2a5831b89f..ba8a88d1c2 100644
--- a/system/doc/design_principles/release_handling.xml
+++ b/system/doc/design_principles/release_handling.xml
@@ -4,7 +4,7 @@
<chapter>
<header>
<copyright>
- <year>2003</year><year>2013</year>
+ <year>2003</year><year>2014</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>
@@ -329,13 +329,26 @@
automatically ensured.</p>
<p>When the release handler encounters the instruction, it first
generates a temporary boot file, which starts the new versions
- of the emulator and the core applications. Then it shuts down
+ of the emulator and the core applications, and the old version
+ of all other applications. Then it shuts down
the current emulator by calling <c>init:reboot()</c>, see
<c>init(3)</c>. All processes are terminated gracefully and
the system is rebooted by the heart program, using the
temporary boot file. After the reboot, the rest of the relup
instructions are executed. This is done as a part of the
temporary boot script.</p>
+ <warning>
+ <p>Since this mechanism causes the new versions of the
+ emulator and core applications to run with the old version of
+ other applications during startup, extra care must be taken to
+ avoid incompatibility. Incompatible changes in the core
+ applications may in some situations be necessary. If possible,
+ such changes are preceded by deprecation over two major
+ releases before the actual change. To make sure your
+ application is not crashed by an incompatible change, always
+ remove any call to deprecated functions as soon as
+ possible.</p>
+ </warning>
<p>An info report is written when the upgrade is completed. To
programatically find out if the upgrade is complete,
call <c>release_handler:which_releases(current)</c> and check