gnue-appserver ./INSTALL ./INSTALL.cvs ./README...

[Reinhard Mueller]

CVSROOT:        /cvsroot/gnue
Module name:    gnue-appserver
Branch:         
Changes by:     Reinhard Mueller <address@hidden>       03/09/18 10:13:56

Modified files:
        .              : INSTALL INSTALL.cvs README 
Added files:
        samples        : README README.cvs 

Log message:
        Several documentation improvements.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue-appserver/INSTALL.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue-appserver/INSTALL.cvs.diff?tr1=1.4&tr2=1.5&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue-appserver/README.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue-appserver/samples/README?rev=1.1
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue-appserver/samples/README.cvs?rev=1.1

Patches:
Index: gnue-appserver/INSTALL
diff -c gnue-appserver/INSTALL:1.16 gnue-appserver/INSTALL:1.17
*** gnue-appserver/INSTALL:1.16 Tue Aug 12 17:26:09 2003
--- gnue-appserver/INSTALL      Thu Sep 18 10:13:56 2003
***************
*** 1,70 ****
! Installation instructions for GNUe-Application Server
  =====================================================
  
- Quick Ref: (read below for more info)
- ------------------------------------
  
! 1. Install the GNUe common package. 
  
! 2. then run :
  
!  $ python setup.py install  (depending on your OS, this could
!                               also be python2.1 or python2.2)
  
  
! General information:
! ====================
  
! GNUe-Application Server needs some prerequisites to work. You need a 
! database managment system, a rpc-interface library, python as programming
! language and a xml-handling library.  As of this writting GNUe Appserver
! allows you to use a variety of database systems, and two different
! rpc-interfaces (py-xmlrpc and Pythonware xmlrpc).
  
! The next part of this document describes the steps to install GNUe-Appserver 
on
! a Debian 3.0, i386 platform.
  
! Debian packages to be installed:
! ================================
! You should apt-get install the following packages:
  
!   python-dev
!   python-egenix-mxdatetime
!   python-xml
!   python-psycopg     (if needed -- for PostgreSQL support)
!   python-mysqldb     (if needed -- for MySQL support)
!   python-xmlrpc      ( available in Debian since version 3.0)
  
! This will also install other packages, such as postgresql-client, et al.
  
  
- Setting GNUe Application Server up 
- ==================================
  
  
! To use appserver you have to adapt you connection.conf file.
  
! 1. add an entry for the database appserver should use.
  
-    The default database name in appserver is "gnue".
-    You can change it with the command line option "--database".
-    If you don't use postgresql you have to set the username and
-    password for the database you want to use by command line options.
  
! 2. Set up the database for appserver. 
  
! 3. for using GNUe Forms or Reports with appserver, you have to add a
!    section similar to the following:
  
!    [appserver]
!    comment = Connection to the GNUe Application Server
!    provider = appserver
!    rpctype = xmlrpc
!    host = localhost
!    port = 8765
!    transport = http
  
! 4. now you can start appserver by executing "gnue-appserver".
  
!    TIP: For troubleshooting run appserver in "non-daemon" mode and activate
!         debugging output by calling "gnue-appserver -Z --debug-level=12"
--- 1,96 ----
! Installation instructions for GNUe Application Server
  =====================================================
  
  
! Dependencies
! ------------
  
! To install gnue-appserver, you need at least the following prerequisites
! installed on your system [Debian packages in brackets]:
  
! * Python 2.1 or greater [python python-dev]
  
+ * eGenix Datetime Routines für Python [python-egenix-mxdatetime]
  
! * XML Tools for Python [python-xml]
  
! * at least one of the following database interfaces, depending on the database
!   you want to use:
!   - psycopg (preferred for PostgreSQL) [python-psycopg]
!   - popy (also possible for PostgreSQL) [python-popy]
!   - pygresql (also possible for PostgreSQL) [python-pygresql]
!   - python-mysqldb (for MySQL)
!   you can find more information about possible database backends in the file
!   README.Databases, distributed with gnue-common.
  
! * at least one of the following RPC libraries:
!   - py-xmlrpc [python-xmlrpc]
!   - Pythonware xmlrpc (included in Python starting with 2.2)
  
! * gnue-common 0.5.0 or greater [gnue-common]
  
! To build the documentation, you need GNU Texinfo 4.0 or newer installed.
  
! You also need a running database server (one of those supported by GNUe) on 
the
! local or on a remote machine, and you need the corresponding database client
! installed on the local machine.  We very much recommend that you make sure 
that
! you can access the database with the databases's normal client tools before 
you
! try to install and run gnue-appserver.
  
