[med-svn] r18891 - trunk/packages/orthanc-postgresql/trunk/debian

[Sebastien Jodogne]

Author: jodogne-guest
Date: 2015-03-02 11:07:36 +0000 (Mon, 02 Mar 2015)
New Revision: 18891

Modified:
   trunk/packages/orthanc-postgresql/trunk/debian/README.Debian
   trunk/packages/orthanc-postgresql/trunk/debian/control
Log:
README

Modified: trunk/packages/orthanc-postgresql/trunk/debian/README.Debian
===================================================================
--- trunk/packages/orthanc-postgresql/trunk/debian/README.Debian	2015-03-02 09:58:59 UTC (rev 18890)
+++ trunk/packages/orthanc-postgresql/trunk/debian/README.Debian	2015-03-02 11:07:36 UTC (rev 18891)
@@ -1,3 +1,6 @@
+General
+=======
+
 Orthanc PostgreSQL is a set of 2 plugins to Orthanc, a lightweight,
 RESTful Vendor Neutral Archive for medical imaging. These plugins
 override the default SQLite engine of Orthanc with a PostgreSQL
@@ -6,6 +9,10 @@
     
 Homepage: https://code.google.com/p/orthanc-postgresql/
 
+
+Configuration
+=============
+
 To enable the plugin, you must specify the parameters of your
 PostgreSQL database by modifying the configuration file
 "/etc/orthanc/orthanc.json", following the instructions in
@@ -13,3 +20,40 @@
 service:
 
 # sudo /etc/init.d/orthanc restart
+
+
+Step-by-step tutorial
+=====================
+
+(1) Install the database server:
+
+# sudo apt-get postgresql
+  
+
+(2) Create an user (whose name is "orthanc" with password
+    "my_password") and a database (whose name is "orthanc") to
+    store the content of Orthanc:
+
+# sudo -u postgres psql postgres
+
+postgres=# CREATE USER orthanc;
+postgres=# ALTER USER orthanc WITH ENCRYPTED PASSWORD 'my_password';
+postgres=# CREATE DATABASE orthanc OWNER orthanc;
+
+Hit <Ctrl-D> to exit the PostgreSQL prompt.
+
+
+(3) Edit the configuration file "/etc/orthanc/orthanc.json" and add the
+    following entry:
+
+  "PostgreSQL" : {
+    "EnableIndex" : true,
+    "EnableStorage": true,
+    "ConnectionUri" : "postgresql://orthanc:my_password@localhost:5432/orthanc"
+  }
+
+
+(4) Restart the Orthanc service and check the logs:
+
+# sudo /etc/init.d/orthanc restart
+# cat /var/log/orthanc/Orthanc.WARNING

Modified: trunk/packages/orthanc-postgresql/trunk/debian/control
===================================================================
--- trunk/packages/orthanc-postgresql/trunk/debian/control	2015-03-02 09:58:59 UTC (rev 18890)
+++ trunk/packages/orthanc-postgresql/trunk/debian/control	2015-03-02 11:07:36 UTC (rev 18891)
@@ -22,6 +22,7 @@
 Package: orthanc-postgresql
 Architecture: any
 Depends: ${misc:Depends}, ${shlibs:Depends}, orthanc (>= 0.8.6)
+Suggests: postgresql
 Description: Plugins to use PostgreSQL as a database back-end to Orthanc
  Orthanc PostgreSQL is a set of 2 plugins to Orthanc, a lightweight,
  RESTful Vendor Neutral Archive for medical imaging. These plugins