4 Provisioning Oracle Database Appliance Bare Metal System
Understand the process to configure Oracle Database Appliance bare metal system.
The Browser User Interface is the preferred method of deploying your bare metal platform configuration. The Browser User Interface provides all of the fields necessary to provision Oracle Database Appliance, including configuring the system, network, database, and Oracle Auto Service Request (Oracle ASR). If you prefer to use the command-line interface, you must create a JSON file to configure the deployment options.
- Verifying Cabling and Network Connections
 After powering on Oracle Database Appliance, verify that the network connections are set up correctly.
- Plumbing the Network
 Plumb the Oracle Database Appliance network with the public internet protocol (IP) information assigned to a node, to enable provisioning of the Oracle Database Appliance software.
- Downloading Oracle Database Appliance Software
 Download Oracle Database Appliance software and copy to a temporary location before applying updates to your appliance.
- Installing Oracle Database Appliance Software
 Install Oracle Database Appliance software, before creating the appliance.
- Creating the Appliance
 Create the appliance using the Browser User Interface or ODACLI commands.
- Managing Local Volumes
 Understand how you can modify the size of logical volumesLOGVOLOPTandLOGVOLU01.
Verifying Cabling and Network Connections
After powering on Oracle Database Appliance, verify that the network connections are set up correctly.
Plumbing the Network
Plumb the Oracle Database Appliance network with the public internet protocol (IP) information assigned to a node, to enable provisioning of the Oracle Database Appliance software.
Important:
On Oracle Database Appliance X9-2, X10, and X11, theodacli configure-firstnet command
        supports bonding of ports across two supported network PCI cards of the same type. 
                     Remember:
To change the network bonding after the system is deployed, run thecleanup.pl -cleanDefNet
        command to ensure that no network setup exists in the bonding interface, and then run the
          odacli configure-firstnet command to configure the new bonding.
                     Note:
If you enable Link Aggregation Control Protocol (LACP) on the bonding interface when you run theodacli configure-firstnet command, then lacp_rate
        is set to 1 (fast). You must adjust the switch setting so that it can support this
          lacp_rate. 
                     Example 4-1 Example of a Bonded Configuration
For a bonded configuration, answer yes to using a bonding
        public interface and configure the first network to use a btbond3 interface
        without configuring DHCP. 
                     
# /opt/oracle/dcs/bin/odacli configure-firstnet
Select the Interface to configure the network on (btbond1 btbond3 btbond4) [btbond1]:btbond3
Use LCAP bonding on btbond3 (yes/no) [no]:yes
INFO: network interface [btbond3] in LACP mode
Configure DHCP on btbond3 (yes/no) [no]:
INFO: You have chosen Static configuration
Use VLAN on btbond3 (yes/no) [no]:yes
Configure VLAN on btbond3, input VLAN ID [2 - 4094] 119
INFO: using network interface btbond3.119
Enter the IP address to configure : 10.31.129.36
Enter the Netmask address to configure : 255.255.255.240
Enter the Gateway address to configure [10.31.129.33] :
INFO: Restarting the network
Shutting down interface btbond1: [ OK ]
Shutting down interface btbond2: [ OK ]
Shutting down interface p3p1: [ OK ]
Shutting down interface p3p2: [ OK ]
Shutting down interface sfpbond1: [ OK ]
Shutting down loopback interface: [ OK ]
Bringing up loopback interface: [ OK ]
Bringing up interface btbond1: Determining if ip address 10.209.13.109 is already in use for device btbond1...
[ OK ]
Bringing up interface btbond2: [ OK ]
Bringing up interface sfpbond1: [ OK ]Example 4-2 Example of Configuring VLAN
# /opt/oracle/dcs/bin/odacli configure-firstnet
Select the Interface to configure the network on (btbond1 btbond3 btbond4) [btbond1]:btbond3
Use LCAP bonding on btbond3 (yes/no) [no]:yes
INFO: network interface [btbond3] in LACP mode
Configure DHCP on btbond3 (yes/no) [no]:
INFO: You have chosen Static configuration
Use VLAN on btbond3 (yes/no) [no]:yes
Configure VLAN on btbond3, input VLAN ID [2 - 4094] 119
INFO: using network interface btbond3.119
Enter the IP address to configure : 10.31.129.36
Enter the Netmask address to configure : 255.255.255.240
Enter the Gateway address to configure [10.31.129.33] :
INFO: Restarting the network
Shutting down interface btbond1:                           [  OK  ]
Shutting down interface em1:                               [  OK  ]
Shutting down interface p1p1:                              [  OK  ]
Shutting down interface p1p2:                              [  OK  ]
Shutting down loopback interface:                          [  OK  ]
Bringing up loopback interface:                            [  OK  ]
Bringing up interface btbond1:  
Determining if ip address 192.0.2.24 is already in use for device btbond1...
                                                           [  OK  ]
Bringing up interface em1:                                 [  OK  ]
Bringing up interface p1p1:  
Determining if ip address 192.0.2.24 is already in use for device p1p1...                                                           [  OK  ]
Bringing up interface p1p2:  
Determining if ip address 192.0.2.24 is already in use for device p1p2...
                                                           [  OK  ]
Bringing up interface btbond1.122:  
Determining if ip address 192.0.2.24 is already in use for device btbond1.122...
                                                           [  OK 
INFO: Restarting the DCS agent
initdcsagent stop/waiting
initdcsagent start/running, process 32104Configuring LACP after Deployment
Use the -o option with the odacli configure-firstnet
        command to enable or disable LACP on a bonding interface.
                     
# odacli configure-firstnet -o
INFO: Configure network option
Select the Interface to configure the network on (btbond1 btbond3 btbond5) [btbond1]:btbond3
Use LACP bonding on btbond3 (yes/no) [no]: yes
INFO: network interface [btbond3] setup in LACP mode# odacli configure-firstnet -o
INFO: Configure network option
Select the Interface to configure the network on (btbond1 btbond3 btbond5) [btbond1]:btbond3
Use LACP bonding on btbond3 (yes/no) [yes]: no
INFO: network interface [btbond3] setup in active-backup modeParent topic: Provisioning Oracle Database Appliance Bare Metal System
Downloading Oracle Database Appliance Software
Download Oracle Database Appliance software and copy to a temporary location before applying updates to your appliance.
Parent topic: Provisioning Oracle Database Appliance Bare Metal System
Installing Oracle Database Appliance Software
Install Oracle Database Appliance software, before creating the appliance.
/u01 and /opt are smaller than the
            corresponding sizes in earlier releases. The size of /u01 is now 40GB
            and the size of /opt is now 30GB. A new ACFS file system, mounted at
                /opt/oracle/oak/pkgrepos/orapkgs/clones, is created during
            provisioning. The DATA disk group provides space of 150 GB for the file system. The
            Oracle Grid Infrastructure and Oracle Database clone files are stored on this file
            system.
                  Important:
If you want to install third-party software on your Oracle Database Appliance, then ensure that the software does not impact the Oracle Database Appliance software. The version lock on Oracle Database Appliance RPMs displays a warning if the third-party software tries to override Oracle Database Appliance RPMs. You must restore the affected RPMs before patching Oracle Database Appliance so that patching completes successfully.Important:
To ensure that your deployment has the latest Oracle Database Appliance firmware, download the latest server patch and update the repository. Then, run theodacli
                    describe-component command to check whether the firmware is current or
                out-of-date. If the firmware is not current, then run the odacli
                    update-server and odacli update-storage commands
                before you deploy the Oracle Database Appliance software. If the firmware is
                current, then you can deploy the Oracle Database Appliance software as described in
                this topic, without updating the server and storage. Before updating the server or
                storage, ensure that you run the odacli create-prepatchreport
                command to generate the prechecks report, otherwise an error is displayed.
                     Note:
Public network gateway must be responsive to ping requests. Oracle Clusterware uses the public network gateway as ping target to facilitate the VIP failover in Oracle Database Appliance high-availability environment.Note:
Starting with Oracle Database Appliance release 19.27, Oracle ASM Filter Driver (ASMFD) is not automatically configured during provisioning of the appliance. Do not specify theenableAFD parameter in the provisioning JSON file. 
                     Creating the Appliance
Create the appliance using the Browser User Interface or ODACLI commands.
Note:
If you plan to enable multi-user access, then refer to the chapter Implementing Multi-User Access on Oracle Database Appliance before you create your appliance.Creating the Appliance using ODACLI Commands
You can use the command odacli create-appliance and a
                JSON file that includes your appliance configuration settings to deploy the
                appliance instead of using the Browser User Interface. Review the readme in the
                    /opt/oracle/dcs/sample directory carefully along with the
                provided JSON example files. Create a JSON file with the necessary changes based on
                your environment and requirements. 
                     
See Also:
Creating an Appliance Using a JSON File in this guide for example JSON files and the procedure to create a JSON file.Note:
It is important to review the readme and the examples carefully before creating your JSON file. If you do not enter your network and Oracle ILOM information correctly based on your setup, you will lose network access to both the host and Oracle ILOM.Creating the Appliance using the Browser User Interface (BUI)
Follow these steps to create the appliance using the BUI:
After deployment, the root and database users
                    SYS, SYSTEM, and PDBADMIN are
                set to the system password. The oracle and grid
                passwords are set to the default password. Change these passwords to comply with
                your user security protocols.
                     
Related Topics
Parent topic: Provisioning Oracle Database Appliance Bare Metal System
Managing Local Volumes
Understand how you can modify the size of logical volumes
            LOGVOLOPT and LOGVOLU01.
                  
About Local Volumes
VolGroupSys. Several logical volumes
                namely LogVolRoot, LogVolU01,
                    LogVolOPT, and LogVolSwap are created in
                    VolGroupSys. On single-node Oracle Database Appliance systems,
                two more logical volumes, LogVolRECO and
                    LogVolDATA, each of 1 GB in size are also created. Oracle
                Database Appliance formats LogVolRoot, LogVolU01,
                and LogVolOPT as ext4 (fourth extended file
                system), and mounts them at /, /u01, and
                    /opt respectively. These logical volumes use only a part of the
                available storage, approximately 125 GB.
                        Note:
The term Local Volume refers to the logical volume and the physical volumes initialized on the operating system disk.LOGVOLOPT and
                    LOGVOLU01 may not have sufficient space for creating Oracle
                Grid Infrastructure homes, installing additional software, creating Oracle Grid
                Infrastructure log files, and others. In such cases, extending the size of these
                local volumes is useful. 
                        Note:
After extension, the size of local volumes cannot be reduced through Oracle Database Appliance tooling. Ensure that you carefully plan local volume extensions.Viewing and Extending the Local Volume Size Using ODACLI Commands
odacli list-localvolumesThe command displays the total size of the physical volume, the free space available in the volume group, and the space required to support ODABR backup during patching. It also displays the space available for extending the local volumes in a safe manner such that sufficient buffer is reserved for ODABR backup. In addition, it shows the details of all the local volumes in the system.
odacli extend-localvolume --name volume_name --size increment_size_in_GB --forceThe command enables extension of LogVolU01 and
                    LogVolOPT only. It allows extension up to the size showed by
                the Space for extension field in the odacli
                    list-localvolumes output.
                     
Viewing and Extending the Local Volume Size Using BUI
- Navigate to the Browser User Interface. You are prompted to set the password
                        for the oda-adminuser.https://ODA-host-ip-address:7093/mgmt/index.html
- In the Appliance home page, click the Local Volumes link on the left-hand pane.
- In the Local Volumes Details page, you can view the physical volume and logical volume details. For high-availability system, you can view these details for both nodes.
- To increase the local volumes LOGVOLOPTandLOGVOLU01sizes, click Extend. Confirm your action in the popup window.
- In the Extend Local Volume page, select the Volume
                            Name, and specify the Increment Size
                        in GB. Click Force Run to override the ODABR backup
                        space requirement. You can extend both LOGVOLOPTandLOGVOLU01volumes.
- Confirm the operation and submit the job. Track the status of the job completion and verify that it completes successfully.
Parent topic: Provisioning Oracle Database Appliance Bare Metal System