.
contact contact

Windows Platform Installation Notes

 
.
  A.06.30 Release Notes
The new Eloquence A.06.30 installation program for the 32bit Windows platform is based on the Microsoft Windows Installer and thus complies to the Microsoft Windows 2000 logo requirements.

It supports Windows 2000, Windows NT 4.0 and Windows 98 as well as Windows 95.

Introduction

The Microsoft Windows Installer is a new 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 A.06.30 provides the eq63.msi file which holds the installation database. The components to be installed are divided into separate "cabinet" files which are laid-out in a compressed format. The contents of the cabinets are listed below.

On Windows 2000, the eq63.msi file is sufficient to start the installation: just double-click the eq63.msi file. There is no need for a separate setup.exe program as with former installations.

However, for Windows NT 4.0, Windows 98 and Windows 95, the appropriate Windows Installer engine might not be present on your machine yet. For this purpose we provide a setup.exe which first installs the appropriate Windows Installer engine on your system and then launches the Eloquence A.06.30 installation.

The Windows Installer engine for Windows NT 4.0 is contained in a file named instmsiw.exe. The name of the file containing the engine for Windows 98 and Windows 95 is instmsia.exe. Both can be manually started to install the appropriate engine on your system, but this is normally done automatically by setup.exe for convenience.

Contents of the cabinet files

The cabinet files represent the different Eloquence A.06.30 components. Each cabinet is self-contained and can be selected during the setup process if you choose a customized installation.
  • eq63_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.

  • eq63_client_runtime.cab
    contains the eloqcore program which enables you to locally execute your Eloquence programs. Additionally, the Eloquence configuration utility is included. If your programs all reside on remote systems it is not necessary to install this cabinet.

  • eq63_client_developer.cab
    contains the Eloquence Integrated Development Environment (the IDE) as well as the list and store utilities and all data base client programs such as schema, dbcreate and dbimport. If you do not modify your programs or data bases on the particular system it is not necessary to install this cabinet.

  • eq63_server.cab
    contains the eloqdb6 data base server as well as the eloqsd daemon. If the particular system runs Windows 2000 or NT and is intended to act as a Eloquence data base and/or application server this cabinet must be installed.

  • eq63_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 cabinet files.

  • eq63_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 cabinet in a central location and integrate it into your intranet web server's document hierarchy.

  • eq63_manuals_pdf.cab
    contains the entire manual set in PDF format to be viewed with the Adobe Acrobat Reader (TM) which is freely available on the internet.
In a complete installation, the three client cabinets are installed as well as the doc_html cabinet. On Windows 2000 or Windows NT, the server cabinet is additionally installed. The manuals are not installed unless you choose a customized installation and select them manually.

Installation instructions

  1. On Windows 2000 or Windows NT 4.0, please ensure you have administrative capabilities.

  2. If you have a previous Eloquence A.06.30 beta release installed, please uninstall it first using the "Add/Remove Programs" applet found in the Windows Control Panel.

    If this does not succeed, please try the installation program of the previous A.06.30 beta release. If this does not work at all, please refer to the "Troubleshooting" section below.

    However, if you have Eloquence A.06.00, A.06.10 or A.06.20 installed, a prior uninstallation is not necessary. You should choose a customized installation and make sure you install A.06.30 into your previous Eloquence installation directory.

    In any case, your previous configuration files are not overwritten by the Eloquence A.06.30 installation process.

  3. Now start the setup.exe installation launcher program and follow the installation instructions.

    If you wonder if you should choose a complete or a custom installation, please refer to the section "Contents of the cabinet files" above.

  4. After installation on Windows 2000 or NT, an A.06.30 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://eloquence.marxmeier.com/license for details about ordering a permanent Eloquence license key.

    Your license file is located in the etc subdirectory of your Eloquence installation, for example at C:\Program Files\Hewlett-Packard\Eloquence\etc\license. Please comment out the previous license key when adding the new A.06.30 license key to your license file. Otherwise the new license may not be recognized and chklic might output the following messages:

        A.06.20: 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 file is located in the etc subdirectory of your Eloquence installation and should be copied into the license file located in the same directory.

Troubleshooting

In rare cases we detected problems during uninstallation of previous HP Eloquence A.06.30 beta releases. In such a case it might be necessary to manually clean-up the Windows Installer database:
  1. Open the "Installer" subdirectory inside your Windows installation directory (for example C:\Windows\Installer).

  2. In this "Installer" subdirectory, please delete the subdirectory which is named "{2BB0A553-CA9B-11D3-8103-00105ABC69D4}".

  3. For each .msi file in the "Installer" subdirectory, you should find out if it is related to Eloquence by starting it with a doubleclick and wait until the first dialog window appears. If this is a "HP Eloquence A.06.30 Setup" window, immediately click the "Cancel" button and delete the file. If it is not, immediately click the "Cancel" button and proceed with the next .msi file.

  4. Finally, start the new Eloquence A.06.30 setup.exe as explained above and use the "Remove" option to uninstall the previous beta release. This should now succeed. Afterwards, start it again to install the new Eloquence A.06.30 software.

  5. If this does not succeed which we have experienced in rare cases it is necessary to manually remove all references to the previous beta release from the Windows registry. To do this, open the "Run" dialog from the start menu and execute "regedit". In the "Edit" menu choose "Find" and search for "355A0BB2B9AC3D1118300001A5CB964D" (without the quotes) in all keys, values and data. Then delete each occurrence which is found.


 
 
.
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision:  2002-11-18  
  Copyright © 1995-2002 Marxmeier Software AG