JAWS DSN Server Installation
Recommended
XAMPP for all platforms
DSN-Server
Requirements
- CVS (also integrated in Eclipse)
- Java Dev-Kit (pref. >=
sun-jdk1.5.0
) - Apache Ant
ant
- MySQL server and appropriate administration frontend:
mysql-server
andphpmyadmin
Installation
- CVS checkout module
proj/dsn_server
frombtnode.cvs.sourceforge.net:/cvsroot/btnode
- edit
Server.properties
- Login to phpmyadmin
- create a mysql-database with name "BTnode" (= default name, see
Server.properties
- SQL Database section) - create a user with all data privileagues on the BTnode db, use the same credentials as in
Server.properties
- create a mysql-database with name "BTnode" (= default name, see
- compile the server with
ant server
- REMOVEME: until now you have to create the directory build manually
mkdir build
- REMOVEME: until now you have to create the directory build manually
- start server with one of
ant run-server ant run-server-linux
- create a new XML-RPC user: open
src/testserver/NewUser.java
- enter a new user/password with appropriate permissions set to true
- run again
ant server
for compilation - run
ant new-user
DSN-GUI
Requirements
- Webserver with PHP support (included in XAMPP, or on debian:
apache2
andlibapache2-mod-php5
package) - PHP modules: gd, mysql (included in XAMPP, or on debian:
php5-gd
andphp5-mysql
package)
Installation
- CVS checkout module
proj/dsngui
into a webserver directory - edit properties.php
- access directory from a browser
- REMOVEME: until now you have to create the directory img manually
mkdir img
- REMOVEME: The image creation is a little bit circumstantial, if its not necessary you can disable it by comment out line 117 (
include "showimg.php";
) in index.php
- REMOVEME: until now you have to create the directory img manually
DSN-script
Requirements
- PHP command-line interpreter (included in XAMPP, or on debian:
php5-cli
package)
Installation
- CVS checkout
proj/dsnscript
- edit rpc-config.php
- run scripts with
php <scriptname>
orphp5 <scriptname>
DSN-Server @ tec-pc-btnode
login: | btnode |
server directory: | /var/jaws/dsn_server |
dsn-script directory: | /var/jaws/dsnscript |
dsn-gui directory: | /var/www/localhost/htdocs/dsngui or ~/local_www/dsngui |
starting the server
- start server inside a 'screen':
screen -S dsnserver ant run-server-linux
- if everything looks fine, detach the screen using (CTRL-a CTRL-d)-shortcut, then you should see the following line:
[detached]
stopping the server
- reattach the dsnserver screen with
screen -r <pid>
orscreen -r <pid>.dsnserver
from anywhere (if nobody else has it attached),screen -ls
returns a list with running screens - press (CTRL-c) to stop ant (together with the dsnserver), this step will also terminate the screen and you should see the following line:
[screen is terminating]
restarting the server
- stop and start the server with the above instructions
reconfiguring the server
- edit Server.properties
- restart server
monitoring dsn-gui-node traffic
Requirements
grc
(withpython
)
The server writes the log-file msglog.txt
. For a nice colorized on-the-fly monitoring,
tail -f msglog.txt | grcat grcat.confor offline with search and scrolling:
cat -f msglog.txt | grcat grcat.conf | less -R
Bugs
[java] Exception in thread "Thread-2" java.lang.OutOfMemoryError: Java heap space
[java] java.net.SocketException: Connection reset