Eloquence B.08.00 - Windows Installation Instructions Rev. 2009-02-23 ========================================================================= ************************************************************************* * * * New installation directory * * -------------------------- * * * * By default, Eloquence B.08.00 is installed to the Eloquence\8.0 * * directory below Program Files. * * * * Starting with Eloquence B.08.00, this will allow future Eloquence * * versions to coexist on the same system. * * * * On 64 Bit Windows, Eloquence is installed below Program Files (x86). * * * * The Eloquence B.08.00 installation program automatically upgrades * * any previous Eloquence software to the new installation directory * * (see upgrade note below). * * * * * * License note * * ------------ * * * * Eloquence B.08.00 requires a license key version B.08.00 or above. * * For a new Eloquence installation or when upgrading from a previous * * Eloquence version a new license key must be obtained to use the * * Eloquence server components. * * * * The installation program by default grants a temporary license valid * * for 30 days if Eloquence B.08.00 is installed for the first time on * * a system. This option may be disabled in the Custom Setup dialog if * * a temporary license is not needed. * * * * To request a permanent license key, please use the form included * * with the delivery or use the license request form on the Eloquence * * web site at: http://eloquence.marxmeier.com/license/ * * * * The Eloquence software id (SWID) necessary to request a license key * * may be obtained using the gethwid utility. The installed license keys * * may be verified using the chklic utility. * * * * It is necessary to install Eloquence to use these utilities. They are * * located in the Eloquence etc installation subdirectory, by default: * * C:\Program Files\Eloquence\8.0\etc\gethwid * * C:\Program Files\Eloquence\8.0\etc\chklic * * * * * * Upgrade note * * ------------ * * * * The Eloquence B.08.00 installation program will automatically detect * * and uninstall any Eloquence version previous to Eloquence B.08.00. * * * * Your existing configuration files will be preserved and migrated to * * the new installation directory. The existing Eloquence services will * * be migrated as well. Please note that this includes any of your own * * customized database server instances if present. * * * * To upgrade from a previous Eloquence version it is not recommended to * * manually uninstall the previous version, as this would prevent the * * Eloquence B.08.00 installation program to migrate the configuration * * files and the Eloquence services. * * * * To avoid that a reboot is necessary after installation, please make * * sure that no program or library of the previous Eloquence version is * * in use. However, you do not need to stop the Eloquence services, as * * the installation program automatically stops and restarts them. * * * ************************************************************************* Installation instructions ------------------------- To install Eloquence B.08.00, administrative privileges are required. Recent Windows versions starting with Windows Vista will automatically request administrative privileges when starting the installation program. In case the installation program complains about a missing or too old Microsoft Windows Installer, please visit the Eloquence B.08.00 download directory at: http://eloquence.marxmeier.com/download/B0800/windows/ - On Windows 95, 98 or ME, you may download and install InstMsiA.exe. - On Windows NT4 or 2000, you may download and install InstMsiW.exe. In case of Windows NT4, this requires installation of Service Pack 6. (Please note that Eloquence B.08.00 does no longer support the Windows versions 95, 98, ME or NT4. The Windows Installer updates for those platforms are currently provided but may be removed without notice.) In the Destination Folder dialog you may modify the directory where the Eloquence software is installed. It is recommended to use the default directory Eloquence\8.0 below Program Files or Program Files (x86) on 64 Bit Windows. In the Custom Setup dialog, the Eloquence components are grouped into categories which may be selectively enabled or disabled for installation. You may later use the installation program or the Add / Remove Programs control panel to modify the selection at any time. Except for the deprecated GUI components, all categories and features are installed by default. Client Runtime Environment - This contains the components necessary to start and run applications written in the Eloquence programming language. Client Developer Tools - This contains the components necessary to develop applications using the Eloquence programming language. Client Database Tools - This contains the database client programs and utilities. Client Database Library - This contains the database client library, including the TurboIMAGE compatibility extension (Image3K) and the Query3K program. Server - This contains the Eloquence application server and database server along with the server-related utilities and programs. 64 Bit Database Server - This option is only available on 64 Bit Windows. It allows to select whether the 64 Bit or the 32 Bit database service is installed. 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 here, either the eloqdb64.exe or the eloqdb32.exe are used to register the Windows service(s) for your database server instance(s). You may later modify this selection by starting the installation program or using the Add / Remove Programs control panel. 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. Server Temporary License - This option is only available if an Eloquence B.08.00 temporary license was not yet installed on this system. If selected, a 30 days temporary license is granted. This includes the TurboIMAGE compatibility option. The generated temporary license keys are added to the license file located in the Eloquence etc directory. On-line Documentation - This contains the on-line documentation in HTML format. This also includes the on-line help used by the Eloquence IDE program and the EqStart utility. Deprecated GUI Components - This contains the deprecated RUNSRV32 and DLGSRV32 programs. Future Eloquence versions will no longer include these programs. By default, they are not installed. If necessary, this category must be manually enabled to install these programs. ************************************************************************* * * * On recent Windows versions starting with Windows Vista, a local group * * named "Eloquence Administrators" is created which has modify/delete * * permissions on the Eloquence etc configuration directory and files. * * * * The installing user is automatically made a member of this group. * * * * After the installation has finished, it may be necessary to log off * * and log on again to activate this new group membership and also to * * activate the modified PATH environment variable where the Eloquence * * bin directory was added. * * * * To add other users to the "Eloquence Administrators" group: * * * * 1) Open the Computer Management Console * * * * From the Start Menu, navigate to: * * Control Panel -> Administrative Tools -> Computer Management * * * * Alternatively, from the Start Menu, open: * * All Programs -> Accessories -> Run * * Then enter "compmgmt.msc" and click OK. * * * * 2) In the left pane, choose Local Users and Groups -> Groups * * * * 3) In the right pane, locate the "Eloquence Administrators" group * * and open its properties with a doubleclick. The properties dialog * * allows to change the group's list of members. * * * * Users added to the "Eloquence Administrators" group may need to log * * off and log on again to activate this new group membership. * * * ************************************************************************* Summary of changes to previous Eloquence versions ------------------------------------------------- - Default installation directory and registry root key The default installation directory and the registry root key contain the product version. Starting with Eloquence B.08.00, this will allow future Eloquence versions to coexist on the same system. The default installation directory is: C:\Program Files\Eloquence\8.0 On 64 Bit Windows, the default installation directory is: C:\Program Files (x86)\Eloquence\8.0 The registry root key is: HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence\8.0 - Automatic uninstallation and migration of previous Eloquence versions If the Eloquence B.08.00 installation program detects that an Eloquence version previous to Eloquence B.08.00 is installed, the previous Eloquence version is automatically uninstalled and the previous configuration files and Eloquence services are migrated. - Database server The 32 Bit database server executable is named "eloqdb32.exe" and the 64 Bit database server executable is named "eloqdb64.exe". The database server executables are installed in the Eloquence bin directory. In previous Eloquence versions, the database server executable was named "eloqdb6.exe" and was installed in C:\Windows\System32. The database service is named "eloqdb". In previous Eloquence versions it was named "eloqdb6". The default database server configuration is named "eloqdb.cfg". In previous Eloquence versions it was named "eloqdb6.cfg". When the installation program migrates the database server instance(s) of a previous Eloquence version to Eloquence B.08.00, it renames the "eloqdb6" service to "eloqdb" and the default "eloqdb6.cfg" file to "eloqdb.cfg". All database server instance(s) are configured to use the 32 Bit database server (on 64 Bit Windows, the 64 Bit database server may be used, depending on the "64 Bit Database Server" option in the Custom Setup dialog). - Database client and utility DLLs The database client and utility DLLs are installed in the Eloquence bin directory. In previous Eloquence versions, they were installed in C:\Windows\System32. Affected DLLs: eloqdb32.dll image3k.dll image3kC.dll fwutil.dll On 64 Bit Windows, the 64 Bit database client and utility DLLs are installed in the Eloquence bin directory. Affected 64 Bit DLLs: eloqdb64.dll image3k64.dll fwutil64.dll The related .lib and .def files are installed in the Eloquence lib directory. - Deprecated components The RUNSRV32 and DLGSRV32 programs are deprecated and not installed by default. Future Eloquence versions will no longer contain these programs. - Obsolete components Starting with Eloquence B.08.00, the components below are obsolete and no longer part of the Eloquence distribution: - eqexec32 (rexec client utility) - eloqcfg (Eloquence configuration utility and control panel) - dlgsrv32.dev (DLGSRV32 development files) If you encounter any installation problems please send us an email to the support@marxmeier.com address or use the Eloquence feedback form located at: http://eloquence.marxmeier.com/support/feedback.html Thank you. Enjoy! Marxmeier Software AG