Installing Oracle Commerce Tools and Frameworks on UNIX

To install Oracle Commerce Tools and Frameworks, extract the package the ZIP archive to your local install directory and run the included runinstaller script.

If you have an earlier version of Oracle Commerce Tools and Frameworks, you must follow the steps in the Oracle Commerce Tools and Frameworks Installation Guide to remove it before installing the latest version.

To install Oracle Commerce Tools and Frameworks:

  1. Download the Tools and Frameworks package from the Oracle Software Delivery Cloud.

  2. Extract the Tools and Frameworks package to a local directory.

  3. If you log on to the UNIX machine through SSH, you must use an X-Windows client to start the installation wizard.

  4. Navigate to the /cd/Disk1/install directory.

    Note

    Verify that the files have executable permissions.

  5. Run runinstaller.sh.

    The Welcome screen displays.

  6. Click Next to begin the installation process.

  7. Read the License Agreement and click I accept the License Terms and Export Restrictions.

  8. If this is the first product that you have installed on this machine using the Oracle Universal Installer, the Specify Inventory directory screen appears.

    1. Specify the directory where the Oracle Universal Installer should place inventory files and directories. Oracle recommends that you accept the default path.

      The Installer uses the Oracle Inventory directory to store inventory information in files and subdirectories. This directory contains permanent and product specific files. Ensure that the files in this folder are not deleted or modified, as this would make patching or upgrading impossible.

    2. Specify the UNIX group name that should own the base directory.

      You must specify a UNIX group name that has permission to update, install, and uninstall Oracle software. Members of this group must have write permissions to the base directory chosen.

    3. Click Next

  9. Choose the installation type, and click Next.

    The Complete Installation includes the reference application; the Minimal Installation does not.

  10. Specify a name and a path where you want to install Tools and Frameworks. Oracle recommends /usr/local/endeca/ToolsAndFrameworks as your path. This is the path that Oracle refers to as your default path throughout the Oracle Commerce documentation.

    Click Next.

    Note

    If you are reinstalling Tools and Frameworks and you receive a message that the name is in use, click Installed Products and remove the previous instance of the name from your Oracle Inventory.

  11. When the Summary screen appears, click Install.

  12. When the End of Installation screen appears, click Exit.

    Note

    If you receive a warning that a new inventory has been created but not yet registered, then you must register the new inventory. Run the /oraInventory/orainstRoot.sh script with root privileges. If you do not register the inventory, you might not be able to update or patch the products you installed or uninstall Tools and Frameworks silently. Run the script as the root user or using sudo with permissions to run the file.

  13. Navigate to the server/bin directory.

  14. Run startup.sh.

    This script sets the environment variables for your Tools and Frameworks installation and initializes the Apache Tomcat Web server, with Workbench running on localhost:8006 as a background process.

    To manage the Workbench process after installation:

Once the Tools and Frameworks are running, you can provision the Discover Electronics reference application using the Deployment Template.

Note

By default, Workbench runs on port 8006 of your machine. If port 8006 is unavailable on your machine, you must change this to a different port. Additionally, if you are not running the Endeca Application Controller on localhost:8888, you must update the EAC configuration for Workbench.

Related links

Copyright © Legal Notices