|
Eloquence B.08.20 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/eloq82 # start/stop script
/etc/rc.config.d/eloquence82 # startup configuration
On Linux:
/etc/init.d/eloq82 # start/stop script
/etc/sysconfig/eloquence82 # startup configuration
On both platforms:
/opt/eloquence/8.2/ # installation directory
/opt/eloquence/8.2/bin/eloqdb # symbolic link to eloqdb??
/opt/eloquence/8.2/bin/eloqdb32 # 32-bit database server
/opt/eloquence/8.2/bin/eloqdb64 # 64-bit database server
/etc/opt/eloquence/8.2/ # default config directory
/etc/opt/eloquence/8.2/license # B.08.10 license file
/etc/opt/eloquence/8.2/eloqdb.cfg # default db server config
/var/opt/eloquence/8.2/ # e.g. server pid files
The B.08.20 startup script eloq82 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.2/newconfig/startup/eloquence.rc).
- On HP-UX, the eloq82 startup config file is /etc/rc.config.d/eloquence82.
- On Linux, the eloq82 startup config file is /etc/sysconfig/eloquence82.
Any customizations from a previous Eloquence version need to be copied
manually. When adjusting the new startup configuration file, notice that
older Eloquence versions before B.08.00 used an ELOQDB6 prefix/suffix for
config options, whereas versions since B.08.00 use an ELOQDB prefix/suffix now.
Beginning with Eloquence 8.0
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 eloq82 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 name has been changed to eloqdb.cfg and it resides in the changed default
directory /etc/opt/eloquence/8.2 -- 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.2 software creates a default
database server config in /etc/opt/eloquence/8.2/eloqdb.cfg that
is based on the template in /opt/eloquence/8.2/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
or /etc/opt/eloquence/8.1/eloqdb.cfg file over to the new
/etc/opt/eloquence/8.2/eloqdb.cfg file:
# coming from Eloquence 7.10 ...
cp /etc/opt/eloquence6/eloqdb6.cfg \
/etc/opt/eloquence/8.2/eloqdb.cfg
# coming from Eloquence 8.0 or 8.1 ...
cp /etc/opt/eloquence/8.1/eloqdb.cfg \
/etc/opt/eloquence/8.2/eloqdb.cfg
If you plan to start the default server with either Eloquence 8.2
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:
# coming from Eloquence 7.10 ...
ln -s /etc/opt/eloquence6/eloqdb6.cfg \
/etc/opt/eloquence/8.2/eloqdb.cfg
# coming from Eloquence 8.0 or 8.1 ...
ln -s /etc/opt/eloquence/8.1/eloqdb.cfg \
/etc/opt/eloquence/8.2/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 older Eloquence versions, 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.
As Eloquence 8.2 is installed to the new /opt/eloquence/8.2 directory,
it also provides the associated database client libraries there...
On HP-UX:
/opt/eloquence/8.2/lib/pa11_32 # 32-bit PA-RISC 1.1
/opt/eloquence/8.2/lib/pa20_32 # 32-bit PA-RISC 2.0
/opt/eloquence/8.2/lib/pa20_64 # 64-bit PA-RISC 2.0
/opt/eloquence/8.2/lib/hpux32 # 32-bit Itanium (IA-64)
/opt/eloquence/8.2/lib/hpux64 # 64-bit Itanium (IA-64)
On Linux (x86):
/opt/eloquence/8.2/lib # 32-bit
On Linux (x86_64):
/opt/eloquence/8.2/lib # 32-bit
/opt/eloquence/8.2/lib64 # 64-bit
On Linux (IA64):
/opt/eloquence/8.2/lib # 64-bit
/emul/ia32-linux/opt/eloquence/8.2/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.20 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 32-bit Windows:
C:\Program Files\Eloquence\8.2 # installation directory
...\Eloquence\8.2\bin\eloqdb32.exe # 32-bit db server
C:\Program Files\Eloquence\8.2\etc # config directory
...\Eloquence\8.2\etc\license # B.08.20 license file
...\Eloquence\8.2\etc\eloqdb.cfg # default db server config
On 64-bit Windows:
C:\Program Files (x86)\Eloquence\8.2 # installation directory
...\Eloquence\8.2\bin\eloqdb32.exe # 32-bit db server
...\Eloquence\8.2\bin\eloqdb64.exe # 64-bit db server
C:\Program Files (x86)\Eloquence\8.2\etc # config directory
...\Eloquence\8.2\etc\license # B.08.20 license file
...\Eloquence\8.2\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.
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 name has been changed to eloqdb.cfg and it resides in the changed default
directory C:\Program Files\Eloquence\8.2\etc for 32-bit Windows
or C:\Program Files (x86)\Eloquence\8.2\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.20 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.2\etc\eloqdb.cfg
C:\Program Files\Eloquence\8.2\etc\eloqdb.sam
- 64-bit Windows
- C:\Program Files (x86)\Eloquence\8.2\etc\eloqdb.cfg
C:\Program Files (x86)\Eloquence\8.2\etc\eloqdb.sam
Note that the contents of the eloqdb.cfg file is upward compatible
with the eloqdb6.cfg file from older Eloquence versions, 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.
Eloquence B.08.20 is installed to the new Eloquence\8.2 directory
and it also provides the associated database client libraries there.
Eloquence B.08.20 no longer installs product specific libraries to
the C:\Windows\system32 directory.
On 32-bit Windows:
C:\Program Files\Eloquence\8.2\bin\eloqdb32.dll
C:\Program Files\Eloquence\8.2\bin\image3k.dll
C:\Program Files\Eloquence\8.2\bin\image3kC.dll
On 64-bit Windows:
C:\Program Files (x86)\Eloquence\8.2\bin\eloqdb32.dll
C:\Program Files (x86)\Eloquence\8.2\bin\image3k.dll
C:\Program Files (x86)\Eloquence\8.2\bin\image3kC.dll
C:\Program Files (x86)\Eloquence\8.2\bin\eloqdb64.dll
C:\Program Files (x86)\Eloquence\8.2\bin\image3k64.dll
The database client and utility DLLs are installed in the Eloquence bin
directory. In Eloquence B.07.10 or older 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.
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
|
