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

Part Number E22692-25
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

4 Deploying Oracle Software on Oracle Database Appliance Virtualized Platform

This chapter provides a checklist of tasks to deploy Oracle Database Appliance Virtualized Platform. Follow the procedures in this chapter if you are either installing software on a new Oracle Database Appliance which has been rack mounted and cabled; or replacing a bare metal installation with Oracle Database Appliance Virtualized Platform. After you complete the steps in this chapter, your Oracle software and an initial database will be available in the ODA_BASE domain, where you create any additional databases that you want to run on these dedicated CPU cores.

Caution:

Installing Oracle Database Appliance Virtual Platform onto a previously configured Oracle Database Appliance overwrites all existing software and applications, including Oracle databases. Ensure you have a backup of all your data and application software before proceeding.

Configuring Oracle Database Appliance Virtualized Platform software and your initial database requires approximately three hours to complete. This chapter contains the following sections, each of which must be completed before proceeding to the next:

Note:

For a checklist of tasks to deploy Oracle software on a non-virtualized Oracle Database Appliance, see Chapter 3, "Deploying Oracle Software on Bare Metal Oracle Database Appliance."

See Also:

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

Powering on Oracle Database Appliance for the First Time

If you have not yet applied power to Oracle Database Appliance, then ensure that you have completed all the required cabling as described in the Owner's Guide. Then power on the system, using the steps given in the Owner's Guide and on the Setup Poster.

Note:

It may take about 5 minutes for the Power OK LEDs to light up and stay lit without blinking. Do not push the power buttons again during this period.

If you are installing Oracle Database Appliance X3-2, then you may wish to confirm that your cables are correctly installed after the system is running and you have a terminal connected to Oracle Database Appliance. Perform this check by running the oakcli validate storageTopology command. For more details, see the section "Cabling Validation Command" in Chapter 9.

Connecting to the System Using Local Login

Oracle Database Appliance is not equipped with a monitor, keyboard, or mouse. To log in locally, attach a monitor to the graphics card port and a keyboard and mouse to the USB ports on Node 0 (see Figure 1-2, callout 3, for Oracle Database Appliance X3-2 connections and see Figure 1-4, callout 7, for Oracle Database Appliance connections).

To activate the X Window System, enter the following command from a terminal interface:

# startx 

You can also use Oracle Integrated Lights Out Manager (Oracle ILOM) to launch a local or remote host console session. See the section on connecting to Oracle ILOM for your specific hardware in Oracle Database Appliance Owner's Guide.

Checking Oracle Database Appliance Virtualization Status

Your vendor may have provisioned Oracle Database Appliance with Oracle Virtual Machine Image. Before you proceed, test for Oracle Virtual Machine Image by logging in to dom0 as root, password welcome1, and entering the command xm list. Examine the output, which should appear similar to the following example.

[root@oak1 ~] # xm list
Name                                 ID  Mem  VCPUs  State  Time(s)
Domain-0                              0 2039     24 r-----   496.1

If the value Domain-0 appears in the Name column, then Oracle Database Appliance has the required Oracle Virtual Machine Image and you are ready to proceed with virtualized software deployment. If the command does not produce the required output or generates errors, then you need to install Oracle Virtual Machine Image.

Note:

Find step-by-step instructions to install Oracle Virtual Machine Image in Note 1520579.1 available at https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=1520579.1

Configuring the Network to Transfer ODA_BASE Template

Use the following procedure to configure an initial network connection for downloading the ODA_BASE Template:

Note:

