|
Eloquence B.08.00 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:
On HP-UX:
/sbin/init.d/eloq8 # start/stop script
/etc/rc.config.d/eloquence8 # startup configuration
On Linux:
/etc/init.d/eloq8 # start/stop script
/etc/sysconfig/eloquence8 # startup configuration
On both platforms:
/opt/eloquence/8.0/ # installation directory
/opt/eloquence/8.0/bin/eloqdb # symbolic link to eloqdb??
/opt/eloquence/8.0/bin/eloqdb32 # 32-bit database server
/opt/eloquence/8.0/bin/eloqdb64 # 64-bit database server
/etc/opt/eloquence/8.0/ # default config directory
/etc/opt/eloquence/8.0/license # B.08.00 license file
/etc/opt/eloquence/8.0/eloqdb.cfg # default db server config
/var/opt/eloquence/8.0/ # e.g. server pid files
The B.08.00 startup script eloq8 uses a different configuration file
from previous versions. A default configuration file is installed on
HP-UX and supported Linux distributions (based on the startup config
file template /opt/eloquence/8.0/newconfig/startup/eloquence.rc).
- On HP-UX, the eloq8 startup config file is /etc/rc.config.d/eloquence8.
- On Linux, the eloq8 startup config file is /etc/sysconfig/eloquence8.
Any customizations from a previous Eloquence version need to be copied
manually. When adjusting the new startup configuration file, notice that
the older Eloquence versions used an ELOQDB6 prefix/suffix for config
options, whereas the new version uses an ELOQDB prefix/suffix now.
The database server program has been renamed to eloqdb32 (the
32-bit version) or eloqdb64 (the 64-bit version), respectively.
This change is transparent when using the eloq8 start script;
the installation creates a symbolic link named eloqdb, pointing
to the default database server program (which is eloqdb32 on
most platforms). You need to manually adjust the symbolic link
(using ln -s) if you prefer to use the 64-bit version.
Note that the choice of the 32-bit or 64-bit database server version
does not depend on whether your client programs are 32-bit or 64-bit
programs (using their respective client libraries). All of the possible
combinations are supported.
You may need to use the 64-bit version if you want to configure the
dedicated Eloquence BufferCache to sizes above 1 GB or configure the
maximum number of concurrent client connections (Threads) to values
above 3000, for example.
The default database server config file has been changed from
eloqdb6.cfg to eloqdb.cfg and it resides in the changed default
directory /etc/opt/eloquence/8.0 -- this change requires manual
adjustments if you update from earlier Eloquence versions and
have used the previous default config file in the past.
The installation of the Eloquence 8 software creates a default
database server config in /etc/opt/eloquence/8.0/eloqdb.cfg that
is based on the template in /opt/eloquence/8.0/newconfig/config.
If you are updating from an earlier Eloquence version and want
to continue using the "default server instance", you need to copy
your customized /etc/opt/eloquence6/eloqdb6.cfg over to the new
/etc/opt/eloquence/8.0/eloqdb.cfg file:
cp /etc/opt/eloquence6/eloqdb6.cfg \
/etc/opt/eloquence/8.0/eloqdb.cfg
If you plan to start the default server with either Eloquence 8
or the prior Eloquence version, for example during an initial
validation phase, then it might be better to use a symbolic link
instead of a copy:
ln -s /etc/opt/eloquence6/eloqdb6.cfg \
/etc/opt/eloquence/8.0/eloqdb.cfg
Without one of the above steps, some of the Eloquence database utilities,
like dbvolcreate, dbvolextend, or dbvoldump, for example, will no longer
work without specifying the path to the config file using the -c command
line option explicitly.
Note that the contents of the eloqdb.cfg file is upward compatible
with the eloqdb6.cfg file from the previous Eloquence version, so 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 following is a brief list of the added or changed options
in the /opt/eloquence/8.0/newconfig/config/eloqdb.cfg template:
- [Server] StatFile, StatFileMode, SessionStatFile, SessionStatMode
- [Config] TransactionSizeLimit
- [Config] IOThreads (unused as of B.08.00)
- [ForwardLog] GroupReadAccess
- [Replication] Role, RedirectWrite, IgnoreWrite, TmpDir
Find details on these options in the description of the Eloquence B.08.00
database server changes.
Note that the GroupReadAccess option in the [ForwardLog] section has
been added because the database server has been changed to create the
forward log files with more restrictive file system permissions, as
they typically contain sensitive data. For security reasons, the new
defaults are more strict than with previous versions, so you may need
to adjust the server configuration and/or the Unix group membership,
if you have users requiring read access to the forward logs.
As Eloquence 8.0 is installed to the new /opt/eloquence/8.0 directory,
it also provides the associated database client libraries there...
On HP-UX:
/opt/eloquence/8.0/lib/pa11_32 # 32-bit PA-RISC 1.1
/opt/eloquence/8.0/lib/pa20_32 # 32-bit PA-RISC 2.0
/opt/eloquence/8.0/lib/pa20_64 # 64-bit PA-RISC 2.0
/opt/eloquence/8.0/lib/hpux32 # 32-bit Itanium (IA-64)
/opt/eloquence/8.0/lib/hpux64 # 64-bit Itanium (IA-64)
On Linux (x86):
/opt/eloquence/8.0/lib # 32-bit
On Linux (x86_64):
/opt/eloquence/8.0/lib # 32-bit
/opt/eloquence/8.0/lib64 # 64-bit
On Linux (IA64):
/opt/eloquence/8.0/lib # 64-bit
/emul/ia32-linux/opt/eloquence/8.0/lib # 32-bit (x86)
It is recommended to compile/link programs and libraries such that
they are enabled for the LD_LIBRARY_PATH and/or SHLIB_PATH
environment variables being used to control the library search path on the
target system. Please refer to the dld.sl(5) man page on HP-UX PA-RISC,
the dld.so(5) man page on HP-UX IA64 and the ld.so(8) man page on Linux.
This is typically the default on HP-UX IA64 and Linux, but may need to
be verified/changed with the chatr utility on HP-UX PA-RISC.
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.00 uses a new installation directory and/or new file names for the software and its
configuration files. This will allow future Eloquence versions to coexist with Eloquence
B.08.00 on the same system:
On 32-bit Windows:
C:\Program Files\Eloquence\8.0 # installation directory
...\Eloquence\8.0\bin\eloqdb32.exe # 32-bit db server
C:\Program Files\Eloquence\8.0\etc # config directory
...\Eloquence\8.0\etc\license # B.08.00 license file
...\Eloquence\8.0\etc\eloqdb.cfg # default db server config
On 64-bit Windows:
C:\Program Files (x86)\Eloquence\8.0 # installation directory
...\Eloquence\8.0\bin\eloqdb32.exe # 32-bit db server
...\Eloquence\8.0\bin\eloqdb64.exe # 64-bit db server
C:\Program Files (x86)\Eloquence\8.0\etc # config directory
...\Eloquence\8.0\etc\license # B.08.00 license file
...\Eloquence\8.0\etc\eloqdb.cfg # default db server config
The 32-bit database server executable is named "eloqdb32.exe"
and (on 64-bit Windows) the 64-bit database server executable
is named "eloqdb64.exe". The database service is named "eloqdb".
Please note that on Windows 64-bit, both the 32-bit database server
(eloqdb32.exe) and the 64-bit database server (eloqdb64.exe) are
installed to the Eloquence bin directory. However, depending on the
selection in the Custom Setup dialog of the installer, either the
eloqdb64.exe or the eloqdb32.exe is used to register the Windows
service(s) for your database server instance(s).
You may later modify this selection by starting the installation program
or using the "Add / Remove Programs" control panel. This will cause your
database server instance(s) to be stopped and restarted with either the
64-bit or the 32-bit database server executable.
Note that the choice of the 32-bit or 64-bit database server version
does not depend on whether your client programs are 32-bit or 64-bit
programs (using their respective client libraries). All of the possible
combinations are supported.
You may need to use the 64-bit version if you want to configure the
dedicated Eloquence BufferCache to sizes above 1 GB or configure the
maximum number of concurrent client connections (Threads) to values
above 3000, for example.
The default database server config file has been changed from
eloqdb6.cfg to eloqdb.cfg and it resides in the changed default
directory C:\Program Files\Eloquence\8.0\etc for 32-bit Windows
or C:\Program Files (x86)\Eloquence\8.0\etc for 64-bit Windows.
These changes are automatically applied by the installer,
if you update from an earlier Eloquence version and have used
the previous default config file in the past.
A new installation of the Eloquence B.08.00 software creates a default
database server config eloqdb.cfg that is based on the template file
eloqdb.sam; both files reside in the Eloquence etc directory:
- 32-bit Windows
- C:\Program Files\Eloquence\8.0\etc\eloqdb.cfg
C:\Program Files\Eloquence\8.0\etc\eloqdb.sam
- 64-bit Windows
- C:\Program Files (x86)\Eloquence\8.0\etc\eloqdb.cfg
C:\Program Files (x86)\Eloquence\8.0\etc\eloqdb.sam
Note that the contents of the eloqdb.cfg file is upward compatible
with the eloqdb6.cfg file from the previous Eloquence version, so 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 following is a brief list of the added or changed options
in the eloqdb.sam template:
- [Server] StatFile, StatFileMode, SessionStatFile, SessionStatMode
- [Config] TransactionSizeLimit
- [Replication] Role, RedirectWrite, IgnoreWrite, TmpDir
Find details on these options in the description of the Eloquence B.08.00
database server changes.
Eloquence B.08.00 is installed to the new Eloquence\8.0 directory
and it also provides the associated database client libraries there.
Eloquence B.08.00 no longer installs product specific libraries to
the C:\Windows\system32 directory.
On 32-bit Windows:
C:\Program Files\Eloquence\8.0\bin\eloqdb32.dll
C:\Program Files\Eloquence\8.0\bin\image3k.dll
C:\Program Files\Eloquence\8.0\bin\image3kC.dll
On 64-bit Windows:
C:\Program Files (x86)\Eloquence\8.0\bin\eloqdb32.dll
C:\Program Files (x86)\Eloquence\8.0\bin\image3k.dll
C:\Program Files (x86)\Eloquence\8.0\bin\image3kC.dll
C:\Program Files (x86)\Eloquence\8.0\bin\eloqdb64.dll
C:\Program Files (x86)\Eloquence\8.0\bin\image3k64.dll
The database client and utility DLLs are installed in the Eloquence bin
directory. In previous Eloquence versions, they were installed in
C:\Windows\System32. As the installation or upgrade process adds the
Eloquence bin directory to the PATH variable, the libraries should
be available to application programs without any manual adjustments.
The related .lib and .def files are installed in the Eloquence lib directory.
|
