2 Installing Oracle Traffic Director

This chapter provides information about installing Oracle Traffic Director.

If installing Oracle Traffic Director on engineered systems, first perform the procedures described in Appendix B, "Requirements for Installing Oracle Traffic Director on Engineered Systems"

This chapter contains the following sections:

2.1 Microsoft C Runtime Libs Required for OTD Installation

MSVC 12 runtime Libraries must be installed separately before installing OTD. You must install Visual C++ Redistributable Packages for Visual Studio, which can be found at:

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

2.2 Prerequisites for Installing Oracle Traffic Director

The following are the prerequisites for installing Oracle Traffic Director.

  • At least 1 core CPU with 4 GB RAM and 4 GB Swap.

  • The following packages are mandatory for installing Oracle Traffic Director on Oracle Linux 6 for Exalogic.

    • 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

  • The following packages are mandatory for installing Oracle Traffic Director on Oracle Linux 6 or 7 for other hardware.

    • 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

For information on installing Oracle WebLogic Server, see Installing Oracle WebLogic Server. 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.

2.2.1 Prerequisites for Installation in a Collocated Domain

These additional prerequisites are required if installing Oracle Traffic Director in a collocated domain with Oracle WebLogic Server. In this configuration, Oracle Traffic Director is administered through Oracle WebLogic Server.

  • Oracle WebLogic Server (wls_jrf_generic.jar)

  • Java SE Development Kit 8

The recommended configuration for a collocated domain uses the Restricted JRF template and does not include a database. If this template is not used, 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).

  • Creation of a domain repository.

2.3 Installation Procedure

This section describes how to install Oracle Traffic Director as a physical application.

You can install Oracle Traffic Director either by using a graphical wizard or in silent mode.

2.3.1 Installing Oracle Traffic Director in Graphical Mode

This section describes how to install Oracle Traffic Director by using an interactive graphical wizard provided by the Oracle Universal Installer. In order to configure Oracle Traffic Director for high availability, the steps below must be performed on two mount points.

  1. Download the installer file.

    The location from which you should download the installer file varies depending on how you intend to use the product:

  2. Click Sign-in/Register.

    Note:

    If you are not already logged in, the Oracle Single Sign-On page appears. Enter your Oracle user id and password and click Sign In.

    The Terms & Restrictions page appears

  3. Click Accept to agree to the Export Restrictions, and then click Continue.

    The Oracle Software Delivery Cloud page appears.

  4. Go to the directory in which you downloaded the installer

  5. Run the following command to launch the installation wizard:

    • On Linux:

      $./otd_linux64.bin
      
    • On Windows:

      setup_otd_win64.exe
      
  6. Follow the on-screen prompts and instructions provided on the screens of the installation wizard. Table 2-1 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-1 Screens of the Installation Wizard

    Screen Description and Action Required

    Installation Inventory Setup

    On UNIX operating systems, this screen will appear 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 Oracle Fusion Middleware Installing Software with the Oracle Universal Installer in Oracle Fusion Middleware Installing Software with the Oracle Universal Installer.

    This screen will not appear on Windows operating systems.

    Welcome

    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 "Selecting Directories for Installation and Configuration" 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.

    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

    Click Finish.


Note:

After installing Oracle Traffic Director, you must create the administration server instance.

2.3.2 Installing Oracle Traffic Director in Silent Mode

This section describes how to install Oracle Traffic Director in noninteractive mode by specifying installation options at the command line. On Exalogic, in order to configure Oracle Traffic Director for high availability, the steps below must be performed on two mount points.

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 the "UNIX Users: Creating the oraInst.loc File" section of the Oracle Fusion Middleware Installation Planning Guide.

  1. Perform steps 1, 2, and 3 of Section 2.3.1, "Installing Oracle Traffic Director in Graphical Mode."

  2. Verify that the prerequisites listed in Section 2.2, "Prerequisites for Installing Oracle Traffic Director" are fulfilled.

  3. Run the following command:

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

    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 cannot be used while performing silent installation of Oracle Traffic Director, as this option will cause the installation to fail.

    For information about the options of the runInstaller command, see the "Silent Oracle Fusion Middleware Installation and Deinstallation" section of the Oracle Fusion Middleware Installation Planning Guide.

2.4 Troubleshooting Installation Problems

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

  • Verify that your computer meets the requirements specified in Section 2.2, "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 Section 3.1.1, "Examine the Installation Log."

    2. Remove the failed installation by running the following command:

      $ORACLE_HOME/oui/bin/deinstall.sh
      
    3. Correct the issue that caused the error.

    4. Restart the installation process.