Index of download.marxmeier.com/eloq/B0700/win32/

Parent Directory
README 2003-08-28 14:13 17.8 KiB
eq70_01.cab 2003-03-21 20:15 779.3 KiB
eq70_02.cab 2003-03-21 20:15 1.4 MiB
eq70_03.cab 2003-03-21 20:15 2.4 MiB
eq70_04.cab 2003-03-21 20:15 1.3 MiB
eq70_05.cab 2003-03-21 20:15 624.8 KiB
eq70_06.cab 2003-03-21 20:15 1.8 MiB
eq70_07.cab 2003-03-21 20:15 627.3 KiB
eq70_08.cab 2003-03-21 20:15 982 KiB
eq70_09.cab 2003-03-21 20:15 1.8 MiB
eq70_all_cab.zip 2003-08-28 14:12 11.3 MiB
eq70_win2k.exe 2003-03-21 20:15 482.3 KiB
eq70_win9x.exe 2003-03-21 20:15 1.9 MiB
eq70_winnt.exe 2003-03-21 20:15 1.9 MiB
readme.txt 2003-08-28 14:13 17.8 KiB
Eloquence B.07.00 - Windows Installation Instructions
Revision: 2003-08-28
=====================================================

This directory holds the release of the Eloquence B.07.00 distribution
for the 32bit Windows platform.

This installation program is based on the Microsoft Windows Installer
and thus complies to the Microsoft Windows XP and 2000 requirements.

Supported platforms: Windows XP, 2000, NT 4, ME, 98 and 95


*************************************************************************
* Please note if you already have Eloquence installed                   *
* ---------------------------------------------------                   *
*                                                                       *
* The Eloquence B.07.00 installation program will automatically detect  *
* and uninstall any existing Eloquence software.                        *
*                                                                       *
* Your existing configuration files will be preserved.                  *
*                                                                       *
* It is not necessary and also not recommended to manually uninstall    *
* your existing Eloquence software.                                     *
*                                                                       *
* By default Eloquence B.07.00 uses an installation directory different *
* from older Eloquence versions up to A.06.31. The installation program *
* will automatically migrate your existing configuration files to the   *
* new installation directory.                                           *
*                                                                       *
* If you however have Eloquence B.06.32 or above installed the new      *
* version will be installed into the existing installation directory by *
* default.                                                              *
*                                                                       *
* Please read the section about updating your Eloquence software below. *
*************************************************************************


Installation instructions
-------------------------

1) Download the appropriate setup executable depending on your operating
   system:

   eq70_win2k.exe - for the Windows XP or 2000 platforms
                    or if the Microsoft Windows Installer engine is already
                    present on your Windows NT, ME, 98 or 95 system

   eq70_winnt.exe - for the Windows NT platform
   eq70_win9x.exe - for the Windows ME, 98 and 95 platforms

   Unless you plan to install HP Eloquence B.07.00 on several machines
   and different platforms you need only one of these three files.

   The setup executables for Windows NT, ME, 98 and 95 are about 1.4 MB
   bigger than the one for Windows XP and 2000 because they additionally
   include the Microsoft Windows Installer 1.2 engine which is a Windows
   XP and 2000 system component.

   If the Microsoft Windows Installer engine is already present on your
   Windows NT, ME, 98 or 95 system it is sufficient to download the rather
   small eq70_win2k.exe (use Start Menu -> Find -> Files or Folders to
   look for a file named msiexec.exe - if it exists the Microsoft Windows
   Installer engine is already present).

   IMPORTANT NOTE: This is a download installation. It requires write
   permissions in the current directory where the eq70_*.exe setup
   executable is located along with the downloaded archives. If you intend
   to use the downloaded files on a CD or DVD you first have to unpack the
   self extracting eq70_*.exe setup executable. It will extract the files
   setup.exe, eq70.msi and some .ini files. Afterwards, the setup.exe will
   be started which you can immediately cancel. Then copy the extracted
   files, not the eq70_*.exe setup executable, to your CD or DVD.

