|
Eloquence B.08.40 is fully upwards compatible to previous
Eloquence B.08.30 versions. This document lists the
configuration changes.
Eloquence B.08.40 may be installed in parallel with previous Eloquence
versions. It uses a separate product name and a version specific
installation and configuration directory.
/opt/eloquence/8.4/ # installation directory
/etc/opt/eloquence/8.4/ # config directory
/etc/opt/eloquence/8.4/license # B.08.40 license file
/etc/opt/eloquence/8.4/eloqdb.cfg # default db server config
/var/opt/eloquence/8.4/ # scratch files, e.g. pid files
/var/opt/eloquence/socket # default path AF_Unix sockets
SystemV init scripts:
/sbin/init.d/eloq84 # start/stop script
/etc/rc.config.d/eloquence84 # startup configuration
The B.08.40 startup script eloq84 uses a separate configuration file.
A default configuration file is installed in /etc/rc.config.d/eloquence84.
Any customizations from a previous Eloquence version need to be copied
manually. As Eloquence no longer uses a 32-bit database server
binary on HP-UX any memory window configuration (setmemwindow)
is no longer necessary and should be removed from the startup
configuration file if present.
The new eloqld license server was integrated in the eloq84
start/stop script and the startup configuration file.
By default it is not started.
The Eloquence config files reside in the config directory
/etc/opt/eloquence/8.4. When updating from a previous
Eloquence version, it may be necessary to change references to
previous config files. For example, some data base utilities
may refer to configuration files for additional database instances.
The installation procedure installs default configuation files
in the /etc/opt/eloquence/8.4 directory.
These are based on the templates shipped in the
/opt/eloquence/8.4/newconfig/config directory.
When updating from a previous Eloquence version it is necessary
to either merge any customizations into the new configuration file
or otherwise copy or link the previous config files to the
Eloquence 8.4 config directory.
Typically, configuration files are fully compatible and defaults
are used for any missing config options.
For example
# coming from Eloquence 8.3
cp /etc/opt/eloquence/8.3/eloqdb.cfg \
/etc/opt/eloquence/8.4/eloqdb.cfg
The eloqdb.cfg is used by default by the eloqdb server process
and some database utilities.
If you intend to switch Eloquence versions for a database instance
(for example, during an initial validation phase) you may
consider creating a symbolic link of the configuration file instead
of a copy of the configuration file.
# coming from Eloquence 8.3
ln -sf /etc/opt/eloquence/8.3/eloqdb.cfg \
/etc/opt/eloquence/8.4/eloqdb.cfg
As Eloquence 8.4 is installed to the separate /opt/eloquence/8.4
directory, any libraries are also installed in the new directory tree.
Eloquence ships client libraries for 32 bit and 64 bit applications.
/opt/eloquence/8.4/lib/hpux32 # 32-bit Itanium (IA-64)
/opt/eloquence/8.4/lib/hpux64 # 64-bit Itanium (IA-64)
Please note that PA-RISC libraries (previously installed in the
pa11_32, pa20_32 and pa20_64 directories) are no longer included.
You may need to adjust your Unix logon scripts or application specific
start scripts to export the proper LD_LIBRARY_PATH and/or SHLIB_PATH
for using the appropriate versions of the Eloquence client libraries.
Eloquence B.08.40 may be installed in parallel with previous Eloquence
versions. It uses a separate product name and a version specific installation
and configuration directory.
/opt/eloquence/8.4/ # installation directory
/etc/opt/eloquence/8.4/ # config directory
/etc/opt/eloquence/8.4/license # B.08.40 license file
/etc/opt/eloquence/8.4/eloqdb.cfg # default db server config
/var/opt/eloquence/8.4/ # scratch files, e.g. pid files
/var/opt/eloquence/socket # default path AF_Unix sockets
Systemd:
/etc/default/eloquence/ # override service defaults
[/usr]/lib/systemd/system/ # systemd unit files
Eloquence uses systemd to manage services.
The previous SystemV init scripts are no longer supported.
The new eloqld84.service unit file is used to manage the
eloqld license server.
For details, please refer to the
Eloquence systemd support document.
The Eloquence config files reside in the config directory
/etc/opt/eloquence/8.4. When updating from a previous
Eloquence version, it may be necessary to change references to
previous config files. For example, some data base utilities
may refer to configuration files for additional database instances.
The installation procedure installs default configuation files
in the /etc/opt/eloquence/8.4 directory.
These are based on the templates shipped in the
/opt/eloquence/8.4/newconfig/config directory.
When updating from a previous Eloquence version it is necessary
to either merge any customizations into the new configuration file
or otherwise copy or link the previous config files to the
Eloquence 8.4 config directory.
Typically, configuration files are fully compatible and defaults
are used for any missing config options.
For example
# coming from Eloquence 8.3
cp /etc/opt/eloquence/8.3/eloqdb.cfg \
/etc/opt/eloquence/8.4/eloqdb.cfg
The eloqdb.cfg is used by default by the eloqdb server process
and some database utilities.
If you intend to switch Eloquence versions for a database instance
(for example, during an initial validation phase) you may
consider creating a symbolic link of the configuration file instead
of a copy of the configuration file.
# coming from Eloquence 8.3
ln -sf /etc/opt/eloquence/8.3/eloqdb.cfg \
/etc/opt/eloquence/8.4/eloqdb.cfg
As Eloquence 8.4 is installed to the separate /opt/eloquence/8.4
directory, any libraries are also installed in the new directory tree.
Eloquence ships client libraries for 32 bit and 64 bit applications.
/opt/eloquence/8.4/lib # 32-bit
/opt/eloquence/8.4/lib64 # 64-bit
For Linux platforms other then x86_64 (x64) the lib64
directory is not available and library files are located
in the lib directory.
You may need to adjust your Unix logon scripts or application specific
start scripts to export the proper LD_LIBRARY_PATH
for using the appropriate versions of the Eloquence client libraries.
Eloquence B.08.40 may be installed in parallel with previous Eloquence versions.
It uses a new installation directory and/or new file names for the software and its
configuration files.
C:\Program Files\Eloquence\8.4 # installation directory
...\Eloquence\8.4\bin # 64-bit binaries
...\Eloquence\8.4\bin\eloqdb64.exe # database server
...\Eloquence\8.4\x86 # 32-bit libraries (optional)
C:\Program Files\Eloquence\8.4\etc # config directory
...\Eloquence\8.4\etc\license # B.08.40 license file
...\Eloquence\8.4\etc\eloqdb.cfg # default db server config
All files in the bin directory are 64-bit.
Some executables, such as eloqdb64.exe, use a "64" designation to retain
the naming convention of previous Eloquence versions.
Others, such as eloqld and eloqds, do not but are 64-bit nevertheless.
If selected for installation, 32-bit Windows files are installed
in the x86 subdirectory to support 32-bit applications.
Note that the the 64-bit database server is compatible with both 64-bit
and 32-bit client applications (using the respective client libraries).
The database server default config file name is:
C:\Program Files\Eloquence\8.4\etc\eloqdb.cfg
When updating from a previous Eloquence version, the previous database
server default config file is migrated to Eloquence B.08.40 unless the
"Migrate previous Eloquence" installation feature is deselected.
A new installation creates the database server default config file from
the eloqdb.cfg template located in the newconfig\config subdirectory:
C:\Program Files\Eloquence\8.4\etc\eloqdb.cfg
C:\Program Files\Eloquence\8.4\newconfig\config\eloqdb.cfg
Note that the contents of the eloqdb.cfg file are upwards compatible
with older Eloquence versions. You don't have to make manual adjustments
unless you want to make use of the new or enhanced configuration options.
The database server assumes default values for missing settings.
The database client libraries are installed below the Eloquence B.08.40
installation directory.
64-bit libraries:
C:\Program Files\Eloquence\8.4\bin\eloqdb64.dll
C:\Program Files\Eloquence\8.4\bin\image3k64.dll
C:\Program Files\Eloquence\8.4\bin\ftc64.dll
32-bit libraries (optional)
C:\Program Files\Eloquence\8.4\x86\bin\eloqdb32.dll
C:\Program Files\Eloquence\8.4\x86\bin\image3k.dll
C:\Program Files\Eloquence\8.4\x86\bin\image3kC.dll
C:\Program Files\Eloquence\8.4\x86\bin\ftc.dll
The database client and utility DLLs are installed in the Eloquence bin,
and optionally the x86\bin, subdirectories.
Existing applications should find the libraries because the installation
program adds the bin and x86\bin subdirectories to the
PATH environment.
The related .lib and .def files are installed in the Eloquence lib and
x86/lib subdirectories.
Multiple database server instances may be registered as separate
Windows services, each with its own Windows service name.
To set up a database server instance, an instance-specific configuration
file is typically derived from the newconfig\config\eloqdb.cfg
default configuration template, then this file
is specified with the Windows service registration.
For example, to set up a 64-bit eloqdb instance named "eloqdb-test"
using the configuration file "C:\data\db\conf\eloqdb-test.cfg":
eloqdb64 -install:eloqdb-test -c C:\data\db\conf\eloqdb-test.cfg
Any additional command line options (here: the -c option to specify the
location of an instance-specific configuration file) are saved and will
implicitly be used whenever the instance is started:
net start eloqdb-test
Please note:
After a database server instance has been registered, the Windows Service
Manager may be used to configure it to start/stop automatically when the
system is started or shut down, and, if desired, to use an account
different from SYSTEM.
The Windows Service Manager may then be used to start/stop the instance.
Alternatively, the net start/stop command line may be used:
net start instance_name
net stop instance_name
To remove an instance from the Windows Service Manager:
eloqdb64 -remove:instance_name
|
