Tutorial
========

Once Orthanc is installed, you can test your installation with:

$ xdg-open http://localhost:8042/app/explorer.html

Then click on the "Upload" button, drag/drop a DICOM file, click on
the "Start the upload" button, and you should be going. For more info,
check out the Orthanc Book, starting with the "Quickstart" section:

https://orthanc.uclouvain.be/book/index.html



Optimizing boot time
====================

If the postgresql package is installed on the local host, the Orthanc
service will start after PostgreSQL service. This is because Orthanc
can be configured to use PostgreSQL as its database back-end instead
of the default SQLite back-end (cf. the "orthanc-postgresql" package).

This dependency of Orthanc against PostgreSQL can slightly impair the
boot time if Orthanc is configured to use SQLite or an external
PostgreSQL server.

If you wish to optimize your boot time, you can safely remove
"postgresql" from the following part of "/etc/init.d/orthanc":

>>>>>
# Should-Start:      postgresql
# Should-Stop:       postgresql
<<<<<

provided that the 2 following conditions are both met:

(1) Orthanc uses SQLite OR an external PostgreSQL server, AND
(2) the local "postgresql" package is installed. 



Upgrading the Orthanc database
==============================

[ This section was contributed by Karsten Hilbert
<karsten.hilbert@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://orthanc.uclouvain.be/book/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://orthanc.uclouvain.be/book/users/replication.html#upgrade-the-database-schema

The script "/usr/sbin/orthanc_upgrade.sh" automates this call.
