.
contact contact

B.08.20 / Release Notes / Installation

Eloquence B.08.20 configuration

 
.
 


HP-UX and Linux

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

Startup Configuration

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.

Choosing 32-bit or 64-bit version

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.

Default database server config

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.

Changed client library location

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.


Windows

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

Choosing 32-bit or 64-bit version

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.

Default database server config

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.

Changed client library location

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.


 
 
.
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision:  2011-12-14  
  Copyright © 2011 Marxmeier Software AG