Deploying an EAC application on Windows

This section describes the steps for deploying an EAC application in a Windows environment using the provided deploy.bat file.

The deploy.bat script in the bin directory configures and distributes the template files into the deployment directory structure.

To deploy an application:

  1. On the primary server, start a command prompt and navigate to deploymentTemplate-[VERSION]\bin.
  2. From the bin directory, run the deploy script. For example:
    C:\Endeca\Solutions\deploymentTemplate-3.2\bin>deploy
    The template identifies the location and version of your Platform Services installation based on the ENDECA_ROOT environment variable. If the information presented by the installer does not match the version or location of the software you plan to use for the deployment, stop the installation, reset your ENDECA_ROOT environment variable, and start again. Note that the installer may not be able to parse the Platform Services version from the ENDECA_ROOT path if it is installed in a non-standard directory structure. It is not necessary for the installer to parse the version number, so if you are certain that the ENDECA_ROOT path points to the correct location, proceed with the installation.
  3. Specify whether the application is a Dgraph deployment or an Agraph deployment.
    1. If an Agraph deployment was selected, specify whether your application is going to use Parallel Forge. The template identifies the location and version of your Platform Services install based on the ENDECA_ROOT environment variable. If the information presented by the installer does not match the version or location of the software you plan to use for the deployment, stop the installation, reset your ENDECA_ROOT environment variable, and start again. Note that the installer may not be able to parse the Platform Services version from the ENDECA_ROOT path if it is installed in a non-standard directory structure. It is not necessary for the installer to parse the version number, so if you are certain that the ENDECA_ROOT path points to the correct location, proceed with the installation.
  4. Specify a short name for your application. The name should consist of lower- or uppercase letters, or digits between zero and nine.
  5. Specify the full path into which your application should be deployed. This directory must already exist. The deploy script creates a folder inside of the deployment directory with the name of your application and the application directory structure. For example, if your application name is MyApp, and you specify the deployment directory as C:\Endeca\apps, the deploy script installs the template for your application into C:\Endeca\apps\MyApp.
  6. Specify the port number of the EAC Central Server. By default, the Central Server host is the machine on which you are running deploy script and that all EAC Agents are running on the same port. All of these settings can be configured to reflect a different environment configuration once the application is deployed.
  7. Specify whether your application will use Oracle Endeca Workbench for configuration management. Integration can be enabled or disabled after deployment, but enabling it deploys a default set of scripts that manage configuration integration from Oracle Endeca Workbench.
  8. Specify the port number of Oracle Endeca Workbench. By default, the installer assumes that the Workbench host is the machine on which it is being run, but this can be re-configured once the application is deployed.
  9. The installer can be configured to prompt the user for custom information specific to the deployment. By default, Dgraph deployments use this functionality to prompt the user for Dgraph and Log Server port numbers, while the Agraph deployment also ask for Agraph (and Forge server, if using Parallel Forge) port numbers.

If the application directory already exists, the installation script archives the existing directory, to avoid accidental loss of data. For example, if the installer finds that C:\Endeca\apps\MyApp already exists, it renames the existing directory to C:\Endeca\apps\MyApp.[timestamp].bak and installs the new deployment into a new MyApp directory. Note that in the case of deployments that use a large amount of disk space, it is important to remove archived deployment directories to clear up disk space.