|Oracle® Database Appliance Getting Started Guide
Release 2.9 for Linux x86-64
|PDF · Mobi · ePub|
Deploying software on a new Oracle Database Appliance to which you have connectivity as described in Chapter 2; or
Replacing a bare metal installation on a running system with Oracle Database Appliance Virtualized Platform.
After completing the steps in this chapter, your Oracle software and an optional initial database will be available in the ODA_BASE domain. You may create any additional databases that you require in this domain where they will run on dedicated CPU cores.
Caution:Deploying Oracle Database Appliance Virtualized 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, which you should address in the order listed here:
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
Before deploying Oracle Database Appliance Virtualized Platform, you may wish to understand the components of the virtual architecture. To help you visualize where processes will run as you complete the deployment steps that refer to specific domains, see the following figure.
After you complete the deployment of Oracle Database Appliance Virtualized Platform, you will have two domains available on each server node, Dom0 and ODA_BASE (also known as Dom1). See Chapter 6, "Managing Virtual Machines on Oracle Database Appliance," for information about managing these domains as well as deploying and using virtual machine domains, shown as Domain U in the preceding figure.
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
welcome1, entering the command
oakcli show env_hw and examining the output. If the output contains the value
VM-Dom0 along with the version of your hardware, 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
You must deploy the ODA_BASE Template on your virtualized Oracle Database Appliance before you deploy other software. This requires downloading the template to an external client, copying the template to dom0, and then running the Oracle Appliance Manager
oakcli deploy oda_base command as described in the following steps.
Note:Oracle Database Appliance Virtualized Platform supports importing templates only.
Download the ODA_BASE Template from My Oracle Support onto your attached external client. Select the template you chose 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
Use the "Select a Release" field to select the desired release before you begin the download.
Copy the ODA_BASE template from the external client to dom0 with an
Alternatively, you may place the End-User Bundle image onto a USB storage device and copy the file once the USB device is visible on the appliance.
Note:Format any USB drives as FAT32, ext3, or ext4. NTFS file formats are not supported.
Log in to dom0 on Oracle Database Appliance Virtualized Platform and copy the template to the
/OVS directory on dom0. Remain logged into dom0 while you complete the remaining steps.
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 (the Core Licensing Options values are different on each Oracle Database Appliance Virtualized Platform hardware 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 deploys ODA_BASE with the requested CPU configuration and starts the domain on both nodes.
You may also assign one or more virtual local area networks (VLANs) to your ODA_BASE during deployment. Do this by responding with
y when prompted for additional VLAN networks, as shown in this example, taken from the
oakcli deploy oda_base interrogatory:
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 6 for more information about managing VLAN interfaces to Oracle Database Appliance Virtualized Platform.
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
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:
This command will remove ODA_BASE so that you may try a fresh deployment.
If your Oracle Database Appliance X3-2 or Oracle Database Appliance X4-2 system was already configured with the virtual machine image before you began the deployment, then you would not have been able to check the storage cabling with Oracle Appliance Manager. Oracle recommends that you perform this validation before continuing with deployment. To perform this check, connect to ODA_BASE using VNC and providing Dom0 for the hostname and 5900 for the port. Log in as root with the password welcome1 and run the following command:
/opt/oracle/bin/oakcli validate -c storagetopology
The command will show errors if your cabling is incorrect. For more details, see the section ”Cabling Validation Command” in Chapter 4.
To deploy the configuration of your Oracle Database Appliance, use an existing configuration file or create the configuration in real time. To begin, connect to Node 0 using VNC and provide dom0 for the Hostname and 5900 for the Port. Then run the command
startx to ready the X Window System for Oracle Appliance Manager Configurator.
If you have a configuration file on an external client that you want to use, then 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, substituting your file's directory path and file name as necessary:
This command will work with a configuration file that you have copied from an external host or that you created on Oracle Database Appliance.
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
and follow the instructions to complete the Oracle Appliance Manager Configurator screens given in Chapter 2. 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.