Managing Tudas Server
Tudas server is build on Zeroc Ice technology. We provide two ways of running server application:
- as stand-alone process (i. e. for testing purposes on local machine)
- as Unix daemon, using jsvc (for final release and deployement on remote machine)
In this section we describe process of building, running and deploying Tudas server taking into account both approaches.
Running Tudas server locally
Assuming that you have properly installed and configured Tudas project in Eclipse IDE, there is no additional building configuration required. To run server on your local host, simply:
1. Change your
communication.configuration.url in
tudas.config to file:/PATH_TO_TUDAS_DIRECTORY/Tudas/config/ice/config_local.client.
2. Run
ch.cern.totem.tudas.server.ServerProcess class in Eclipse.
Running Tudas server on pctotem34
You can easly manage Tudas server remotely, using SSH:
1. Connect to
pctotem34.cern.ch by SSH and log in as root (if you're outside CERN, remember about
port forwarding).
2. Open tudas server directory:
cd servers/tudas
- Here you've got all server files, including configuration and running scripts:
File/directory |
Description |
How to use it? |
tudas_start |
script starting Tudas server daemon |
invoke command: ./tudas_start |
tudas_stop |
script stoping Tudas server daemon |
invoke command: ./tudas_stop |
tudas.conf |
server configuration properties file |
open with text editor and edit properties (all settings are described below) |
log |
logger directory. It contains server logs |
open log/server.log to see logs |
server-x.x.x.jar |
current version of Tudas server library |
- |
- You can change properties in tudas.conf file:
Property name |
description |
ServerLibrary |
location of server library jar file |
ServerClass |
class which should be invoked as server daemon |
DaemonName |
the name of daemon process |
PidFile |
path to file storing PID of daemon process (jsvc needs this information to stop daemon) |
- Web content of Tudas server, including Ice configuration for clients is stored in /var/www/html/tudas. If you want to share something that can be downloaded by anyone (especially, by client-side applications), just put it into that location.
Deploying Tudas server
When you provide new version of Tudas, often there is a need to build and deploy new Tudas server library. With our Maven configuration, building process is quick and simple:
1. Open you main Tudas project directory.
2. Invoke maven command:
mvn package
3. When Maven build is ready, a new
server/target/server-x-x-x.jar file is created. You have to replace old file on pctotem34 (for example by using
scp or
WinScp). Remember that old server should be stopped before replacing operation (just invoke script
./tudas_stop as described above).
Topic revision: r2 - 2012-09-12
- unknown