sthen d5ffe85b7d Remove use of sudo from pkg READMEs in a few ports as packages and their
instructions are meant to work on a fresh install.

- easy cases: replace some '$ sudo somecommand' with '# somecommand'
(while there I've swapped some "${RCDIR}/foo start" with "rcctl foo start").

- replace some 'sudo -u user somecommand foo bar' with
'su -s /bin/sh user "/path/to/somecommand foo bar"' and similar.
Not pretty with the -s, but many of the uids that need to run
these commands have /sbin/nologin as their usual shell.
2015-07-06 11:25:36 +00:00
..
2015-03-29 20:06:45 +00:00

$OpenBSD: README,v 1.5 2015/07/06 11:25:36 sthen Exp $

+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------

Initial setup
=============

To configure a Trac environment, you must run the following command
and follow the prompts:
    su -s /bin/sh _trac "${TRUEPREFIX}/bin/trac-admin </path/to/projectenv> initenv"

Here, "</path/to/projectenv>" is the location on your disk where you
want to place the project environment. The _trac user will need the
appropriate permissions.

"</path/to/projectenv/conf/trac.ini>" is the configuration file of your
project environment which allows to setup the name of the project, etc.

To get started with Trac, you can use the built-in webserver.
Configure the daemon flags in /etc/rc.conf.local with a suitable port
and path if the defaults (/var/www/trac and port 8085) are not suitable:

tracd_flags=-p 8085 </path/to/projectenv>

And start the daemon:

# rcctl tracd start

Now you can open up a web brower and go to http://localhost:8085/. You
should see a single link for the project you just created. If you follow
the link, you should see trac in action.

Further information
===================

You can find the Trac Installation and Upgrade Guides here:
  http://projects.edgewall.com/trac/wiki/TracInstall
  http://projects.edgewall.com/trac/wiki/TracUpgrade

By default only Subversion is supported. Other VCS backends are
available as modules; see the documentation.