2 Installing Eloquence on the HP-UX platform

Configuring the eloqsd server

Eloquence A.06.00 no longer has an eloqd server. Beginning with Eloquence A.06.00, the former eloqd has been renamed to eloqsd. This has been done to retain the interoperability of Eloquence A.06.00 with previous releases on the same system.

The eloqsd server is an important part of Eloquence. It is responsible for the following tasks:

NOTE: The eloqsd server is not related to Eloquence database operation. If the only Eloquence component you intend to use is the database, you don't need to configure and run the eloqsd server.

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:

Configuring the eloqsd TCP service

You may want to define the eloqsd service names in your /etc/services file. This is optional, as you can specify the port number directly in the eloqsd.cfg configuration file.

Please add lines like below to your /etc/services file:

eloqsd     8100/tcp    # Eloquence A.06.00 eloqsd server
the 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.

Configuring the default eloqsd account and group

The eloqsd server requires you to specify an account and group name in the configuration file. Whenever eloqsd is started with root capabilities it will switch to the specified account/group instead. This is required, because for one it is generally not a good idea to run programs with root capabilities unless necessary, on the other hand this is used as the default account and group for users accessing files through the eloqsd or starting a background process.

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. You can configure this with SAM. The account should be marked "disabled" in SAM (which will result in an asterisk in the password) to prevent logins using the eloqsd account.

Configuring the eloqsd server startup

To specify thet the eloqsd server is started at system boot time, set the START_ELOQSD variable to 1 in the Eloquence startup/shutdown configuration file /etc/rc.config.d/eloquence6. Change the line defining the START_ELOQSD variable like this:

START_ELOQSD=1

Configuring the eloqsd server

The eloqsd server is configured by editing the eloqsd.cfg, eloqsd.user and eloqsd.share configuration files. All configuration files provide complete inline documentation and are included at the end of this section for your reference.

The configuration files are located in the /opt/eloquence6/etc directory. Each configuration file is responsible for a specific part of the eloqsd configuration:

eloqsd.cfg
This is used for the general configuration of the server.
eloqsd.user
Eloqsd provides its own user configuration. This makes it possible to define eloqsd users without the need to have a system account for each individual user. Instead eloqsd users are associated with system accounts and groups.
As passwords are defined in this file we consider it good practice to make this file unreadable for regular users. You should chown it to root and chmod id to 400.
eloqsd.share
This configuration file is used to define resources which can be accessed through the eloqsd server.

The eloqsd command line options

The eloqsd server supports the following command line options which can be used to temporarily override configured settings in the eloqsd.cfg configuration file.

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
OptionDescriptionEquiv.*
-c nameSpecifies the configuration file name 
-d flagsSpecifies the server log flags.LogFlags
-l nameSpecifies the server log file.LogFile
-fRun in foreground. This is used for debugging the eloqsd server. 
-s nameThe 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 facilityWhen logging to the syslog daemon, you can define a syslog facility (USER/DAEMON LOCAL0..LOCAL7)SysFacility
-I identWhen logging to the syslog daemon, you can define a syslog identifier. The default is eloqsdSysIdent

*Equivalent configuration file directive.

The eloqsd HTTP status display

When the ServiceHttp is defined in the eloqsd.cfg configuration file, you can use a web browser such as Netscape or Mozilla to view the configuration and state of the eloqsd process in your network.

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.


Eloquence Installation and Configuration - 29 OCT 2004