Skip to content

QIE Express Install Instructions

If you are comfortable with the Java Runtime Environment and software installations in general, you can follow the express install steps below. Otherwise, more detailed information is contained in the remainder of this install guide for installing and configuring the QIE environment.

Install QIE

Run the QIE Windows installer to install QIE to the local machine. You are prompted to install or locate an existing Java Runtime. You are also prompted to install MariaDB, which is the default database. You may instead point QIE at any of the supported database vendors. See Supported Databases. If you elect to install the free MariaDB choose a root database password and remember it. When the QIE installer completes, click 'Start' in the QIE Service Manager dialog to launch the QIE service.

Note

Contact Qvera support for information on downloading the latest QIE installer.

Install a Compatible Browser

Install a compatible browser on the machine you administer QIE from. See Supported Browsers.

Launch QIE and Activate your License

If QIE was installed on the local machine, the console can be accessed by navigating to http://localhost using a supported browser. Otherwise, if QIE was installed on a remote server, the console can be accessed by navigating to http://<qie-server-hostname> from a supported browser.

Note

If the Jetty port was changed (in the Java tab of the QIE Service Manager dialog) from port 80 to some other port (e.g. port 8080), the port number must be appended to the URL in order to connect to the QIE console (e.g. http://localhost:8080).

Opening QIE in a new window

By default (QIE v0.50 and later), navigating to the console URL opens QIE in the current browser tab. To force it to open in a new browser window, append /qie/launcher.html?newwin to the URL, for example, http://<qie-server-hostname>/qie/launcher.html?newwin. The complementary ?appwin parameter forces same-tab launch, which is the default behavior.

To log in, use the default username ('admin') and password ('admin'). After logging in, you are prompted to change the default 'admin' password.

To activate a license, select 'Help -> About' from the main menu. On the 'License Keys' tab select 'insert'. Enter a valid QIE customer ID and password and click 'Get License'. Click 'Save' after it populates the license details. Click 'OK' to exit the about dialog.

Note

A valid QIE customer ID and password can be obtained by contacting Qvera

Note

For applying multiple licenses to a single install of QIE see Licenses and License Groups.

Installing QIE with a Proxy Server

If QIE is being installed in an environment which requires that internet traffic be routed through a proxy server, QIE must be configured with the appropriate proxy host and port settings in order to gain access to external resources, including the ability to communicate with Qvera's Licensing Server. To configure the proxy settings:

  1. Login to QIE and navigate to the System Configuration page.

  2. Select the Use Proxy checkbox in the Http/Https Proxy Settings.

  3. Enter the Proxy Host and Port information.

  4. If you have specific hosts that should bypass the proxy, they can be entered in the Non-Proxy Host field. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. Any host matching one of these patterns is reached through a direct connection instead of through a proxy.

  5. When prompted, answer "Yes" to the QIE Service Restart Required prompt. This restarts the QIE service and enables the proxy settings.

Optimizing Performance for Large XML Messages

When doing extensive processing of XML files, you may want to use the alternate XML parsing engine to improve performance. The default DOM implementation that comes with Java is slower and uses more memory. To use the fast xml parsing engine:

  1. Download the vtd-xml-qvera.jar from https://www.qvera.com/vtdDownload.html.

Note

Some browsers may warn you that jar files can be harmful and ask you to confirm that you want to keep the jar file. Confirm to continue the download.

Note

This JAR file is freely distributed by SourceForge.net. Qvera has modified the SourceForge.net VTD JAR file to handle XPath expressions consistent with the default JRE DOM implementation. As per the terms of the GPL license under which this JAR file is distributed, the vtd-xml-qvera.jar source code is freely available upon request.

  1. Copy the vtd-xml-qvera.jar to the 'lib' directory located in the QIE Home directory specified in the Java Options field of the Java tab in the QIE Service Manager.

  2. Login to QIE and navigate to the System Configuration page. Select the Manage External Libraries button and make sure that the vtd-xml-qvera.jar file is checked.

  3. Click Update to apply any changes and close the Manage External Libraries dialog.

  4. When prompted, answer "Yes" to the QIE Service Restart Required prompt. This restarts the QIE service and enables the fast xml parsing engine for use.