2) The Eloquence components are divided into separate file archives by
   category. Depending on your requirements you might not need all of them.
   The installation detects which archives were downloaded (they must be
   located along with the setup executable in the same directory) and lets
   you choose among them which components are to be installed.

   Due to a limitation in the Microsoft Windows Installer implementation
   the archives have short DOS 8.3 file names. The suggested long names
   are indicated in addition.

   Just download all the components you need.

   Note: The eq70_all_cab.zip archive is provided for convenience and
   contains all components. After downloading, please extract its contents
   into the same directory where the setup executable is located.

   These are the various components and what they contain:

   eq70_01.cab (long name: eq70_client_gui.cab)
     - contains the runsrv32 and dlgsrv32 graphical user interface
       components necessary to execute any local or remote GUI-enabled
       Eloquence program. Such a program can conveniently be started
       with either the eqstart or eqexec32 utilities which are both
       included as well. This is the minimum client installation.

   eq70_02.cab (long name: eq70_client_runtime.cab)
     - contains the eloqcore program which enables you to locally execute
       Eloquence programs. Additionally, the Eloquence configuration
       utility is included. If your programs all reside on remote systems
       it is not necessary to install this archive.

   eq70_03.cab (long name: eq70_client_developer.cab)
     - contains the Eloquence Integrated Development Environment
       (the IDE) as well as the list and store utilities. If you do not
       modify your programs on or from the particular system it is not
       necessary to install this archive.

   eq70_04.cab (long name: eq70_client_dbtools.cab)
    - contains the client database tools necessary to create and maintain
      Eloquence databases, such as schema, dbcreate, dbimport and dbutil.
      If you do not maintain your databases on or from the particular
      system it is not necessary to install this archive.

   eq70_05.cab (long name: eq70_client_dblib.cab)
    - contains the client database library which is required to access
      Eloquence databases from within programming languages other than
      Eloquence Basic. This archive also contains the Eloquence Image3K
      TurboIMAGE compatibility extension.

   eq70_06.cab (long name: eq70_server.cab)
     - contains the eloqdb6 database server as well as the eloqsd service.
       If the particular system runs Windows XP, 2000 or NT and is intended
       to act as an Eloquence database and/or application server this
       archive must be installed. Since the Windows Service Control Manager
       is not available on Windows ME, 98 or 95 the server components are
       not installed unless your system runs Windows XP, 2000 or NT.

   eq70_07.cab (long name: eq70_doc_html.cab)
     - contains the core on-line documentation and release notes and should
       be installed along with the client_runtime and/or client_developer
       archive files.

   eq70_08.cab (long name: eq70_manuals_html.cab)
     - contains the entire manual set in HTML format. Since these are a lot
       of small files you should consider to install this archive in a
       central location and integrate it into your intranet web server's
       document hierarchy. By default, this archive is not installed.
       However, if you select to install this archive it will automatically
       integrate into the on-line documentation.

   eq70_09.cab (long name: eq70_manuals_pdf.cab)
     - contains the entire manual set in PDF format to be viewed with the
       Adobe Acrobat Reader (TM) which is included on this media and
       freely available on the Internet
       ( http://www.adobe.com/products/acrobat/readstep.html ).
       By default, this archive is not installed.

   By default, all components except the manuals are installed. However,
   you can manually select which components you want to install.

3) On Windows XP, 2000 or NT please log-on as Administrator before you
   install Eloquence (Windows "Power-User" privileges are sufficient).

4) If you already have Eloquence installed:

   a) Please make sure that no Eloquence program is running (e.g. stop
      the RUN server and exit from the IDE). You don't have to stop the
      servers, though, because the installation program will appropriately
      stop and uninstall them.

   b) The Eloquence B.07.00 installation program will automatically detect
      and uninstall any existing Eloquence software.
      
      Your existing configuration files will be preserved.

      It is not necessary and also not recommended to manually uninstall
      your existing Eloquence software.

      By default Eloquence B.07.00 uses an installation directory different
      from older Eloquence versions up to A.06.31. The installation program
      will automatically migrate your existing configuration files to the
      new installation directory.

      If you however have Eloquence B.06.32 or above installed the new
      version will be installed into the existing installation directory by
      default.

      Please read the section about updating your Eloquence software below.

5) Now start the setup executable which reflects your operating system
   and follow the installation instructions.

   On Windows XP, 2000 or NT, if you downloaded the server archive you
   have the choice to install a temporary server license if Eloquence
   B.07.00 is installed for the first time. This option is enabled by
   default. You can deselect this option manually if you don't want to
   install the temporary server license now. Later, you can use the
   Software applet in the Windows Control Panel to modify your Eloquence
   B.07.00 installation which will allow you to install the temporary
   license subsequently.

6) After installation on Windows XP, 2000 or NT a B.07.xx license key is
   required in order to use the Eloquence server components. During
   installation a temporary license key is generated on demand which
   is valid until 30 days after installation.

   Please visit the Eloquence Web site at
      http://www.marxmeier.com/eloquence/license
   for details about obtaining a permanent Eloquence license key.

   Your license file is located in the etc subdirectory of your
   Eloquence installation, for example at
      C:\Program Files\Eloquence\etc\license.

   Please comment out any previous license key when adding the new
   B.07.xx license key to your license file. Otherwise the new license
   may not be recognized and chklic might output the following messages:

      B.06.32: Bad license key revision.
      Duplicate sequence number: Ignoring license

   If you're using the Eloquence Personal Edition, please use the license
   template file license.sam, it contains an updated license key for the
   Eloquence Personal Edition.

   The license.sam file is located in the etc subdirectory of your
   Eloquence installation and should be copied into the license file
   located in the same directory.


Updating your existing Eloquence software
-----------------------------------------

If your existing Eloquence software is version B.06.32 or above it will be
uninstalled automatically. The new version will be installed into the
existing installation directory. This will preserve your configuration
files.

If you however have HP Eloquence A.06.31 or below installed please note:

* By default, Eloquence B.07.00 is installed into a different location
  than HP Eloquence versions up to A.06.31. The new location is

   C:\Program Files\Eloquence

  as opposed to the previous location which was

   C:\Program Files\Hewlett-Packard\HP Eloquence

