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 |