Index: head/devel/phabricator/files/pkg-message.in
===================================================================
--- head/devel/phabricator/files/pkg-message.in	(revision 511289)
+++ head/devel/phabricator/files/pkg-message.in	(revision 511290)
@@ -1,78 +1,89 @@
 [
 { type: install
   message: <<EOM
 To run the phabricator daemons from startup, add phd_enable="YES"
 to /etc/rc.conf. You can control the daemons using
 
 service phd start
 service phd stop
 etc.
 
 Before starting the daemons, please finish configuring your Phabricator
 instance. This involves configuring a web server (Apache, NGINX, LightHTTP)
 and a database server (MySQL, MariaDB). You can find detailed instructions
 on how to finish your setup at:
 
 https://secure.phabricator.com/book/phabricator/article/configuration_guide/
 
 Please note that all files are located in %%PREFIX%%/lib/php/phabricator,
 so if the documentation refers to ./bin, this means
 
   %%PREFIX%%/lib/php/phabricator/bin,
 
 if it refers to webroot, this means
 
   %%PREFIX%%/lib/php/phabricator/webroot.
 
 You might want to install textproc/py-pygments to improve syntax
 highlighting.
 
 Starting with version 20170630, phabricator daemons run as user www
 by default. If you're updating from a version before 20170630 you will need
 to fix permissions of /var/tmp/phd and repositories. Alternatively
 you can continue to run phabricator daemons as root by adding
 phd_user="root" to /etc/rc.conf.
 
 Phabricator daemons and ssh-git requires setting up sudo, see
 
   %%PREFIX%%lib/php/phabricator/resources/sshd/phabricator-sudoers.sample
 
 for an example.
 
 A phabricator example configuration installed here:
 
   %%PREFIX%%lib/php/phabricator/conf/local/local.json.sample
 
 Don't forget to update the database schema after update:
 
+  service nginx stop
+  service php-fpm stop
   service phd stop
   cd %%PREFIX%%/lib/php/phabricator
   ./bin/storage upgrade
   service phd start
+  service php-fpm start
+  service nginx start
 
-You also might want to stop the web server while upgrading the database.
+The above procedure is for users of nginx and php-fpm, please adapt
+accordingly to match your setup.
+
+If your configuration uses an unprivileged user to connect to the database,
+you may have to override the default user so the schema changes can be
+applied with root or some other admin user:
+
+  ./bin/storage upgrade --user <user> --password <password>
 
 If you want to access phabricator hosted git repositories via git,
 you can add the following configuration snippet to /etc/sshd_config
 and reload sshd afterwards (`service sshd reload'):
 
 ========================================================================
 Match User git
  AllowUsers git
  AuthorizedKeysCommand %%PREFIX%%/lib/php/phabricator/resources/sshd/phabricator-ssh-hook.sh
  AuthorizedKeysCommandUser git
  AuthorizedKeysFile none
  AuthenticationMethods publickey
  PermitRootLogin no
  PasswordAuthentication no
  PermitTTY no
  AllowAgentForwarding no
  AllowTcpForwarding no
  GatewayPorts no
  PermitOpen none
  PermitTunnel no
  X11Forwarding no
 ========================================================================
 EOM
 }
 ]