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).

Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r2 - 2012-09-12 - unknown
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TOTEM All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright &© 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback