4 Deploying Oracle Software on Oracle Database Appliance

This chapter provides a checklist of tasks to deploy Oracle software after you have established connectivity to Oracle Database Appliance

Topics:

About Deploying Oracle Database Appliance Software Using OAKCLI

Review this information to understand the steps required for different deployments, where log files are placed, and how to change deployment types.

Tasks in this chapter are marked to indicate if they apply to Bare Metal deployments, Virtualized Platform deployments, or both. Perform only the tasks designated for a deployment on your platform.

Deploying Oracle Database Appliance software requires approximately 1 hour to complete for Bare Metal installations, and about 3 hours for Virtualized Platform deployments.

Note:

If you are planning to convert from Oracle Database Appliance Virtualized Platform to a bare metal deployment, first check with My Oracle Support to confirm that you have a compatible image installed.

Recovering from Failed Deployments, Or Changing Deployments

You can use the cleanup script cleanupDeploy.sh described in this chapter to reset your system. Use the cleanup script if you want to do the following tasks:

  • Repeat a failed deployment

  • Convert from a Bare Metal deployment to a Virtualized Platform deployment

  • Convert from a Virtualized Platform deployment to a Bare Metal deployment

About OAKCLI Deploy Command Log Files

The oakcli deploy command creates log files in the following filepath:

/opt/oracle/oak/onecmd/tmp/

Log files are prefaced with the string STEP. For example:

/opt/oracle/oak/onecmd/tmp/STEP-6-20160226103534.log

Deploying Virtualized Platform Oracle Database Appliance Software

Complete this procedure to deploy a Virtualized Platform configuration on Oracle Database Appliance

The procedure to deploy software in a Virtualized Platform configuration consists of the following steps:

  1. Check Oracle Database Appliance hardware to see if it is configured with a virtual machine (VM).

  2. Install the ODA_BASE template on Oracle Database Appliance.

  3. Prepare the appliance to run Oracle Appliance Manager Configurator.

  4. Deploy your configuration using Oracle Appliance Manager.

You must complete the deployment tasks in the order that they are listed.

  1. Log in as root with the password welcome1.
  2. Enter the command oakcli show env_hw
    This command displays the Oracle Database Appliance hardware on which you are deploying. If the output of this command is prefixed with the string VM-ODA_BASE, then the system is configured with a virtual machine (dom0/oda_base).

    For example, the output of each of the following commands shows both the hardware platform, and that the platform is configured with a virtual machine environment:

    [root@oda1n1 ~]# oakcli show env_hw VM-ODA_BASE ODA V1

    [root@oda2n1 ~]# oakcli show env_hw VM-ODA_BASE ODA X3-2

    [root@oda3n1 ~]# oakcli show env_hw VM-ODA_BASE ODA X4-2

    [root@oda3n1 ~]# oakcli show env_hw VM-ODA_BASE ODA X5-2

    If you do not have a virtual machine deployed on your appliance, then refer to My Oracle Support note 1520579.1 for the procedure to install a virtual machine:

    https://support.oracle.com/epmos/faces/DocumentDisplay?cmd=show&type=NOT&id=1520579.1

  3. Log in to My Oracle Support, and download and install the ODA_BASE Template.

    Complete the following steps to download the appropriate ODA_BASE template to an external client, and then copy the template to your Oracle Database Appliance.

    1. From an external client machine, log on to My Oracle Support and access note 888888.1:
    2. In the Latest Releases section, under OS ISO Image / Bare Metal - Virtualized Platform, find the link to the patch number that is described as "VM Template (ODA_BASE), and click the link.
    3. From the Patch Search Results page, download the current Oracle Database Appliance ODA_BASE template onto your external client.
    4. Use either a Secure Copy (scp) command or a USB storage device to copy the ODA_BASE template from the external client to Dom0 on Node 0. Use the /scp or /OVS directory as the target location.

      Note:

      If you choose to use a USB drive to transfer the file, then format it first as FAT32, ext3, or ext4. NTFS file formats are not supported.

    5. Log in to Dom0 as root on Node 0 of Oracle Database Appliance Virtualized Platform, and copy the ODA_BASE template to the /OVS directory on Dom0 if it is not already there. Remain logged in to Dom0 while you complete the remaining steps in this task.
    6. Run the command oakcli deploy oda_base, and provide the template location, core licensing options, and select the base domain memory allocation.

      The deploy oda_base option automatically deploys ODA_BASE on both nodes. If your ODA_BASE template is in the /OVS directory, then your deployment dialog should look similar to the following example (values, such as the number of available CPU cores, differ between Oracle Database Appliance Virtualized Platform hardware platforms):

      # oakcli deploy oda_base
