2 Installing Eloquence on the HP-UX platform
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.
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
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
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
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]=testThis example configuration file specifies to not start the eloqsd service and defines two eloqdb6 instances, prod and test.
# @(#) 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]=""