Skip Headers
Oracle® Database Appliance Getting Started Guide
Release 2.10 for Linux x86-64

E22692-36
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

3 Deploying Oracle Software on Oracle Database Appliance

This chapter provides a checklist of tasks to deploy Oracle software after you have connectivity to Oracle Database Appliance as described in Chapter 2. Deploying Oracle Database Appliance software requires approximately 1 hour to complete for bare metal installations and about 3 hours for virtualized platform deployments. The extra time for virtualized deployments is required to complete additional steps and because some operations take longer when configuring virtual domains.

Each task in this chapter identifies whether it applies to a bare metal platform, to a virtualized platform, or to all platforms. Take care to perform only the tasks designated for a deployment on your platform: tasks 1, 3, 4, and 5 are for Oracle Database Appliance Virtualized Platform deployments, tasks 2, 4, and 5 are for Oracle Database Appliance bare metal deployments.

You can repeat a failed deployment, or perform a new deployment to convert from a bare metal to a virtualized platform, or from a virtualized to a bare metal platform, after running a cleanup script as described at the end of this chapter.

See Also:

Oracle Database Appliance Setup Poster for an overview of the deployment process

Deployment Tasks: An Annotated Check List

You must complete the deployment tasks in the order that they are listed. However, some tasks are not needed for bare metal deployments and other steps are not needed for virtualized platform deployments. When you are not required to complete a task for your type of deployment, continue with the next required task.

Task 1: Check Oracle Database Appliance Virtualization Status (Virtualized Platform Deployments Only)

To check whether Oracle Database Appliance has a virtualized image installed, log in as root with the password welcome1 and enter the command oakcli show env_hw. If the output contains the value VM-Dom0 along with the version of your hardware, then you can proceed with deployment of Oracle Database Appliance Virtualized Platform as described in the next section. If the command does not produce the required output or generates errors, then you must install the Oracle Database Appliance virtualized image.

Note:

Find instructions to install the Oracle Database Appliance virtualized image in the white paper "Step by Step Instructions on Installing Virtualized Image on Oracle Database Appliance" at https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=1520579.1

After installing the virtualized image, you may need to reconfigure your initial network as described in "Configuring an Initial Network".

Task 2: Install the End-User Bundle (Bare Metal Platform Deployments Only)

You must install the end-user bundle on Oracle Database Appliance before you deploy any other software. This requires downloading the appropriate patch file to your external client and then copying and installing the patch as described in the following steps.

  1. From an external client machine, log on to My Oracle Support and access note 888888.1 at:

    https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=888888.1

  2. In the Latest Releases section, find the link to the patch described as "End User Bundle (GI+RDBMS)."

  3. Click the link to download the current Oracle Database Appliance end-user bundle patch onto your external client.

  4. Copy the end-user bundle patch to a location on Oracle Database Appliance (for example, the /tmp directory) using a secure copy (scp) command by navigating to the folder on your client where you downloaded the end-user bundle patch, then enter a command similar to the following (which shows an Oracle Database Appliance Release 2.9 file):

    scp p17630388_29000_Linux-x86-64.zip root@oda_host:/tmp
    

    This example assumes that you set up a static IP address with the host name oda_host and configured Oracle Database Appliance with that address using oakcli configure firstnet.

    Alternatively, place the end-user bundle patch onto a USB storage device that you make accessible on Oracle Database Appliance. Go to go to the location of the End-User Bundle image on the device and run the oakcli unpack command.

    Note:

    Format any USB drives as FAT32, ext3, or ext4. NTFS file formats are not supported.
  5. Change the directory to /opt/oracle/oak/bin.

  6. 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.

    For example, if the end-user bundle patch file for Oracle Database Appliance Release 2.9 were in /tmp, then the following command would unpack p17630388_29000_Linux-x86-64.zip:

    # ./oakcli unpack -package /tmp/p17630388_29000_Linux-x86-64.zip
    

    The oakcli unpack command unpacks the files, and places them in the location required for deployment.

Task 3: Install the ODA_BASE Template (Virtualized Platform Deployments Only)

