Eloquence B.08.20 - Windows Installation Instructions Rev. 2012-05-03 ========================================================================= Summary ------- - Supported Windows versions: XP, Server 2003, Vista, Server 2008, 7 - 32-bit and 64-bit Windows versions are supported. Selected Eloquence components are installed both as 32-bit and 64-bit binaries, such as the database server, the dbfsck program and the client libraries. On 64-bit Windows the installation program allows to choose between activating the 32-bit or the 64-bit database server. - Eloquence B.08.20 requires a license key version B.08.20 or above. - Previous Eloquence versions may coexist with Eloquence B.08.20 on the same system. Please refer to the upgrade notes below for details. New installation directory -------------------------- The default installation directory is "Program Files\Eloquence\8.2" ("Program Files (x86)\Eloquence\8.2" on 64-bit Windows). Eloquence B.08.20 may coexist with previous Eloquence versions if all installed Eloquence versions use different installation directories. License note ------------ Eloquence B.08.20 requires a license key version B.08.20 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 data encryption feature is an optional product component and requires an additional license key for being functional. The installation program by default grants a 30 days temporary license if Eloquence B.08.20 is installed for the first time. 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: 32-bit Windows C:\Program Files\Eloquence\8.2\etc\gethwid C:\Program Files\Eloquence\8.2\etc\chklic 64-bit Windows C:\Program Files (x86)\Eloquence\8.2\etc\gethwid C:\Program Files (x86)\Eloquence\8.2\etc\chklic Please refer to the Eloquence B.08.20 License Key documentation for additional details, located on the Eloquence web site at: http://eloquence.marxmeier.com/support/B0820/relnotes/license.html Upgrading a previous Eloquence version -------------------------------------- If the installation program detects an existing Eloquence B.08.xx it provides two additional options in the Custom Setup dialog: - Migrate previous Eloquence If selected, the installation program will migrate the existing configuration files of a previous Eloquence B.08.xx version to Eloquence B.08.20. A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.20 etc configuration directory. If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.00 and B.08.10, only the configuration files of the most recent previous version are migrated, while any older B.08.xx installation is not touched. If the "Uninstall" option below is selected in addition, any migrated configuration file is deleted in the previous Eloquence B.08.xx etc configuration directory. - Uninstall previous Eloquence If selected, an existing previous Eloquence B.08.xx version is uninstalled. If multiple previous Eloquence B.08.xx versions are present, only the most recent previous version is uninstalled, while any older B.08.xx installation is not touched. By default, both options are selected. The "Uninstall" option cannot be selected if the "Migrate" option is deselected. Upgrading Eloquence B.07.10 or older ------------------------------------ The installation program unconditionally migrates and uninstalls any existing Eloquence version B.07.10 or older. Eloquence versions before B.08.00 use shared installation directories such as the Windows System directory, which complicates to make them coexist with other Eloquence versions on the same system. When migrating an Eloquence version B.07.10 or older, the "eloqdb6" service is renamed to "eloqdb" and the default "eloqdb6.cfg" file is renamed to "eloqdb.cfg". Please note that if the installation program detects an existing Eloquence B.08.xx along with an Eloquence version B.07.10 or older it assumes that you know what you are doing and does not touch the older Eloquence version. Installation instructions ------------------------- To install Eloquence B.08.20, administrative privileges are required. Recent Windows versions starting with Windows Vista will automatically request administrative privileges. In the Destination Folder dialog the default installation directory may be confirmed or modified. In the Custom Setup dialog, the Eloquence component categories may be selectively enabled or disabled for installation. You may later use the installation program in Modify maintenance mode to modify the selection at any time. All categories and features are selected 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. The database client and utility DLLs are installed in the Eloquence bin directory. The related .lib and .def files are installed in the Eloquence lib directory. In addition, on 64-bit Windows the 64-bit database client and utility DLLs are installed in the Eloquence bin64 directory. The related .lib and .def files are installed in the Eloquence lib64 directory. Server - This contains the Eloquence application server and database server along with the server related utilities and programs. The server executables are installed in the Eloquence bin directory. In addition, on 64-bit Windows the 64-bit database server (eloqdb64.exe) and the 64-bit dbfsck program (dbfsck64.exe) are installed in the Eloquence bin64 directory. 64-bit Database Server - This option is only available on 64-bit Windows. It allows to select whether the 32-bit or the 64-bit database service is activated. Please note that on 64-bit Windows, both the 32-bit database server (eloqdb32.exe) and the 64-bit database server (eloqdb64.exe) are installed to the Eloquence bin and bin64 directories. However, depending on the selection here, either the eloqdb32.exe or the eloqdb64.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 in Modify maintenance mode. This will cause your database server instance(s) to be stopped and restarted with either the 32-bit or the 64-bit database server executable. Server Temporary License - This option is only available if an Eloquence B.08.20 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. As long as the temporary license was not yet installed on the system you may later choose to install it by starting the installation program in Modify maintenance mode. 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. Migrate previous Eloquence - This option is only available if an existing previous Eloquence B.08.xx version is detected on this system. If selected, the installation program will migrate the existing configuration files of a previous Eloquence B.08.xx version to Eloquence B.08.20. A backup copy is created if a migrated configuration file already exists in the Eloquence B.08.20 etc configuration directory. If multiple previous Eloquence B.08.xx versions are present, for example both Eloquence B.08.00 and B.08.10, only the configuration files of the most recent previous version are migrated, while any older B.08.xx installation is not touched. If the "Uninstall" option below is selected in addition, any migrated configuration file is deleted in the previous Eloquence B.08.xx etc configuration directory. If you don't select the "Uninstall" option below, you may later use the "Migrate" option by starting the installation program in Modify maintenance mode. In this case, this option is not selected by default but must be manually enabled. Uninstall previous Eloquence - This option is only available if an existing previous Eloquence B.08.xx version is detected on this system and if this is the initial installation (i.e., this option is not available in Modify maintenance mode). If selected, an existing previous Eloquence B.08.xx version is uninstalled. If multiple previous Eloquence B.08.xx versions are present, only the most recent previous version is uninstalled, while any older B.08.xx installation is not touched. This option cannot be selected if the "Migrate" option is deselected. Using database encryption ------------------------- The Eloquence database encryption feature allows to designate fields with sensitive contents for encrypted storage. It helps protecting database volume files, forward logs, as well as dbstore output files against unauthorized access to sensitive data. Please refer to the database encryption documentation for additional details, located on the Eloquence web site at: http://eloquence.marxmeier.com/support/B0820/relnotes/encryption.html Database encryption is an optional add-on requiring an extra license key. Besides installing this license key, encryption requires that the OpenSSL library is installed. Eloquence was tested against OpenSSL versions 0.9.8o and 1.0.0a available through the OpenSSL for Windows link located at: http://openssl.org/related/binaries.html You need to install the 32-bit "Win32 OpenSSL Light" version, and also the 64-bit version in addition if the 64-bit database server is used. Moreover, you may need to install the "Visual C++ Redistributables" in case the OpenSSL installation program indicates that these are not yet present on the system. Accessing Eloquence configuration files --------------------------------------- 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 (and the bin64 directory on 64-bit Windows) 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. Multiple Eloquence versions on the same system ---------------------------------------------- If multiple Eloquence versions are installed on the same system, the PATH environment variable may contain references to different Eloquence bin (and bin64) directories, where only the first one is in effect. This may affect Eloquence command line utilities and shared libraries if these are invoked without qualifying the path to the binary file. The installation program appends the Eloquence bin directory (and the bin64 directory on 64-bit Windows) to the PATH variable. If multiple Eloquence versions are installed, it might be necessary to review the PATH variable to make sure the desired Eloquence bin (and bin64) directory is in effect. Summary of changes to previous Eloquence versions ------------------------------------------------- - Default installation directory and registry root key On 32-bit Windows, the default installation directory is: C:\Program Files\Eloquence\8.2 On 64-bit Windows, the default installation directory is: C:\Program Files (x86)\Eloquence\8.2 The registry root key is: HKEY_LOCAL_MACHINE\SOFTWARE\Marxmeier\Eloquence\8.2 Please note that on 64-bit Windows this key is located in the 32-bit registry. The 64-bit Windows registry editor displays the key below HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (there is a 32-bit registry editor available in addition, by default C:\WINDOWS\SysWOW64\regedit.exe, which displays the key in its usual location). - 64-bit components On 64-bit Windows, the 64-bit executables are now installed in the Eloquence bin64 directory. The PATH environment variable is set to both the bin and bin64 directories. The 64-bit .lib and .def files are installed in the Eloquence lib64 directory. - Default database server activation on 64-bit Windows On 64-bit Windows, the 32-bit database server is activated by default. In the Custom Setup dialog, the 64-bit Database Server option may be used to activate the 64-bit database server. 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