[med-svn] [Git][med-team/orthanc][master] added instructions to upgrade the database schema. Closes: #829380

[Sebastien Jodogne]

Sebastien Jodogne pushed to branch master at Debian Med / orthanc


Commits:
9f004236 by Sebastien Jodogne at 2020-04-08T07:47:10+02:00
added instructions to upgrade the database schema. Closes: #829380

- - - - -


2 changed files:

- debian/changelog
- debian/orthanc-doc.README.Debian


Changes:

=====================================
debian/changelog
=====================================
@@ -1,3 +1,9 @@
+orthanc (1.6.0+dfsg-2) UNRELEASED; urgency=medium
+
+  * Added sample in README.Debian about database upgrade. Closes: #829380
+
+ -- Sebastien Jodogne <s.jodogne at gmail.com>  Wed, 08 Apr 2020 07:33:51 +0200
+
 orthanc (1.6.0+dfsg-1) unstable; urgency=medium
 
   [ Giovanni Mascellani <gio at debian.org> ]


=====================================
debian/orthanc-doc.README.Debian
=====================================
@@ -1,4 +1,43 @@
-The index of the available documentation about Orthanc can be opened
-using the following command:
+
+Samples and documentation of plugin SDK
+=======================================
+
+The index of the available samples about Orthanc (Python, Lua and
+plugins), as well as the documentation of the Orthanc plugin SDK, can
+be opened using the following command:
 
 $ xdg-open file:///usr/share/doc/orthanc/index.html
+
+
+Upgrading the Orthanc database
+==============================
+
+[ This section was contributed by Karsten Hilbert
+<karsten.hilbert at gmx.net>. For more context, check out the Debian
+issue #829380 (orthanc: please provide orthanc_upgrade script). ]
+
+
+As explained in the Orthanc Book, the schema of the Orthanc database
+has evolved over time:
+https://book.orthanc-server.com/developers/db-versioning.html
+
+The latest versions of Orthanc still use the same schema as Orthanc
+0.9.5, that was released back in December 2015. If you need to upgrade
+an Orthanc server from some version < 0.9.5, you'll have to start the
+new version of Orthanc with the "--upgrade" command-line argument:
+https://book.orthanc-server.com/users/replication.html#upgrade-the-database-schema
+
+Here is a possible script to run such an upgrade in Debian, after
+having upgraded the "orthanc" package:
+
+    systemctl stop orthanc.service
+    /usr/sbin/Orthanc --upgrade --trace --logfile=/var/log/orthanc/upgrade.log /etc/orthanc/
+    RESULT=$?
+    if [ $RESULT -ne 0 ] ; then
+        echo "error upgrading"
+        read -e
+        less /var/log/orthanc/upgrade.log
+        exit $RESULT
+    fi
+    systemctl start orthanc.service
+



View it on GitLab: https://salsa.debian.org/med-team/orthanc/-/commit/9f004236c6190a4b3137d358b8de9d0cae498f90

-- 
View it on GitLab: https://salsa.debian.org/med-team/orthanc/-/commit/9f004236c6190a4b3137d358b8de9d0cae498f90
You're receiving this email because of your account on salsa.debian.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/debian-med-commit/attachments/20200408/171b5500/attachment-0001.html>