Installing Platform Services on Windows

You install the Platform Services on Windows by using the installation wizard.

Use the following prerequisites before installing:

To install the Endeca Platform Services on Windows:

  1. In your local environment, locate the Endeca Platform Services installation package that you downloaded from the Endeca Developer Network (EDeN) site. The name of the installation file is as follows:
    • For 32-bit Windows: platformservices_603_i86pc-win32.exe
    • For 64-bit Windows: platformservices_603_x86_64pc-win32.exe
  2. Double-click the installer file to start the wizard.
  3. When the Endeca Platform Services Setup Wizard screen appears, click Next to begin the installation process.
  4. Read the copyright information and click Next.
  5. In the Endeca License Agreement screen, select I accept the terms in the license agreement and then click Next.
  6. In the Destination Folder screen, select an installation location or accept the default C:\Endeca\PlatformServices installation directory.
    Keep in mind that you cannot install the Endeca software in a directory with spaces in its name.
    Note: If you do not use the default location, and you are installing more than one Endeca product on the same machine, ensure that you install each product to a separate location.
  7. In the Custom Setup screen, select the program features you want to install, then click Next. Note that some items have sub-items. By default, all of the items are selected for installation.
    Feature Contents
    Endeca Platform Services Data Foundry components, such as Forge and the CADK
    Endeca Application Controller Server and Agent EAC Central Server and Agent
    Endeca Application Controller Agent EAC Agent only
    Endeca Application Controller Utility EAC command-line utility (eaccmd)
    Endeca Presentation and Logging APIs Java and .NET APIs for Endeca MDEX Engine and Log Server
    Endeca logging and reporting components Endeca Log Server and Report Generator
    Endeca Reference Implementation Sample source data project and JSP/.NET UI references
    Documentation This guide, Migration Guide, Licensing Guide
    Endeca Control System Endeca Control Interpreter (not installed by default)
    The wizard displays the required disk space for the selected features. The entire Platform Services installation requires approximately 370 MB of disk space.
  8. In the Endeca Services Information screen, enter the user name, domain name, and password to use when launching the Endeca HTTP Service, then click Next. This user must already exist. For details on creating the user account, see the previous topic, "Creating a user for the Endeca services on Windows".
  9. In the Endeca Application Controller Service Information screen, enter the following information and then click Next.
    • The port on which the Endeca HTTP Service will listen (default is 8888).
    • The shutdown port of the Endeca HTTP Service (default is 8090).
    • The location (an absolute path) of the MDEX Engine root directory (for example, C:\Endeca\MDEX\6.1.5). Note that the installer does not verify the existence of the directory; this allows you to install the Platform Services package before the MDEX Engine package.
  10. In the Ready to Install the Program screen, confirm the settings you selected in previous screens, then click Install.
  11. When the installation is complete, click Finish to exit the wizard.
  12. When you exit the wizard, you are prompted to restart your computer. You may do so now, or wait until later. Note that you must restart your computer to set the Endeca environment variables correctly and to start the Endeca HTTP Service.

After the computer restarts, the Endeca environment variables (such as ENDECA_ROOT) are available for use and the Endeca HTTP Service starts up.

Depending on your application needs, you may have to perform two post-installation tasks:
  • If you did not specify the MDEX Engine root directory (at Step 9), the com.endeca.mdexRoot setting (in the EAC eac.properties configuration file) will have a blank value. The file is located in the %ENDECA_CONF%\conf directory. If you later install the MDEX Engine on your system, you must edit the file and add the absolute path of the MDEX Engine root directory in the setting. For more information on this file, see the Endeca Application Controller Guide.
  • If you have installed the Endeca Control System, you should manually add ENDECA_MDEX_ROOT as a system environment variable so that the JCD Service starts with this variable in its environment. You can add this variable before or after you install the MDEX Engine package. For details on adding this environment variable and on starting the JCD Service, see the Endeca Control System Guide.