/[gnue]/gnue-appserver/INSTALL
ViewVC logotype

Diff of /gnue-appserver/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.16 by reinhard, Tue Aug 12 21:26:09 2003 UTC revision 1.17 by reinhard, Thu Sep 18 14:13:56 2003 UTC
# Line 1  Line 1 
1  Installation instructions for GNUe-Application Server  Installation instructions for GNUe Application Server
2  =====================================================  =====================================================
3    
 Quick Ref: (read below for more info)  
 ------------------------------------  
4    
5  1. Install the GNUe common package.  Dependencies
6    ------------
7    
8  2. then run :  To install gnue-appserver, you need at least the following prerequisites
9    installed on your system [Debian packages in brackets]:
10    
11   $ python setup.py install  (depending on your OS, this could  * Python 2.1 or greater [python python-dev]
                               also be python2.1 or python2.2)  
12    
13    * eGenix Datetime Routines für Python [python-egenix-mxdatetime]
14    
15  General information:  * XML Tools for Python [python-xml]
 ====================  
16    
17  GNUe-Application Server needs some prerequisites to work. You need a  * at least one of the following database interfaces, depending on the database
18  database managment system, a rpc-interface library, python as programming    you want to use:
19  language and a xml-handling library.  As of this writting GNUe Appserver    - psycopg (preferred for PostgreSQL) [python-psycopg]
20  allows you to use a variety of database systems, and two different    - popy (also possible for PostgreSQL) [python-popy]
21  rpc-interfaces (py-xmlrpc and Pythonware xmlrpc).    - pygresql (also possible for PostgreSQL) [python-pygresql]
22      - python-mysqldb (for MySQL)
23      you can find more information about possible database backends in the file
24      README.Databases, distributed with gnue-common.
25    
26  The next part of this document describes the steps to install GNUe-Appserver on  * at least one of the following RPC libraries:
27  a Debian 3.0, i386 platform.    - py-xmlrpc [python-xmlrpc]
28      - Pythonware xmlrpc (included in Python starting with 2.2)
29    
30  Debian packages to be installed:  * gnue-common 0.5.0 or greater [gnue-common]
 ================================  
 You should apt-get install the following packages:  
31    
32    python-dev  To build the documentation, you need GNU Texinfo 4.0 or newer installed.
   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)  
33    
34  This will also install other packages, such as postgresql-client, et al.  You also need a running database server (one of those supported by GNUe) on the
35    local or on a remote machine, and you need the corresponding database client
36    installed on the local machine.  We very much recommend that you make sure that
37    you can access the database with the databases's normal client tools before you
38    try to install and run gnue-appserver.
39    
40    It is of course suggested that you have GNUe's front end tools installed either
41    on the local or on a remote machine.
42    
 Setting GNUe Application Server up  
 ==================================  
43    
44    Installation
45    ------------
46    
47  To use appserver you have to adapt you connection.conf file.  * Make sure that you have write permission in the directory /usr/local and it's
48      subdirectories.
49    
50  1. add an entry for the database appserver should use.  * From the shell prompt, change into the directory containing the file
51      "setup.py" and type "./setup.py install".  If you have all prerequisites
52      installed, the installation process should run without errors.  If any error
53      occures although you have fulfilled all dependencies described above, this is
54      probably a bug, either in the installation program or in the documentation.
55      Please report it.
56    
    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.  
57    
58  2. Set up the database for appserver.  Configuration
59    -------------
60    
61  3. for using GNUe Forms or Reports with appserver, you have to add a  (Future releases might have an own documentation file describing configuration
62     section similar to the following:  more detailed)
63    
64     [appserver]  The most important configuration file for gnue-appserver is "connections.conf".
65     comment = Connection to the GNUe Application Server  If you did a standard installation, you can find it in /usr/local/gnue/etc.
    provider = appserver  
    rpctype = xmlrpc  
    host = localhost  
    port = 8765  
    transport = http  
66    
67  4. now you can start appserver by executing "gnue-appserver".  On the machine running gnue-appserver, you must have an entry in the
68    connections.conf pointing to your database.  The default database name in
69    appserver is "gnue".  You can change it with the command line option
70    "--database".  If you don't use postgresql you have to set the username and
71    password for the database you want to use by command line options.
72    
73     TIP: For troubleshooting run appserver in "non-daemon" mode and activate  Example for a correct connections.conf entry on the machine running
74          debugging output by calling "gnue-appserver -Z --debug-level=12"  gnue-appserver:
75    
76      [gnue]
77      comment = Database for GNUe Application Server
78      provider = psycopg
79      host = localhost
80      dbname = gnue
81    
82    On the machine running the front ends (gnue-forms, gnue-reports,
83    gnue-designer), you need an entry in the connections.conf that points to the
84    Application Server.  If you have the front ends installed on the same machine
85    as gnue-appserver, there's only a single connections.conf with both entries.
86    
87    Example for a correct connections.conf entry on the machine running gnue-forms,
88    gnue-reports or gnue-designer:
89    
90      [appserver]
91      comment = Connection to the GNUe Application Server
92      provider = appserver
93      rpctype = xmlrpc
94      host = localhost
95      port = 8765
96      transport = http

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26