diff --git a/doc/README.urpmi b/doc/README.urpmi new file mode 100644 index 00000000000..c31e558d5b5 --- /dev/null +++ b/doc/README.urpmi @@ -0,0 +1,36 @@ +Installation Steps +------------------ + +1. Check that all the required dependencies are installed. + +2. Create a postgresql database. + +The default database name is "terp". If you want to use another name, you +will need to provide it when launching the server (by using the commandline +option --database). + +To create a postgresql database named "terp" using the following command: + $ createdb --encoding=UNICODE terp + +If it is the first time you use postgresql you might need to create a new user +to the postgres system using the following commands (where myusername is your +unix user name): + + $ su - + # su - postgres + $ createuser tinyerp + Shall the new user be allowed to create databases? (y/n) y + Shall the new user be allowed to create more new users? (y/n) y + CREATE USER + $ logout + # logout + +3. Launch service daemon by "service tinyerp-server start". + +The first time it is run, the server will initialise the database with all the default values. + +4. Connect to the server using the GUI client. + +There are two accounts by default: + * login: admin, password:admin + * login: demo, password:demo diff --git a/doc/openerp-server.conf b/doc/openerp-server.conf new file mode 100644 index 00000000000..16a00b4251c --- /dev/null +++ b/doc/openerp-server.conf @@ -0,0 +1,20 @@ +[options] +without_demo = False +upgrade = False +verbose = False +xmlrpc = True +db_user = False +db_password = False +root_path = None +soap = False +translate_modules = ['all'] +db_name = terp +netrpc = True +demo = {} +interface = +db_host = False +db_port = False +port = 8069 +addons_path = None +reportgz = False + diff --git a/doc/openerp-server.init b/doc/openerp-server.init new file mode 100644 index 00000000000..0eb3d363875 --- /dev/null +++ b/doc/openerp-server.init @@ -0,0 +1,134 @@ +#!/bin/bash +# tinyerp-server This shell script takes care of starting and stopping +# TinyERP server +# +# chkconfig: 345 95 05 +# description: TinyERP server +# +# pidfile: /var/run/tinyerp-server.pid +# config: /etc/tinyerp-server.conf + +### BEGIN INIT INFO +# Provides: tinyerp-server +# Required-Start: postgresql +# Required-Stop: postgresql +# Should-Start: $network harddrake +# Default-Start: 345 +# Short-Description: Launches the TinyERP server. +# Description: This startup script launches the TinyERP server. +### END INIT INFO + +# Source function library. +. /etc/rc.d/init.d/functions + +PIDFILE=/var/run/tinyerp/tinyerp-server.pid +LOCKFILE=/var/lock/subsys/tinyerp-server +LOGFILE=/var/log/tinyerp/tinyerp-server.log + +OPTS="--pidfile=$PIDFILE --logfile=$LOGFILE" + +prog="tinyerp-server" +desc="TinyERP Server Daemon" + +# check if the tinyerp-server conf file is present, then use it +if [ -f /etc/tinyerp-server.conf ]; then + OPTS="$OPTS -c /etc/tinyerp-server.conf" +fi + +# Source function library +if [ -f /etc/init.d/functions ] ; then + . /etc/init.d/functions +elif [ -f /etc/rc.d/init.d/functions ] ; then + . /etc/rc.d/init.d/functions +else + exit 0 +fi + +# check the existence of the tinyerp-server script +[ -z "/usr/bin/tinyerp-server" ] && exit 0 + +RETVAL=0 + +start() { + echo -n $"Starting $desc ($prog): " + daemon --user tinyerp --check tinyerp-server \ + "/usr/bin/setsid /usr/bin/tinyerp-server \ + -c /etc/tinyerp-server.conf \ + --pidfile=$PIDFILE \ + --logfile=$LOGFILE &" + + RETVAL=$? + echo + [ $RETVAL -eq 0 ] && touch $LOCKFILE + return $RETVAL +} + +stop() { + echo -n $"Stopping $desc ($prog): " + kill -TERM `cat $PIDFILE` > /dev/null 2>&1 + RETVAL=$? + if [ $RETVAL -eq 0 ] ; then + rm -f $LOCKFILE + + echo_success + echo + else + echo_failure + echo + fi + return $RETVAL +} + +restart() { + stop + start +} + +condrestart() { + [ -e $LOCKFILE ] && restart || : +} + +status() { + if [ -f $PIDFILE ] ; then + checkpid `cat $PIDFILE` + RETVAL=$? + if [ $RETVAL -eq 0 ] ; then + echo $"$prog is running..." + else + echo $"$prog is stopped" + fi + else + echo $"$prog is stopped" + fi + return $RETVAL +} + +case "$1" in +start) + start + ;; + +stop) + stop + ;; + +restart|reload) + restart + ;; + +condrestart) + condrestart + ;; + +status) + status + ;; + +probe) + exit 0 + ;; + +*) + echo $"Usage: $0 {start|stop|status|restart|condrestart|reload}" + exit 1 +esac diff --git a/doc/openerp-server.logrotate b/doc/openerp-server.logrotate new file mode 100644 index 00000000000..5d8585fe5d2 --- /dev/null +++ b/doc/openerp-server.logrotate @@ -0,0 +1,5 @@ +/var/log/tinyerp/*.log { + copytruncate + missingok + notifempty +}