This network configuration may be replaced during the final image configuration.
  1. Note the default network connections for the Oracle VM Network, shown in Table 6-2, "Oracle Database Appliance Virtualized Platform Network Interfaces" in Chapter 6 before you begin.

  2. As a minimum requirement, ensure that Ethernet cables with access to the public gateway are attached to Eth2/Eth3 (bond0, the public interface). Refer to Figure 1-2 for reference.

  3. Run the command oakcli configure firstnet to configure the network, and respond to the prompts as required. For example:

    # /opt/oracle/oak/bin/oakcli configure firstnet
    

    The output should appear similar to the following:

    Configure the network for the node(s)(local, global) [global]:  global
    The network configuration for both nodes:
    Domain Name: mydomain.dom
    DNS Server(s):  Primary DNS Server: 190.0.2.2
                   Secondary DNS Server:
    Node Name             Host Name
    0              mysystem1
    1              mysystem2
    Choose the network interface to configure (net1 , net2, net3, net4) [net1]: net1
    Configure DHCP on net1?(yes/no):no
           You have chosen static configuration on net1
           Enter the IP address for net1 on Node 0: 190.0.2.40
           Enter the IP address for net1 on Node 1: 190.0.2.41
           Netmask for net1: 255.255.252.0
           Gateway Address for net1 [190.0.2.1]: 
    Plumbing the IPs now for Node 0
    Restarting the network for Node 0
    Plumbing the IPs now for Node 0
    Restarting the network for Node 1
    :::::::::::::::::
    

Installing ODA_BASE on Oracle Database Appliance Virtualized Platform

You must install the ODA_BASE Template on your virtualized Oracle Database Appliance before you can deploy other software. This requires downloading the template to an external client, copying it to dom0, and then running the Oracle Appliance Manager deployment command as described in the following steps.

Note:

Oracle Database Appliance Virtualized Platform supports importing templates only.
  1. Download the ODA_BASE Template from My Oracle Support onto your attached external client. Select the template you selected from the list in "Sizing ODA_BASE on Oracle Database Appliance Virtualized Platform"

    Note:

    The current version of the ODA_BASE template is available for download from https://updates.oracle.com/download/16186172.html
  2. Copy the ODA_BASE template from the external client to dom0 with an scp command.

  3. Copy the template to the /OVS directory on dom0.

  4. Use the command syntax oakcli deploy oda_base and respond to the prompts to deploy the ODA_BASE on both nodes. If your ODA_BASE Template is in the /OVS directory, the start of the dialog should look similar to the following example (with more Core Licensing Options available if you are deploying Oracle Database Appliance X3-2 Virtualized Platform):

    # /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
    

    This command installs ODA_BASE with the requested CPU configuration and starts the domain on both nodes.

  5. To verify that your deployment of ODA_BASE is valid, enter 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 there are problems with your ODA_BASE installation, then you can run the following command from Node 0:
/opt/oracle/oak/tools/cleanOdatabase.py

This command will remove ODA_BASE so that you can retry the installation from the beginning.

Deploying Your Configuration on Oracle Database Appliance Virtualized Platform

To deploy the configuration of your Oracle Database Appliance, you can use an existing configuration file or create the configuration in real time. To begin, connect to dom1 using VNC and provide dom0 for the Hostname and 5900 for the Port. Then run the command startx to ready the X Window System software for the Oracle Appliance Manager Configurator.

If you have a configuration file on an external client that you want to use, you must first copy the file to ODA_BASE on Oracle Database Appliance. The copy requires two steps because you are logged in to dom0. First copy the configuration file to dom0 with an scp command. Second, enter an scp command with the internal IP address 192.168.16.27 to copy the configuration from dom0 to ODA_BASE.

To initiate the deployment using an existing configuration file, enter a command similar to the following:

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

Substitute your own file's name and path if you did not use the default name for your configuration file or save the file in the temporary directory.

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

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

and follow the instructions to complete the Oracle Appliance Manager Configurator screens given in Chapter 2.

Oracle recommends that perform the Run Validations step on the Network Validations screen before proceeding to the Summary Screen. Select the Install option on the Configurator Summary page to complete the deployment.

Note:

Set the DISPLAY variable in your VNC window if the Oracle Appliance Manager Configurator Welcome window does not open properly.

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

Note:

If you encounter installation problems, then you can run the following command from Node 0: /opt/oracle/oak/onecmd/cleanupDeploy.pl

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

For more information about reinitializing deployment, see:

"Deinstalling Oracle Software and Reinitializing Storage"