Enter the template location: /OVS/templateBuild-2012-12-22-12-05.tar.gz
Core Licensing Options:
        1.  2 CPU Cores
                2.  4 CPU Cores
3.  6 CPU Cores
4.  8 CPU Cores
5.  10 CPU Cores
6.  12 CPU Cores
7.  14 CPU Cores
8.  16 CPU Cores
9.  24 CPU Cores
10. 36 CPU Cores
                Selection [1 : 6] : 3
                ODA base domain memory in GB (min 16, max 244)(Current Memory 150G)[default 192]  : 32
      Continue configuration choices in the next step.
    7. Assign additional virtual local area networks (VLANs) to your ODA_BASE.

      To assign VLANs, respond with y when you are prompted for VLAN networks, and respond with n if you do not want to deploy another VLAN, or if you have completed assigning additional VLANs.

      Additional vlan networks to be assigned to oda_base ? (y/n) : y
Select the network to assign [Test00,Test01,Test02,Test03]: Test00
Additional vlan networks to be assigned to oda_base ? (y/n) : y
Select the network to assign [Test00,Test01,Test02,Test03]: Test01
Additional vlan networks to be assigned to oda_base ? (y/n) : n
    8. When the command completes, verify that your deployment of ODA_BASE is valid by running the command show oda_base, and confirming that ODA_BASE is configured.

      For Example:

      # oakcli show oda_base
ODA base domain
ODA base CPU cores :2
ODA base domain memory :16
ODA base template :/tmp/oda_base_2.10.tar.gz
ODA base vlans :['priv1', 'net1', 'net2', 'net3', 'net4', 'db_mgmt']
ODA base current status :Running

      Note:

      If you encounter problems, and need to clean up and start again with a new ODA_BASE deployment, then first run the following command from Dom0 on Node 0:

      /opt/oracle/oak/tools/cleanOdabase.py

      This command removes ODA_BASE, so that you can try a fresh deployment.

    9. For Oracle Database Appliance X3-2, Oracle Database Appliance X4-2, or Oracle Database Appliance X5-2, Oracle recommends that you check the storage cabling before continuing with deployment.

      To perform this check, connect to ODA_BASE on Node 0 using root for the user name and welcome1 for the password. After connecting, run the following command:

      # oakcli validate -c storagetopology

      The command displays errors if the cables between the two nodes and the storage shelf or shelves are not in the correct sockets.

  4. Log in to Node 0 as root, and log in to ODA_BASE by starting VNC, using hostname: dom0, and port: 5900.
  5. From the VNC session, run the command startx to start an X Window System Xterm session.
  6. Start the deployment using oakcli deploy. Either use an existing configuration file that you created earlier, or build a new one.

    For example, to start the deployment using an existing configuration, enter a command similar to the following, substituting your file's name and directory path:

    # oakcli deploy -conf /tmp/onecommand.param

    If the command oakcli deploy fails to open the Oracle Appliance Manager Welcome window, then check to make sure that your DISPLAY variable is set to display to your terminal.

    Note:

    Do not use a configuration file created for an earlier version of Oracle Appliance Manager Configurator. If you do not have a current configuration file, then complete a real-time configuration and deployment, as described in the following step.

    To initiate a real-time configuration and deployment, enter the following command:

    # oakcli deploy

    Follow the instructions to complete the Oracle Appliance Manager Configurator screens, as described in “Running the Standalone Oracle Database Appliance Configurator." Select the Install option on the Configurator Summary page to complete the deployment.

