Index of download.marxmeier.com/eloq/B0710/win32/
Eloquence B.07.10 - Windows Installation Instructions
Revision: 2006-01-12
=====================================================
This directory holds the release of the Eloquence B.07.10 distribution
for the 32bit Windows platform.
This installation program is based on the Microsoft Windows Installer.
Supported platforms: Windows 2003 x86 and x64
Windows XP x86 and x64
Windows 2000
*************************************************************************
* Please note if you already have Eloquence installed *
* --------------------------------------------------- *
* *
* The Eloquence B.07.10 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.10 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) Please log-on as Administrator before you install Eloquence
(Windows "Power-User" privileges are sufficient).
2) 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, uninstall and reinstall them.
b) The Eloquence B.07.10 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.10 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.
3) Now start the Eloquence B.07.10 installation program.
Should the installation program complain about a missing or too old Windows
Installer, please download and install the Windows Installer installation
program that is appropriate for your platform:
* On Windows 95, 98 or ME, please download and install InstMsiA.exe.
* On Windows NT or 2000, please download and install InstMsiW.exe.
(Please note that Eloquence B.07.00 does not support Windows 95, 98, ME
or NT anymore. The Windows Installer installation programs for those
platforms are currently provided but may be removed without notice.)
The installation program allows to choose the directory where Eloquence
will be installed. The default location is C:\Program Files\Eloquence.
In the Custom Setup dialog all Eloquence components are listed and can
be selected or deselected for installation:
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.
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 component.
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 component.
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 component.
Client Database Library
- contains the client database library which is required to access
Eloquence databases from within programming languages other than
Eloquence Basic. This component also contains the Eloquence Image3K
TurboIMAGE compatibility extension and the QUERY3K utility.
Server
- contains the eloqdb6 database server as well as the eloqsd service.
If the particular system is intended to act as an Eloquence database
and/or application server this component must be installed.
On-line Documentation
- contains the core on-line documentation and release notes and should
be installed along with the Client Runtime Environment and/or Client
Developer Tools.
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 component in a
central location and integrate it into your intranet web server's
document hierarchy. By default, this component is not installed.
However, if you select to install this component 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
( http://www.adobe.com/products/acrobat/readstep.html ).
By default, this component is not installed.
If Eloquence is installed for the first time you have the choice to install
a temporary server license. 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.10 installation which will allow
you to install the temporary license subsequently.
4) After installation a B.07.10 license key is required in order to use the
Eloquence server components. During installation a temporary license key
is generated on demand that 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.10 license key to your license file. Otherwise the new license
may not be recognized and chklic might output the following messages:
B.07.00: 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.10 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.10 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.10 server components require a new license
key. Previous A.06.xx, B.06.32 and B.07.00 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
-------------------------------------------
* Single file installation program
Eloquence B.07.10 is now installed through a single file installation
program. In previous versions, the Eloquence components could be
downloaded and installed separately. This was dropped in favor of a
single file installation to ease the software download and to avoid
problems caused by missing component archive files.
* 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.10.
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.10 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.10 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).
* Automatic stop, uninstallation and reinstallation of Eloquence servers
Before installation or uninstallation begins, all running Eloquence
servers (eloqsd, eloqdb6) are stopped and all present Eloquence servers
(including any additional eloqdb6 instances) are removed from the Windows
Service Control Manager.
After installation has finished, all servers are restored to their original
state. This includes the eloqsd and eloqdb6 automatic/manual startup type
as well as any additional eloqdb6 instances that were present before
installation. The Eloquence servers may then immediately be started in the
Windows Service Control Manager or through a reboot of the system.
* Environment
The bin subdirectory of the Eloquence B.07.10 installation (for example
C:\Program Files\Eloquence\bin) is added to the system PATH environment
variable so that each of the Eloquence command line programs can be
conveniently executed.
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.10
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
that 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.
* RUN server autostart shortcut
The installation program no longer creates an autostart shortcut for the
RUN server component. In case it is required it must be manually created:
1) Open the bin subdirectory of the Eloquence B.07.10 installation (for
example C:\Program Files\Eloquence\bin).
2) Right-click the RUNSRV32.EXE program and choose "Send To" -> "Desktop".
This creates a shortcut for RUNSRV32.EXE on the desktop.
3) Right-click the "Start Menu" -> "Programs" -> "Startup" program group
and choose "Open" (or "Open All Users" if you want the RUNSRV32.EXE
to be autostarted for all users on the system).
This opens the Startup program group in an Explorer window.
4) Drag the RUNSRV32.EXE shortcut from the desktop and drop it into the
Startup program group.
* License requirements
Eloquence B.07.10 requires a new license key. Previous A.06.xx, B.06.32
and B.07.00 license keys do not work anymore. The installation program
installs a temporary license on demand even if an A.06.xx or B.06.32
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
