4 Installing Eloquence on the Linux platform
Eloquence implements some limited file sharing capabilities for the new graphical development environment through the eloqsd server. This makes it independent of the availability of specific network file systems (NFS/ SMB) and overcomes inappropriate limitations.
Running an eloqsd server on your system is not mandantory unless you are using eloq (providing virtual terminal capabilities). However, when no eloqsd process is active, TASKID values are no longer unique and are set to 1 by default.
In order to run the eloqsd server it is required to adapt your system configuration. This involves the following steps:
Please add lines like below to your /etc/services file:
eloqsd 8100/tcp # Eloquence A.06.00 eloqsd serverthe first column specifies the service name (eg. eloqsd) and the second column the associated port number and protocol (eg. 8100/tcp). The selected port numbers may not already be in use by another programs.
NOTE: All systems must use the same port numbers in order to communicate.
While you can specify any user or group account in the configuration file, we recommend to create a specific user account and group for Eloquence which is used by the eloqsd server.
We recommend to create the user account eloqsd and the group eloqsd which should have the account eloqsd as a member. The account should be marked "disabled" (by putting an asterisk into the password field of the /etc/passwd file) to prevent logins using the eloqsd account.
START_ELOQSD=1NOTE: The /etc/sysconfig/eloquence6 location of the startup/shutdown configuration file applies to recent LSB compliant Linux distributions. Older distributions such as SuSE Linux 7.3 and before use the /etc/rc.config.d/eloquence6 location instead.
The configuration files are located in the /opt/eloquence6/etc directory. Each configuration file is responsible for a specific part of the eloqsd configuration:
usage: eloqsd [options] options: -help = show usage (this list) -c name = configuration file -d flags = debug mode -l name = log file name (or console/syslog/default) -f = run in foreground -s name = service name (tcp/ip transport) -F facility = syslog facility (USER/DAEMON/LOCAL0..LOCAL7) -I ident = syslog identifier
|-c name||Specifies the configuration file name|
|-d flags||Specifies the server log flags.||LogFlags|
|-l name||Specifies the server log file.||LogFile|
|-f||Run in foreground. This is used for debugging the eloqsd server.|
|-s name||The service name (as defined in /etc/services) or the port number where the server should listen for requests. The default value is eloqdb6.||Service|
|-F facility||When logging to the syslog daemon, you can define a syslog facility (USER/DAEMON LOCAL0..LOCAL7)||SysFacility|
|-I ident||When logging to the syslog daemon, you can define a syslog identifier. The default is eloqsd||SysIdent|
*Equivalent configuration file directive.
To access the eloqsd server, you need to provide an URL like below:
http://server:port/where server is the host name or IP number of the system running the eloqsd server and port is the port number used for ServiceHttp in the eloqsd.cfg file.