See Also:

Deploying Bare Metal Platforms on Oracle Database Appliance

Complete this procedure to deploy Oracle software directly on the appliance, also known as a Bare Metal configuration of Oracle Database Appliance.

The procedure to deploy software in a bare-metal configuration consists of the following steps:

  1. Install the end-user bundle for Bare Metal platform deployments

  2. Prepare the appliance to run Oracle Appliance Manager Configurator

  3. Deploy your configuration using Oracle Appliance Manager.

You must install the end-user bundle on Oracle Database Appliance before you deploy any other software. To install the end-user bundle, download the appropriate patch file to an external client. Copy the patch from your client to Oracle Database Appliance, and install the patch.

You must complete the steps in the order listed.

  1. Log on to My Oracle Support from an external client, and access My Oracle Support note 888888.1.
  2. In the Latest Releases section, under OS ISO Image / Bare Metal - Virtualized Platform, find the link to the current patch numbers that are described as Oracle Database Appliance End User Bundle (GI+RDBMS) and Oracle Database Appliance Bare Metal ISO Image, and click the link to download the patches.
  3. Copy the patches from the external client to Oracle Database Appliance.

    You can copy the file either by using a Secure Copy command (scp), or by using a USB storage device.

    To use a USB drive to transfer the file, you must format it first as FAT32, ext3, or ext4. NTFS file formats are not supported.

    To use secure copy, you must first set up a static IP address (for example. oda_host) and configure Oracle Database Appliance with that address by using the oakcli configure firstnet command.

    For example, if you use the scp command, then enter a command similar to the following, where the temporary host address is oda_host, and you are copying the bundle to /tmp:

    scp p12978712_121260_Linux-x86-64_1of2.zip root@odahost:/tmp

    scp p12978712_121260_Linux-x86-64_2of2.zip root @odahost:/tmp

  4. Use the command syntax oakcli unpack -package /directory_path/package_name to unpack the Oracle Database Appliance software, where directory_path is the path where the end-user bundle patch file is located, and package_name is the name of the package.

    For example, if the end-user bundle patch files for Oracle Database Appliance Release 12.1.2.6.0 are in /tmp, and the patch names are p12978712_121260_Linux-x86-64_1of2.zip and p12978712_121260_Linux-x86-64_2of2.zip, then enter the following commands:

    # oakcli unpack -package /tmp/p12978712_121260_Linux-x86-64_1of2.zip
# oakcli unpack -package /tmp/p12978712_121260_Linux-x86-64_2of2.zip

    The command oakcli unpack unpacks the bundle patch, and places the extracted files in the directory locations required for deployment.

  5. Log in to Node 0 of Oracle Database Appliance as the root user using the default password.
  6. Run the command startx start an X Window System Xterm session.
  7. (Optional) If you want to deploy from a configuration file that you created offline, then use scp or a USB drive to copy the configuration file to Oracle Database Appliance.
  8. Run a configuration using Oracle Appliance Manager Configurator.

    To run a configuration using a configuration file, run the following command:

    oakcli deploy -conf /tmp/onecommand.param.

    This command opens the Oracle Appliance Manager Configurator using an existing configuration file.

    Do not use a configuration file created for an earlier version of Oracle Appliance Manager Configurator. If you do not have a current configuration file, then complete a real-time configuration and deployment.

    To run a real-time configuration and deployment, enter the following command:

    oakcli deploy

    This command opens Oracle Appliance Manager Configurator graphic user interface, which prompts you to provide information for the deployment.

    Note:

    If the command oakcli deploy fails to open the Welcome window in Oracle Appliance Manager Configurator, then set the user DISPLAY variable to display to your terminal window.

  9. Refer to the step-by-step procedure for Oracle Appliance Manager Configurator, as described in the section "Running the Standalone Oracle Database Appliance Configurator"
See Also: