[DRE-maint] Bug#672534: problems with unprivilleged user documentation

[chrysn]

Package: redmine
Version: 1.3.3+dfsg1-2
Severity: minor

the instructions for running redmine as an unprivilleged user (section
"MANUAL INSTALL / RUNNING AS UNPRIVILEGED USER WITHOUT COPYING
/usr/share/redmine" in /usr/share/doc/redmine/README.Debian.gz could use
some updates:

* (minor): point 3 says "adapt it to your needs"; even though using the
  sqlite template as suggested, i had to look up the value for "adapter"
  ("sqlite3") on the web.

  i suggest the following wording:

----

3. Copy /usr/share/redmine/templates/database.yml.template to $mydir/config/database.yml
and adapt it to your needs. For a quick setup it's easier to use the
sqlite template database-sqlite.yml.template located in the same dir,
replace _DBC_DBTYPE_ with sqlite3 and _DBC_BASEPATH_/_DBC_DBNAME_ with
@@@.

----

  (wherever the suggested location would be). the
  database-sqlite.yml.template file could have its _DBC_DBTYPE_ already
  filled in as it is sqlite specific, byt maybe there's a reason it
  isn't.

* (major) in point 6., running webrick suffers from the constraints
  already discussed in bug 589033, just that with an unprivilleged
  setup, chowning /usr/share/redmine/tmp is pretty much a no-go.

  even after i did create it and chowned it to my user, similar trouble
  went on:

  /usr/lib/ruby/vendor_ruby/rails/rack/log_tailer.rb:10:in `size': No
  such file or directory - /usr/share/redmine/log/production.log
  (Errno::ENOENT)

please try out that part of the README.Debian.gz with a current version.

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.1.0-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages redmine depends on:
ii  dbconfig-common        1.8.47+nmu1
ii  debconf [debconf-2.0]  1.5.43
ii  redmine-sqlite         1.3.3+dfsg1-2
ii  ruby-coderay           1.0.6-1
ii  ruby-net-ldap          0.0.4-1
ii  ruby-rack              1.4.1-1
ii  ruby-rails-2.3         2.3.14-2
ii  ruby1.8                1.8.7.358-2

redmine recommends no packages.

Versions of packages redmine suggests:
ii  bzr             2.6.0~bzr6522-1
ii  cvs             2:1.12.13+real-9
ii  darcs           <none>
ii  git             1:1.7.10-1
ii  libopenid-ruby  <none>
ii  mercurial       2.2.1-2
ii  ruby-rmagick    <none>
ii  subversion      1.6.17dfsg-3

-- debconf information:
  redmine/instances/default/passwords-do-not-match:
  redmine/instances/default/db/basepath:
  redmine/instances/default/pgsql/changeconf: false
  redmine/default-language: ${defaultLocale}
  redmine/instances/default/pgsql/no-empty-passwords:
  redmine/instances/default/pgsql/manualconf:
  redmine/instances/default/pgsql/authmethod-admin: ident
  redmine/instances/default/pgsql/admin-user: postgres
  redmine/instances/default/pgsql/authmethod-user: password
  redmine/old-instances:
  redmine/instances/default/upgrade-error: abort
  redmine/instances/default/upgrade-backup: true
  redmine/instances/default/mysql/admin-user: root
  redmine/instances/default/mysql/method: unix socket
  redmine/instances/default/remove-error: abort
  redmine/instances/default/dbconfig-remove:
  redmine/instances/default/remote/port:
* redmine/instances/default/dbconfig-install: false
  redmine/instances/default/remote/newhost:
  redmine/instances/default/missing-db-package-error: abort
  redmine/instances/default/pgsql/method: unix socket
  redmine/instances/default/database-type:
  redmine/missing-redmine-package:
  redmine/instances/default/dbconfig-reinstall: false
  redmine/instances/default/db/app-user: redmine
  redmine/notify-migration:
  redmine/instances/default/db/dbname: redmine_default
  redmine/instances/default/purge: false
  redmine/current-instances: default
  redmine/instances/default/remote/host:
  redmine/instances/default/dbconfig-upgrade: true
  redmine/instances/default/internal/reconfiguring: false
  redmine/instances/default/install-error: abort
  redmine/instances/default/internal/skip-preseed: true

-- 
To use raw power is to make yourself infinitely vulnerable to greater powers.
  -- Bene Gesserit axiom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-ruby-extras-maintainers/attachments/20120511/a13c221b/attachment-0001.pgp>