3 Installing Eloquence on Windows
The Installation Program
The Eloquence installation program is based on the Microsoft Windows Installer.
The Microsoft Windows Installer is a system component initially shipped with Windows 2000. It interoperates with so-called MSI files which are actually databases holding all information about any installed product. Therefore, the Windows Installer is always aware about all installed software on the system and the several components installed with any software. This makes it easy to keep the system in a clean state. Additionally, the Windows Installer can take the necessary steps to repair a particular installation or to uninstall a particular product.
Eloquence B.07.00 provides the eq70.msi file which holds the installation database. The components to be installed are divided into separate archives which are laid-out in a compressed format. The contents of the archives are listed below.
The different Eloquence components can be installed independently. Each component is contained in a separate, self-contained archive file. The installation program expects to find the archive files in the same directory where the eq70.msi file is located. It lets you choose among the present archive files 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.
- Client GUI Environment
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.
- Client Runtime Environment
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.
- Client Developer Tools
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.
- Client Database Tools
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.
- Client Database Library
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.
contains the eloqdb6 database server as well as the eloqsd service. If the particular system runs Windows Server 2003, 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 Server 2003, XP, 2000 or NT.
- On-line Documentation
contains the core on-line documentation and release notes and should be installed along with the client_runtime and/or client_developer archive files.
- Reference Manuals (html)
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.
- Reference Manuals (pdf)
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. By default, this archive is not installed.
By default, all components except the manuals are installed. The installation program detects which archive files are present (e.g. if not all components are required and therefore only a subset has been downloaded) and will not offer the related missing components for installation.
To install Eloquence from the CD-ROM media, open the \B0700\win32 directory and use the setup.exe program contained in this directory.
Eloquence can be downloaded from the Eloquence web site at:
- Download the appropriate setup executable depending on your operating system:
for the Windows Server 2003, XP or 2000 platforms
for the Windows NT platform
for the Windows ME, 98 and 95 platforms
Unless you plan to install 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 Server 2003, XP and 2000 because they additionally include the Microsoft Windows Installer 1.2 engine which is a Windows Server 2003, XP and 2000 system component.
The installation detects which archive files are present and offer the related components for installation.
- Download the archive files of the components you want to install and put them into the same directory where the setup executable is located. At least one archive file must be present, otherwise the installation program will not install anything.
NOTE: You can use the eq70_all_cab.zip file to download all archive files at once. After downloading, unpack its contents into the directory where the setup executable is located.
NOTE: A download installation requires write permissions in the directory where the setup executable is located along with the downloaded archive files. 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.
* 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 services (eloqsd, eloqdb6), though, because the installation program will appropriately stop and uninstall them.
- On Windows Server 2003, XP, 2000 or NT please log-on as Administrator before you install Eloquence (Windows "power user" privileges are sufficient).
- 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.
The installation program should start and guide you through the installation process. The Custom Setup dialog lets you choose which components you want to install. By default, all components (minus those you did not download) except the manuals are selected for installation.
- Now start either the setup.exe installation launcher program or the self-extracting eq70_win2k.exe, eq70_winnt.exe or eq70_win9x.exe setup executable, depending if you do a CD-ROM or download installation.
On Windows Server 2003, XP, 2000 or NT you can choose 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 disable 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.
Please visit the Eloquence Web site at http://www.marxmeier.com/eloquence/license for details about obtaining a permanent Eloquence license key.
- After installation on Windows Server 2003, XP, 2000 or NT a B.07.00 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.
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:
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.
- 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.
Changes to previous Eloquence installations
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.
- Migration and uninstallation of previous software
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.
- Default installation location
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.
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).
As opposed to HP Eloquence versions A.06.31 and below, the archive files eq70_04.cab and eq70_05.cab have been added to separate the database tools and libraries from the runtime and development archives.
The eq70_05.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.
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.
- Automatic stop and uninstallation of Eloquence servers
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.
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 Server 2003, XP, 2000 and NT this is applied to the system PATH environment variable.
On uninstallation, this setting is removed.
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.
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.
The Eloquence program group contains additional shortcuts for Eloquence QUERY and the on-line documentation and manuals.
If the eq70_01.cab archive is installed an autostart shortcut is created for the Eloquence Run server (applies to "All Users" on Windows Server 2003, XP, 2000 and NT). It is removed on uninstallation.
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.
Eloquence Installation and Configuration - 29 OCT 2004