2 Installing Eloquence on the HP-UX platform
Configuring the eloqdb5 server
The eloqdb5 server provides access to former A.05.xx data bases for Eloquence A.06.00. The Eloquence A.05.xx eloqnd server is no longer used with Eloquence A.06.xx. The eloqdb5 server is only available on HP-UX.
In order to run the eloqdb5 server it is required to adapt your system configuration. This involves the following steps:
- Configuring the eloqdb5 TCP service
- Configuring the default eloq account and group
- Configuring the eloqdb5 server startup
- Configuring the eloqdb5 server
NOTE: The eloqdb5 server requires that the Eloquence revision A.05.xx is installed and the eloqd is running. Otherwise it will start but refuse to accept a client connection.
eloqdb5 is different from the eloqnd included with Eloquence A.05.xx.
Configuring the eloqdb5 TCP service
It is recommended, that you define the eloqdb5 service name in your /etc/services file as this will enable database clients to use a symbolic name instead of a port number when specifying a database. However is optional, as you can specify the port number directly in the eloqsd.cfg configuration file.
Please add a line like below to your /etc/services file:
eloqdb5 8104/tcp # Eloquence A.06.00 eloqdb5 server
the first column specifies the service name (eg. eloqdb5) and the second column the associated port number and protocol (eg. 8104/tcp). The selected port numbers may not already be in use by another programs.
NOTE: All systems must use the same port numbers for the same service in order to communicate.
You can have more than one instance of the eloqdb5 server running on a single system, however they must use different services/port numbers.
Configuring the default eloq account and group
The eloqdb5 server requires you to specify an account and group name in the configuration file. Whenever it 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 and on the other hand to overcome the special handling for the root user in the A.05.xx data base.
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 eloqdb5 server.
We recommend to create the user account eloq and the group eloq which should have the account eloq 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 eloq account.
Configuring the eloqdb5 server startup
This is different bewteen the HP-UX 9.x and 10.x operating system:
- On HP-UX 9.x you can start the eloqdb5 server from your /etc/rc startup configuration file. This is executed whenever the operating system is entering the run level 2.
Add a line like below to your /etc/rc configuration script:
# Start Eloquence eloqdb5 server
/opt/eloquence6/bin/eloqdb5
- With HP-UX 10.x, all you need is to set the START_ELOQDB5 variable to one in the Eloquence A.06.00 startup/shutdown configuration file.
Change the line defining the START_ELOQDB5 variable in the file /etc/rc.config.d/eloquence6 like below:
START_ELOQDB5=1
Configuring the eloqdb5 server
The eloqdb5 server is configured by editing the eloqdb5.cfg configuration file. It is located in the Eloquence configuration directory. The eloqdb5.cfg configuration file provides complete inline documentation. The default configuration file is included at the end of this section for your reference.
The Eloquence configuration directory depends on your operating system:
- HP-UX 10.x
- /opt/eloquence6/etc
- HP-UX 9.x
- /etc/opt/eloquence6
The eloqdb5 command line options
The eloqdb5 server supports the following command line options which can be used to temporarily override configured settings in the configuration file.
usage: eloqdb5 [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
| Option | Description | Equiv.* |
| -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 eloqdb6 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 syslog identifier. The default is eloqdb5 | SysIdent |
*Equivalent configuration file directive.
Eloquence Installation and Configuration - 19 DEC 2002