2 Installing Eloquence on the HP-UX platform

Eloquence startup/shutdown script

Manually starting and stopping the server processes

The Eloquence startup script may be used to manually start/stop/restart server processes or verify a server process is active.

Please note that using the startup/shutdown script to control server processes need root capabilities. Status inquiries do not require root capabilities.

The Eloquence startup/shutdown script supports the following options:

start [arg list ...]

Start the configured Eloquence services. If the optional argument list is not provided, all configured Eloquence services (or database server instances) are started. If the argument list is present, only the specified services (or instances) are started.

Please note: A database server instance is not be started automatically if the ELOQDB6_START[0] configuration option is set to 0.

stop [arg list ...]

Stop the configured Eloquence services. If the optional argument list is not provided, all configured Eloquence services (or instances) are stopped. If the argument list is present, only the specified services (or instances) are stopped.

Please note that the Eloquence start/stop script only manages configured services. Previous versions of the shutdown script stopped unconfigured Eloquence services as well.

restart [arg list ...]

Restart the configured Eloquence services. If the optional argument list is not provided, all configured Eloquence services (or instances) are restarted.

status [arg list ...]

Display the status of Eloquence services. If the optional argument list is not provided, all configured Eloquence services (or instances) are returned.

info [arg list ...]

Display the startup configuration of Eloquence services. If the optional argument list is not provided, the configuration of all Eloquence services (or instances) is returned.

An optional argument list may be used to specify which Eloquence service(s) should be managed. An argument specifies either an Eloquence service or a database instance which is configued in the startup configuration file.

eloqsd
Specfies the Eloquence eloqsd service
eloqdb6
Specfies all configured Eloquence eloqdb6 instances
For example:

Start all configured services
# /sbin/init.d/eloq6 start
Restart eloqsd service
# /sbin/init.d/eloq6 restart eloqsd
Stop all configured eloqdb6 instances
# /sbin/init.d/eloq6 stop eloqdb6
Start eloqdb6 instances prod and test
# /sbin/init.d/eloq6 start prod test
# /sbin/init.d/eloq6 start
Starting eloqsd daemon                            [OK]
Starting eloqdb6[eloqdb] daemon                   [OK]
# /sbin/init.d/eloq6 status
eloqsd process is active (pid 16645)              [running]
eloqdb6[eloqdb] process is active (pid 16652)     [running]
# /sbin/init.d/eloq6 info eloqdb
 eloqdb6 instance id = eloqdb
  configuration file = /etc/opt/eloquence6/eloqdb6.cfg
  service = eloqdb
  args = 
  run prefix = 
  automatic start = 1

Location of the Eloquence startup/shutdown script

The location of the Eloquence startup/shutdown script depends on the operating system:

HP-UX

/sbin/init.d/eloq6

SuSE Linux

/etc/init.d/eloq6 (SuSE Linux 7.1 and above)
/sbin/init.d/eloq6 (SuSE Linux before 7.1)

Red Hat Linux

/etc/init.d/eloq6
or /etc/rc.d/init.d/eloq6

LSB compliant Linux

/etc/init.d/eloq6

Location of the Eloquence startup/shutdown configuration file

The Eloquence startup/shutdown script uses a new configuration template file. It is backwards compatible to previous Eloquence versions. The location of the startup configuration file depends on the operating system:

HP-UX

/etc/rc.config.d/eloquence6

SuSE Linux

/etc/sysconfig/eloquence6 (SuSE 8.0 Linux and above)
/etc/rc.config.d/eloquence6 (SuSE Linux 7.3 and before)

Red Hat Linux

/etc/sysconfig/eloquence6

LSB compliant Linux

/etc/sysconfig/eloquence6

During the update from a previous Eloquence installation a previous configuration file is moved to the new location. However, we recommend to start with the configuration template file if updating from a previous HP Eloquence version.

The example command shown below is specific to HP-UX, please change the target location depending on the operating system.

   cp /opt/eloquence6/newconfig/startup/eloquence.rc \
      /etc/rc.config.d/eloquence6

Eloquence startup/shutdown configuration options

The Eloquence startup/shutdown configuration file specifies the operation of the startup/shutdown script. The following global configuration options are available:

START_ELOQ

If START_ELOQ is set to anything besides 1 it disables the automatic Eloquence startup entirely. To retain compatibility to previous Eloquence releases on Linux "yes" is accepted as well. The default is START_ELOQ=1

START_ELOQSD

If START_ELOQSD is set to 1 the eloqsd daemon is started automatically. The default is START_ELOQSD=1

ELOQSD_ARGS

The ELOQSD_ARGS allows specifying eloqsd command line arguments. The default is ELOQSD_ARGS=""

ELOQSD_RUNPFX

The ELOQSD_RUNPFX variable allows specifying a command which is then expected to start eloqsd. The default is ELOQSD_RUNPFX=""

For example:
ELOQSD_RUNPFX="/usr/bin/nice -n10" starts eloqsd with a nice value of 10.

START_ELOQDB6

If START_ELOQDB6 is set to 1 then the eloqdb6 daemon is started automatically. The default is START_ELOQDB6=1

ELOQDB6_DEFAULT_ARGS

The ELOQDB6_DEFAULT_ARGS specifies the default command line arguments which are used with all eloqdb6 instances unless defined specifically. The default is ELOQDB6_DEFAULT_ARGS=""