* The installation program will automatically migrate your configuration
  and license files from a previous HP Eloquence installation. This will
  take the new software location into account so it is not necessary to
  install Eloquence B.07.00 into the same directory where your previous
  HP Eloquence software is installed.

* The installation program will also uninstall your previous HP Eloquence
  software. It is not necessary to uninstall it yourself. In fact, this
  would prevent the installation program from detecting your previous
  HP Eloquence version.

* Uninstallation takes place before the new software is copied to your
  disk. For HP Eloquence A.06.3x, the uninstallation process is visually
  indicated. Versions before A.06.30 are however silently uninstalled.
  Please be patient during uninstallation.

* All standard HP Eloquence settings in the Windows registry are migrated
  as well. While the HP Eloquence root key is migrated by the installation
  program the application-specific settings are migrated by the respective
  programs, i.e. the Eloquence IDE, the Eqstart program and the
  Configuration utility.

* However, in case you manually created non-standard registry settings
  these must be manually migrated. The new Eloquence registry key is

   HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence

* As in previous HP Eloquence versions, the corresponding HKEY_CURRENT_USER
  key is searched first to allow overriding the defaults with user-specific
  settings.

IMPORTANT NOTE: The Eloquence B.07.00 server components require a new
license key. Previous A.06.xx and B.06.xx license keys do not work anymore.
To migrate your existing license, first install the temporary license,
then visit the Eloquence web site at
   http://www.marxmeier.com/eloquence/license
to obtain a new license key.


Changes to previous Eloquence installations
-------------------------------------------

* Migration and uninstallation of previous HP Eloquence software

  If you have a HP Eloquence version A.06.31 or below installed its
  configuration and license files are migrated to Eloquence B.07.00.
  The previous software is uninstalled afterwards.

* Default installation location

  As opposed to HP Eloquence versions A.06.31 and below, the default
  Eloquence B.07.00 installation directory has been changed to:
  C:\Program Files\Eloquence

* Registry root key

  As opposed to HP Eloquence versions A.06.31 and below, the Eloquence
  B.07.00 registry root key has been changed to:
  HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence

* Default server names

  As opposed to HP Eloquence versions A.06.31 and below, the default
  Eloquence server names in the Windows Service Control Manager have been
  changed. By default, the database server is named "eloqdb6" and the
  application server is named "eloqsd" (formerly "HP EloqDB6" and "HP
  EloqSD", respectively).

* Component archives

  As opposed to HP Eloquence versions A.06.31 and below, the archive files
  eq70_client_dbtools.cab and eq70_client_dblib.cab have been added to
  separate the database tools and libraries from the runtime and
  development archives.

  The eq70_client_dblib.cab archive also contains the Eloquence Image3K
  TurboIMAGE compatibility extension.

  Due to a limitation in the Microsoft Windows Installer implementation
  the archives have short DOS 8.3 file names.

* Automatic stop and uninstallation of Eloquence servers

  Before installation or uninstallation begins, all running Eloquence
  servers (eloqdb6, eloqsd) are stopped and all present Eloquence servers
  are removed from the Windows Service Control Manager.

  After installation has finished, the default eloqdb6 and eloqsd servers
  are installed in the Windows Service Control Manager. However, they are
  not started automatically because the configuration and license probably
  must be adjusted manually.

* Environment

  The bin subdirectory of the Eloquence B.07.00 installation (for example
  C:\Program Files\Eloquence\bin) is added to the PATH environment variable
  so that each of the Eloquence command line programs can be conveniently
  executed. On Windows XP, 2000 and NT this is applied to the system PATH
  environment variable.

  On uninstallation, this setting is removed.

* Configuration files

  The SYSTEM and EXAMPLE volume paths are configured into the eloq.config
  file located in the etc subdirectory. Therefore, the Eloquence B.07.00
  system programs (such as QUERY, CFORM, MFORM, PFORM) and examples can
  be executed without further configuration.

  The system and example programs are located in the share\prog and
  share\example subdirectories, respectively.

  Of course, if the existing eloq.config file contains customized settings
  which are different from the default settings they are not changed to
  keep your eloq.config file functional.

* Windows system files

  The Eloquence TCP network services are configured into the Windows
  SERVICES file. No further configuration is necessary to run any Eloquence
  client or server programs. However, these settings are not removed on
  uninstallation.

* Windows start menu

  The Eloquence program group contains additional shortcuts for Eloquence
  QUERY and the on-line documentation and manuals.

* Autostart shortcut

  If the eq70_client_gui.cab archive is installed an autostart shortcut is
  created for the Eloquence RUN Server (applies to "All Users" on Windows
  XP, 2000 and NT). It is removed on uninstallation.

* License requirements

  Eloquence B.07.00 requires a new license key. Previous A.06.xx and
  B.06.xx license keys do not work anymore. The installation program
  installs a temporary license on demand even if an A.06.xx or B.06.xx
  temporary license has been installed previously.


If you encounter any installation problem please send us a message either
by e-mail (feedback@marxmeier.com) or fax (+49-202-2431-420). Thank you.


Enjoy!
Marxmeier Software AG