.
contact contact

B.08.40 / Release Notes / Installation

Eloquence B.08.40 configuration

 
.
 

Eloquence B.08.40 is fully upwards compatible to previous Eloquence B.08.30 versions. This document lists the configuration changes.


HP-UX

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

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.

Default database server config

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

Changed client library location

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.


Linux

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

Startup configuration using systemd

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.

Default database server config

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

Changed client library location

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.


Windows

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).

Default database server config

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.

Changed client library location

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.

Using multiple database server instances

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:

  • Use a Windows Administrator Command Prompt to execute these commands, i.e., choose "Run as administrator" from the Command Prompt context menu.

  • The installation program registers a default instance named "eloqdb".

  • If multiple Eloquence versions are installed on the same system, the PATH environment variable defines which version is used by default. The command below outputs the default eloqdb64 version:
    eloqdb64 -version
    
    If this is not the desired version to use for an instance, the absolute eloqdb executable path needs to be specified, such as:
    "C:\Program Files\Eloquence\8.4\bin64\eloqdb64" -install ...
    

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


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2024-05-28  
  Copyright © 1995-2024 Marxmeier Software AG