The Eloquence startup/shutdown configuration file may be used to configure multiple eloqdb6 instances.

Unless specified here, the Eloquence startup/shutdown script only supports the default database server instance. This section allows specifying database server instances which are to be maintained by the eloquence startup script. Each database server instance must be specified with a distinct index, starting with the index 0.

The following options may be specified for each eloqdb6 instance:

ELOQDB6_CFG[0]

This option specifies the configuratin file which is used with this database server instance (required). This file can be specified with an absolute path or relative to the directory /etc/opt/eloquence6
The default is ELOQDB6_CFG[0]=eloqdb6.cfg

ELOQDB6_ID[0]

This configuration option may be used to specify a symbolic name to the database server instance (optional). If not specified, this defaults to the service name or port number, specified in the config file or "eloqdb". The instance id may be used as an optional argument with the Eloquence startup/shutdown script to specify a database server instance.

ELOQDB6_START[0]

This configuration option may be used to specify if the Eloquence startup script should start this service automatically. If set to 1, the database server instance is started automatically. If set to 0, the startup script will ignore this entry for the start and restart option and the database server instance must be managed manually by providing the instance id name on the script command line.
The default is ELOQDB6_START[0]=1

ELOQDB6_ARGS[0]

The ELOQDB6_ARGS[0] option may be used to specify eloqdb6 command line arguments for this database instance. If not specified this defaults to ELOQDB6_DEFAULT_ARGS.

ELOQDB6_RUNPFX[0]

This configuration option may be used to specify a command which is then expected to start eloqdb6. The default is ELOQDB6_RUNPFX[0]=""

For example:
ELOQDB6_RUNPFX[0]="/usr/bin/setmemwindow" starts the eloqdb6 process in a separate memory window.

For example:

START_ELOQSD=0
ELOQDB6_CFG[0]=eloqdb6_prod.cfg
ELOQDB6_START[0]=1
ELOQDB6_ID[0]=prod
ELOQDB6_CFG[1]=eloqdb6_test.cfg
ELOQDB6_START[0]=1
ELOQDB6_ID[0]=test
This example configuration file specifies to not start the eloqsd service and defines two eloqdb6 instances, prod and test.

Eloquence startup/shutdown configuration file template

# @(#) eloquence.rc - B.07.00
# Eloquence automatic startup configuration
#
# Eloquence startup confguration file. 
# This file is sourced by the startup/shutdown script.
#
# The location of this file depends on the operating system:
# HP-UX: /etc/rc.config.d/eloquence
# RedHat Linux, SuSE Linux 8.0+: /etc/sysconfig/eloquence
# SuSE Linux 7.0 to 7.3 /etc/rc.config.d/eloquence

### global settings

# If START_ELOQ is set to anything besides 1 it disables the 
# automatic Eloquence startup entirely. To retain compatibility
# to previous Eloquence releases on Linux "yes" is accepted 
# as well.
#START_ELOQ=1

# If START_ELOQSD is set to 1 the eloqsd daemon is started
# automatically. The ELOQSD_ARGS allows specifying eloqsd command 
# line arguments. The ELOQSD_RUNPFX variable allows specifying
# a command which is then expected to start eloqsd (e.g. nice).
#START_ELOQSD=1
#ELOQSD_ARGS=""
#ELOQSD_RUNPFX=""

# If START_ELOQDB6 is set to 1 then the eloqdb6 daemon is started
# automatically. The ELOQDB6_DEFAULT_ARGS specifies the default 
# command line arguments, which are used with all eloqdb6
# instances unless defined specifically.
#START_ELOQDB6=1
#ELOQDB6_DEFAULT_ARGS=""

### eloqdb6 instances ###

# Unless specified here, the Eloquence startup/shutdown script
# only supports the default database server instance. This 
# section allows to specify database server instances which are
# to be maintained by the eloquence startup script.
# Each database server instance must be specified with a distinct
# index, starting with the index 0.
#
# ELOQDB6_CFG[0] = 
#  Configuration file used with this database instance (required). 
#  This can be an absolute path or relative to /etc/opt/eloquence6
#
# ELOQDB6_ID[0] = 
#  The instance id is used to specify an alias to a eloqdb6 instance
#  (optional). If not specified, this defaults to the service name 
#  or port number, specified in the config file (defaults to eloqdb).
#  The instance id may be used as a startup script argument to
#  specify a database server instance.
#
# ELOQDB6_ARGS[0]=""
#  Command line arguments for this instance (optional). If not
#  specified (eg. commented out), the ELOQDB6_DEFAULT_ARGS is used.
#
# ELOQDB6_START[0]={0|1}
#  Specifies if the Eloquence startup/shutdown script should make
#  use of this entry (optional). This setting defaults to 1 which
#  specifies a database instance is used with the startup script.
#  If set to 0, the startup script will ignore this entry for the
#  start and restart option.
#
# ELOQDB6_RUNPFX[0]=""
#  Allows to define a command which is then expected to start
#  the eloqdb6 instance (e.g. nice). On HP-UX this may be used
#  to define a memory window used by the database server instance.
#
#ELOQDB6_CFG[0]=eloqdb6.cfg
#ELOQDB6_START[0]=1
#ELOQDB6_ARGS[0]=""
#ELOQDB6_ID[0]=""
#ELOQDB6_RUNPFX[0]=""

Eloquence Installation and Configuration - 29 OCT 2004