+ It is of course suggested that you have GNUe's front end tools installed 
either
+ on the local or on a remote machine.
  
  
+ Installation
+ ------------
  
! * Make sure that you have write permission in the directory /usr/local and 
it's
!   subdirectories.
  
! * From the shell prompt, change into the directory containing the file
!   "setup.py" and type "./setup.py install".  If you have all prerequisites
!   installed, the installation process should run without errors.  If any error
!   occures although you have fulfilled all dependencies described above, this 
is
!   probably a bug, either in the installation program or in the documentation.
!   Please report it.
  
  
! Configuration
! -------------
  
! (Future releases might have an own documentation file describing configuration
! more detailed)
  
! The most important configuration file for gnue-appserver is 
"connections.conf".
! If you did a standard installation, you can find it in /usr/local/gnue/etc.
  
! On the machine running gnue-appserver, you must have an entry in the
! connections.conf pointing to your database.  The default database name in
! appserver is "gnue".  You can change it with the command line option
! "--database".  If you don't use postgresql you have to set the username and
! password for the database you want to use by command line options.
  
! Example for a correct connections.conf entry on the machine running
! gnue-appserver:
! 
!   [gnue]
!   comment = Database for GNUe Application Server
!   provider = psycopg
!   host = localhost
!   dbname = gnue
! 
! On the machine running the front ends (gnue-forms, gnue-reports,
! gnue-designer), you need an entry in the connections.conf that points to the
! Application Server.  If you have the front ends installed on the same machine
! as gnue-appserver, there's only a single connections.conf with both entries.
! 
! Example for a correct connections.conf entry on the machine running 
gnue-forms,
! gnue-reports or gnue-designer:
! 
!   [appserver]
!   comment = Connection to the GNUe Application Server
!   provider = appserver
!   rpctype = xmlrpc
!   host = localhost
!   port = 8765
!   transport = http
Index: gnue-appserver/INSTALL.cvs
diff -c gnue-appserver/INSTALL.cvs:1.4 gnue-appserver/INSTALL.cvs:1.5
*** gnue-appserver/INSTALL.cvs:1.4      Tue Aug 12 17:26:09 2003
--- gnue-appserver/INSTALL.cvs  Thu Sep 18 10:13:56 2003
***************
*** 21,27 ****
  
  1. Change to the directory gnue-appserver/src.
  
! 2. type "./gcvs test.py"
  
  requires: * a connection.conf with a [gnue] entry
            * database tables created with the "setup-*.sh" from the 
--- 21,27 ----
  
  1. Change to the directory gnue-appserver/src.
  
! 2. type "gcvs test.py"
  
  requires: * a connection.conf with a [gnue] entry
            * database tables created with the "setup-*.sh" from the 
***************
*** 37,43 ****
  
  2. Startup GNUe Appserver by executing "gacvs -Z"
  
! 3. do the test example by calling "./gcvs testRPC.py"
  
  requires: * a connection.conf with a [gnue] entry
            * database tables created with the "setup-*.sh" from the 
--- 37,43 ----
  
  2. Startup GNUe Appserver by executing "gacvs -Z"
  
! 3. do the test example by calling "gcvs testRPC.py"
  
  requires: * a connection.conf with a [gnue] entry
            * database tables created with the "setup-*.sh" from the 
Index: gnue-appserver/README
diff -c gnue-appserver/README:1.1 gnue-appserver/README:1.2
*** gnue-appserver/README:1.1   Thu Apr 18 12:02:18 2002
--- gnue-appserver/README       Thu Sep 18 10:13:56 2003
***************
*** 10,23 ****
  speed, and consistency.
  
  The GNUe Appserver is still under heavy development and not ready to be used
! in production environments. This is a preview release.
  Please refer to the file named `NEWS' to see which version you are looking at
  here, and what has changed since earlier versions.
  
  To install GNUe Appserver on your system, follow the procedure described in 
the
  file `INSTALL'.
  
! GNU Enterprise is free software. See the file `COPYING' for the terms and
  conditions for copying, distribution and modification.
  
  Please send bug reports to address@hidden
--- 10,27 ----
  speed, and consistency.
  
  The GNUe Appserver is still under heavy development and not ready to be used
! in production environments.  This is a preview release.
  Please refer to the file named `NEWS' to see which version you are looking at
  here, and what has changed since earlier versions.
  
  To install GNUe Appserver on your system, follow the procedure described in 
the
  file `INSTALL'.
  
! The directory `samples' contains several files that help you to try out GNUe
! Appserver once you have installed it.  Please refer to the file `README' in
! that directory for details.
! 
! GNU Enterprise is free software.  See the file `COPYING' for the terms and
  conditions for copying, distribution and modification.
  
  Please send bug reports to address@hidden