Installing a per-user MDEX Engine installation on Windows

A per-user installation of the MDEX Engine may be used if administrator permissions are unavailable. This is primarily useful for training and for small-scale development environments.

Note: Installing a per-user installation of the MDEX Engine on Microsoft Server 2008 is only permitted when it has been configured as a managed application, or the DisableMSI registry key has been set to zero. Contact an administrator if you require a per-user installation under Windows Server 2008.

Before installing, make sure to uninstall any previous versions of the MDEX Engine using the Uninstall a program utility in the Control Panel.

If a per-machine installation of the MDEX Engine is already present, attempting to install a per-user installation fails and the installer instead attempts to uninstall the per-machine installation.

Important: If you are setting up your MDEX Engine for a production environment, you must use a per-machine installation. Additionally, if you are using a Platform Services installation, you must also use a per-machine MDEX Engine installation.

To install the Endeca MDEX Engine as a per-user installation:

In your local environment, locate the Endeca MDEX Engine software that you downloaded from the Endeca Developer Network (EDeN).
Double-click the installer file mdex_<version>_x86_64pc-win32.exe to start the wizard.
The wizard verifies the contents of the installation package and confirms that no previous version is installed.

Note: If the installer identifies that the previous version is still installed, cancel the installation and uninstall the previous version using the Uninstall a program utility in the Contol Panel.
Click Next to begin the installation process.
In the Copyright and Legal screen, click Next.
In the License Agreement screen, select I accept the terms in the license agreement, then click Next.
In the Select Program Folder screen, do the following:
- Accept the default value for Program Folder.
- Select the Only for me (current user) button.
Select an installation location or accept the default installation %USERPROFILE%\Endeca\MDEX\<version> which creates the directory %USERPROFILE%\Endeca\MDEX\<version>.
You cannot install the MDEX Engine into a directory that contains content.

The wizard displays both the required and available disk space for the target directory chosen. The MDEX Engine requires approximately 500 MB of disk space. The installer requires approximately 190 MB of space on the system drive for temporary files. These files are cleared after the installation process completes.

Note: If you install to a non-default location, the installation does not create the sub-directory structure MDEX\<version> unless you specify this structure explicitly. Additionally, clicking the Back button in the installation wizard resets the installation path to the default directory.
Click Finish. The wizard confirms that you have successfully completed the installation.

If you intend to run MDEX Engine applications or tools from the command line, without using the EAC or JCD and Control Interpreter, run the batch file mdex_setup.bat after you install the MDEX Engine. You must run this script from a Windows Command Prompt, not a PowerShell Console.

The MDEX Engine installer creates this batch file in the target directory. For example, if you installed to the default location, this file is located at %USERPROFILE%\MDEX\<version>\mdex_setup.bat.

The batch file sets up the environment variable ENDECA_MDEX_ROOT that the MDEX Engine uses and that points to %USERPROFILE%\MDEX\<version>.The script also adds the utilities directory and the MDEX Engine binaries to the search path.

The script is optional and provided as a convenience. Note that it only sets the variables for the current user in the current context. Optionally, you can manually set the environment variables as global environment variables.