gnue-appserver - GNUe Application Server

gnue-appserver [ options ]

The GNUe Application Server is the core of the n-tier variant of the GNU Enterprise system. To the front end (be it GNUe Forms, GNUe Reports or any other tool), it provides user-defineable business objects with arbitary fields and methods. While transforming access to those fields and methods into database communication and calling of scripts, it cares about stability, security, speed, and consistency.

GENERAL OPTIONS

--connection <name>, -c

--connections <loc>

Specifies the location of the connection definition file. <loc> may specify a file name (/usr/local/gnue/etc/connections.conf),or a URL location (http://localhost/connections.conf).If this option is not specified, the environent variable GNUE_CONNECTIONS is checked.If neither of them is set, "/home/reinhard/gnue/etc/connections.conf" is used as a default.

--database <name>

Depreciated: Set the Database to use for loading and storing data to <name>. gnue-appserver will search for it in connections.conf.

--debug-file <filename>

Sends all debugging messages to a specified file (e.g., "--debug-file trace.log" sends all output to "trace.log")

--debug-level <level>

Enables debugging messages. Argument specifies the level of messages to display (e.g., "--debug-level 5" displays all debugging messages at level 5 or below.)

--help

Displays this help screen.

--help-config

Displays a list of valid configuration file entries, their purpose, and their default values.

--help-connections

Display help information related to database connections, including a list of available drivers.

--help-dev

Display all options of interest to core developers.

--loglevel <loglevel>

If set to 1, provides information on data dispatched to the RPC interface.

--modulepath <pathlist>, -m

Semicolon-separated list of paths to load modules from

--no-detach, -Z

Do not send the server into the background. For a POSIX system, this option keeps the server process from forking and detaching from its controlling terminal.

--password <password>, -p

Set the password for the used database.

--pidfile <pid-file>, -P

Filename to store the server's process id.

--rpc-port <port>

Set the GNURPC port. For more information on GNURPC have a look at common/doc/RPC-abstraction.

--rpc-type <type>

Set the GNURPC connection type. The currently supported values for <type> are 'xmlrpc', 'xmlrpc.py_xmlrpc', 'xmlrpc.pw_xmlrpc' and 'pyro'. For more information on GNURPC connection types have a look at common/doc/RPC-abstraction.

--selftest

Test appservers connection to the backend database, check correctness of global settings, etc.

--silent

Displays no output at all.

--username <user>, -u

Set the username for the used database.

--version

Displays the version information for this program.

--web-frontend

Enable appservers web frontend. Just works for the rpc-type XMLRPC. The webfrontend is at the same port as XMLRPC.

DEVELOPER OPTIONS

--debug-gc <logfile>, -g

--debug-imports

All python imports are logged to stdout

--interactive-debugger

Run the app inside Python's built-in debugger

--profile

Run Python's built-in profiler and display the resulting run statistics.

--selfdoc <type[,subtype]>

Generates self-documentation.

--selfdoc-file <filename>

Specifies the filename that selfdoc should write to. If not provided, output is sent to stdout.

--selfdoc-format <format>

Format to output the self-documentation in. Supported formats are dependent on the type of selfdoc being created.

--selfdoc-options <options>

Options specific to individual selfdoc types.

Debug Python's garbage collection on a SIGUSR1. If the argument is empty 'garbage.log' will be used as logfile.

Set the Database to use for loading and storing data to <name>. gnue-appserver will search for it in connections.conf.

GNU Enterprise Project <info@gnue.org>

Please report any bugs to info@gnue.org. Include a complete, self-contained example that will allow the bug to be reproduced, and say which version of this tool you are using.

Copyright © 2000-2005 Free Software Foundation, Inc.

gnue-appserver is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

gnue-appserver is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with gnue-appserver; see the file COPYING. If not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.