Deploying the Discover Electronics reference application silently using Forge

The silent deployment script is useful if you want to add the deployment of the Discover reference application to an install script, or push out the deployment on multiple machines. Deploying the Forge-based version of the Discover Electronics Reference Application is not recommended. Oracle recommends that you deploy the CAS-based version of the Discover Electronics Reference Application as the basis for any custom Guided Search applications that you may create.

Before you begin, you must install Tools and Frameworks using the Complete Installation type of installation. The complete installation installs Forge by default. You do not need to install the Content Acquisition System (CAS) to deploy the Discover Electronics reference application using Forge.

The syntax to run the silent deployment is the following: 

On Windows: deploy.bat –-app <FULL_PATH_TO_DESCRIPTOR_FILE> --install-config <FULL_PATH_TO_RESPONSE_FILE> --no-prompt

On UNIX: deploy.sh –-app <FULL_PATH_TO_DESCRIPTOR_FILE> --install-config <FULL_PATH_TO_RESPONSE_FILE> --no-prompt

where the options have the following values. Note that both options are required.

Option

Description

FULL_PATH_TO_DESCRIPTOR_FILE

The full path to the descriptor file that uses Forge. For example, C:\Endeca\ToolsAndFrameworks\11.3.0\reference\discover-data\deploy.xml

FULL_PATH_TO_RESPONSE_FILE

The full path to the response file which is used by the silent deployment script. For example, C:\Users\<myname>\install\install_config.xml.

To deploy the Discover Electronics reference application silently:

  1. Ensure that the Oracle Tools Service is running.

  2. If you haven't already, create a directory for deployed Endeca applications, such as C:\Endeca\Apps on Windows, or /usr/local/endeca/apps on UNIX.

  3. If you have logged into the Oracle Commerce Workbench and changed the admin password, run the manage_credentials.bat script to update credentials in the credential store.

    1. Navigate to the <installation path>\ToolsAndFrameworks\<version>\credential_store\bin directory on Windows, or the equivalent path on UNIX.

    2. Run the manage_credentials.bat script as follows: 

      manage_credentials.bat add --key ifcr

    3. Type yes when asked if you want to replace existing credential of type [password]

  4. In a text editor, create the response file and save it as install_config.xml in the C:\Users\<myname>\Downloads\OCxmgr_installer<version>-win64\cd\Disk1\install directory. 

    <install app-name="Discoverforge">
  <deployment-path>/localdisk/endeca/apps</deployment-path>
  <base-module type="dgraph" />
  <options>
    <option name="eac-port">8888</option>
    <option name="workbench-port">8006</option>
    <option name="dgraph1Port">20000</option>
    <option name="authoringDgraphPort">20002</option>
    <option name="logserverPort">20010</option>
    <option name="jps-config-location">/localdisk/endeca/ToolsAndFrameworks/11.3.0/server/workspace/credential_store/jps-config.xml</option>
    <option name="application-export-directory">/localdisk/endeca/ToolsAndFrameworks/11.3.0/server/workspace/state/repository</option>
    <option name="authoring-application-export-directory">/localdisk/endeca/ToolsAndFrameworks/11.3.0/server/workspace/state/generation_data</option>
    <option name="language-code">en</option>
  </options>
</install>

    The Forge-based version of the Discover Electronics Reference application is available in English only. Therefore, specifying the language code is optional.

  5. From a command prompt, navigate to the <installation path>\ToolsAndFrameworks\<version>\deployment_template\bin directory on Windows, or the equivalent path on UNIX..

  6. Run the deploy script and specify all the options described above.

Example 4. Example

deploy.bat --app C:\Endeca\ToolsAndFrameworks\11.3.0\reference\discover-data\deploy.xml --install-config C:\Users\<myname>\install\install_config.xml --no-prompt

Copyright © Legal Notices