You must install the ODA_BASE template on Oracle Database Appliance before you deploy any other software. This requires downloading the appropriate ODA_BASE template to an external client and then copying the template to your Oracle Database Appliance as described in the following steps.

  1. From an external client machine, log on to My Oracle Support and access note 888888.1 at:

    https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=888888.1

  2. In the Latest Releases section, find the link to the patch described as "VM Template (ODA_BASE).

  3. Click the link to download the current Oracle Database Appliance ODA_BASE template onto your external client.

  4. Copy the ODA_BASE template from the external client to Dom0 with an scp command.

    Alternatively, you could place the ODA_BASE template onto a USB storage device and copy the template once the USB device is visible on Oracle Database Appliance.

    Note:

    Format any USB drives 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. Remain logged into Dom0 while you complete the remaining steps in this task.

  6. Use the command oakcli deploy oda_base and respond to the prompts to deploy ODA_BASE. This command 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):

    # /opt/oracle/oak/bin/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
                            Selection [1 : 6] : 3
                            ODA base domain memory in GB (min 8, max 88)[default 48]  : 32
    
  7. The oakcli deploy oda_base command also enables you to assign one or more virtual local area networks (VLANs) to your ODA_BASE. To deploy VLANs, respond with y when prompted for additional VLAN networks, and respond with n when you have no (or no more) VLANs to deploy, as shown in this partial example:

    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
    

    See Also:

    Section About Network Infrastructure and Virtual Local Area Networks on Oracle Database Appliance Virtualized Platform in Chapter 5 for more information about managing VLAN interfaces to Oracle Database Appliance Virtualized Platform.
  8. When the command completes, verify that your deployment of ODA_BASE is valid by running the xm list command. Examine the output to confirm that the Name column contains the values Domain-0 and oakDom1 as shown in the following example.

    [root@oak1 ~]# xm list
    
    Name                             ID   Mem  VCPUs  State    Time(s)
    Domain-0                          0  2039     24 r-----  119879.5
    oakDom1                           1 32768     12 r-----    1969.7
    

    Tip:

    If you have problems with your ODA_BASE deployment, then run the following command from Dom0 on Node 0:
    /opt/oracle/oak/tools/cleanOdabase.py
    

    This command will remove ODA_BASE so that you can try a fresh deployment.

  9. If you are deploying Oracle Database Appliance X3-2 or Oracle Database Appliance X4-2, then Oracle recommends that you check the storage cabling before continuing with deployment. To perform this check, connect to ODA_BASE using VNC with Dom0 for the hostname, 5900 for the port, root for the user name, and welcome1 for the password. After connecting, run the following command:

    /opt/oracle/oak/bin/oakcli validate -c storagetopology
    

    The command will display errors if the cables between the two nodes and the storage shelf or shelves are not in the correct sockets. For more details, see the section ”Cabling Validation Command” in Chapter 7.

Task 4: Prepare to Run Oracle Database Manager Configurator (All Platform Deployments)

Log into Node 0 of Oracle Database Appliance as the root user with the default password. If you are deploying on Oracle Database Appliance Virtualized Platform, then you need to connect to Dom0 through VNC using dom0 for the Hostname and 5900 for the Port.

If you want to deploy from a configuration file that you created offline, as described in "Using Oracle Appliance Manager Configurator," then copy the configuration file to Oracle Database Appliance using a command similar to the scp command used to copy the patch in Step 4 of your previous task. If you are deploying on Oracle Database Appliance Virtualized Platform, then you need to copy the file from Dom0 to ODA_BASE by using use another scp command to send the file to the internal IP address 192.168.16.27. You can place the configuration file in the /tmp directory for convenience, or into a more permanent location for future use.

Run the command startx to ready the X Window System for Oracle Appliance Manager configurator.

Note:

Set the DISPLAY variable in your terminal window if the oakcli deploy command fails to open the Welcome window in Oracle Appliance Manager configurator.

Task 5: Deploy Your Configuration (All Platform Deployments)

You must have a configuration file to deploy Oracle Database Appliance. You can use a file that you created earlier with the standalone Oracle Appliance Manager configurator or build a new one at this time. You can also use a configuration file previously built and saved on on Oracle Database Appliance.

To initiate the deployment using an existing configuration file, enter a command similar to the following, substituting your file's name and directory path as necessary:

# /opt/oracle/oak/bin/oakcli deploy -conf /tmp/onecommand.param

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:

# /opt/oracle/oak/bin/oakcli deploy

Follow the instructions to complete the Oracle Appliance Manager configurator screens given in "Using Oracle Appliance Manager Configurator". Select the Install option on the configurator Summary page to complete the deployment.

When the deployment is complete on both nodes, you will see the message Oracle Database Appliance Deployment successful.

Note:

If you encounter deployment problems, then run the following command on Node 0 (from ODA_BASE if you are configuring Oracle Database Appliance Virtualized Platform):

/opt/oracle/oak/onecmd/cleanupDeploy.pl

This command restores the servers to their predeployment state. You can then restart the deployment.