2 Installing Oracle Traffic Director

To install Oracle Traffic Director, you need to understand its prerequisites and procedures.

This section contains the following topics:

Prerequisites for Installing Oracle Traffic Director

There are mandatory configurations and packages required to Install Oracle Traffic Director.

The following table lists the prerequisites for installing Oracle Traffic Director on various platforms.

Table 2-1 Prerequisites for Installing OTD

Platforms Prerequisites

Oracle Linux 6 for Exalogic

The following are pre-requisite packages for OTD installation:
  • compat-glibc-2.3.4-x86_64 or higher

  • binutils-2.20.51.0.2-5.11.el6-x86_64 or higher

  • compat-libcap1-1.10-1-x86_64 or higher

  • compat-libstdc++-33-3.2.3-69.el6-x86_64 or higher

  • compat-libstdc++-33-3.2.3-69.el6-i686 or higher

  • libgcc-4.4.4-13.el6-i686 or higher

  • libgcc-4.4.4-13.el6-x86_64 or higher

  • libstdc++-4.4.4-13.el6-x86_64 or higher

  • libstdc++-4.4.4-13.el6-x86_64 or higher

  • libstdc++-devel-4.4.4-13.el6-x86_64 or higher

  • sysstat-9.0.4-11.el6-x86_64 or higher

  • gcc-4.4.4-13.el6-x86_64 or higher

  • gcc-c++-4.4.4-13.el6-x86_64 or higher

  • glibc-2.12-1.7.el6-i686 or higher

  • glibc-2.12-1.7.el6-x86_64 or higher

  • glibc-devel-2.12-1.7.el6-x86_64 or higher

  • glibc-devel-2.12-1.7.el6 or higher

  • libaio-0.3.107-10.el6-x86_64 or higher

  • libaio-devel-0.3.107-10.el6-x86_64 or higher

Oracle Linux 6 or 7 for other hardware

The following are pre-requisite packages for OTD instalation:
  • binutils-2.20.51.0.2-5.11.el6-x86_64 or higher

  • compat-libcap1-1.10-1-x86_64 or higher

  • compat-libstdc++-33-3.2.3-69.el6-x86_64 or higher

  • compat-libstdc++-33-3.2.3-69.el6-i686 or higher

  • libgcc-4.4.4-13.el6-i686 or higher

  • libgcc-4.4.4-13.el6-x86_64 or higher

  • libstdc++-4.4.4-13.el6-x86_64 or higher

  • libstdc++-4.4.4-13.el6-x86_64 or higher

  • libstdc++-devel-4.4.4-13.el6-x86_64 or higher

  • sysstat-9.0.4-11.el6-x86_64 or higher

  • gcc-4.4.4-13.el6-x86_64 or higher

  • gcc-c++-4.4.4-13.el6-x86_64 or higher

  • glibc-2.12-1.7.el6-i686 or higher

  • glibc-2.12-1.7.el6-x86_64 or higher

  • glibc-devel-2.12-1.7.el6-x86_64 or higher

  • glibc-devel-2.12-1.7.el6 or higher

  • libaio-0.3.107-10.el6-x86_64 or higher

  • libaio-devel-0.3.107-10.el6-x86_64 or higher

Windows

Microsoft Visual C++ 12 runtime Libraries must be installed separately before installing OTD. You can download Visual C++ Redistributable Packages for Visual Studio 2013 by clicking the following link:

https://www.microsoft.com/en-us/download/details.aspx?id=40784

AIX

The following APAR are required:
  • 6100-08 - use AIX APAR IV23241

  • 7100-02 - use AIX APAR IV23727

Prerequisites for Installing Oracle Traffic Director in a Collocated Domain

These additional prerequisites are required if you are installing Oracle Traffic Director in a collocated domain with Oracle WebLogic Server. Oracle Traffic Director can either be administered through Fusion Middleware Control or using WLST commands. In this configuration, Oracle Traffic Director is administered through Fusion Middleware Control.

  • Oracle WebLogic Server (fmw_12.2.1.x.0_infrastructure_generic.jar)

  • Java SE Development Kit 8

Note:

For information on installing Oracle WebLogic Server, see Installing and Configuring Oracle WebLogic Server and Coherence. For information on performing administration tasks, see Administering Oracle WebLogic Server and Administering Oracle Traffic Director. For a list of custom Oracle Traffic Director WLST commands see Oracle Traffic Director WLST Command Reference.

The recommended configuration for a collocated domain is to use the Restricted JRF template that does not require a database. If the Full JRF template is used instead, then the following are additional requirements:

  • Oracle Database (Without a Restricted JRF template, the Oracle Traffic Director domain creation requires a running Oracle database to successfully complete the installation.)

  • Domain repository

Installation Procedure

There are two types of installations, Collocated and Standalone. As per your organizational requirement, you can install Oracle Traffic Director in a Standalone mode or in a Collocated domain with the WebLogic Server. Also, you can use the Graphical User Interface or a silent mode to complete the installation.

The following lists the names of the installer for various platforms:
  • Linux: fmw_12.2.1.3.0_otd_linux64.bin

  • Windows: fmw_12.2.1.3.0_otd_win64.exe

  • AIX: fmw_12.2.1.3.0_otd_aix_ppc64.bin

  • Solaris Sparc: fmw_12.2.1.3.0_otd_solaris_sparc64.bin

  • Solaris x64: fmw_12.2.1.3.0_otd_intelsolaris.bin

This chapter contains the following sections:

Installing a Standalone or a Collocated Oracle Traffic Director in Graphical Mode

Both Standalone and Collocated OTD can be installed in graphical mode.

Note:

To install collocated OTD, you need to install WebLogic Server (fmw_12.2.1.3.0_infrastructure_generic.jar) first. For information on installing Oracle WebLogic Server, see Installing and Configuring Oracle WebLogic Server and Coherence. For a list of custom Oracle Traffic Director WLST commands see Oracle Traffic Director WLST Command Reference.

Note:

The common infrastructure made available to OTD from Weblogic server installation enables administration of OTD through the FMW control or using WLST command in collocated mode; whereas, these administration options are not available in standalone mode install.

Perform the following steps to install Oracle Traffic Director in Graphical Mode:

  1. Sign in to the target system.
  2. Download the following from Oracle Technology Network or Oracle Software Delivery Cloud to your target system:
    (UNIX: fmw_12.2.1.3.0_otd_linux64.bin), (Windows: setup_fmw_12.2.1.3.0_otd_win64.exe), (SPARC: ./fmw_12.2.1.3.0_otd_solaris_sparc64.bin), (Solaris x64: ./fmw_12.2.1.3.0_otd_intelsolaris.bin), (AIX: ./fmw_12.2.1.3.0_otd_aix_ppc64.bin)
  3. Change to the directory where you downloaded the 12c (12.2.1.3.0) product distribution.
  4. Start the installation program by entering the following command:
    (UNIX) ./fmw_12.2.1.3.0_otd_linux64.bin
    (Windows) fmw_12.2.1.3.0_otd_win64.cmd
    (SPARC) ./fmw_12.2.1.3.0_otd_solaris_sparc64.bin
    (Solaris x64) ./fmw_12.2.1.3.0_otd_intelsolaris.bin
    (AIX) ./fmw_12.2.1.3.0_otd_aix_ppc64.bin
  5. Follow the installation wizard on-screen prompts and instructions. Table 2-2 provides a brief description of each screen and the action required on the screen.

    For more information about a specific screen, click the Help button on the screen.

    Table 2-2 Screens of the Installation Wizard

    Screen Description and Action Required

    Installation Inventory Setup

    On UNIX operating systems, this screen appears if this is the first time you are installing any Oracle product on this host. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location.

    For more information about the central inventory, see About the Oracle Central Inventory in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

    This screen doesn’t appear on Windows operating systems.

    Welcome

    Review the information to make sure that you have met all the prerequisites, then click Next.

    Auto Updates

    Select whether or not you want to receive automatic updates for this product.

    Installation Location

    Use this screen to specify the location of your Oracle home directory.

    Oracle home is the directory in which software binaries for Oracle products are stored. Note that run-time processes cannot write to this directory.

    If you are installing using the standard installation topology for Oracle Traffic Director in a WebLogic Server domain, then you must enter the path to an existing Oracle Fusion Middleware Infrastructure Oracle home.

    If you are installing using the standard installation topology for Oracle Traffic Director in a standalone domain, you can specify an Oracle home directory of your choice. However, ensure that you install the software in a new Oracle home.

    For more information about Oracle Fusion Middleware directory structure, see About the Recommended Directory Structure in Planning an Installation of Oracle Fusion Middleware.

    Installation Type

    Use this screen to select the type of installation and consequently, the products and feature sets you want to install.

    Select Standalone OTD (Managed independently of WebLogic server) if you are installing Oracle Traffic Director in a Standalone domain or installing Oracle Traffic Director in a remote node of a collocated domain.

    Select Collocated OTD (Managed through WebLogic server) if you are installing Oracle Traffic Director in a WebLogic Server domain on the administration server node.

    JDK Selection

    This screen allows you to select the JDK version that is used for the installation.

    Prerequisite Checks

    The installer analyzes the host computer to ensure that the prerequisites are fulfilled. The results of the prerequisite checks are displayed on this screen.

    If a prerequisite check fails, an error or warning message is displayed.

    • Fix the error and click Rerun. For example, if any of the required packages listed in Prerequisites for Installing Oracle Traffic Director are not available in the system, install them.

    • To ignore the error or warning and continue with the installation, click Skip.

    • To stop the prerequisite checking process, click Stop.

    Click Next to continue.

    Specify Security Updates

    If you already have an Oracle Support account, use this screen to indicate how you would like to receive security updates.

    If you do not have one and are sure you want to skip this step, clear the check box and verify your selection in the follow-up dialog box.

    Installation Summary

    This screen displays the Oracle home directory that you specified earlier. It also indicates the amount of disk space that will be used for the installation and the free space available.

    Review information on this screen.

    To change the Oracle home directory, click the Back button or the Installation Location link in the left navigation pane.

    To save the settings specified so far in the installation wizard in a text file (called a response file), click Save. If necessary, you can use the response file to perform the same installation from the command line.

    Click Install to proceed with the installation process.

    For more information about silent or command line installation, see Using the Oracle Universal Installer in Silent Mode in Installing Software with the Oracle Universal Installer.

    Installation Progress

    This screen shows the progress and status of the installation process.

    If you want to cancel the installation, click Cancel. The files that were copied to your system before you canceled the installation will remain on the system; you should remove them manually.

    Click Next to continue.

    Installation Complete

    This screen displays the Installation Location and the Feature Sets that are installed. Review this information and click Finish to close the installer.

Installing a Collocated or a Standalone Oracle Traffic Director in Silent Mode

This section describes how to install collocated or standalone Oracle Traffic Director in silent mode by specifying installation options at the command line.

If a central inventory directory is not already available on the host on which you are installing Oracle Traffic Director, you must create an oraInst.loc file before starting the silent installation. For more information, see Oracle Central Inventory Location on UNIX Operating Systems in Installing Software with the Oracle Universal Installer.

For ExaLogic, the path that you provide for ORACLE_HOME must be the NFS share that is mounted locally within the compute node.

Note:

The ignoreSysPrereqs option should not be used while performing silent installation of Oracle Traffic Director, as this option will cause the installation to fail.

  1. Sign in to the target system.
  2. Download the following from Oracle Technology Network or Oracle Software Delivery Cloud to your target system:
    (UNIX: fmw_12.2.1.3.0_otd_platform_linux64.bin), (Windows: setup_fmw_12.2.1.3.0_otd_platform_win64.exe)
  3. Change to the directory where you downloaded the 12c (12.2.1.3.0) product distribution.
  4. Verify that the prerequisites listed in Prerequisites for Installing Oracle Traffic Director are fulfilled.
  5. Run the following command for collocated or standalone OTD:

    For collocated OTD:

    ./xxx.bin -silent ORACLE_HOME=$ORACLE_HOME DECLINE_SECURITY_UPDATES=true INSTALL_TYPE="Collocated OTD (Managed through WebLogic server)" -invPtrLoc testhome/oraInventory/inv.txt

    For standalone OTD:

    xxx.bin -silent ORACLE_HOME=$ORACLE_HOME DECLINE_SECURITY_UPDATES=true INSTALL_TYPE="Standalone OTD (Managed independently of WebLogic server)" -invPtrLoc /scratch/oraInventory/inv.txt

    Note:

    The above commands show .bin files for Linux. However, for your platform specific file names, see Installation Procedure

    For information about the options of the runInstaller command, see Running the Oracle Universal Installer in Silent Mode section of Fusion Middleware Installing Software with the Oracle Universal Installer.

Troubleshooting Installation Problems

It is important to understand the known errors that may occur during the installation. You can follow the troubleshooting procedure in order to fix them.

If you encounter an error while installing Oracle Traffic Director, do the following:

  • Verify that your system meets the requirements specified in Prerequisites for Installing Oracle Traffic Director

  • While using the installation wizard, if you realize that you entered incorrect information on one of the installation screens, then return to that screen by clicking Back, enter the correct information and proceed with the installation

  • If an error occurs while the installer is copying or linking files:

    1. Note the error and review the installation log files. For more information, see Examining the Installation Log.

    2. Remove the failed installation by entering the following command: ORACLE_HOME/oui/bin/deinstall.sh

    3. Correct the issue that caused the error.

    4. Restart the installation process.