Oracle X6-2-HA Deployment And User's Manual
  1. Manuals
  2. Brands
  3. Oracle Manuals
  4. Server
  5. Database Appliance X6-2-HA
  6. Deployment and user's manual

Oracle X6-2-HA Deployment And User's Manual

Database appliance
Hide thumbs Also See for X6-2-HA:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
Table of Contents

Advertisement

Quick Links

Download this manual See also: Service Manual, Owner's Manual
Oracle® Database Appliance
X6-2-HA Deployment and User's Guide
Release 18.3 for Linux x86-64
F10531-03
May 2019

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the X6-2-HA and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Oracle X6-2-HA

Summary of Contents for Oracle X6-2-HA

  • Page 1 Oracle® Database Appliance X6-2-HA Deployment and User's Guide Release 18.3 for Linux x86-64 F10531-03 May 2019...
  • Page 2 Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

  • Page 3: Table Of Contents

    About the Web Console Preparing for Oracle Database Appliance Installation and Deployment Registering Your Support Identifier on My Oracle Support Planning Oracle Database Appliance Configuration Options Selecting Oracle Database Appliance Bare Metal Options Selecting Oracle Database Appliance Virtualized Platform Options...
  • Page 4 Cabling Oracle Database Appliance to Connect to Fiber Public Networks (Optional) Attaching a Storage Expansion Shelf to Oracle Database Appliance About Attaching and Cabling Storage Shelves Installing and Cabling a Storage Expansion Shelf Attaching Peripheral Devices First Startup of Oracle Database Appliance...
  • Page 5 Patching Oracle Database Appliance Bare Metal Systems Using the Command-Line Patching Oracle Database Appliance Virtualized Platform 7-10 Patching Trace File Analyzer (TFA) Collector 7-12 Adding Repositories for Patch Updates 7-13 Re-imaging Oracle Database Appliance Cleaning Up Incomplete or Failed Installations...
  • Page 6 12-3 About Oracle Database Appliance Virtualized Platform Architecture 12-3 About Virtual Machines and Oracle Database Appliance Virtualized Platforms 12-4 About Network Infrastructure and VLANs on Oracle Database Appliance Virtualized Platform 12-6 How to Create and Manage Shared Repositories 12-9 Creating a Shared Repository...
  • Page 7 Adding or Removing a Virtual Disk to or from a Virtual Machine 12-29 Removing a Virtual Machine from a Shared Repository 12-30 Performing a Live Migration for an Oracle Database Appliance Virtual Machine 12-30 How to Create Driver Domain Virtual Machines 12-31...
  • Page 8 Showing the CPU Pools Configured on Oracle Database Appliance Virtualized Platform Nodes 12-45 Changing the Number of CPUs Assigned to a CPU Pool on Oracle Database Appliance Virtualized Platform Nodes 12-46 Assigning a Virtual Machine to a CPU Pool on Oracle Database Appliance...
  • Page 9 odacli describe-backupreport 13-42 odacli describe-schedule 13-44 odacli irestore-database 13-44 odacli list-backupreports 13-46 odacli list-backupconfigs 13-47 odacli list-objectstoreswifts 13-47 odacli list-schedules 13-48 odacli recover-database 13-48 odacli update-backupconfig 13-50 odacli update-database 13-51 odacli update-objectstoreswift 13-52 odacli update-schedule 13-53 odacli CPU Core Commands 13-54 odacli list-cpucores 13-54...
  • Page 10 13-96 odacli create-logcleanjob 13-97 odacli list-logcleanjobs 13-99 odacli describe-logcleanjob 13-100 odacli create-auto-logclean-policy 13-100 odacli list-auto-logclean-policy 13-102 odacli Oracle Auto Service Request Commands 13-102 odacli configure-asr 13-103 odacli update-asr 13-105 odacli describe-asr 13-106 odacli test-asr 13-107 odacli delete-asr 13-108...
  • Page 11 13-124 odaadmcli power disk 13-124 odacli-adm set-credential 13-125 Oracle Appliance Manager Command-Line Interface for Virtualization About the Oracle Appliance Manager Command-line Interface (OAKCLI) 14-3 Managing OAKCLI Privileges and Security with SUDO 14-5 oakcli add disk -local 14-7 oakcli configure commands...
  • Page 12 oakcli modify database 14-30 oakcli orachk 14-31 oakcli reconfigure osparams 14-32 oakcli resize dbstorage 14-33 oakcli restart oda_base 14-34 oakcli show commands 14-34 oakcli show asr 14-37 oakcli show cooling 14-37 oakcli show controller 14-38 oakcli show cpupool 14-38 oakcli show databases 14-39 oakcli show db_config_params 14-39...
  • Page 13 Using the Oracle ORAchk Health Check Tool 15-6 About Trace File Analyzer Collector 15-8 Running Trace File Analyzer (TFA) Collector Commands 15-8 Running the Disk Diagnostic Tool 15-11 Running the Oracle Database Appliance Hardware Monitoring Tool 15-11 Preparing Log Files for Oracle Support Services 15-12 xiii...
  • Page 14 Example JSON Files to Create a Single Node Appliance with the CLI Example JSON File to Create a Multi-Node Appliance with the CLI Database Templates for Oracle Database Appliance About Database Templates for Oracle Database Appliance Types of Database Templates for Oracle Database Appliance X6-2-HA...
  • Page 15 Index...
  • Page 16 Example of Showing CPUs Assigned to Defined CPU Pools on Oracle Database Appliance Virtualized Platform Nodes 12-46 12-24 Example of Changing the Number of CPUs Assigned to a CPU Pool on Oracle Database Appliance Virtualized Platform Nodes 12-46 12-25 Example of Assigning a Virtual Machine to a CPU Pool on Oracle Database...
  • Page 17 Delete a Level 0 or Level 1 Backup 13-41 13-31 Delete a Long Term Backup Report 13-41 13-32 Deleting a Backup Configuration 13-41 13-33 Deleting the Oracle Object Store Credentials 13-42 13-34 Display Details of a Specific Backup Report 13-43 13-35 Display Schedule Details 13-44 13-36...
  • Page 18 Registering a Migrated Database 13-66 13-63 Upgrading an Oracle Database 13-68 13-64 Deleting a Database Named hrmsdb 13-69 13-65 Displaying a List of Oracle Home Directories 13-71 13-66 Displaying Oracle Database Home Details 13-72 13-67 Creating an Oracle Database Home 13-73 13-68...
  • Page 19 13-102 13-96 Configuring Oracle ASR with a Proxy Server 13-104 13-97 Configuring an External Oracle ASR 13-104 13-98 Updating Oracle ASR with a New Proxy Server 13-106 13-99 Displaying Oracle ASR Details 13-106 13-100 Testing the Oracle ASR Configuration 13-107...
  • Page 20 14-26 14-12 Displaying the Write Cache Status of Disks 14-27 14-13 Locating an Oracle ASM Disk by Turning on the Disk’s LED 14-28 14-14 Example Command to View the Bill of Materials from the Command Line for Virtualized Platforms Deployments...
  • Page 21 Stopping the Local ODA_Base 14-53 14-38 Running Diagnostic Tests on a Disk in the Expansion Storage Shelf 14-54 14-39 Unpacking Packages into the Oracle Appliance Manager Repository 14-55 14-40 Verify the Contents of a Patch Bundle 14-56 14-41 Enabling 12 CPU Cores for Oracle Database Appliance...
  • Page 22 Oracle ACFS Storage Space Determining Storage on the DATA Disk Group JSON File to Create a Single Node Oracle Database Appliance with Role Separation JSON File to Create a Single Node Oracle Database Appliance without Role Separation JSON File to Create a Multi-Node Oracle Database Appliance with Role Separation...
  • Page 23 Oracle Database Appliance Virtualized Platform Architecture 12-3 12-2 Architecture Overview of Oracle Database Appliance Virtualized Platform Shared Repositories 12-6 12-3 Basic Virtual Machine Local Area Network 12-8 12-4 Oracle Database Appliance Virtualized Platform with Virtual Local Area Networks 12-9 xxiii...
  • Page 24 Minimum IP Address Requirements for Oracle Database Appliance Virtualized Platform Deployment 2-11 Description of Callouts for Cabling Oracle Database Appliance X6-2-HA with a Single Storage Shelf Description of Callouts for Cabling Oracle Database Appliance Storage Expansion Shelf Peripheral Device Connections for Oracle Database Appliance...

  • Page 25: Audience

    Preface Oracle Database Appliance is an optimized, prebuilt database system that is easy to deploy, operate, and manage. By integrating hardware and software, Oracle Database Appliance eliminates the complexities of nonintegrated, manually assembled solutions. Oracle Database Appliance reduces the installation and software deployment times from weeks or months to just a few hours while preventing configuration and setup errors that often result in suboptimal, hard-to-manage database environments.

  • Page 26: Related Documents

    Oracle Automatic Storage Management Administrator's Guide For more information about Oracle Integrated Lights Out Manager 3.2, see https:// docs.oracle.com/cd/E37444_01/. For more details about other Oracle products that are mentioned in Oracle Database Appliance documentation, see the Oracle Documentation home page at http:// docs.oracle.com.
  • Page 27 Preface Convention Meaning boldface Boldface type indicates graphical user interface elements associated with an action or terms defined in the text. italic Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values. Monospace type indicates commands within a paragraph, URLs, code monospace in examples, text that appears on the screen, or text that you enter.

  • Page 28: Introduction To Oracle Database Appliance

    Introduction to Oracle Database Appliance Oracle Database Appliance saves time and money by simplifying deployment, maintenance, and support of database solutions for organizations of every size. Oracle Database Appliance hardware models are optimized to run Oracle Database Standard Edition and Enterprise Edition.
  • Page 29 Oracle Database Appliance X6-2S, X6-2M, X6-2L are single node systems that you deploy as a bare metal platform. Oracle Database Appliance X6-2-HA is a two-node system with the option to deploy as a bare metal platform or a virtualized platform. Starting with with Oracle Database Appliance release 18.3, systems deployed as bare metal are migrated from oakcli to...

  • Page 30: Oracle Database Appliance Software Terminology

    Software for Oracle Database Appliance Patch Description Oracle Database Appliance patch Use the patch bundle to update to the latest release after Oracle Database bundle (quarterly patch release) Appliance is deployed. The patch updates the Oracle Database Appliance server, storage, and database components.
  • Page 31 RDBMS Clone Use the RDBMS Software Clone files to get the latest RDBMS clone binaries for Oracle Database releases 18c, 12.2.0.1, 12.1.0.2, and 11.2.0.4. The RDBMS clone files are needed to create Oracle databases and database homes. Bare Metal ISO Image Use to reimage the appliance and reset the system back to the factory configuration.

  • Page 32: About The Web Console

    (Update), and the quarterly release update revision version (Revision). Prior to Oracle Database release 18c, changing the first or second digit in the release number was an upgrade, and changing the fourth digit indicated an update.
  • Page 33 Create, update, and delete networks – View interface details • Oracle ASR – View Oracle Auto Service Request (Oracle ASR) configuration details – Configure, update, test, and delete Oracle ASR • Patch Manager – Update the patch repository with Oracle Database Appliance patches –...
  • Page 34 Expand About in the upper right corner of the Web Console to perform the following tasks: • Click About to view the Oracle Database Appliance release that is installed on the appliance. • Click Update ILOM Setting to change the root password. To enable first-time login and access to Oracle ILOM, a default Administrator (root) account and its password are provided with the system.

  • Page 35: Preparing For Oracle Database Appliance Installation And Deployment

    You cannot obtain support or software from Oracle without registered SIs. Planning Oracle Database Appliance Configuration Options Use these topics to help you to make decisions about your Oracle Database Appliance configuration. These topics help you to select the correct Oracle Database Appliance and plan for deployment.

  • Page 36: Selecting Oracle Database Appliance Bare Metal Options

    Topics: • Selecting Oracle Database Appliance Bare Metal Options Oracle Database Appliance is shipped from the factory to deploy as bare metal. • Selecting Oracle Database Appliance Virtualized Platform Options Review Virtualized Platform options, and requirements for these options, such as shared disks and virtual local area networks.

  • Page 37: Selecting Database Configuration Options

    Select the database templates and configuration options to properly size and configure your initial database. Review the database configuration options and select the templates for Oracle Real Application Clusters (Oracle RAC), and Oracle RAC One Node databases needed to configure your initial database. This information is relevant to you if you plan to configure an initial database during Bare Metal or Virtualized Platform deployments.

  • Page 38: Selecting Database Deployment Options For Oracle Database Appliance

    Oracle RAC: Oracle Real Application Clusters 18c, with the following characteristics: – Oracle RAC home – Oracle RAC software is installed on both servers – Enterprise Edition license is required – Oracle RAC license on each server is required (not eligible for the 10-day rule)

  • Page 39: Selecting Database Templates For Oracle Database Appliance

    On Oracle Database Appliance Virtualized Platform, if you only plan to deploy one Oracle Database, then Oracle recommends that you use a template for your ODA_BASE that has the same name as the template that you choose for your Oracle Database.

  • Page 40: Calculating Required Cores

    Oracle Database Appliance. You can select database template sizes larger than your current needs to provide for planned growth, which you accommodate later by adjusting System Global Area (SGA) and Program Global Area (PGA) sizes, as well as the number of cores.

  • Page 41: List Of Information You Need Before Deployment

    Collect security, storage, and network information required to prepare for deploying Oracle Database Appliance. • Checklist for System Details Use the checklist to gather system information that you need to obtain for Oracle Database Appliance. Record the values for your system. • Checklist for Custom Node Network Address Configuration Use the checklists in this topic to identify the IP addresses required for Oracle Database Appliance.
  • Page 42 If you have NTP servers, and you want to synchronize time between Oracle Database Appliance nodes using NTP, then be prepared to provide the addresses for the servers. If you do not provide addresses for NTP servers, then Oracle Grid Infrastructure software configures time synchronization between nodes using Cluster Time Synchronization Service (CTSS).

  • Page 43: Checklist For System Details

    Chapter 2 Gathering System Requirement Information Checklist for System Details Use the checklist to gather system information that you need to obtain for Oracle Database Appliance. Record the values for your system. Table 2-1 Checklist for System Configuration Information for Oracle Database...

  • Page 44: Checklist For Custom Node Network Address Configuration

    Configure Oracle Enterprise Manager console Checklist for Custom Node Network Address Configuration Use the checklists in this topic to identify the IP addresses required for Oracle Database Appliance. By default, names for network interfaces are derived from the Oracle Database Appliance system name, which you provide during installation.

  • Page 45: Minimum Ip Address Requirements For Oracle Database Appliance Virtualized Platform Deployment

    Lights Out Manager (ILOM) User Virtual Not Applicable No default No default Machine Minimum IP Address Requirements for Oracle Database Appliance Virtualized Platform Deployment Table 2-3 Minimum IP Address Requirements for Oracle Database Appliance Virtualized Platform Deployment Type of IP...
  • Page 46 Chapter 2 Gathering System Requirement Information Table 2-3 (Cont.) Minimum IP Address Requirements for Oracle Database Appliance Virtualized Platform Deployment Type of IP Minimum IP IP Address Your Values As Same Address Default Values Applicable Subnet Counts Single Client No default...

  • Page 47: Readying Oracle Database Appliance For Deployment

    Interconnect is reserved for Oracle Grid Infrastructure (GI) and Oracle Relational Database Management System (RDBMS). • Attaching Supplied Cables for Oracle Database Appliance If you are using Oracle Database Appliance with a single storage shelf, attach the interconnect cables. • Attaching a Storage Expansion Shelf to Oracle Database Appliance Review these topics to install and cable a storage expansion shelf for Oracle Database Appliance.

  • Page 48: Attaching Supplied Cables For Oracle Database Appliance

    Attaching Supplied Cables for Oracle Database Appliance InfiniBand cards, then the onboard 10GBase-T (Copper) ports are used for the interconnect. Attaching Supplied Cables for Oracle Database Appliance If you are using Oracle Database Appliance with a single storage shelf, attach the interconnect cables. Topics: •...

  • Page 49: Cabling Oracle Database Appliance To Connect To Fiber Public Networks (Optional)

    Cabling Oracle Database Appliance to Connect to Fiber Public Networks (Optional) You can configure Oracle Database Appliance X6-2-HA to use 10GbE SFP+ (fiber) connections for the public network if you ordered the configuration that contains 10GbE SFP+ (fiber) cards instead of InfiniBand cards.

  • Page 50: Attaching A Storage Expansion Shelf To Oracle Database Appliance

    X2130-3M-N TwinAx 5m X2130-3M-N Attaching a Storage Expansion Shelf to Oracle Database Appliance Review these topics to install and cable a storage expansion shelf for Oracle Database Appliance. Topics: • About Attaching and Cabling Storage Shelves Review these options and best practices for adding storage shelves for Oracle Database Appliance X6-2-HA.

  • Page 51: About Attaching And Cabling Storage Shelves

    Database Appliance X6-2-HA. Storage Shelf Options for Oracle Database Appliance X6-2-HA Oracle Database Appliance X6-2-HA can be shipped with one or two storage shelves. You can obtain the second shelf at a later time to double your storage capacity. If you originally deployed Oracle Database Appliance with one storage shelf, then you can add a storage expansion shelf at any time without having to shut down your databases or applications.

  • Page 52: Description Of Callouts For Cabling Oracle Database Appliance Storage Expansion Shelf

    The cables identified with callout numbers in the preceding figures are included with each shipped Oracle Database Appliance storage expansion shelf. These cables are all black, but have colored labels at each end that match the references to cable colors in the text and the label colors on the back panels.

  • Page 53: Installing And Cabling A Storage Expansion Shelf

    Chapter 3 Attaching Peripheral Devices Installing and Cabling a Storage Expansion Shelf Use this procedure to install and cable a storage expansion shelf for Oracle Database Appliance Place the storage expansion shelf below your Oracle Database Appliance, if possible, or else close enough to connect the provided cables.

  • Page 54: First Startup Of Oracle Database Appliance

    Use this procedure to start up either a newly-installed Oracle Database Appliance, or to start up the appliance after you power it down. To ready Oracle Database Appliance for the powering on the first time, you need to attach all of the required power cords and confirm that initialization completes successfully.

  • Page 55: Powering On Oracle Database Appliance The First Time

    Chapter 3 First Startup of Oracle Database Appliance Powering On Oracle Database Appliance the First Time Use this procedure the first time you power on Oracle Database Appliance. Note: After you connect power cords, the green SP OK light-emitting diode (LED) lights blink for a few minutes, and then turn to steady ON.

  • Page 56: Configuring Oracle Integrated Lights Out Manager

    IP address or host name assigned by the DHCP server, use the network tools provided with the DHCP server. If you do not use DHCP, then use the custom option in Oracle Database Appliance Manager Configurator to assign IP addresses and host names to Oracle ILOM when you deploy your database.
  • Page 57 Chapter 3 Configuring Oracle Integrated Lights Out Manager Using a client system's browser, enter the IP address or host name assigned by DHCP into the browser address field and press Enter. At the login page, enter the default user name, root and the default password, changeme.

  • Page 58: Provisioning Oracle Database Appliance Baremetal System

    The Web Console 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.
  • Page 59 For a bonded configuration, answer yes to using a bonding public interface and configure the first network to use a btbond1 interface without configuring DHCP. # opt/oracle/dcs/bin/odacli/configure-firstnet Using bonding public interface (yes/no) [yes]: yes Select the Interface to configure the network on (btbond1): btbond1...
  • Page 60 Chapter 4 Plumbing the Network INFO: You have chosen Static configuration Enter the IP address to configure : 10.1.10.2 Enter the Netmask address to configure : 255.255.255.0 Enter the Gateway address to configure[10.1.10.1] : INFO: Plumbing the IPs now /usr/share/system-config-network/netconfpkg/NCHostsList.py:100: DeprecationWarning: BaseException.message has been deprecated as of Python badlines.append((num, value_exception.message)) /usr/share/system-config-network/netconfpkg/NCHostsList.py:105:...

  • Page 61: Verifying Cabling And Network Connections

    Run the validation scripts only on Oracle Database Appliance HA models. Log into the Oracle Database Appliance console and access the server node with user name as root and password welcome1. Run validation scripts on both nodes, to verify cabling:...
  • Page 62 If there is a storage expansion shelf connected to the appliance, then power it on. Run the storagetopology command on both nodes to make sure the cabling is correct: # /opt/oracle/dcs/bin/odacli validate-storagetopology INFO : ODA Topology Verification INFO : Running on Node0...

  • Page 63: Downloading Oracle Database Appliance Software

    Download Oracle Database Appliance software and copy to a temporary location before applying updates to your appliance. Download the software files from My Oracle Support to a temporary location on an external client. Refer to the release notes for details about the software for the latest release.

  • Page 64: Installing Oracle Database Appliance Software

    The GI and RDBMS Clone files for release 18.3 are extracted. odacli-dcs-18.3.0.0.0-181205-GI-18.3.0.0.zip odacli-dcs-18.3.0.0.0-180905-DB-18.0.0.0.zip Copy the software files from the external client to Oracle Database Appliance. Use the scp or sftp protocol to copy the bundle. Example using scp command: scp software_file root@oda_host:/tmp...

  • Page 65: Creating The Appliance

    [root@oda1 opt]# rm software_file rm: remove regular file software_file? y You have now updated the repository with the Oracle Database Appliance software, and can create your appliance, as described in the next topic. Creating the Appliance Create the appliance using the Web Console.
  • Page 66 VIP IP Address for Node1: Enter the virtual IP address that resides on Node1 and is shared between the nodes. (Optional) ILOM Host Name: Enter the name of the Oracle ILOM host for Node0 and Node1. (Optional) ILOM Network IP Address: Enter the IP address for the ILOM for...
  • Page 67 PDB Admin User: Enter an Admin user name for the pluggable database (PDB). Database Edition: Select the Oracle Database edition, either Standard Edition and Enterprise Edition. Your license determines which database edition you are eligible to create in the appliance.
  • Page 68 Flex, then you can select the Database Redundancy value as Mirror or High. You can choose Oracle ACFS storage for all database versions, but if you select Oracle ACFS storage, then you cannot specify the database redundancy.
  • Page 69 • To enable Oracle ASR, select Yes and complete the fields: ASR User Name: Enter the e-mail address associated with the My Oracle Support account under which the server is registered. Password: Enter the password associated with the My Oracle Support account under which the server is registered.
  • Page 70 Activity tab. Click the job number to view the tasks. 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.

  • Page 71: Provisioning An Oracle Database Appliance Virtualized Platform

    Provisioning an Oracle Database Appliance Virtualized Platform Oracle Database Appliance provides you with the option to reimage the system and configure the appliance as a virtualized platform. Note: You can provision Standard Edition and Standard Edition 2 Oracle Real Application Cluster (Oracle RAC) databases, but you must use Oracle VM virtualization on a virtualized platform on Oracle Database Appliance and follow the single socket per server licensing restriction.

  • Page 72: Setting Up The Virtualized Platform

    Click Download to download the zip file onto your external client. Unzip the zip file onto external client to get the ISO image. Open a browser and connect to Oracle Integrated Lights Out Manager (ILOM) on Node0 as root. The Summary home page appears.
  • Page 73 For local network, run the command on both nodes. For global network, run the command on any one node. The global configuration sets the initial public network for both the nodes on Oracle Database Appliance, enabling you to download the deployment software onto the appliance. # oakcli configure firstnet...

  • Page 74: Installing Virtualized Platform Software And Deploying The Appliance

    Download and copy the template files to the /OVS directory on dom0 (Node 0). From an external client machine, log on to My Oracle Support and download the Oracle Database Appliance VM Template. Select the latest version from the menu.
  • Page 75 If you use a USB drive to transfer the file, then format it first as FAT32, ext3, or ext4. NTFS file formats are not supported. Log into dom0 as root on Node 0 of Oracle Database Appliance. Remain logged in to dom0 while you complete the remaining steps in this task.
  • Page 76 Chapter 5 Installing Virtualized Platform Software and Deploying the Appliance 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.
  • Page 77 0 4096 r----- 482672.4 oakDom1 2 32768 b---- 132134.6 • Run the command oakcli show oda_base # /opt/oracle/oak/bin/oakcli show oda_base ODA base domain ODA base CPU cores ODA base domain memory :32 ODA base template :/OVS/oda_base_18.3.tar.gz ODA base vlans :[ 'priv1', 'net1']...
  • Page 78 Do not ignore any errors or warnings in the output. If the cabling validation fails, connect the cables correctly and rerun the command until the command runs without any errors or warnings. Do not deploy Oracle Database Appliance until the cabling is correct.
  • Page 79 192.168.16.27 from test0-dom0 Log in as root user. Run the command oakcli configure firstnet from the /opt/ oracle/oak/oakcli directory. Enter the ODA_BASE (Node 0) network information. The command uses an interactive script and prompts you for the information needed to configure the network.
  • Page 80 INFO: Patching storage on node 192.168.16.28 After the firmware patching is completed, confirm that all appropriate components are updated # oakcli show version -detail Deploy the Oracle Grid Infrastructure and Oracle Database software on the appliance. Confirm you are in ODA_BASE: For example:...
  • Page 81 Click Next. Enter or review the configuration details for your system, network, and database information. For details, see “Running the Standalone Oracle Database Appliance Configurator”. Validate your network on the Network Validation page.

  • Page 82: Creating A Configuration File For A Virtualized Platform

    Oracle Auto Service Request (Oracle ASR) configuration. You can configure Oracle ASR after deployment. • Oracle Cloud File System mount point and file system size. Configure a Cloud FS if you want a non-database file location accessible by both nodes. •...

  • Page 83: Running The Standalone Oracle Database Appliance Configurator

    Oracle Database Appliance. If you do not do this, then the validation fails, regardless of whether or not you have completed required configuration.
  • Page 84 Chapter 5 Creating a Configuration File for a Virtualized Platform On the System Information page, provide the system name, and select the correct value from the lists for your region and time zone. In the New Root Password and New Root Password (confirm) fields, enter a new password for the root user. Click Next.
  • Page 85 Chapter 5 Creating a Configuration File for a Virtualized Platform On the Network Information page, provide your domain name, DNS server addresses, public and VIP addresses for your two nodes, SCAN name and addresses, and netmask and Gateway addresses. Click Next. As you enter data on this page, some fields are automatically filled with values derived from earlier entries.
  • Page 86 Database Type. The default type is OLTP. You can also select DSS, or select In-Memory. • Database Class. Select the database class that you want to deploy. Not all options are available for all models of Oracle Database Appliance; the default class is odb-06. • Database Language. The default language is AMERICAN •...
  • Page 87 Click Save to save the configuration file. Click Finish. Note the name and location of the configuration file. You can copy this configuration file to your Oracle Database Appliance for deployment. If you need to make corrections before deployment, then rerun the standalone Oracle Database Appliance Manager Configurator, load your configuration file, make the changes, and save the file again.
  • Page 88 Chapter 5 Creating a Configuration File for a Virtualized Platform If you are running the Configurator on Oracle Database Appliance, and you have completed the preliminary steps to configure your initial network and install the software or deploy ODA_BASE, then you can click Install to deploy the configuration.

  • Page 89: Oracle Database Appliance Postinstallation Tasks

    Complete these administrative tasks after you have deployed software, but before the system is operational. • Configuring CPU Core Count Oracle Database Appliance is delivered with all 36 cores on each server enabled. Follow this procedure to reduce the number of cores, if required. • Securing Oracle ILOM Service Processors Change the Oracle ILOM default password after completing Oracle Database Appliance deployment.

  • Page 90: Changing Oracle Database Appliance Passwords

    Changing the Oracle Installation Owner Passwords During deployment, the root and database users SYS, SYSTEM and PDBADMIN are set to the system password. After deployment, the oracle and grid passwords are also set to the system password. Change the passwords to comply with your enterprise user security protocols.
  • Page 91 Chapter 6 Changing Oracle Database Appliance Passwords Click About, then click Sign Out. Log back into the Web Console with the new password.

  • Page 92: Patching Oracle Database Appliance

    Patching Oracle Database Appliance To keep Oracle Database Appliance running with the latest software, check for and apply Oracle Database Appliance patch bundles when they are released. • About Patching Oracle Database Appliance Use the Oracle Database Appliance Patch Bundle to patch your appliance.
  • Page 93 About Patching Oracle Database Appliance The Oracle Database Appliance Release Notes include information about the latest Oracle Database Appliance patch bundle and a list of component versions in the patch bundle. Oracle recommends updating the appliance with the latest Oracle Database Appliance software version to take advantage of new features, fixes, and the latest supported component versions.

  • Page 94: About Migrating Oracle Database Appliance To The Dcs Stack

    About Using a Different Version of Java Development Kit (JDK) Oracle Database Appliance depends on a specific version of JDK. If you want to use a different version of JDK for a specific application, then install it in a different directory and only point to it for that application.
  • Page 95 Patching pe-checks are available only when patching ODACLI stack. If you are patching and migrating from OAKCLI to ODACLI stack for bare metal system, then follow the procedure in the topic Patching Oracle Database Appliance Bare Metal Systems Using the Command-Line. For patching Virtualized Platform, see the topic Patching Oracle Database Appliance Virtualized Platform.

  • Page 96: Running Update Pre-Checks Before Applying Patches

    Follow the procedure in this topic only when patching ODACLI stack. If you are patching and migrating from OAKCLI to ODACLI stack for bare metal system, then follow the procedure in the topic Patching Oracle Database Appliance Bare Metal Systems Using the Command-Line. For patching Virtualized Platform, see the topic Patching Oracle Database Appliance Virtualized Platform.

  • Page 97: Patching Oracle Database Appliance Using The Web Console

    Updating the Patch Repository Using the Web Console Download the Oracle Database Appliance patches from My Oracle Support and save them in a directory on the appliance. See the Oracle Database Appliance Release Notes for a list of available patches and links to download the patches.

  • Page 98: Patching Database Homes To The Latest Release

    Before upgrading to a different database home, upload the RDBMS Clone Files for the database version, to the repository and then create the database home. See Patching Oracle Database Appliance Using the CLI for the procedure to update the repository with the latest RDBMS Clone Files.
  • Page 99 CLI commands. Patching Oracle Database Appliance Bare Metal Systems Using the Command-Line Follow these steps to apply patches to Oracle Database Appliance OAKCLI bare metal system using CLI commands. Download the Oracle Database Appliance Server Patch for the ODACLI/DCS stack (patch 28864520) from My Oracle Support to a temporary location on an external client.
  • Page 100 For example, for 18.3: [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-storage -v 18.3.0.0.0 -rolling To update the Oracle Database Appliance repository with 18.3 RDBMS Clone files: Download the RDBMS Clone software file p27604558_18300_Linux- x86-64.zip and extract the RDBMS Clone file software: unzip /tmp/27604558_183000_Linux-x86-64.zip odacli-dcs-18.3.0.0.0-180905-DB-18.0.0.0.zip...

  • Page 101: Patching Oracle Database Appliance Virtualized Platform

    Stack and Virtualized Platforms for 18.3 p28864520_183000_Linux-x86-64_1of3.zip p28864520_183000_Linux-x86-64_2of3.zip p28864520_183000_Linux-x86-64_3of3.zip Copy the software files from the external client to Oracle Database Appliance. For two-node systems, ensure that you copy the software files to both nodes. Use the scp or sftp protocol to copy the bundle. 7-10...
  • Page 102 For example, for 18.3: [root@oda1 opt]# /opt/oracle/oak/bin/oakcli update -patch 18.3.0.0.0 -- storage To update the Oracle Database Appliance repository with 18.3 RDBMS Clone files: Download the RDBMS Clone software file p28864456_18300_Linux- x86-64.zip to /tmp location and unpack the RDBMS Clone file software: oakcli unpack -package /tmp/28864456_183000_Linux-x86-64.zip...

  • Page 103: Patching Trace File Analyzer (Tfa) Collector

    Patch Trace File Analyzer (TFA) Collector to ensure that it contains the latest RPMs, and your deployment runs the latest diagnostic data collection version. If you are deploying Oracle Database Appliance for the first time, then TFA is installed with the new release in the location /opt/oracle/tfa/tfa_home.

  • Page 104: Adding Repositories For Patch Updates

    Adding Repositories for Patch Updates Add patch repositories to update operating system RPMs. Patching of operating system is included in the Oracle Database Patch Bundle. If you want to update other RPMs, then you can configure any private or public repository.

  • Page 105: Re-Imaging Oracle Database Appliance

    Use the Oracle Database Appliance cleanup deploy utility, /opt/oracle/oak/ onecmd/cleanup.pl to uninstall Oracle Database Appliance components. • Restoring an Oracle Database Appliance Baremetal System Re-image Oracle Database Appliance to perform a bare metal restore of Oracle Database Appliance. • Performing Secure Erase of Data on Storage Disks With this release, you can securely erase data from storage devices.

  • Page 106: Command Options For Cleanup Utility

    When the grid_user and db_user are the same (roleSeparation=false), you must run the script for each user (-gridUser and -dbUser). Table 8-1 Command Options for Cleanup Utility Option Description Describes the Oracle Grid Infrastructure user grid_user name. The default user is grid Describes the database user name. The db_user...

  • Page 107: Restoring An Oracle Database Appliance Baremetal System

    Re-image Oracle Database Appliance to perform a bare metal restore of Oracle Database Appliance. Bare metal restore uses Oracle Integrated Lights Out Manager (ILOM) to re-image the Oracle Database Appliance node. The ILOM must be configured before performing a bare metal restore or re-image. Generally, the ILOM is configured as part of readying for deploying Oracle Database Appliance.
  • Page 108 # cat /proc/mdstat When the re-synchronization is complete, re-imaging is completed and the machine restarts. After the machine restarts, the system is ready for you to deploy the Oracle software on the appliance to create an Oracle Database Appliance bare metal platform.

  • Page 109: Performing Secure Erase Of Data On Storage Disks

    If you have any data on the disk, then take a backup of your storage disk before running the secure erase tool. Follow the steps to run the secure erase tool: Stop oakd and the database and Oracle Grid Infrastructure before running the secure erase tool. On bare metal systems, run the command:...

  • Page 110: Installing Oracle Orachk Health Check Tool After Re-Imaging The Appliance

    For Oracle Database Appliance bare metal systems, you must manually reinstall Oracle ORAchk Health Check Tool after re-imaging the appliance. Oracle ORAchk Health Check Tool performs proactive heath checks for the Oracle software stack and scans for known problems. If you have re-imaged your appliance, then manually run the RPMs for re-installing Oracle ORAchk Health Check Tool.

  • Page 111: Managing Oracle Databases

    During configuration, two administrative accounts are created for Oracle Database Appliance: the user grid, with a user ID (UID) of 1001, and the user oracle, with a UID of 1000. The user grid is the Oracle Grid Infrastructure installation owner. The user oracle is the Oracle Database installation owner, and the owner of all Oracle Database homes (Oracle homes).

  • Page 112: About Data Migration Options For Oracle Database Appliance

    SYS and SYSTEM users is the Master Password that you set in the Web Console. To change the Group Name and GID from the default values on the Oracle Database Appliance X7-2-HA Virtualized Platform, use the -advance parameter with the command oakcli deploy.

  • Page 113: Working With Databases

    • transportable tablespaces • RMAN You can also use the RMAN utility to back up and recover databases on Oracle Database Appliance. Working with Databases Use the Web Console to display a list of databases, database details, and create and delete databases.

  • Page 114: Creating A Database

    Oracle Database 18.3 is supported on both Oracle Automatic Storage Management (Oracle ASM) and Oracle ASM Cluster file system (ACFS). When databases are created in Oracle ACFS, each database is configured with its own Oracle ACFS file system for the datafiles and uses the following naming convention: /u02/app/db user/oradata/db unique name.
  • Page 115 You must enter a name. The name must contain lowercase alphanumeric characters and cannot exceed 8 characters. The Oracle system identifier (SID) is always set to the database name. (Optional) In the DB Unique Name field, enter a name to define a unique name for the database.

  • Page 116: Creating A Database Instance

    Note: If you provisioned the appliance without creating an initial database, then you must create a Oracle home. If the version of the database home is different from the migrated database, create a database home for the migrated database. You might want to create a database home specifically for the migrated database.

  • Page 117: Cloning A Database From Backup

    Use the Web Console to clone a database from a backup. When you backup a database in Oracle Database Appliance, a backup report is created. Save the backup report as a JSON file and you can use the file to create a database on the same appliance, or a different appliance.
  • Page 118 In the DB Name field, enter a name for the database. The name must contain lowercase alphanumeric characters and cannot exceed 8 characters. The Oracle system identifier (SID) is always set to the database name. Enter the password in the SYS User Password field and the Confirm SYS User Password field.

  • Page 119: Cloning A Database

    The source database must use Oracle ACFS storage. • The source database must not be a multitenant container databases (CDBs) • The ADVM compatibility of Oracle ASM disk groups must be set to 18c or later. • Oracle Flex ASM must be enabled. •...

  • Page 120: Upgrading A Database

    Use the odacli clone-database command to clone a new database from a source database. Upgrading a Database Use the Oracle Appliance Manager Web Console to upgrade an Oracle database to a different database home version. Before upgrading to a different database home, you must upload the RDBMS database version to the repository and create the database home.

  • Page 121: About Managing Multiple Oracle Homes On Oracle Database Appliance

    Create and manage one or more Oracle home directories and Oracle databases on Oracle Database Appliance. Oracle home is the directory in which you install Oracle Database binaries, and from which Oracle Database runs. Oracle Database Appliance supports multiple Oracle homes, including support of different release Oracle Database homes.

  • Page 122: Viewing Database Homes

    Creating a Database Home Use the Web Console to create database homes in Oracle Database Appliance. Before you can create a database home, the Oracle Database Appliance RDBMS Clone file image must be in the repository. Follow these steps to create a database...

  • Page 123: Migrating Databases

    Oracle Database Appliance. • About Migrating Databases You can migrate an entire active container database (CDB) or non-CDB database to an Oracle Database Appliance machine by using the RMAN duplicate command. • Configuring a Static Listener Configure a static listener before you duplicate a database.

  • Page 124: Configuring A Static Listener

    You can only migrate and register a database of the same storage type. For example, to migrate and register an Oracle ACFS database, you must create an Oracle ACFS database and then migrate and register it. Similarly, to to migrate an Oracle ASM database, you must create an Oracle ASM database and then migrate it.

  • Page 125: Migrating A Database

    As oracle user, set the ORACLE_HOME and ORACLE_SID environment variables. ORACLE_HOME=path of Oracle Home against which the AUX DB is created ORACLE_SID=database unique name Display a list of all database storage configured on the appliance and database storage identifiers (ID).

  • Page 126: Registering A Database

    ID: ff2023d9-338d-4cff-8bb4-e73a89e32ce4 DB Name: PRODDB DBUnique Name: PRODDB DB Resource ID: c5b77384-634e-4dc8-b10b-fa2831d2c59b Storage Type: Acfs DATA Location: /u02/app/oracle/oradata/PRODDB RECO Location: /u03/app/oracle/fast_recovery_area/ REDO Location: /u03/app/oracle/redo/ State: ResourceState(status=Configured) Created: November 22, 2016 12:07:12 PM SGT UpdatedTime: November 22, 2016 12:26:39 PM SGT Duplicate the database.
  • Page 127 Oracle Database Appliance environment, then the datapatch will fail. If you have Oracle Database version 11.2 with SQL patches, you must roll back any patches applied to the source database that are not part of the installed Oracle Database Bundle patch (BP).

  • Page 128: About Managing Multiple Database Instances Using Instance Caging

    Consolidation can minimize idle resources, maximize efficiency, and lower costs. Oracle Database Appliance templates are already tuned for the size of each database instance workload. They are designed to run on a specific number of cores. Instance...

  • Page 129: Oracle Em Express And Db Console

    Chapter 9 Oracle EM Express and DB Console Instance caging allocation of core resources is enabled in accordance with the Oracle Database Appliance database template size that you select for each database. The CPU_COUNT initialization parameter is set in the template. Use the CPU_COUNT setting that matches the size of each database to consolidate, and follow the standard instructions for configuring instance caging.

  • Page 130: Managing Storage

    You can add storage at any time without shutting down your databases or applications. • About Storage Addition Options for Oracle Database Appliance X6-2-HA With this release, you can also add X7-2 storage disks to X6-2-HA Oracle Database Appliance, with some configuration changes. • Preparing for Storage Expansion Review and perform these best practices before adding storage to the base shelf or adding the expansion shelf.

  • Page 131: About Storage Addition Options For Oracle Database Appliance X6-2-Ha

    Oracle Database Appliance with existing databases. About Storage Addition Options for Oracle Database Appliance X6-2-HA With this release, you can also add X7-2 storage disks to X6-2-HA Oracle Database Appliance, with some configuration changes. 10-2...

  • Page 132: Preparing For Storage Expansion

    Preparing for Storage Expansion Oracle Database Appliance X6-2-HA uses 1.6 TB raw Solid-State Drives (SSDs), formatted to 1.2 TB for performance. When you order for Oracle Database Appliance X7-2 storage, you receive the default 3.2 TB raw Solid-State Drives, partitioned as per your existing storage capacity.
  • Page 133 Run the odaadmcli orachk command on each node. If there is a problem connecting to either node, then check the /etc/bashrc file and remove (or remark out) any values in the profile for root, oracle, grid users. Run odaadmcli orachk on Node 0:...

  • Page 134: Adding The 10-Pack Of Ssds

    Add the 10-pack solid-state drives (SSDs) for data storage into the existing base configuration to fully populate the base storage shelf. Before adding the disks to the system, ensure that Oracle Database Appliance is on the latest update version. Insert disks one at a time in slots 10 through 19.
  • Page 135 (CACHED and MEMBER), then go to Step 7. su grid user /opt/oracle/oak/bin/stordiag/asm_script.sh 1 6 If the disks are not added to Oracle ASM, then add them manually. As a grid user, execute the sqlplus '/as sysasm' command on the master node to add the disks to Oracle ASM.

  • Page 136: Adding The Storage Expansion Shelf

    Incorrect connections can cause data loss when adding a storage expansion shelf to Oracle Database Appliance with existing databases. If this is a new deployment or re-image of Oracle Database Appliance, perform the following steps in order: Power on the base storage.
  • Page 137 : Overall Cable Validation on Node0 SUCCESS : JBOD Nickname set correctly : Oracle Database Appliance - The correct results will confirm if the two server nodes are properly cabled to the base storage shelf and all disks are online, with a good status, and added to the existing diskgroups on both nodes.
  • Page 138 : Check for overall status of cable validation on Node0 SUCCESS : Overall Cable Validation on Node0 SUCCESS : JBOD0 Nickname set correctly : Oracle Database Appliance - SUCCESS : JBOD1 Nickname set correctly : Oracle Database Appliance - Look for the following indicators that both storage shelves are recognized: •...
  • Page 139 Wait for the command to finish. It takes about 2 to 3 minutes. Then verify that the expansion storage shelf disk status in ASM is ONLINE and CACHED. Run the command show jbod status to check Oracle ASM disk group and disk status.
  • Page 140 Chapter 10 Adding the Storage Expansion Shelf # odaadmcli show validation storage errors Use the odaadmcli show validation storage failures command to show soft validation errors. A typical soft disk error would be an invalid version of the disk firmware. # odaadmcli show validation storage failures Run the odaadmcli show version command to verify that all firmware components in the storage expansion are current.

  • Page 141: Backup, Restore And Recover Databases

    Configuring Agent Proxy Settings for Object Store Access If the Object Store IP address is accessible through proxy setup only from the Oracle Database Appliance server, then define the proxy setting for the agent, so that the agent can access the Object Store.
  • Page 142 Chapter 11 About Database Backup and Recovery Options It is important to create a backup recovery strategy to protect the databases in Oracle Database Appliance from data loss due to a physical problem with a disk that causes a failure of a read from or write to a disk file that is required to run the database, or due to user error.
  • Page 143 Backup to Disk When you backup to disk, you are using the Oracle Fast Recovery Area (FRA) of the disk. FRA is a storage directory that allows backup and recovery operations on Oracle databases.
  • Page 144 NFS location: Create a mount point for the NFS location. The mount point must be accessible from both nodes. The oracle user must have read/write permissions to the NFS location. If the request is being made to a remote server, ensure that it is running.
  • Page 145 • Quick recovery from backups. With the Oracle Object Storage, you can safely and securely use the Web Console to store or retrieve data directly from within the cloud platform, at any time.
  • Page 146 About Database Backup and Recovery Options Note: Before you can use this backup option, you must create an Oracle Cloud Infrastructure Object Storage account. When you create the account, you define the account credentials, end point URL, and bucket. Go to the...
  • Page 147 A system change number (SCN) is a stamp that defines a committed version of a database at a point in time. Oracle assigns every committed transaction a unique SCN. You can recover a database to the latest time or to an SCN.

  • Page 148: Creating A Mount Point For Nfs Backup Location

    For Longterm backups, create a JSON input file and use the command odacli delete-backup for a given Backup Report to delete the backups from Oracle Object Storage. Typically, older level 0 and level 1 database backups are considered obsolete and deleted based on the defined recovery window, as follows: •...

  • Page 149: Configuring Agent Proxy Settings For Object Store Access

    External FRA (NFS Location). Configuring Agent Proxy Settings for Object Store Access If the Object Store IP address is accessible through proxy setup only from the Oracle Database Appliance server, then define the proxy setting for the agent, so that the agent can access the Object Store.

  • Page 150: Creating A Database Backup Policy

    Use the Web Console to create a policy to backup a database to an internal or external Oracle Fast Recovery Area (FRA) location or to the Object Store. The backup policy defines the backup, including the location where you want to store the backups and the recovery window.

  • Page 151: Updating A Database With A Backup Policy

    Chapter 11 Updating a Database with a Backup Policy Enter a name for the backup policy and select the number of days for the recovery window. Select Enable Crosscheck to determine if the files on the disk on in the media management catalog correspond to data in the RMAN repository.

  • Page 152: Updating A Database Backup Policy

    Chapter 11 Updating a Database Backup Policy The details include whether or not Auto Backup is enabled, the Backup Destination, and options to create a backup, enable or disable automatic backups, update the database, and archive log backup schedule. (Optional) Click Manual Backup to create a single backup. Click Update Database Backup Schedule to schedule automatic backups.

  • Page 153: Viewing Backup Reports

    For level 0 and level 1 backups, the recovery window defined in the Backup Configuration determines when the backup is obsolete. The ranges are as follows: • Backup to disk: between 1 and 14 days • Backup to the Oracle Object Storage: between 1 and 31 days 11-13...

  • Page 154: Deleting A Backup Policy

    Chapter 11 Deleting a Backup Policy For Long Term backups to the Oracle Object Storage, view the Backup Report for a database to determine when the backup is obsolete. To delete Long Term Backup, the Database Resource ID or Database name and the Backup Report are required.

  • Page 155: Preparing For Database Backup To Disk

    Report and the command-line interface. Preparing for Database Backup to Disk Use the command-line interface to create a policy to backup a database to the Oracle Fast Recovery Area (FRA) of a disk. You can create a backup policy using the Web Console or the command-line interface.

  • Page 156: Preparing For Database Backup To Nfs Location

    Chapter 11 Using the CLI to Backup, Restore, and Recover The following example uses the Database Resource Name, mydb and the Backup Configuration Name, mydb: # odacli update-database -in mydb -bin mybcfg -bp You can create manual backups or scheduled backups to disk. Preparing for Database Backup to NFS Location Use the command-line interface to create a policy to backup a database to an External FRA (NFS Location).

  • Page 157: Preparing For Database Backup To Oracle Cloud

    Create a backup configuration to backup a database to Oracle Cloud Infrastructure Object Storage. Before you can backup to Oracle Object Storage, you must sign up for an Oracle Cloud Infrastructure Object Storage account and know your Oracle Object Storage credentials.

  • Page 158: Backing Up A Database With The Cli

    The day and time are based on the Oracle Database Appliance time zone. The AutoSchedule triggers a level 0 Backup every Sunday and a level 1 the other 6 days of the week. Use the command odacli update-schedule to disable or change the scheduled backup time.

  • Page 159: Recovering A Database With The Cli

    Recover the database to the system using a Backup Report, point-in-time recovery (PITR), a system change number (SCN), or from the latest backup time. Recovering a database in Oracle Database Appliance is a full RMAN database recovery. Recovering from a backup report requires JSON input for the backup report.
  • Page 160 Chapter 11 Using the CLI to Backup, Restore, and Recover "oraHomeVersion" : "12.2.0.1.170814 (26723265, 26609817)", "sqlPatches" : "25811364,26609817", "backupLogLoc" : "https://swiftobjectstorage.example.com/v1/dbaasimage/backupbucket/system_namec1n1/ rmanlog/ExampleDBu/2717054291/2018-01-08/rman_backup_2018-01-08_12-42-41.0545.log", "tdeWalletLoc" : null, "dbConfigLoc" : "https://swiftobjectstorage.example.com/v1/dbaasimage/backupbucket/system_namec1n1/ dbconfig/ExampleDBu/2717054291/2018-01-08/ DBCONFIG_TAG20180108T124407_2018-01-08_12-44-07.0533.tar.gz", "name" : "Backup_Report_ExampleDB", "createTime" : "January 08, 2018 12:42:08 PM UTC", "state"...

  • Page 161: Restoring A Database With The Cli

    Using the CLI to Backup, Restore, and Recover Restoring a Database with the CLI Restore a database to a system from Oracle Object Storage using a Backup Report and the command-line interface. When you restore a database, environment and validation checks and setup tasks are performed.
  • Page 162 Chapter 11 Using the CLI to Backup, Restore, and Recover "updatedTime" : "January 08, 2018 12:44:12 PM UTC", "backupReportLogDetail" : "https://swiftobjectstorage.example.com/v1/dbaasimage/backupbucket/ system_namec1n1/ rmandetaillogreport/ExampleDBu/2717054291/2018-01-08/ rman_list_backup_detail_2018-01-08_12-44-04.0362.log", "dbInfo" : { "dbClass" : "OLTP", "dbType" : "RAC", "dbShape" : "odb1", "dbEdition" : "EE", "dbStorage" : "ASM" "dbDataSize"...

  • Page 163: Managing An Oracle Database Appliance Virtualized Platform

    Oracle Database Appliance Virtualized Platform. Learn about resizing your Oracle Database domain (ODA_BASE), a privileged virtual machine. • About Oracle Database Appliance Virtualized Platform You can use Oracle VM to optimize your system resource use for databases and applications. • Oracle Database Appliance Virtualized Platform Architecture Review these topics to understand Oracle Database Appliance Virtualized Platform, and how you can use it to optimize system resource use.

  • Page 164: About Oracle Database Appliance Virtualized Platform

    These topics describe how to use OAKCLI to create and manage CPU pools on Oracle Database Appliance Virtualized Platform. About Oracle Database Appliance Virtualized Platform You can use Oracle VM to optimize your system resource use for databases and applications. You can deploy a virtualized platform on Oracle Database Appliance. The virtual platform is based on Oracle VM.

  • Page 165: Oracle Database Appliance Virtualized Platform Architecture

    Platform works with Oracle Database Appliance hardware. • About Virtual Machines and Oracle Database Appliance Virtualized Platforms Oracle Database Appliance Virtualized Platform is designed to run and deploy virtual machines to manage system resources. About Oracle Database Appliance Virtualized Platform Architecture Review this topic to understand how Oracle Database Appliance Virtualized Platform works with Oracle Database Appliance hardware.

  • Page 166: About Virtual Machines And Oracle Database Appliance Virtualized Platforms

    CPUs, network devices, and disk devices, in which virtual machines run. A guest is a virtualized operating system running within a domain. Multiple guests can run on the same instance of Oracle Database Appliance Virtualized Platform, each 12-4...
  • Page 167 ODA_BASE contains three shared repositories named fs1, fs2, and fs3. • Each shared repository is an Oracle ACFS in ODA_BASE created on top of the Oracle Automatic Storage Management (Oracle ASM) disk group (DATA or RECO) chosen by the user when creating the shared repository.

  • Page 168: About Network Infrastructure And Vlans On Oracle Database Appliance Virtualized Platform

    Note: Virtual machine (VM) repositories on Oracle Database Appliance can only be on the boot drives or an Oracle Database Appliance shared storage shelf. External storage cannot be used for VM shared repositories on Oracle Database Appliance. About Network Infrastructure and VLANs on Oracle...
  • Page 169 For example, to connect a virtual machine named myvm1 to the net1 network, you would use the following command: oakcli modify vm myvm1 -addnetwork net1 The illustration “Basic Virtual Machine Local Area Network" shows a typical Oracle Database Appliance local area network configuration that results from this virtual machine network configuration:...
  • Page 170 Chapter 12 About Network Infrastructure and VLANs on Oracle Database Appliance Virtualized Platform Figure 12-3 Basic Virtual Machine Local Area Network You assign default VLANs to ODA_BASE during the installation and configuration of Oracle Database Appliance Virtualized Platform. The figure "Oracle Database Appliance Virtualized Platform with Virtual Local Area Networks"...

  • Page 171: How To Create And Manage Shared Repositories

    • Starting a Shared Repository Use the oakcli start repo command to start a virtual machine and assign it to a shared repository on Oracle Database Appliance Virtualized Platforms • Stopping a Shared Repository Use the oakcli stop repo command to command to stop a shared repository on a node on Oracle Database Appliance Virtualized Platforms.

  • Page 172: Creating A Shared Repository

    Oracle Database Appliance Virtualized Platforms. Creating a Shared Repository Use the oakcli create repo command to create a shared repository on Oracle Database Appliance Virtualized Platforms. When you run the oakcli create repo command, you identify the repository name...

  • Page 173: Starting A Shared Repository

    Starting a Shared Repository Use the oakcli start repo command to start a virtual machine and assign it to a shared repository on Oracle Database Appliance Virtualized Platforms Before you can assign a virtual machine to a shared repository, use the oakcli start repo command to start the repository and make the storage available.

  • Page 174: Deleting A Shared Repository

    Use the command oakcli show vdisk to view information about virtual disks on Oracle Database Appliance Virtualized Platforms. • Cloning Virtual Disks Use the oakcli clone vdisk command to create clones of virtual disks on Oracle Database Appliance Virtualized Platforms. 12-12...

  • Page 175: Creating A Virtual Disk For Use In A Shared Repository

    Example 12-8 Example of Displaying the Information for All Vdisks This example displays information about all virtual disks configured on an Oracle Database Appliance: # oakcli show vdisk NAME...

  • Page 176: Cloning Virtual Disks

    VmAttached Cloning Virtual Disks Use the oakcli clone vdisk command to create clones of virtual disks on Oracle Database Appliance Virtualized Platforms. The command oakcli clone vdisk defines the size of the virtual disk, the shared repository in which that disk is created, defines the unique name for that disk within that shared repository, and defines if the disk is used for one virtual machine, or can be shared by multiple virtual machines.

  • Page 177: Attaching A Virtual Disk To A Virtual Machine

    -repo repoprod1 How to Manage Virtual Machine Templates These topics describe how to use OAKCLI to import, configure, modify and check virtual machine templates on Oracle Database Appliance Virtualized Platform. • About Managing Virtual Machine Templates Import and configure virtual machine templates as the source for the virtual machines deployed on Oracle Database Appliance Virtualized Platform.

  • Page 178: About Managing Virtual Machine Templates

    Note: You cannot create or clone templates directly on Oracle Database Appliance Virtualized Platform, you must use the Oracle VM templates that are available in Oracle Software Delivery.

  • Page 179: Importing Virtual Machine Templates

    The oakcli show vmtemplate command displays the name and repository for each virtual machine template as well as the default number of CPUs and default amount of memory that Oracle Database Appliance Virtualized Platform would assign to a virtual machine created from the template.
  • Page 180 Chapter 12 How to Manage Virtual Machine Templates You can import virtual machine templates and assemblies directly from a remote repository using a URL to identify the source of the files. You can choose to use a remote copy command to copy files from the remote repository into your Dom0 /OVS directory, and then import the files using the path and names to identify the downloaded files.

  • Page 181: Configuring A Virtual Machine Template

    Configuring a Virtual Machine Template Use the oakcli configure vmtemplate command to configure a virtual machine template on Oracle Database Appliance Virtualized Platform. The values become the default values for any virtual machine cloned from this template. You can change any or all of them later with the oakcli configure vm command.

  • Page 182: Modifying A Virtual Machine Template Configuration

    Use the oakcli delete vmtemplate command to remove a virtual machine template. If you no longer need a template that you previously stored, then you can remove the template from the repository. Example Remove the virtual machine template named myol6u_15gb3 from Oracle Database Appliance Virtualized Platform: oakcli delete vmtemplate my0l6u_15gb3 12-20...

  • Page 183: How To Create Clones And Snap Clones Of A Template

    • About Creating Clones and Snap Clones of a Template You can create, or clone, virtual machines from imported templates (or assemblies) or from an existing virtual machine on Oracle Database Appliance Virtualized Platforms. • Cloning a Template With OAKCLI Use the oakcli clone vm command to clone virtual machines that have attached virtual disks on Oracle Database Appliance Virtualized Platforms.

  • Page 184: Creating A Snap Clone From A Template With Oakcli

    Creating a Snap Clone from a Template With OAKCLI Use the oakcli clone vm command to create a snap clone of a virtual machine template on Oracle Database Appliance Virtualized Platforms. Use the -vmtemplate name option to provide the name of the virtual machine template that you want to clone, where name is the name of the template.

  • Page 185: How To Manage Virtual Machines On Oracle Database Appliance Virtualized Platform

    Database Appliance Virtualized Platform. • Starting and Stopping a Virtual Machine Use the oakcli start vm command to start a virtual machine on Oracle Database Appliance Virtualized Platform and use the oakcli stop vm command to stop a virtual machine.

  • Page 186: About Managing Virtual Machines On Oracle Database Appliance Virtualized Platform

    Chapter 12 How to Manage Virtual Machines on Oracle Database Appliance Virtualized Platform About Managing Virtual Machines on Oracle Database Appliance Virtualized Platform Deploy virtual machines on Oracle Database Appliance Virtualized Platform to run other workloads that are independent of databases running in ODA_BASE Use OAKCLI commands to create and manage virtual machines, including starting and stopping them, and opening consoles for graphical user interface (GUI) access.
  • Page 187 Chapter 12 How to Manage Virtual Machines on Oracle Database Appliance Virtualized Platform sample5_odarepo1 2048 OFFLINE odarepo1 sample6_odarepo1 2048 OFFLINE odarepo2 test1_odarepo1 2048 OFFLINE odarepo1 test2_odarepo2 2048 OFFLINE odarepo2 vm1_odarepo1 4096 ONLINE odarepo1 vm2_odarepo2 2048 OFFLINE odarepo2 win_vm1 1500 ONLINE odarepo1 •...

  • Page 188: Creating A Virtual Machine

    Configuring a Virtual Machine Use the oakcli configure vm command to configure a virtual machine on Oracle Database Appliance Virtualized Platform. Include a -prefnode clause, to identify the node where you want the virtual machine...

  • Page 189: Starting And Stopping A Virtual Machine

    Database Appliance Virtualized Platform and to increase or decrease resource allocation to user domains. Starting and Stopping a Virtual Machine Use the oakcli start vm command to start a virtual machine on Oracle Database Appliance Virtualized Platform and use the oakcli stop vm command to stop a virtual machine.

  • Page 190: Externally Configuring A Virtual Machine

    0:eth0;com.oracle.linux.network.ipaddr.0:192.1.2.18' Note: • For more information about Oracle VM Guest Additions, see "Using the Oracle VM Guest Additions" in the Oracle VM Utilities Guide for x86 at http://docs.oracle.com/cd/E35328_01/E35333/html/vmutl-guestadd.html. • Refer to the whitepaper Oracle Database Appliance: Automated Virtual Machine Provisioning for more information.

  • Page 191: Creating An Image For A New Virtual Machine

    Chapter 12 How to Manage Virtual Machines on Oracle Database Appliance Virtualized Platform Creating an Image for a New Virtual Machine Use the oakcli clone vm command to create an image for a new virtual machine on Oracle Database Appliance Virtualized Platform.

  • Page 192: Removing A Virtual Machine From A Shared Repository

    When you no longer have use for a particular virtual machine, delete the machine. When deleting the machine, you can specify the Oracle Database Appliance node from which you want to remove the virtual machine. If this optional parameter is not included, then the virtual machine is removed from both nodes.

  • Page 193: How To Create Driver Domain Virtual Machines

    Chapter 12 How to Create Driver Domain Virtual Machines Example 12-20 Example of Migrating a Virtual Machine from the Currently Running Node to Another Node This example migrates a virtual machine named myvm1 # oakcli migrate vm myvm1 How to Create Driver Domain Virtual Machines Use driver domain virtual machines to improve performance.

  • Page 194: Creating A Driver Domain Virtual Machine From A Template

    Unbreakable Enterprise Kernel 3 (UEK3). • Microsoft Windows with Oracle VM Windows PV Driver 3.4.1. Oracle VM Windows PV Driver 3.4.1 release is available for download on My Oracle Support as patch number 23346086. • Oracle Solaris 11.3 or higher x86.

  • Page 195: Converting A Virtual Machine To A Driver Domain Virtual Machine

    Chapter 12 How to Create Driver Domain Virtual Machines clone virtual machine oakcli clone vm vm1_ol5u7 -vmtemplate OL5U7 -repo odarepo1 -node 0 - driverdomain Run the oakcli show vm command to confirm that the virtual machine is configured in driver domain mode. When the virtual machine is in driver mode, the output for the DriverDomain attribute is TRUE.

  • Page 196: Converting A Root Disk To A Driver Domain Disk

    OL6U7_x86_64_PVHVM or OVM_OL5U7_X86_64_PVM_10GB.tgz, that are available in the /OVS directory in Dom0. Using driver domains requires at least Oracle Database Appliance version 12.1.2.7.0. In this example, the following is the layout of disks in the original OL6U7 virtual machine: - boot/root disk '/dev/xvda' (echo -e "p"...
  • Page 197 Chapter 12 How to Create Driver Domain Virtual Machines The df -h is as follows: # df -h Filesystem Size Used Avail Use% Mounted on /dev/xvda2 11G 814M 8.9G 9% /tmpfs 3.9G 0 3.9G 0% /dev/shm /dev/xvda1 479M 51M 399M 12% /boot /dev/xvdb1 92G 55G 33G 63% /u01 Clone a guest VM as a driver domain guest VM.
  • Page 198 Chapter 12 How to Create Driver Domain Virtual Machines For example, the OL6U7 virtual machine is in the odarepo1 repository: /u01/app/sharedrepo/odarepo1/.ACFS/snaps/OL6U7/VirtualMachines/ OL6U7/vm.cfg Add the new disk entry on the disk parameter. disk = ['file:virtual disk file path,virtual device,r/w option'] For example, add the newboot virtual disk for the OL6U7 virtual machine, which is in the odarepo1 repository.
  • Page 199 Setup Grub in the new boot disk. Use the grub or grub2 command, where /dev/xvdc is the new boot disk device. • If you are using Oracle Linux 6U7, use grub: # grub grub> device (hd0) /dev/xvdc grub> root (hd0,0) grub>...
  • Page 200 Chapter 12 How to Create Driver Domain Virtual Machines • If you are using Oracle Linux 7u2, use grub2: # grub2-mkconfig -o /boot/grub2/grub.cfg # grub2-install /dev/xvdc The following example uses grub: # grub Probing devices to guess BIOS drives. This may take a long time.
  • Page 201 Chapter 12 How to Create Driver Domain Virtual Machines Edit /etc/fstab with the new boot device. UUID=b072e1e9-05a9-4544-a4dd-b15ba49cea2f / ext4 defaults 1 1 #UUID=301e09e2-78e4-47d6-b501-d4f1098b419d /boot ext4 defaults 1 2 <<--- Original boot device UUID=3d7a177b-0fa0-4212-9c0c-c5554bb1817a /boot ext4 defaults 1 2 UUID=39e5a125-a1d8-48f4-9e81-f9e89b4dd51b swap swap defaults 0 0 tmpfs /dev/shm tmpfs defaults 0 0 devpts /dev/pts devpts gid=5,mode=620 0 0 sysfs /sys sysfs defaults 0 0...
  • Page 202 Chapter 12 How to Create Driver Domain Virtual Machines The following is an example of the vm.cfg before the edit: # cat vm.cfg vif = ['type=netfront,bridge=net1'] name = 'OL6U7' extra = 'NODENAME=OL6U7' builder = 'hvm' cpus = '24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47 ,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,6 vcpus = 2 memory = 8192 cpu_cap = 0 vnc = 1...
  • Page 203 Chapter 12 How to Create Driver Domain Virtual Machines Stop and restart the guest VM oakcli stop vm vm_name oakcli start vm vm_name oakcli stop vm OL6U7 oakcli start vm OL6U7 Check the layout of the new disks. The layout should be similar to the following: # df -h Filesystem Size Used Avail Use% Mounted on/dev/xvdb2 11G 814M 8.9G 9% / tmpfs 3.9G 0 3.9G 0% /dev/shm...
  • Page 204 Chapter 12 How to Create Driver Domain Virtual Machines Note: The oakcli clone vm command creates a duplicate (snapshot) of the VDisks that are attached to the guest VM. Use the oakcli delete vdisk command to remove the orphan VDisks. Run the oakcli show vm vm_name command to verify that the oakcli virtual machine inventory is in sync with the vm.cfg file.

  • Page 205: How To Manage High Availability On Oracle Database Appliance Virtualized Platform

    Chapter 12 How to Manage High Availability on Oracle Database Appliance Virtualized Platform How to Manage High Availability on Oracle Database Appliance Virtualized Platform Use the oakcli configure vm command to configure high availability services for your virtual machines. A system that is highly available is designed to provide uninterrupted computing services during essential time periods, during most hours of the day, and during most days of the week throughout the year.

  • Page 206: About Managing Cpu Pools For Resource Allocation

    Use the command oakcli show cpupool command to display the CPUs assigned to each defined CPU pool. • Changing the Number of CPUs Assigned to a CPU Pool on Oracle Database Appliance Virtualized Platform Nodes Use the oakcli configure cpupool command to change the number of CPUs assigned to a CPU pool.

  • Page 207: About Over-Subscribed Cpu Pools

    Chapter 12 How to Manage CPU Pools on Oracle Database Appliance Virtualized Platform odaBaseCpuPool [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11] oakcli show cpupool -node 1 Pool Cpu List default-unpinned-pool [12, 13, 14, 15, 16, 17, 18, 1...

  • Page 208: Changing The Number Of Cpus Assigned To A Cpu Pool On Oracle Database Appliance Virtualized Platform Nodes

    Use the oakcli configure cpupool command to change the number of CPUs assigned to a CPU pool. An Oracle VM Server can belong to only one virtual pool. However, you can change the resources allocated to a virtual pool to increase the CPU resources available to the virtual machine.
  • Page 209 Chapter 12 How to Manage CPU Pools on Oracle Database Appliance Virtualized Platform Example 12-25 Example of Assigning a Virtual Machine to a CPU Pool on Oracle Database Appliance Virtualized Platform This oakcli configure vm example pins the virtual machine named wintest to...

  • Page 210: Oracle Database Appliance Command-Line Interface

    Oracle Database Appliance Command- Line Interface The command-line interface has different classes of tools to manage Oracle Database Appliance. • About Oracle Database Appliance Command-Line Interface Three classes of tools are available to perform deployment, lifecycle management, and system administration on Oracle Database Appliance.

  • Page 211: About Oracle Database Appliance Command-Line Interface

    Three classes of tools are available to perform deployment, lifecycle management, and system administration on Oracle Database Appliance. The command-line interface (CLI) is an alternative to Oracle Database Appliance Web Console for some appliance configuration and patching tasks, database management, and job activity.
  • Page 212 • Show server, memory, processor, power, cooling, and network details Depending on your version of Oracle Appliance Manager and your hardware, some of the odacli commands may not be available to you. To see which commands are supported on your version of Oracle Appliance Manager and your hardware, run the odacli help command: odacli -h.
  • Page 213 Pluggable Database Admin User --pdbname, -p Pluggable Database Name --version, -v Database Version Oracle Database Appliance Manager Command-Line Interface Help Run the -h command to see the usage information for all commands available for your Oracle Database Appliance. For example: odacli -h 13-4...

  • Page 214: Managing Odacli Privileges And Security With Sudo

    You may want to use SUDO as part of your system auditing and security policy. For most tasks, Oracle recommends that you log in as root to use the Oracle Appliance Manager command-line interface on Oracle Database Appliance. If you are not logged in as root, then you cannot carry out most actions on the appliance.
  • Page 215 You do this by adding lines to the commands section in the /etc/sudoers file: ## The commands section may have other options added to it. Cmnd_Alias ODACLI_CMDS=/opt/oracle/dcs/bin/odacli * jdoe ALL = ODACLI_CMDS In this example, the user name is jdoe. The file parameter setting ALL= ODACLI_CMDS grants the user jdoe permission to run all odacli commands that are defined by the command alias ODACLI_CMDS.

  • Page 216: Configure Command

    SUDO prevents jdoe2 from running the command. [jdoe2@servernode1 ~]$ sudo /opt/oracle/dcs/bin/odacli list-databases Sorry, user jdoe2 is not allowed to execute '/opt/oracle/dcs/bin/odacli list-databases' as root on servernode1. Configure Command Use the configure and update commands to configure the appliance.

  • Page 217: Configure-Firstnet

    # configure-firstnet Usage Notes This command ensures that the system is available in the network, enabling you to manage the deployment through the Oracle Appliance Manager Web Console. • Bonded network configuration: Bonded dual-ported interface. With the bonded configuration, you can only enable one of the interfaces. The bonded configuration supports VLANs.
  • Page 218 Chapter 13 Configure Command bonding: btbond1: Removing slave em3. bonding: btbond1: releasing active interface em3 :::::::::: Example 13-5 Configuring the First Network as a Non-Bonded Network The following is an example of a non-bonded configuration. For a non-bonded configuration, answer no to using a bonding public interface. # configure-firstnet Using bonding public interface (yes/no) [yes]: no INFO: Breaking the bonding on btbond1...

  • Page 219: Odacli Apply Patch And Update Commands

    • odacli list-availablepatches Use the odacli list-availablepatches command to display all available patches for Oracle Database Appliance. • odacli list-prepatchreports Use the odacli list-prepatchreports command to display all pre-check reports, with a list of pre-checks run with status and comments.

  • Page 220: Odacli Describe-Component

    Use the odacli describe-component command to display the installed version and the latest available version for each component. If there are multiple DB Homes installed in Oracle Database Appliance, then the output will display the version details for each of the installed homes. You can use this command to check the component version after applying a patch.
  • Page 221 Chapter 13 odacli Apply Patch and Update Commands Usage Notes Use the odacli describe-component command to get component details. On a multi-node environment, the command provides details across all nodes. Use the -- node or --local option to get component details for a specific node. Example 13-6 Displaying Patch Details for Components # odacli describe-component...

  • Page 222: Odacli Describe-Latestpatch

    41016500 41017100 up-to-date odacli describe-latestpatch Use the odacli describe-latestpatch command to display a list of the latest supported patch versions for each component. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli describe-latestpatch [-h] Parameters Parameter Description (Optional) Displays help for using the command.

  • Page 223: Odacli Describe-Prepatchreport

    Use the odacli describe-prepatchreport command to display the pre-check report, with a list of pre-checks run with status and comments. Patching pre-checks help identify and remedy any problems before attempting to patch, and ensure all components are ready for updates. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli 13-14...
  • Page 224 Chapter 13 odacli Apply Patch and Update Commands Syntax odacli describe-prepatchreport -i Parameters Parameter Description (Optional) Displays help for using the command. --help (Optional) Displays JSON output. The default is false. --json Specifies the Job ID for the pre-check report. --jobid Usage Notes Use the odacli describe-prepatchreport command to display the pre-check...
  • Page 225 Chapter 13 odacli Apply Patch and Update Commands running Validate patching tag Success Validated patching tag: 12.2.1.2.0 Validate available space Success Validated free space under / Is system provisioned Success Verified system is provisioned Validate minimum agent version Success GI patching enabled in current DCSAGENT version...

  • Page 226: Odacli Update-Agentconfig-Parameters

    Patch conflict check Success No patch conflicts found on DBHome odacli update-agentconfig-parameters Use the odacli update-agentconfig-parameters command to modify configuration variables used by the appliance. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli update-agentconfig-parameters Parameters Parameter Description (Optional) Displays help for using the --help command.
  • Page 227 Configuring Agent Proxy Settings for Object Store Access If the Object Store IP address is accessible through proxy setup only from the Oracle Database Appliance server, then define the proxy setting for the agent, so that the agent can access the Object Store.

  • Page 228: Odacli List-Agentconfig-Parameters

    Chapter 13 odacli Apply Patch and Update Commands odacli list-agentconfig-parameters Use the odacli list-agentconfig-parameters command to list configuration variables used by the appliance. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-agentconfig-parameters [-h] [-j] [-n] Parameters Parameter Description (Optional) Displays help for using the --help command.

  • Page 229: Odacli List-Availablepatches

    Configuring Agent Proxy Settings for Object Store Access If the Object Store IP address is accessible through proxy setup only from the Oracle Database Appliance server, then define the proxy setting for the agent, so that the agent can access the Object Store.

  • Page 230: Odacli List-Prepatchreports

    Patching pre-checks help identify and remedy any problems before attempting to patch, and ensure all components are ready for updates. File Path /opt/oracle/dcs/bin/odacli Syntax odacli list-prepatchreports [-h] [-j] Parameters...

  • Page 231: Odacli Update-Dbhome

    File Path /opt/oracle/dcs/bin/odacli Syntax odacli update-dbhome -i dbhomeid -v version [-j] [-h] [-v] Parameters Parameter Description Defines the Oracle Database Home to update. --dbhomeid (Optional) Displays help for using the --help-h command. --json (Optional) Displays JSON output. The default is false.

  • Page 232: Odacli Update-Dcsagent

    Chapter 13 odacli Apply Patch and Update Commands Usage Notes • The update-dbhome command applies the latest release update (RU) for Oracle Database home. • To be updated with the latest patches, the database must be running. • Only databases in the Configured status are updated. Use the odacli list- database command to see a list of configured databases.

  • Page 233: Odacli Update-Repository

    If the patch contains more than one zip file, then extract and concatenate the zip files before updating the repository. The following is an example of the steps to get the files from My Oracle Support, extract, and concatenate the files: Note: The file names in the examples might not reflect actual file names.
  • Page 234 Parameter Description Defines the zip filename of patch bundle or --filename –f RDBMS clones downloaded from My Oracle Support. Provide a comma-separated list of absolute file paths of the end user and patch bundles. (Optional) Displays JSON output. The default --json is false.

  • Page 235: Odacli Update-Server

    , use the update-dcsagent command to update the agent to the current version. On Oracle Database Appliance X7-2-HA, you must run the command on both nodes. After the update is applied, the agent automatically restarts. It will take a few minutes to reconnect to the server.

  • Page 236: Odacli Update-Storage

    --version –v (Optional) Displays JSON output. The default --json is false. (Optional) Displays help for using the --help command. (Optional) Enables to patch shared disks in --rolling rolling fashion without stopping Oracle Clusterware. The shared disks must be online. 13-27...

  • Page 237: Odacli Appliance Commands

    Use the odacli appliance commands to perform lifecycle activities for the appliance. • odacli create-appliance Use the odacli create-appliance command in a JSON file format to provision Oracle Database Appliance. • odacli describe-appliance Use the odacli describe-appliance command to display appliance details.

  • Page 238: Odacli Describe-Appliance

    (Optional) Displays JSON output. --json, -j (Optional) Displays help for using the command. --help odacli describe-appliance Use the odacli describe-appliance command to display appliance details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli describe-appliance [-d|-no-d][-j][-h] Parameters Parameter Description (Optional) Displays the agent CLI build details.

  • Page 239: Odacli Describe-System

    Reco High odacli describe-system Use the odacli describe-system command to display details about components installed on the system. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To list jobs and view job details and status: odacli describe-system [-h] [-b] [-d] [-j] Parameters Parameter Description (Optional) Displays JSON output.
  • Page 240 Chapter 13 odacli Appliance Commands Time Stamp : July 29, 2018 7:00:12 PM UTC RPMS Installed RPMS : acl-2.2.49-7.el6_9.1.x86_64, aide-0.14-11.el6.x86_64, alsa-lib-1.1.0-4.el6.x86_64, at-3.1.10-49.el6.x86_64, atk-1.30.0-1.el6.x86_64, attr-2.4.44-7.el6.x86_64, audit-2.4.5-6.el6.x86_64, audit- libs-2.4.5-6.el6.x86_64, audit-libs- python-2.4.5-6.el6.x86_64, augeas- libs-1.0.0-10.el6.x86_64, authconfig-6.1.12-23.el6.x86_64, avahi- libs-0.6.25-17.el6.x86_64, b43- openfwwf-5.2-10.el6.noarch, basesystem-10.0-4.0.1.el6.noarch, bash-4.1.2-48.el6.x86_64, bc-1.06.95-1.el6.x86_64, bind- libs-9.8.2-0.62.rc1.el6_9.5.x86_64, bind- utils-9.8.2-0.62.rc1.el6_9.5.x86_64,...
  • Page 241 Chapter 13 odacli Appliance Commands +-33-3.2.3-69.el6.x86_64, compat- readline5-5.2-17.1.el6.x86_64, compat-sap-c+ +-4.8.2-16.el6.x86_64, ConsoleKit-0.4.1-6.el6.x86_64, ConsoleKit- libs-0.4.1-6.el6.x86_64, ConsoleKit- x11-0.4.1-6.el6.x86_64, coreutils-8.4-46.0.1.el6.x86_64, coreutils- libs-8.4-46.0.1.el6.x86_64, cpio-2.10-13.el6.x86_64, cpp-4.4.7-18.el6.x86_64, cpupowerutils-1.3-2.el6.x86_64, cpuspeed-1.5-22.0.1.el6.x86_64, cracklib-2.8.16-4.el6.x86_64, cracklib- dicts-2.8.16-4.el6.x86_64, crash-7.1.4-1.0.1.el6_7.x86_64, crda-3.13_2015.10.22-3.el6.x86_64, createrepo-0.9.9-27.el6_9.noarch, cronie-1.4.4-16.el6_8.2.x86_64, cronie- anacron-1.4.4-16.el6_8.2.x86_64, crontabs-1.10-33.el6.noarch, cryptsetup- luks-1.2.0-11.el6.x86_64, cryptsetup-luks- libs-1.2.0-11.el6.x86_64, cups- libs-1.4.2-78.el6_9.x86_64, ....

  • Page 242: Odacli List-Featuretracking

    Chapter 13 odacli Appliance Commands odacli list-featuretracking Use the odacli list-featuretracking command to display the latest feature tracking report. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax Use the odacli list-featuretracking command to display the latest feature tracking report. odacli list-featuretracking [-h] [-j] Parameters...
  • Page 243 Chapter 13 odacli Appliance Commands Measured Feature Name High Water Mark Category ------------------------------------------------------------ Maximum usage of CPU 8.12 DCS Agent Maximum usage of Memory 437.12 DCS Agent Maximum number of threads DCS Agent Maximum number of open file descriptors DCS Agent Maximum number of Databases Database Maximum number of EE Databases...

  • Page 244: Odacli Backup And Recovery Commands

    Storage Maximum usage of ACFS file systems 12.19 Storage odacli Backup and Recovery Commands Use the odacli backup and recover commands to backup to and restore from Oracle Cloud Infrastructure Object Storage or disk. Topics: • odacli create-backup Use the command odacli create-backup to create a Level 0, Level 1, archivelog, or Longterm backup.
  • Page 245 Backup and Recovery Commands • odacli create-objectstoreswift Use the command odacli create-objectstoreswift to create and store the Oracle credential details required to backup to Oracle Object Store. • odacli delete-backup Use the command odacli delete-backup to delete backups. •...

  • Page 246: Odacli Create-Backup

    0 or a level 1 backup. If you do not select a backup type (level 0, level 1, or LongTerm), a level 1 backup is performed. – Longterm: Longterm backups are only available when backing up to Oracle Cloud Infrastructure Object Storage (Oracle Object Storage). 13-37...

  • Page 247: Odacli Create-Backupconfig

    # odacli create-backup -i20576eb1-bc32-4e34-bf97-fda0b60ca15b -bt Regular- L0 -t 2017Dec22ProductionLevel0 odacli create-backupconfig Use the command odacli create-backupconfig to create a backup configuration. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli create-backupconfig -n backup configuration name -d backup destination{Disk|ObjectStore|NFS|None} [-c] [-cr] [-h] [-j] [-no- cr] [-o][-w] Parameters...

  • Page 248: Odacli Create-Objectstoreswift

    -d NFS -n NfsPolicy1 -c /tmp/Nfsbackps -w 2 odacli create-objectstoreswift Use the command odacli create-objectstoreswift to create and store the Oracle credential details required to backup to Oracle Object Store. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli create-objectstoreswift -e swift end point URL [-h] [-j] -n...

  • Page 249: Odacli Delete-Backup

    Usage Notes The command creates and stores the Oracle Cloud Infrastructure Object Storage credential details in the system and stores the password in an encrypted Oracle wallet. You can attach the credentials to one or more backup configurations. The credentials are validated during the command odacli create-backupconfig with objectstore as the destination.

  • Page 250: Odacli Delete-Backupconfig

    Chapter 13 odacli Backup and Recovery Commands • Delete long term backups from Oracle Object Storage by using a JSON file with the --backupreport option. • To locate the database ID, view the databases in the Web Console or use the command odacli list-databases.

  • Page 251: Odacli Delete-Objectstoreswift

    You cannot delete the Object Store credentials if they are attached to a backup configuration. Example 13-33 Deleting the Oracle Object Store Credentials # odacli delete-objectstoreswift -i Object Store Swift id odacli describe-backupreport Use the command odacli describe-backupreport to display details of a specific backup report.
  • Page 252 Chapter 13 odacli Backup and Recovery Commands Parameter Description (Optional) Displays JSON output. The default is false. --json Defines the backup report ID. --id Example 13-34 Display Details of a Specific Backup Report # odacli describe-backupreport -i 2d82460c-d648-4e75-8c7d-72cc90bc442a "id" : "2d82460c-d648-4e75-8c7d-72cc90bc442a", "dbResId"...

  • Page 253: Odacli Describe-Schedule

    Backup and Recovery Commands "dbRedoSize" : "16403M" odacli describe-schedule Use the command odacli describe-schedule to display details for a specific schedule. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli describe-schedule [-h] [-j] [-i] Parameters Parameter Description (Optional) Displays help for using the --help command.
  • Page 254 The command odacli irestore-database restores a database to a system using the Backup Report of a long term backup that is in the Oracle Object Store. You can restore a database from one appliance to another appliance, or to the same appliance after the source database is deleted.

  • Page 255: Odacli List-Backupreports

    Chapter 13 odacli Backup and Recovery Commands validation checks, and tasks needed to restore a database to an Oracle Database Appliance system. Example 13-36 Restoring a Database to the Same System Run the command odacli irestore-database with the backup report. Enter the SYS user password when prompted.

  • Page 256: Odacli List-Backupconfigs

    Chapter 13 odacli Backup and Recovery Commands odacli list-backupconfigs Use the command odacli list-backupconfig to list all backup configurations. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-backupconfig [-h] [-j] Parameters Parameter Description (Optional) Displays help for using the --help command. (Optional) Displays JSON output. The default --json is false.

  • Page 257: Odacli List-Schedules

    Displaying a List of ObjectStore Swift Credentials # odacli list-objectstoreswifts odacli list-schedules Use the command odacli list-schedules to display a list of the scheduled backups. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli list-schedules [-h] [-j] Parameters Parameter Description (Optional) Displays help for using the --help command.
  • Page 258 Chapter 13 odacli Backup and Recovery Commands Parameters Parameter Description (Optional) JSON input for a backup report. {Regular-L0|Regular-L1| --backupReport Longterm} Defines the Database Name. --dbName Defines the Database Resource ID. --dbid (Optional) Displays help for using the command. --help (Optional) Displays JSON output. The default is false. --json (Optional) Defines the date and time of the backup.

  • Page 259: Odacli Update-Backupconfig

    Chapter 13 odacli Backup and Recovery Commands odacli update-backupconfig Use the command odacli update-backupconfig to update a backup configuration. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli update-backupconfig -n backup configuration name -d backup destination{Disk|ObjectStore|None} [-c] [-cr] [-h] [-j] [-no-cr] [-o][-w] Parameters Parameter Description Defines the backup destination.

  • Page 260: Odacli Update-Database

    Wednesday...|Sunday Usage Notes For backup to the Oracle Object Store, you can set an RMAN backup password. The password is encrypted and stored in an Oracle wallet. The password is used when using the command odacli create-backup to create a database backup.

  • Page 261: Odacli Update-Objectstoreswift

    # odacli update-database -in mydb -bin mybcfg -bp odacli update-objectstoreswift Use the command odacli update-objectstoreswift to change the credentials for the ObjectStore account. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli update-objectstoreswift [-h] [-j] -i Object Store Swift id [-p] swift password [-u] Object Store user name Parameters...

  • Page 262: Odacli Update-Schedule

    Usage Notes Use this command to update the password when it is changed for an ObjectStore account. The command updates the Oracle ObjectStore credential details in the system and stores the password in an encrypted Oracle wallet. The credentials are validated during the command odacli update-backupconfig with objectstore as the destination.

  • Page 263: Odacli Cpu Core Commands

    Use the odacli update-cpucore command to enable the number of CPU cores in the system. odacli list-cpucores Use the odacli list-cpucores command lists the history of core configuration changes in the system. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-cpucores [-h] Parameters Parameter Description...

  • Page 264: Odacli Describe-Cpucore

    July 25, 2016 9:39:59 AM SGT Configured odacli describe-cpucore Use the odacli describe-cpucore command to display the current core configuration and the modification date and time. File Path /opt/oracle/dcs/bin/odacli Syntax odacli describe-cpucore [-h] Parameters Parameter Description (Optional) Displays help for using the --help command.

  • Page 265: Odacli Database Commands

    Chapter 13 odacli Database Commands Parameters Parameter Description Defines the number of cores to be enabled in --cores the system. (Optional) Displays help for using the --help command. Usage Notes • The number of cores you enable must be a multiple of 2. •...

  • Page 266: Odacli List-Databases

    Use the odacli delete-database command to delete a database. odacli list-databases Use the odacli list-databases command to list all databases on the appliance. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To display a list of all databases: odacli list-databases [-h] Parameters...

  • Page 267: Odacli Create-Database

    PDB Admin User Name: pdbadmin Class: OLTP Shape: odb2 Storage: ASM CharacterSet: DbCharacterSet(characterSet=AL32UTF8, nlsCharacterset=AL16UTF16, dbTerritory=AMERICA, dbLanguage=AMERICAN) Home ID: fe87f30c-b810-45d1-8b96-13996ad7a255 Console Enabled: true Created: Jun 14, 2016 6:21:14 PM odacli create-database Use the odacli create-database command to create a new database. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli 13-58...
  • Page 268 --dbshape the total memory allocated to the database. For example, odb1 and odb2. The default is odb1 Defines the Database Storage, either Oracle ACFS or --dbstorage -r{ACFS|ASM} Oracle ASM. The default value is Oracle ASM. Defines the database territory. The default territory is --dbterritory AMERICA.
  • Page 269 When you specify both the --version and the--dbhomeid, the version is ignored and the database is created against the existing database home. • Oracle Database 12.1 or later is supported on both Oracle Automatic Storage Management (Oracle ASM) and Oracle ASM Cluster file system (ACFS). The default is Oracle ASM.
  • Page 270 Oracle Database 11.2 is only supported on Oracle ACFS. • When databases are created in Oracle ACFS, each database is configured with its own Oracle ACFS file system for the datafiles and uses the following naming convention: /u02/app/db user/oradata/db unique name. The default size of this mount point is 100 GB.
  • Page 271 "updatedTime" : "July 26, 2018 03:54:03 AM EDT" Example 13-59 Creating a Database Against a Different Version Either of the following statements creates a database against a home with Oracle Database Bundle (170718) applied: # odacli create-database -m -n hrmsdb1 -v 12.1.0.2 # odacli create-database -m -n hrmsdb2 -v 12.1.0.2.170718...

  • Page 272: Odacli Clone-Database

    The source database must not be a multitenant container database (CDB) Example 13-60 Cloning a Database The following example creates a clone database snap1 from source database acfsdb1. # /opt/oracle/dcs/bin/odacli clone-database -n snap1 -u snap1u -f acfsdb1 - hm password 13-63...

  • Page 273: Odacli Modify-Database

    Database Commands Related Topics • Cloning a Database Create a database from an existing Oracle ACFS database. odacli modify-database Use the odacli modify-database command to move a database from one database home to another database home of same base version.
  • Page 274 Chapter 13 odacli Database Commands Parameters Parameter Description (Optional) Defines the backup configuration --backupconfigid identifier for future use. Defines the database class. The database {OLTP|DSS|IMDB} --dbclass class setting determines the database SGA memory and instance PGA memory configuration. The options are as follows: •...
  • Page 275 The registration process sets, or resets, the recommended appliance-specific parameters. • The database being registered must use Oracle Managed Files and the file location must match the DATA Location, REDO Location and RECO Location of the odacli describe-dbstorage command. •...

  • Page 276: Odacli Upgrade-Database

    Use the odacli upgrade-database command to upgrade a database from a supported release. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To upgrade an Oracle Database: odacli upgrade-database -i Comma separated list of database ids -from source dbhome id -to destination dbhome id [-j] [-h] Parameters Parameter Description (Optional) Defines the Database IDs to upgrade.
  • Page 277 When you do not define a database ID, all of the databases under the source database home are upgraded. You can upgrade databases of the following releases: • Oracle Database 12.2 to 18c • Oracle Database 12.1 to 18c •...

  • Page 278: Odacli Delete-Database

    The delete-database command deletes the database, the file system, and the underlying advm volumes assigned to the database. For example, deleting a database named hrdb also deletes the file system /u02/app/ oracle/oradata/hrdb. Do not keep any other files on this database file location. Example 13-64 Deleting a Database Named hrmsdb In this example we want to delete a database named hrmsdb.

  • Page 279: Odacli Dbhome Commands

    DBHome Commands Use the odacli DBHome commands to manage database Home operations. • odacli list-dbhomes Use the odacli list-dbhomes command to display a list of Oracle Home directories. • odacli describe-dbhome Use the odacli describe-dbhome command to display Oracle Database Home details.

  • Page 280: Odacli Describe-Dbhome

    Parameter Description (Optional) Displays JSON output. --json Example 13-65 Displaying a List of Oracle Home Directories Run the following command to display a list of Oracle Home directories: # odacli list-dbhomes Name DB Version ------------------------------------ ----------------- ---------- b727bf80-c99e-4846-ac1f-28a81a725df6 OraDB12102_home1 12.1.0.2...

  • Page 281: Odacli Create-Dbhome

    Chapter 13 odacli DBHome Commands Example 13-66 Displaying Oracle Database Home Details The following output is an example of using the display Oracle Database Home details command: # odacli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6 DB Home details ---------------------------------------------------------------- ID: b727bf80-c99e-4846-ac1f-28a81a725df6 Name: OraDB12102_home1 Version: 12.1.0.2...

  • Page 282: Odacli Delete-Dbhome

    11.2.0.4.161018 • 11.2.0.4.160719 Note: Oracle Database 11.2.0.4.160419 is not supported. Attempts to create an Oracle Database 11.2 against an 11.2.0.4.160419 database home will fail. Example 13-67 Creating an Oracle Database Home The following example creates an Oracle Database Home version 12.1.0.2.170718.

  • Page 283: Odacli Database Storage Commands

    Example 13-68 Deleting an Empty Database Home # odacli delete-dbhome -i 0ce547ca-3df2-4178-a7e6-eefa613aeab4 odacli Database Storage Commands Use the Database Storage commands to list, describe, create, and delete Oracle database storage. • odacli list-dbstorages Use the odacli list-dbstorages command to display a list of all of the database storage configured in the appliance.

  • Page 284: Odacli Describe-Dbstorage

    Configured 0266edac-c729-4539-861f-3f3d543be9e4 Acfs db12SE Configured odacli describe-dbstorage Use the odacli describe-dbstorage command to display storage configuration details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli describe-dbstorage -i [-j] [-h] Parameters Parameter Description Identifies the database storage. --id (Optional) Displays JSON output. The default --json is false.

  • Page 285: Odacli Create-Dbstorage

    Chapter 13 odacli Database Storage Commands Example 13-70 Displaying Database Oracle ACFS Storage Details The following example displays Oracle ASM Cluster file system (ACFS) storage details: # odacli describe-dbstorage -i 9fe39332-cc1a-4b4b-8393-165524a6ef6b DBStorage details ---------------------------------------------------------------- ID: 9fe39332-cc1a-4b4b-8393-165524a6ef6b DB Name: rdb121a DBUnique Name: rdb121a...
  • Page 286 Appliance Manager. • Oracle Database is supported on both Oracle Automatic Storage Management (Oracle ASM) and Oracle ASM Cluster file system (ACFS). The default is Oracle ASM. • When you create ACFS database storage, the command creates a separate ACFS file system and creates the directory structure for other database files, such as archives and online logs.

  • Page 287: Odacli Delete-Dbstorage

    APPSDB", "updatedTime" : "August 09, 2016 06:19:35 AM WSST" odacli delete-dbstorage Use the odacli delete-dbstorage command to delete database storage that is not associated with a database. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli delete-dbstorage -i [-h] Parameters Parameter Description Identifies the database storage using a --id database identifier (ID).
  • Page 288 Chapter 13 odacli Database Storage Commands Syntax odacli describe-dgstorage -d diskgroup -h Parameters Parameter Description Specifies the disk group for which information --diskgroup is displayed. (Optional) Displays help for using the --help command. Usage Notes This command displays the storage information for all the databases backed by a disk group, for each disk group present in the system.
  • Page 289 Chapter 13 odacli Database Storage Commands Physical Space: vGB(v$asm_diskgroup.total_mb) Physical Used : wGB (v$asm_file.space) Physical Free : uGB(v$asm_diskgroup.free_mb) Physical Reserved : uGB(Lookup Table) Diskgroup: RECO Redundancy: normal|high|flex Physical Free Space: wGB Physical Total Space: xGB Database Unique Name: rdbx Location: /u02/app/test/ fast_recovery_area Used Space: dGB (acfsutil.total –...

  • Page 290: Odacli List-Dgstorages

    Chapter 13 odacli Database Storage Commands odacli list-dgstorages Use the odacli list-dgstorages command to display the disk group information. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-dgstorages -r redundancy -h Parameters Parameter Description Specifies the disk group redundancy. --redundancy (Optional) Displays help for using the --help command.

  • Page 291: Odacli Job Commands

    Use the odacli list-jobs command to display a list of jobs, including the job IDs, status, and the job created date and time stamp. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To list jobs and view job details and status: odacli list-jobs [-j] [-h] [-o] [-f] [-t] [-hd] [-tl] [-k] [-s]...
  • Page 292 Chapter 13 odacli Job Commands Parameter Description (Optional) Describes a job created since a --from specific date. In the format YYYY-MM-DD , such as YYYY-MM-DD HH:mm:ss 2018-01-01 2018-01-01 01:00:00 Examples: # odacli list-jobs -f 2018-08-27 # odacli list-jobs -f "2018-08-27 03:00:00"...
  • Page 293 Chapter 13 odacli Job Commands Example 13-76 Displaying a List of Jobs To display a list of jobs: # odacli list-jobs Description Created ---------------------------- --------------------- ---------------------------- a6084067-72a1-4625-bea7-efd Provisioning service creation Jun 2, 2018 10:19:23 AM (Continued) Status ------- Success Example 13-77 Displaying Specified Number of Older Jobs To display a specified number of older jobs: # odacli list-jobs -hd 5...
  • Page 294 Chapter 13 odacli Job Commands 1:50:18 AM UTC Success edd55e7d-f81f-4a10-942d-1121aef0bff3 DcsCli patching August 7, 2018 1:50:32 AM UTC Success acc22c60-3476-4566-8faa-4d36b116eded create backup config:aaaaaaaaaaaaaaaaaaaaaaaaaaaaa August 7, 2018 2:01:46 AM UTC Success d89efedf-9110-429a-a3b2-ccd6a53f8564 Database Home OraDB12201_home2 creation with version :12.2.0.1 August 7, 2018 2:36:05 AM UTC Success 2a5532ae-41fa-47c2-bc90-010a5f26d6b2 Database service creation with db name: my122 August 7, 2018 3:52:38 AM UTC Success c4e533e9-c596-478f-92db-2f11f1384075 Discover Components : all August 7,...

  • Page 295: Odacli Describe-Job

    Use the odacli describe-job command to display details about a specific job, including the job ID, status, tasks, and the job created date and time stamp. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To view a specific job, status, and tasks: odacli describe-job...

  • Page 296: Odacli Network Commands

    Chapter 13 odacli Network Commands Parameter Description (Optional) Displays JSON output. The default --json is false. Example 13-80 Displaying a List of Scheduled and Executed Jobs Display a list of scheduled tasks, the status, and the date and time that the task was executed.

  • Page 297: Odacli List-Networks

    • odacli list-networkinterfaces Use the odacli list-networkinterfaces command to display network interfaces. odacli list-networks Use the odacli list-networks command to display networks. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-networks [-j] [-h] Parameters Parameter Description (Optional) Displays JSON output. --json (Optional) Displays help for using the command.

  • Page 298: Odacli Describe-Network

    BOND 192.168.16.25 255.255.255.0 odacli describe-network Use the odacli describe-network command to display the details of a specific network. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To display the details of a specific network: odacli describe-network -i id [-j][-u][-h] Parameters Parameter Description Identifies the network ID. Use the...

  • Page 299: Odacli Create-Network

    Chapter 13 odacli Network Commands odacli create-network Use the odacli create-network command to create a network. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli create-network [-d|-no-d] -n interface -p ipaddress -w {Public|Private|Dataguard|Backup|Other} -s subnetmask -g gateway[-h] [-j] VLAN [-p] Parameters Parameter Description Identifies the default network.

  • Page 300: Odacli Update-Network

    -w Database -s 255.255.255.0 -g 192.0.2.1 -v 123 odacli update-network Use the odacli update-network command to update an existing network configuration. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To update a network: odacli update-network -i id [-p IP address] [-w [Public|Dataguard|Backup|Other]] [-s network subnet mask]...

  • Page 301: Odacli Delete-Network

    Chapter 13 odacli Network Commands odacli delete-network Use the command odacli delete-network to delete a network. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To delete a network: odacli delete-network -i id [-j] [-h] Parameters Parameter Description Defines the network identity. --id (Optional) Displays JSON output.

  • Page 302: Odacli Describe-Networkinterface

    "updatedTime" : "July 26, 2018 23:14:32 PM EDT" odacli describe-networkinterface Use the odacli describe-networkinterface command to display the details of any network interface. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To display the details of a specific network interface: odacli describe-networkinterface -i id [-j][-h][-u] Parameters...

  • Page 303: Odacli List-Networkinterfaces

    Chapter 13 odacli Network Commands Example 13-87 Displaying Network Details Enter the following command to display the details of network interface with ID fe1bf0a7-f56e-44cd-9a84-f374c0aa4b61: # /opt/oracle/dcs/bin/odacli describe-networkinterface -i fe1bf0a7-f56e-44cd-9a84-f374c0aa4b61 -u 1 Network Interface details ---------------------------------------------------------------- ID: fe1bf0a7-f56e-44cd-9a84-f374c0aa4b61 Name: eth2 NIC: eth2...

  • Page 304: Log Commands

    Use the odacli log commands to specify the options to collect and delete logs. • odaadmcli manage diagcollect Use the odaadmcli manage diagcollect command to collect diagnostic logs for Oracle Database Appliance components. • odacli list-logspaceusage Use the odacli list-logspaceusage command to display the log file usage.

  • Page 305: Odacli List-Logspaceusage

    "payrolldb" are replaced with another string, such as "oCjlN7F8P", in the TFA collection. Example 13-89 Masking Sensitive Data in Log Collection # odaadmcli manage diagcollect --dataMask invoke /opt/oracle/dcs/bin/diagcollector.py DataMask is set as 1 Datasanitize is set as 0 Current TFA version is: 183000 odacli list-logspaceusage Use the odacli list-logspaceusage command to display the log file usage.

  • Page 306: Odacli Create-Logcleanjob

    Use the odacli create-logcleanjob command to create a job to purge log files for a specified time period. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax To list jobs and view job details and status: odacli create-logcleanjob [-h] [-c] [-o] [-u] 13-97...
  • Page 307 Chapter 13 Log Commands Parameters Parameter Description (Optional) Displays help for using the --help command. (Optional) Specifies the list of components, --components separated by comma. The values are For example, database|dcs gi,dcs (Optional) Cleans logs older than specified --olderthan time interval. Default is 30 if it is not specified.

  • Page 308: Odacli List-Logcleanjobs

    0 0 bytes gi /u01/app/12.2.0.1/grid July 25, 2018 7:45:10 PM UTC e03d90b5-41dd-45e0-8b7a-1480d6d7f86f 0 0 bytes gi /u01/app/12.2.0.1/ grid July 25, 2018 8:06:59 PM UTC e03d90b5-41dd-45e0-8b7a-1480d6d7f86f 0 0 bytes dcs /opt/oracle/dcs/log July 25, 2018 8:06:56 PM UTC ---------- ------------------------------------------------------------ 13-99...

  • Page 309: Odacli Describe-Logcleanjob

    Files Deleted Size Freed Component Top Path TimeStamp -------------------- -------------------- -------------------- -------------------- ----- e03d90b5-41dd-45e0-8b7a-1480d6d7f86f 0 0 bytes dcs /opt/oracle/dcs/log July 25, 2018 8:06:56 PM UTC e03d90b5-41dd-45e0-8b7a-1480d6d7f86f 0 0 bytes gi /u01/app/12.2.0.1/grid July 25, 2018 8:06:59 PM UTC odacli create-auto-logclean-policy Use the odacli create-auto-logclean-policy command to create a policy for a job to automatically purge log files for a specified time period when certain criteria are met.
  • Page 310 Chapter 13 Log Commands Syntax To list jobs and view job details and status: odacli create-auto-logclean-policy [-h] [-c] [-o] [-u] [-uMB] [-f] [- uPer] Parameters Parameter Description (Optional) Displays help for using the --help command. (Optional) Specifies the list of components, --components separated by comma.

  • Page 311: Odacli List-Auto-Logclean-Policy

    Component UsageOverPercentage freeSpaceBelowPercentage UsageOverMB OlderThan OlderThanUnit --- -------------------- -------------------- ------------------------------------------------ database odacli Oracle Auto Service Request Commands Use the Oracle Auto Service Request (Oracle ASR) commands to configure, update, test, and delete Oracle ASR on the system. • odacli configure-asr • odacli update-asr...

  • Page 312: Odacli Configure-Asr

    • odacli test-asr • odacli delete-asr odacli configure-asr Use the odacli configure-asr command to configure Oracle Auto Service Request (Oracle ASR) after deploying the appliance. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli configure-asr -u username -a asrpassword [-r proxyserver] [-t...
  • Page 313 All log files for Oracle ASR are located in the /var/opt/asrmanager/log/ directory. To configure an external Oracle ASR Manager, you must define the Oracle ASR Configuration Type as external (-e external). For example, odacli configure-asr - e external -i 198.51.100.1...

  • Page 314: Odacli Update-Asr

    Chapter 13 odacli Oracle Auto Service Request Commands odacli update-asr Use the odacli update-asr command to make changes to Oracle Auto Service Request (Oracle ASR) configuration details after deploying the appliance. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax update-asr -u username -a asrpassword [-r proxyserver] [-t proxyport] [-...

  • Page 315: Odacli Describe-Asr

    Oracle Auto Service Request Commands • You cannot use the update-asr command to change the Oracle ASR type. For example, from internal to external. To change the Oracle ASR type, delete the existing configuration using the odacli delete-asr and then re-configure Oracle ASR using the odacli configure-asr command.

  • Page 316: Odacli Test-Asr

    SnmpVersion: V3 State: N/A Created: July 15, 2016 8:53:54 AM PST Updated: July 15, 2016 8:53:54 AM PST odacli test-asr Use the odacli test-asr command to test the Oracle Auto Service Request (Oracle ASR) configuration. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli test-asr [-h]...

  • Page 317: Odacli Delete-Asr

    Chapter 13 odacli OS Commands odacli delete-asr Use the odacli delete-asr command to remove the Oracle Auto Service Request (Oracle ASR) configuration from the system. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax # odacli delete-asr [-h] Parameters Parameter Description (Optional) Displays help for using the --help command.

  • Page 318: Odacli List-Osconfigurations

    OS Commands odacli list-osconfigurations Use the command odacli list-osconfigurations to display the current HugePage and memlock values and view suggested values based on the total available space. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odacli Syntax odacli list-osconfigurations [-h] [-j] Parameters Parameter Description (Optional) Displays help for using the --help command.
  • Page 319 Chapter 13 odacli OS Commands Syntax odacli update-osconfigurations [-h] [-hs] [-j] [-m] Parameters Parameter Description (Optional) Displays help for using the --help command. (Optional) Updates the HugePage value. --hugespace (Optional) Displays JSON output. The default --json is false. (Optional) Updates the memlock value. --memlock Usage Notes The command updates memlock in the /etc/security/limits.conffile and...

  • Page 320: Odacli Validate-Storagetopology

    (if one is installed). Oracle recommends that you run the odacli validate-storagetopology command before deploying the system to ensure that the cabling is correct. This will avoid and prevent problems during deployment due to incorrect or missing cable connections.
  • Page 321 (Optional) Displays help for using the command. --help Example 13-104 Displaying Environment and Hardware Details To display the hardware details, enter the command odaadmcli show env_hw. The results show a bare metal Oracle Database Appliance system. # odaadmcli show env_hw BM ODA_Lite X7-2 Medium 13-112...

  • Page 322: Odaadmcli Show Fs

    Chapter 13 odaadmcli Hardware Monitoring Commands odaadmcli show fs Use the odaadmcli show fs command to display filesystem details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To display filesystem details: odaadmcli show fs [-h] Parameters Parameter Description (Optional) Displays help for using the command.

  • Page 323: Odaadmcli Show Network

    P0/D8 Samsung 32 GB 2400 MHz odaadmcli show network Use the odaadmcli show network command to show network details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To show network details: odaadmcli show network [-h] Parameters Parameter Description (Optional) Displays help for using the command.

  • Page 324: Odaadmcli Show Power

    Use the odaadmcli show power command to display power supply details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax Run this command on the master node, to display power supply details on Oracle Database Appliance High-Availability (HA) models: odaadmcli show power [-h] Parameters Parameter Description (Optional) Displays help for using the command.

  • Page 325: Odaadmcli Show Processor

    Chapter 13 odaadmcli Hardware Monitoring Commands odaadmcli show processor Use the odaadmcli show processor command to display processor details. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To show processor details: odaadmcli show processor [-h] Parameters Parameter Description (Optional) Displays help for using the command.

  • Page 326: Odaadmcli Storage Commands

    Serial Number : 1605NM10JJ Primary OS : Not Available ILOM Address : 10.209.8.215 ILOM MAC Address : 00:10:E0:95:98:F0 Description : Oracle Database Appliance X7-2 Small 1606NM1s02 Locator Light : Off Actual Power Consumption : 135 watts Ambient Temperature : 24.250 degree C...

  • Page 327: Odaadmcli Expand Storage

    -ndisk enclosure. Usage Notes On high-availability (HA) Oracle Database Appliance hardware models, run the command only on the master node. Various storage options are available. On multi-node platforms, the base storage is SSD and you can choose to add either SSD or HDD disks. When adding a storage expansion shelf, all disks must be the same type (you cannot combine SSD and HDD disks).

  • Page 328: Odaadmcli Show Disk

    Use the odaadmcli show disk command to display the status of a single disk or of all disks on the system. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To display the status of all disks on the system: odaadmcli show disk [-h]...

  • Page 329: Odaadmcli Show Diskgroup

    : 0 odaadmcli show diskgroup Use the odaadmcli show diskgroup command to list configured diskgroups or display a specific diskgroup configuration. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To list configured diskgroups: odaadmcli show diskgroup [-h] To display DATA configurations: odaadmcli show diskgroup [DATA] [-h]...

  • Page 330: Odaadmcli Show Controller

    /dev/NVD_S01_S2LHNAAH101008p1 pd_01 ONLINE Good odaadmcli show controller Use the odaadmcli show controller command to display details of the controller. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To display details of the controller: odaadmcli show controller id [-h] Parameters Parameter Description Defines the controller.

  • Page 331: Odaadmcli Show Raidsyncstatus

    = 11 nvme-power-control = 1 sun-nac-name = /SYS/DBP/NVME1 odaadmcli show raidsyncstatus Use the odaadmcli show raidsyncstatus command to display the RAID SYNC status. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To display the status of RAID SYNC: odaadmcli show raidsyncstatus [-h] Parameters Parameter Description (Optional) Displays help for using the command.
  • Page 332 Displaying Storage Devices The following example displays details about the storage devices on an appliance. # odaadmcli show storage ==== BEGIN STORAGE DUMP ======== Host Description: Oracle Corporation:ORACLE SERVER X6-2 Total number of controllers: 2 Id = 0 Pci Slot = 10...
  • Page 333 ==== END STORAGE DUMP ========= odaadmcli stordiag Use the odaadmcli stordiag command to collect detailed information for each disk or NVMe. File Path $ORACLE_HOME/opt/oracle/dcs/bin/odaadmcli Syntax To collect storage diagnostics for disks and NVM Express (NVMe): odaadmcli stordiag n [-h] Parameters...
  • Page 334 Parameter Description Agent password. The Agent password is needed to access the --password Oracle Appliance Manager Web Console. User name required to access the Oracle Appliance Manager --username Web Console. The default user name is oda-admin --json (Optional) Displays JSON output.
  • Page 335 Chapter 13 odacli-adm set-credential Usage Notes Only root user can reset the oda-admin user credentials. Example 13-121 Resetting the oda-admin Password in Interactive Mode To reset the oda-admin user password to a new password in interactive mode: # odacli-adm set-credential --password --username oda-admin Agent password: password 13-126...
  • Page 336 Use the oakcli delete commands to delete components from Oracle Database Appliance. • oakcli deploy Use the command oakcli deploy to deploy Oracle Grid Infrastructure for a cluster on Oracle Database Appliance. • oakcli expand storage Use the oakcli expand storage command to configure the solid-state drives (SSDs) for data storage into the existing base configuration to fully populate the base storage shelf.
  • Page 337 • oakcli locate disk Use the oakcli locate disk command to locate the physical disk that is associated with a named Oracle ASM disk by turning the disk's LED light on or off. • oakcli manage diagcollect Use the oakcli manage diagcollect command to collect diagnostic information about Oracle Database Appliance for troubleshooting purposes, and for working with Oracle Support Services.
  • Page 338 Use the oakcli upgrade command to upgrade the Oracle Database software on Oracle Database Appliance. • oakcli validate Validates the state of an Oracle Database Appliance or the viability of an operating system patch. • oakcli Virtual Disk Commands Use the oakcli virtual disk (vdisk) commands to manage virtual disks on Oracle Database Appliance virtualized platform.
  • Page 339 OAKCLI Command Location and Path Configuration The Oracle Appliance Manager command-line interface is in the following directory: /opt/oracle/oak/bin/oakcli Configure the root user account on your Oracle Database Appliance servers to have the PATH variable defined to search for oakcli commands in the path /opt/ oracle/oak/bin/oakcli.
  • Page 340 You may want to use SUDO as part of your system auditing and security policy. For most tasks, Oracle recommends that you log in as root to use the Oracle Appliance Manager command-line interface on Oracle Database Appliance. If you are not logged in as root, then you cannot carry out most actions on the appliance.
  • Page 341 After you configure the sudoer file with the user, the user jdoe can run the set of oakcli commands configured with the command alias OAKCLI_CMDS. For example: $ sudo oakcli create database -db newdb INFO: 2015-08-05 14:40:55: Look at the logfile '/opt/oracle/oak/log/ scaoda1011/tools/12.1.2.4.0/createdb_newdb_91715.log' for more details INFO: 2015-08-05 14:40:59: Database parameter file is not provided. Will...
  • Page 342 Use the oakcli configure additionalnet command to configure any unconfigured public networks in bare metal, Domain 0, and ODA_BASE. • oakcli configure asr Use the oakcli configure asr command to configure Oracle Auto Service Request (Oracle ASR) on Oracle Database Appliance. • oakcli configure cpupool Use the oakcli configure cpupool command to configure a CPU pool on one Oracle Database Appliance Virtualized Platform node.
  • Page 343 • oakcli configure firstnet Use the oakcli configure firstnet command to configure an initial network on Oracle Database Appliance that enables you to download deployment software. • oakcli configure network Use the oakcli configure network command to configure the network after either replacing a network card or swapping the public network from copper to fiber and vice versa.
  • Page 344 Oracle ASR Manager IP and port • You can configure Oracle ASR on Oracle Database Appliance to use its own ASR Manager (internal Oracle ASR) or use Oracle ASR Manager configured on another server in the same network as your appliance (external Oracle ASR). If you already have Oracle ASR Manager configured in your environment, you can register Oracle Database Appliance with your existing Oracle ASR Manager.
  • Page 345 -node nodenum (Optional) Display help for using the command. Configuring a CPU Pool Configure a CPU pool named twonode with two cores on Node 1 of Oracle Database Appliance Virtualized Platform: oakcli configure cpupool twonode -numcpu 2 -node 1 oakcli configure firstnet Use the oakcli configure firstnet command to configure an initial network on Oracle Database Appliance that enables you to download deployment software.
  • Page 346 Chapter 14 oakcli configure commands Note: Oracle recommends using the oakcli configure firstnet command only one time on Oracle Database Appliance. Subsequent use after configuring the initial network can cause unpredictable changes to your network settings. oakcli configure network Use the oakcli configure network command to configure the network after either replacing a network card or swapping the public network from copper to fiber and vice versa.
  • Page 347 Chapter 14 oakcli configure commands Examples Here are examples of how to use the oakcli configure oda_basecommand. Changing the CPU Core Count in ODA_BASE Change the CPU core count from six to eight in ODA_BASE: # oakcli configure oda_base Core Licensing Options: 1.
  • Page 348 Example 14-1 Preparing a Copy of the Configuration File If you created a configuration file previously and copied this file to Oracle Database Appliance, then prepare the configuration file to be used during the configuration process. For example, if you copied the file myserver1.conf to /tmp, then enter the following command: oakcli copy -conf /tmp/myserver1.conf...
  • Page 349 Use the oakcli create snapshotdb command to create a snapshot database from an existing database. oakcli create cpupool Use the command oakcli create cpupool to create a CPU pool on one Oracle Database Appliance Virtualized Platform node. Syntax oakcli create cpupool poolname -numcpu cpu_count -node nodenum [-h]...
  • Page 350 The -oh and the -version parameters are mutually exclusive. Attempting to use both in the same command will generate an error. • When a database is created without identifying an Oracle home, a new Oracle home is created using a standard naming convention (for example, 14-15...
  • Page 351 OLTP database type and if there is some free space available on flash storage. • Beginning with Oracle Database 12c release 1 (12.1.0.2), you can create an Oracle Database in Oracle ASM. Oracle ASM is the default storage. Examples This section shows different scenarios for using the command oakcli create database.
  • Page 352 This example also creates a new Oracle home: oakcli create database -db sales2 -params salesdbtemplate oakcli create dbhome Use the oakcli create dbhome command to create a new database home on Oracle Database Appliance. Syntax oakcli create dbhome [-version version] [-h]...
  • Page 353 Chapter 14 oakcli create commands Creating a Database Home Create a database home called sales1 using Oracle Database version 12.1.0.2.4. oakcli create dbhome -version 12.1.0.2.4 oakcli create dbstorage Use the oakcli create dbstorage command to create a storage structure for migrating databases from Oracle ASM to Oracle ACFS.
  • Page 354 Use the oakcli create db_config_params command to generate a database configuration file. The configuration file is created in /opt/oracle/oak/install/dbconf and is given the default extension .dbconf. Syntax oakcli create db_config_params -conf filename [-h] Parameters...
  • Page 355 Selected value is: en Successfully generated the Database parameter file 'newconf' oakcli create repo Use the oakcli create repo command to create a new shared repository on Oracle Database Appliance Virtualized Platform. Syntax oakcli create repo repo_name -size size [M|G] -dg DATA|RECO [-h]...
  • Page 356 Use the oakcli delete commands to delete components from Oracle Database Appliance. • oakcli delete cpupool Use the oakcli delete cpupool command to delete a CPU pool from one Oracle Database Appliance Virtualized Platform node. • oakcli delete database Use the oakcli delete database command to delete a database from Oracle Database Appliance.
  • Page 357 Use the oakcli delete repo command to delete a shared repository. oakcli delete cpupool Use the oakcli delete cpupool command to delete a CPU pool from one Oracle Database Appliance Virtualized Platform node. Syntax oakcli delete cpupool poolname -node nodenum [-h]...
  • Page 358 Name of the configuration file that you want to remove, without -conffilename its path name (Optional) Display help for using the command oakcli delete dbhome Use the oakcli delete dbhome command to delete a database home from Oracle Database Appliance. Syntax oakcli delete dbhome -oh oracle_home [-h] Parameters...
  • Page 359 The command will not succeed if testrepo01 is active on one or both nodes. oakcli deploy Use the command oakcli deploy to deploy Oracle Grid Infrastructure for a cluster on Oracle Database Appliance. Syntax oakcli deploy [-config] [-conf config_file] [-advance][-h]...
  • Page 360 (Optional) Preload the configuration stored in the named -conf config_file configuration file, config_file (Optional) Perform the deployment, or run the Oracle Appliance -advance Manager Configurator, in advance mode. Use this option to launch Oracle Appliance Manager and change the default user ID or group user ID.
  • Page 361 The command oakcli deploy creates a log file that is prepended with the character string STEP*. The log file is stored in the following location: /opt/oracle/oak/onecmd/tmp/ oakcli expand storage Use the oakcli expand storage command to configure the solid-state drives (SSDs) for data storage into the existing base configuration to fully populate the base storage shelf.
  • Page 362 Use the oakcli locate disk command to locate the physical disk that is associated with a named Oracle ASM disk by turning the disk's LED light on or off. Syntax oakcli locate disk diskname [on|off][-h]...
  • Page 363 Example 14-13 Locating an Oracle ASM Disk by Turning on the Disk’s LED Turn on the LED of the Oracle ASM disk named disk pd_23: oakcli locate disk pd_23 on oakcli manage diagcollect Use the oakcli manage diagcollect command to collect diagnostic information about Oracle Database Appliance for troubleshooting purposes, and for working with Oracle Support Services.
  • Page 364 Usage Notes The command describes the system components such as node information, installed RPMs, Oracle Grid Infrastructure version and patches, Database home details and stores the information in a file. Example 14-14 Example Command to View the Bill of Materials from the...

  • Page 365: Oakcli Modify Database

    Change the database type assigned to the database dbhome_1 to a DSS database: oakcli modify database DB dbhome_1 -dbtype DSS Example 14-16 Modifying the Database Size Change the database size for the database named dbhome_1 to a 6-core CPU Oracle Database Appliance DSS database template: oakcli modify database dbhome_1 -to odb-06 14-30...

  • Page 366: Oakcli Orachk

    • The command offers multiple options that are generic to the ORAchk command when run on servers other than the Oracle Database Appliance server. You can find details about these options by running the command oakcli orachk -h. The options are grouped into the following categories, but this document does not list...

  • Page 367: Oakcli Reconfigure Osparams

    Use the oakcli reconfigure osparams command to adjust the kernel parameters based on the available RAM after you upgrade memory or DIMM. After you change or expand memory on Oracle Database Appliance, use the oakcli reconfigure osparams command to display the current configuration and suggested values for memlock and vm.nr_hugepages.
  • Page 368 Use the oakcli resize dbstorage command to resize the space used for a storage structure that was created for the purpose of migrating databases from Oracle ASM to Oracle ACFS. You can check the current space usage using oakcli show fs and then add space using oakcli resize dbstorage.
  • Page 369 Parameter (Optional) -h displays help for using the command. oakcli show commands Use the oakcli show commands to display the status of Oracle Database Appliance components. The oakcli show commands display status information for the node where you run the command. To see the list of components available on the current node, use the...

  • Page 370: Oakcli Show Commands

    -h. • oakcli show asr Use the oakcli show asr command to display your Oracle Auto Service Request configuration details. • oakcli show cooling Use the oakcli show cooling command to display the status of the cooling units.
  • Page 371 Use the oakcli show fs command to display all database and cloudfs file systems created on ASM Cluster File System (ACFS) in addition to the local file systems on the Oracle Database Appliance node. • oakcli show memory Use the oakcli show memory command to display information about memory modules.

  • Page 372: Oakcli Show Asr

    Chapter 14 oakcli show commands oakcli show asr Use the oakcli show asr command to display your Oracle Auto Service Request configuration details. Syntax oakcli show asr [-h] Parameters (Optional) -h displays the help for using this command. oakcli show cooling Use the oakcli show cooling command to display the status of the cooling units.

  • Page 373: Oakcli Show Controller

    Syntax oakcli show cpupool -node nodenum nodenum is the number of the Oracle Database Appliance node that you want to examine, either 0 or 1. Displaying Core Mapping for Node 0 Display the core mapping information for Node 0:...

  • Page 374: Oakcli Show Databases

    Parameters Parameter Description (Optional) Displays help for using the command. Usage Notes On Oracle Database Appliance, the minimum supported Oracle Database release is 11.2.0.4. Oracle Database 11.2.0.3.x is not supported. Example 14-20 Displaying Database Details # oakcli show databases Name...

  • Page 375: Oakcli Show Dbhomes

    => AMERICA COMPONENT_LANGUAGES => oakcli show dbhomes Use the oakcli show dbhomes command to display information about each existing Oracle database home, including home name, home location, and database version. Syntax oakcli show dbhomes [-detail] [-h] Parameters Parameter Description (Optional) Include a list of databases -detail associated with each home.

  • Page 376: Oakcli Show Dbstorage

    (Optional) Display help for using the command. Usage Notes Example 14-24 Oracle Database Appliance with Non-CDB Databases Here is an example of the oakcli show dbstorage command output for an Oracle Database Appliance. The output includes only non-CDB databases. Half of the 14-41...

  • Page 377: Oakcli Show Disk

    Chapter 14 oakcli show commands available disk group storage is allocated to Oracle ACFS, except for the FLASH disk group. In the FLASH disk group, all storage is allocated to Oracle ACFS. # oakcli show dbstorage All the DBs with DB TYPE as non-CDB share the same volumes...

  • Page 378: Oakcli Show Diskgroup

    Displaying Information About a Specific Shared Disk Display information about the shared disk named pd_01: oakcli show disk -shared pd_01 oakcli show diskgroup Use the oakcli show diskgroup command to display Oracle Automatic Storage Management (Oracle ASM) disk group information. Syntax oakcli show diskgroup [disk_group_name][-h]...

  • Page 379: Oakcli Show Expander

    Chapter 14 oakcli show commands Displaying the Environment and Hardware for a Virtualized Platform Show the environment type and hardware model when logged in to ODA_BASE on Oracle Database Appliance Virtualized Platform: oakcli show env_hw VM-ODA_BASE ODA X7-2 oakcli show expander Use the oakcli show expander command to display information about a SAS expander.

  • Page 380: Oakcli Show Fs

    Use the oakcli show fs command to display all database and cloudfs file systems created on ASM Cluster File System (ACFS) in addition to the local file systems on the Oracle Database Appliance node. Syntax oakcli show fs [-h] Parameter (Optional) -h displays help for using the command.

  • Page 381: Oakcli Show Processor

    Chapter 14 oakcli show commands Parameter (Optional) -h displays help for using the command. Example 14-29 Displaying Power Supply Information Display the power supply information of the node where the command is executed: # oakcli show power NAME HEALTH HEALTH_DETAILS PART_NO. SERIAL_NO. LOCATION INPUT_POWER OUTPUT_POWER INLET_TEMP EXHAUST_TEMP...

  • Page 382: Oakcli Show Raidsyncstatus

    Examples Here are examples of how to use the oakcli show repo command. Example 14-30 Displaying the Available Virtual Machine Repositories Display the virtual machine repositories on Oracle Database Appliance Virtualized Platform nodes: oakcli show repo NAME REPOTYPE NODENUM...

  • Page 383: Oakcli Show Server

    Chapter 14 oakcli show commands odarepo2 local repo1 shared repo1 shared Example 14-31 Displaying Details About a Specific Shared Repository Display information about the repository named repo1 on Node 1: oakcli show repo repo1 -node 1 Resource: repo1_1 AutoStart restore DATA Device /dev/asm/repo1-286...

  • Page 384: Oakcli Show Validation Storage

    Chapter 14 oakcli show commands oakcli show validation storage Use the oakcli show validation storage command to show whether validation storage is enabled or disabled. Syntax oakcli show validation storage [-h] Parameter (Optional) -h displays help for using the command. Example 14-32 Determining if Storage Validation is Enabled # oakcli show validation storage...

  • Page 385: Oakcli Show Version

    This is an example of how to determine if all of the components are successfully updated after applying the 12.1.2.10.0 patch. You can also view the applied patch version information for the software and firmware on Oracle Database Appliance. All components are successfully updated when Up-to-date appears in the Supported Version column.

  • Page 386: Oakcli Start Commands

    Related Topics • oakcli update Use the oakcli update command to apply Oracle Database Appliance patches. oakcli start commands Use the oakcli start commands to start a virtual machine, to start a shared repository on a node, or to start ODA_BASE on the local node.

  • Page 387: Oakcli Start Repo

    Chapter 14 oakcli stop command Example 14-33 Starting ODA_BASE on the Local Node Connect to Dom0 on the desired node and enter the following command to start ODA_BASE on that node: oakcli start oda_base oakcli start repo Use the oakcli start repo command to start a shared repository on a node. Syntax oakcli start repo repo_name [-node node_number] [-h] Parameters...

  • Page 388: Oakcli Stordiag

    Chapter 14 oakcli stordiag Parameter Description is the number of the node where the shared -node node_number node_number repository is to be stopped, either 0 or 1. The parameter -node is only valid when stopping a virtual machine on a shared repository.

  • Page 389: Oakcli Test Asr

    <output truncated> oakcli test asr Use the oakcli test asr command to send a test trap to determine if Oracle Auto Service Request (Oracle ASR) is configured and working correctly. The command returns a success message if Oracle ASR is functioning properly.

  • Page 390: Oakcli Unpack

    Chapter 14 oakcli unpack Usage Notes Run the command on both nodes. The Oracle ASR logs are always on the node where the ASR Manager is installed, which is the master node. oakcli unpack Use the oakcli unpack command to unpack packages into the Oracle Appliance Manager repository.
  • Page 391 After unpacking the patch bundle, but before applying the patch, verify the contents of the patch for the release. When patching a virtualized platform, the --local option is supported, when Oracle Grid Infrastructure upgrade is not required. For example, after applying the patch for Oracle Database Appliance 18.3, Oracle Grid Infrastructure is upgraded to 18.0.0.0.

  • Page 392: Oakcli Update-Cpucore

    -patch Command Examples Update the appliance with the 18.3 patch: oakcli update -patch 18.3.0.0.0 Patch the Oracle Database homes on both nodes: oakcli update -patch 18.3.0.0.0 --database oakcli update-cpucore Use the oakcli update-cpucore command to enable a specified number of licensed CPU cores for Oracle Database Appliance.
  • Page 393 Example 14-41 Enabling 12 CPU Cores for Oracle Database Appliance The following command enables 12 CPU cores on an Oracle Database Appliance system. oakcli update-cpucore -cores 12 Please enter the 'root' password: Please re-enter the 'root' password: Setting up SSH ....Completed...

  • Page 394: Oakcli Upgrade

    Chapter 14 oakcli upgrade oakcli upgrade Use the oakcli upgrade command to upgrade the Oracle Database software on Oracle Database Appliance. For patching Oracle Database Appliance itself, use the oakcli update command. Syntax oakcli upgrade database [-db db_names | -from source_home] -to destination_home...
  • Page 395 Chapter 14 oakcli validate oakcli validate Validates the state of an Oracle Database Appliance or the viability of an operating system patch. Syntax oakcli validate [[-V | -l | -h]] | [[-v][-f output_file] [-a | -d | -c checklist][- ver patch_version]]...
  • Page 396 SUCCESS : Node name based on cable configuration found : NODE0 INFO : Check Nickname SUCCESS : Nickname set correctly : Oracle Database Appliance - E0 INFO : The details for Storage Topology Validation can also be found in log file=/opt/oracle/oak/log/<hostname>/storagetopology/...
  • Page 397 Checking the Viability of a Patch Use the oakcli validate ospatch -ver patch_version command to report any reasons for not being able to patch Oracle Database Appliance with the patch named in patch_version. Run this command before you attempt to patch Oracle Database Appliance to determine if it will succeed or if you need to make changes before applying the patch.

  • Page 398: Oakcli Virtual Disk Commands

    Chapter 14 oakcli Virtual Disk Commands oakcli Virtual Disk Commands Use the oakcli virtual disk (vdisk) commands to manage virtual disks on Oracle Database Appliance virtualized platform. • oakcli create vdisk Use the oakcli create vdisk command to create a new virtual disk in a shared repository on Oracle Database Appliance Virtualized Platform.

  • Page 399: Oakcli Clone Vdisk

    -repo vrepo1 -src vdisk1 oakcli delete vdisk Use the oakcli delete vdisk command to delete a virtual disk from a shared repository on Oracle Database Appliance Virtualized Platform. Syntax oakcli delete vdisk vdisk_name -repo repository_name [-h]...

  • Page 400: Oakcli Show Vdisk

    (Optional) Display help for using the command. Examples Here are examples of how to use the oakcli show vdisk command. Example 14-44 Displaying Information for All Virtual Disks Display information about all virtual disks on Oracle Database Appliance Virtualized Platform: # oakcli show vdisk NAME SIZE...

  • Page 401: Oakcli Virtual Machine Commands

    Use the oakcli clone vm command to create clones and snap clones of virtual machines. • oakcli configure vm Use the oakcli configure vm command to configure a virtual machine on Oracle Database Appliance Virtualized Platform and to increase or decrease resource allocation to user domains. •...
  • Page 402 Unbreakable Enterprise Kernel 3 (UEK3), or Unbreakable Enterprise Kernel Release 4 (UEK R4). – Microsoft Windows with Oracle VM Windows PV Driver 3.4.1. Oracle VM Windows PV Driver 3.4.1 release is available for download on My Oracle Support as patch number 23346086. 14-67...

  • Page 403: Oakcli Configure Vm

    -vmtemplate myol6u_15gb1 -repo repo2 -node 0 - driverdomain oakcli configure vm Use the oakcli configure vm command to configure a virtual machine on Oracle Database Appliance Virtualized Platform and to increase or decrease resource allocation to user domains.
  • Page 404 Maximum number of CPUs that the virtual machine can consume. The -maxvcpu maxcpu range is 1 to 72. This number depends on your Oracle Database Appliance configuration. Priority for CPU usage, where larger values have higher priority. The -cpuprio priority range is 1 to 65535.
  • Page 405 CPU a guest is allowed to consume. If the Processor Cap is set at 100% in Oracle VM, then the value set in vm.cfg is 0, which means there is no limit to CPU utilization.

  • Page 406: Oakcli Delete Vm

    Description (Optional) Name of the virtual machine to be deleted vm vm_name (Optional) Oracle Database Appliance node from which you want -server node_number to remove the virtual machine. If this optional parameter is not included, then the virtual machine is removed from both nodes.

  • Page 407: Oakcli Show Vm

    Example 14-48 Sending a Message to a Running Virtual Machine Update the root user password for the gc_11g virtual machine: oakcli modify vm gc_11g -s "com.oracle.linux.root-password:password" oakcli show vm Use the oakcli show vm command to display information about virtual machines.
  • Page 408 Chapter 14 oakcli Virtual Machine Commands Examples Here are examples of how to use the oakcli show vm command. Example 14-49 Displaying Details for All Virtual Machines Display the virtual machine names, memory and vCPU allocations, status, virtual disks, and repository name for all virtual machines: # oakcli show vm NAME MEMORY...

  • Page 409: Oakcli Show Vmconsole

    Chapter 14 oakcli Virtual Machine Commands NodeNumStart OL_5 PrivateIP None ProcessorCap RepoName odarepo1 State Online TemplateName otml_sample1_odarepo1 Vcpu cpupool twocpu vncport 5901 oakcli show vmconsole Use the oakcli show vmconsole command to open a GUI virtual machine console to manage a specific virtual machine. Syntax oakcli show vmconsole vm_name [-h] Parameters...

  • Page 410: Oakcli Virtual Machine Template Commands

    (VM) templates. • oakcli configure vmtemplate Use the oakcli configure vmtemplate command to configure a virtual machine template on Oracle Database Appliance Virtualized Platform. • oakcli delete vmtemplate Use the oakcli delete vmtemplate command to delete a virtual machine template.
  • Page 411 Chapter 14 oakcli Virtual Machine Template Commands Parameter Description Number of nodes assigned to virtual machines cloned from the -vcpu cpucount template. Maximum number of CPUs that virtual machines cloned from the -maxvcpu maxcpu template can consume. Priority for CPU usage, where larger values have higher priority (1 to -cpuprio priority 256).

  • Page 412: Oakcli Delete Vmtemplate

    Chapter 14 oakcli Virtual Machine Template Commands See Also:: Oracle VM Release 3.1 documentation, which is available at the following URL: http://docs.oracle.com/cd/E27300_01 for more information about the options in the preceding table. For example, see 2.8. Virtual Machines for details about the option -domain http://docs.oracle.com/cd/E27300_01/E27309/html/vmusg-ovm-vms.html...

  • Page 413: Oakcli Import Vmtemplate

    Chapter 14 oakcli Virtual Machine Template Commands Parameter Description (Optional) Oracle Database Appliancenode from which you want -server node_number to remove the virtual machine template. If this optional parameter is not included, then the virtual machine template is removed from both nodes.
  • Page 414 Chapter 14 oakcli Virtual Machine Template Commands include the name given in the vmtemplate vmtemplatename clause followed by a sequence number, such as vmtemplatename1, vmtemplatename2, and vmtemplatename3. • When importing into a shared repository, you must include the -node option with a valid node number, 0 or 1.

  • Page 415: Oakcli Modify Vmtemplate

    Chapter 14 oakcli Virtual Machine Template Commands oakcli modify vmtemplate Use the oakcli modify vmtemplate command to add networks to or delete networks from an existing virtual machine template. Syntax oakcli modify vmtemplate vmtemplatename [-addnetwork|- deletenetworkvlanname] [-h] Parameters Parameter Description (Optional) Adds a VLAN network to the named virtual machine -addnetworkvlanname template...

  • Page 416: Oakcli Vlan Management Commands For Virtual Platform

    • oakcli create vlan Use the oakcli create vlan command to create a new virtual local area network (VLAN) on an Oracle Database Appliance Virtualized Platform node. • oakcli delete vlan Use the oakcli delete vlan command to delete a virtual local area network.

  • Page 417: Oakcli Delete Vlan

    Parameters Parameter Description Name of the virtual local area network to be deleted vlan vlan_name Oracle Database Appliance node from which you want to -node node_number remove the virtual local area network (Optional) Display help for using the command. Example...

  • Page 418: Oakcli Show Vlan

    Chapter 14 oakcli VLAN Management Commands for Virtual Platform oakcli show vlan Use the oakcli show vlan command to display information about virtual local area networks (VLANs) configured on Oracle Database Appliance. Syntax oakcli show vlan [-h] Parameter (Optional) -h displays help for using the command.

  • Page 419: Troubleshooting Oracle Database Appliance

    Troubleshooting Oracle Database Appliance Understand tools you can use to validate changes and troubleshoot Oracle Database Appliance problems. • Viewing Component Information on the Appliance View details of all the components installed on the appliance, and the RPM drift information.
  • Page 420 The bill of materials is also available through the command line for bare metal and virtualized platforms deployments. The information about the installed components is collected according to a set schedule, and stored in the location /opt/oracle/dcs/ Inventory/ for bare metal deployments and in the /opt/oracle/oak/Inventory/ directory for virtualized platforms.
  • Page 421 Chapter 15 Viewing Component Information on the Appliance augeas- libs-1.0.0-10.el6.x86_64, authconfig-6.1.12-23.el6.x86_64, avahi- libs-0.6.25-17.el6.x86_64, b43- openfwwf-5.2-10.el6.noarch, basesystem-10.0-4.0.1.el6.noarch, bash-4.1.2-48.el6.x86_64, bc-1.06.95-1.el6.x86_64, bind- libs-9.8.2-0.62.rc1.el6_9.5.x86_64, bind- utils-9.8.2-0.62.rc1.el6_9.5.x86_64, binutils-2.20.51.0.2-5.47.el6_9.1.x86_64, biosdevname-0.7.2-1.el6.x86_64, bridge- utils-1.2-10.el6.x86_64, busybox-1.15.1-21.el6_6.x86_64, bzip2-1.0.5-7.el6_0.x86_64, bzip2- libs-1.0.5-7.el6_0.x86_64, certificates-2017.2.14-65.0.1.el6_9.noarch, cairo-1.8.8-6.el6_6.x86_64, celt051-0.5.1.3-0.el6.x86_64, checkpolicy-2.0.22-1.el6.x86_64, chkconfig-1.3.49.5-1.el6.x86_64, cloog- ppl-0.15.7-1.2.el6.x86_64, compat- libcap1-1.10-1.x86_64, compat-libstdc+ +-33-3.2.3-69.el6.x86_64, compat- readline5-5.2-17.1.el6.x86_64,...
  • Page 422 Example Command to View the Bill of Materials from the Command Line for Virtualized Platforms # oakcli describe-system -b Example 15-3 Example Command to View the Bill of Materials Report from the Stored Location # /opt/oracle/dcs/Inventory/ total 264 -rw-r--r-- 1 root root 83550 Apr 26 05:41 oda_bom_2018-04-26_05-41-36.json 15-4...

  • Page 423: Errors When Logging Into The Web Console

    Understand how to troubleshoot errors that occur when re-imaging Oracle Database Appliance. If re-imaging Oracle Database Appliance fails, with old header issues such as errors in storage discovery, or in running GI root scripts, or disk group RECO creation, then use the force mode with cleanup.pl.

  • Page 424: Using The Oracle Orachk Health Check Tool

    Use the ORAchk Health Check Tool to audit configuration settings and check system health. Oracle ORAchk Health Check Tool performs proactive heath checks for the Oracle software stack and scans for known problems. Oracle ORAchk Health Check Tool audits important configuration settings for Oracle RAC two-node deployments in the following categories: •...
  • Page 425 Running ORAchk on Oracle Database Appliance 18.3 Baremetal Systems for New Installation When you install Oracle Database Appliance 18.3, the ORAchk RPMs are installed in the directory /opt/oracle.SupportTools/orachk/. You can verify that ORAchk is installed by running the following command: [root@oak bin]# rpm -q orachk orachk-18.3.0_20180808-2.x86_64...

  • Page 426: About Trace File Analyzer Collector

    Trace File Analyzer (TFA) Collector simplifies diagnostic data collection on Oracle Grid Infrastructure and Oracle Real Application Clusters systems. TFA behaves in a similar manner to the ion utility packaged with Oracle Clusterware. Both tools collect and package diagnostic data. However, TFA is much more powerful than ion, because TFA centralizes and automates the collection of diagnostic information.

  • Page 427: Command Options For Tfactl Tool

    -odapatching diagnostic logs for patching components of the Appliance. (Optional) Use this option to view the -odadataguard diagnostic logs for Oracle Data Guard component of the Appliance. (Optional) Use this option to view provisioning -odaprovisioning logs for the Appliance. (Optional) Use this option to view -odaconfig configuration-related diagnostic logs.
  • Page 428 (Cont.) Command Options for tfactl Tool Option Description (Optional) Use this option to view the -afd diagnostic logs for Oracle ASM Filter Driver. (Optional) Use this option to view the -crs diagnostic logs for Oracle Clusterware. (Optional) Use this option to view the -cha diagnostic logs for the Cluster Health Monitor.

  • Page 429: Running The Disk Diagnostic Tool

    Running the Oracle Database Appliance Hardware Monitoring Tool The Oracle Database Appliance Hardware Monitoring Tool displays the status of different hardware components in Oracle Database Appliance server. The tool is implemented with the Trace File Analyzer collector. Use the tool both on bare-metal and on virtualized systems.

  • Page 430: Preparing Log Files For Oracle Support Services

    If necessary, use the command odaadmcli manage diagcollect to collect diagnostic files to send to Oracle Support Services. Use the Bill Of Materials report saved in the /opt/oracle/dcs/Inventory/ directory, to enable Oracle Support to help troubleshoot errors, if necessary. 15-12...
  • Page 431 Chapter 15 Preparing Log Files for Oracle Support Services If you have a system fault that requires help from Oracle Support Services, then you may need to provide log records to help Oracle support diagnose your issue. You can use Trace File Collector (the tfactl command) to collect all log files for the Oracle Database Appliance components.

  • Page 432: Odacli Command Reference For Oakcli Migration

    • CPU Core Commands ODACLI and OAKCLI commands for common CPU core tasks. • Oracle Auto Service Request (ASR) Commands ODACLI and OAKCLI commands for ASR tasks. Appliance Commands ODACLI and OAKCLI commands for common tasks performed on the appliance.

  • Page 433: Patching Commands

    Patching Commands Task Command to Run on the Command to Run on the DCS Stack OAK Stack Validate the state of an Oracle Not Applicable. oakcli validate Database Appliance or the viability of an operating system patch. Configure the first network.

  • Page 434: Database Commands

    DCS Stack OAK Stack Update the operating system, odacli update-server oakcli update -patch firmware, Oracle Appliance version --server Kit, Oracle Clusterware, and all other infrastructure components. Update the storage. odacli update-storage oakcli update -patch version --storage Unpack packages into the...

  • Page 435: Database Storage Commands

    Appendix A Database Storage Commands Task Command to Run on the Command to Run on the DCS Stack OAK Stack Display a list of Oracle Home odacli list-dbhomes oakcli show dbhomes directories. Display Oracle Database odacli describe-dbhome oakcli show dbhomes —...

  • Page 436: Storage Commands

    List configured diskgroups or odaadmcli show oakcli show diskgroup display a specific Oracle diskgroup Automatic Storage Management (Oracle ASM) diskgroup configuration. Display details of the odaadmcli show oakcli show controller controller.

  • Page 437: Job Commands

    X7-2 models. Locate the physical disk that is Not Applicable oakcli locate disk associated with a named Oracle ASM disk by turning the disk's LED light on or off. Display information about a odaadmcli show expander oakcli show expander SAS expander.

  • Page 438: Hardware Monitoring Commands

    Display the current core Not Applicable odacli describe-cpucore configuration and the modification date and time. Update or enable the number Not Applicable odacli update-cpucore of CPU cores in the system Reconfigure your Oracle Not Applicable oakcli apply Database Appliance core capacity.

  • Page 439: Oracle Auto Service Request (Asr) Commands

    Appendix A Oracle Auto Service Request (ASR) Commands Task Command to Run on the Command to Run on the DCS Stack OAK Stack Adjust the kernel parameters Not Applicable oakcli reconfigure based on the available RAM osparams after you upgrade memory or DIMM.

  • Page 440: Oracle Database Appliance Software Configuration Defaults

    Console and are useful when you need to track and debug jobs. You can also use the Oracle Appliance Manager Web Console to view job activity, including the tasks that make up the job. The status of each task appears in the Web...
  • Page 441 Appendix B Location of Log Files If you log a Service Request, upload all of the logs in the /opt/oracle/dcs/log directory. Patching Log Files All patching-related information is logged in the dcs-agent log file at /opt/ oracle/dcs/log/dcs-agent.log. DCS Agent Log Directories Agent-specific activities are logged in the dcs-agent log.

  • Page 442: Default Operating System Groups And Users Configuration For Oracle Database

    All passwords are set to the Master password that you define during deployment. Default Operating System Groups and User Configurations Table B-1 Default Operating System Groups and Users Configuration for Oracle Database Appliance Groups and Users Default Value Oracle Grid Infrastructure installation owner...

  • Page 443: Oracle Database Appliance Storage Defaults

    Oracle Database Appliance uses the Oracle Automatic Storage Management Cluster File System (Oracle ACFS) for storage of database and virtual machine files. Oracle ACFS provides both servers with concurrent access to some or all of the shared storage on Oracle Database Appliance. Oracle ACFS supports space-efficient storage snapshots, which provides fast provisioning databases and virtual machines within Oracle Database Appliance.

  • Page 444: Oracle Acfs Mount Points And Storage Space

    Review Oracle ASM Cluster file system (ACFS) mount points for Oracle Database Appliance. The storage shelf in the base Oracle Database Appliance X6-2-HA system is half populated with 10 solid-state drives (SSDs) for data storage, totaling 12TB of raw storage capacity. The storage shelf in the base system also has four 200 GB high endurance SSDs for database redo logs to improve performance and reliability.

  • Page 445: Displaying Mounted Disk Details

    Example C-1 Oracle ACFS Storage Space When the Oracle ACFS file systems are created, they do not initially consume all of the storage in the appliance. Space is preserved for additional repositories, or in some cases, database files stored directly in Oracle ASM. You can check for available storage space in your file systems by running the operating system command df -k as shown in the following example.

  • Page 446: Determining Usable Storage For Oracle Database Appliance X6-2-Ha

    N DATA Determining Usable Storage for Oracle Database Appliance X6-2-HA Review the usable disk capacity available for Oracle Database Appliance X6-2-HA and how capacity is derived. Oracle Database Appliance X6-2-HA use 1.6TB raw Solid-State Drives, formatted to 1.2TB for performance. The usable data capacity varies because it is derived by...
  • Page 447 When Oracle ASM calculates Usable Free Space, it determines the amount of space to reserve in the case of a disk failure. When you query Oracle ASM or Oracle Database Appliance commands to view the amount of storage available, the...

  • Page 448: Oracle Acfs Space Management

    1230996 610468 305150 RECO/ Note: Note: 1TB = MB divided by 1024 The following table describes how capacity terms are defined by Oracle ASM and Oracle Database Appliance. Table C-4 Definition of Terminology Term Oracle ASM Definition Oracle Database Appliance...
  • Page 449 Appendix C Oracle ACFS Space Management When the Oracle ACFS file systems are created, they do not initially consume all of the storage in the appliance. Space is preserved for additional repositories, or in some cases, database files stored directly in Oracle ASM. You can check for available storage space in your file systems by running the operating system command df -k as shown in the following example.

  • Page 450: Creating An Appliance Using Json File

    Creating an Appliance Using JSON File Understand the process to create an appliance using the command odacli create-appliance and view an example JSON file. • Loading and Saving Appliance Configurations You can load a saved JSON file and use it to configure your appliance, and save an existing configuration as a JSON file from the Web Console.

  • Page 451: Readme For The Command Odacli Create-Appliance

    Note: If you do not enter your network and Oracle ILOM information correctly based on your setup, then network access is lost to both the host and Oracle ILOM. When using the example to create your JSON file, change the definitions to match...
  • Page 452 JSON File to Create a Single Node Oracle Database Appliance with Role Separation The following is an example of a JSON file that creates a single node appliance on Oracle Database Appliance X7-2S or X7-2M. The example uses role separation. "instance" : { "name" : "odambox", "instanceBaseName"...
  • Page 453 Appendix D Example JSON Files to Create a Single Node Appliance with the CLI "nodeName" : "odambox", "network" : [ { "nicName" : "btbond1", "ipAddress" : "10.0.1.11", "subNetMask" : "255.255.240.0", "gateway" : "10.0.0.1", "networkType" : [ "Public" ], "isDefaultNetwork" : true "ilom"...
  • Page 454 JSON File to Create a Single Node Oracle Database Appliance without Role Separation The following is an example of a JSON file that creates an Oracle Database Appliance without using role separation. This example creates two groups (oinstall and dba) and one user ("oracle").
  • Page 455 Appendix D Example JSON Files to Create a Single Node Appliance with the CLI "userId" : 1000, "userName" : "oracle", "userRole" : "oracleUser" "nodes" : [ { "nodeNumber" : "0", "nodeName" : "odambox", "network" : [ { "nicName" : "btbond1", "ipAddress"...

  • Page 456: Example Json File To Create A Multi-Node Appliance With The Cli

    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, then network access is lost to both the host and Oracle ILOM.
  • Page 457 Role Separation The following is an example of a JSON file that creates a multi-node appliance on Oracle Database Appliance X7-2-HA bare metal platform. The example uses role separation. When using the example to create your JSON file, change the definitions to match your environment.
  • Page 458 Appendix D Example JSON File to Create a Multi-Node Appliance with the CLI "userRole":"gridUser" "userId":102, "userName":"oracle", "userRole":"oracleUser" "objectStoreCredentials":null "nodes":[ "nodeNumber":"0", "nodeName":"odahaboxc1n2", "network":[ "nicName":"btbond1", "ipAddress":"10.31.98.133", "subNetMask":"255.255.240.0", "gateway":"10.31.96.1", "networkType":[ "Public" "isDefaultNetwork":true "ilom":{ "ilomName":"odahabox2-c", "ipAddress":"10.31.16.140", "subNetMask":"255.255.240.0", "gateway":"10.31.16.1" "nodeNumber":"1", "nodeName":"odahaboxc1n1", "network":[ "nicName":"btbond1", "ipAddress":"10.31.98.132", "subNetMask":"255.255.240.0", "gateway":"10.31.96.1",...
  • Page 459 Appendix D Example JSON File to Create a Multi-Node Appliance with the CLI "grid":{ "diskGroup":[ "diskGroupName":"DATA", "redundancy":"HIGH", "diskPercentage":80 "diskGroupName":"RECO", "redundancy":"HIGH", "diskPercentage":20 "diskGroupName":"REDO", "redundancy":"HIGH", "diskPercentage":null "scan":{ "scanName":"odahaboxc1-scan", "ipAddresses":[ "10.31.98.182", "10.31.98.183" "vip":[ "nodeNumber":"0", "vipName":"odahaboxc1n2-vip", "ipAddress":"10.31.98.159" "nodeNumber":"1", "vipName":"odahaboxc1n1-vip", "ipAddress":"10.31.98.158" "language":"en", "enableAFD":"TRUE" "database":{ "dbName":"myTestDb", "databaseUniqueName":"myTestDb_sea1kj", "dbVersion":"12.2.0.1", "dbHomeId":null,...
  • Page 460 Appendix D Example JSON File to Create a Multi-Node Appliance with the CLI "dbClass":"OLTP", "dbShape":"odb1", "dbStorage":"ACFS", "dbCharacterSet":{ "characterSet":"AL32UTF8", "nlsCharacterset":"AL16UTF16", "dbTerritory":"AMERICA", "dbLanguage":"AMERICAN" "dbConsoleEnable":false, "backupConfigId":null "asr":null D-11...

  • Page 461: Database Templates For Oracle Database Appliance

    Manager (the Resource Manager), you can provide desired levels of service across multiple instances on a single Oracle Database Appliance. Oracle Database Appliance templates are already tuned for the size of each database instance workload. They are designed to run on a specific number of cores. Caging...
  • Page 462 About Oracle Database Appliance Template Options The database templates are configured specifically for the type of database workload that you want to carry out on your databases on Oracle Database Appliance. Choose the template that best matches the common workload your databases perform (OLTP, DSS, In-Memory).

  • Page 463: Appliance

    Types of Database Templates for Oracle Database Appliance X6-2-HA Types of Database Templates for Oracle Database Appliance X6-2-HA Use one of the database templates defined for Oracle Database Appliance X6-2-HA. Oracle Database Appliance OLTP Database Template Sizes Table E-1 Oracle Database Appliance OLTP Database Template Sizes...
  • Page 464 Appendix E Types of Database Templates for Oracle Database Appliance X6-2-HA Table E-3 (Cont.) Oracle Database Appliance In-Memory Database Template Size Template Process Redo log file Log buffer Cores (GB) (GB) Memory size (GB) (MB) (GB) odb-02 odb-04 odb-06 1200...
  • Page 465 13-106 Cluster Health Monitor test, 13-107 collect diagnostic data, 14-28, 14-29 update, 13-105 Cluster Time Synchronization Service See also Oracle ASR (Auto Service Request) See CTSS Automatic Storage Management component version See Oracle ASM display, 14-55 configuration type, Configuration Audit Tool (ORAchk),...
  • Page 466 CTSS (Cluster Time Synchronization Service), deployment options virtualized platform, deployment plan, 5-12 DHCP (Dynamic Host Configuration Protocol) connect to Oracle ILOM, 3-10 DATA disk group, C-3, initial network, 14-10 database, 2-9, 9-11, E-1, Oracle ILOM configuration, 3-10...
  • Page 467 Grid user, load configuration, group user local repository, 12-16 change name or ID, 14-24 log files, groups and users defaults, sending to Oracle Support Services, 15-12 Guest Domains (Domain U) log switch definition, 12-3 select template, E-1, guest virtual machine logs...
  • Page 468 Index oakcli commands (continued) delete dbstorage, 14-23 network delete repo, 12-12, 14-24 configure, 13-8 delete vdisk, 12-15 display details, 14-45 delete vlan, 14-82 network infrastructure, 12-6 delete vm, 14-71 network interface delete vmtemplate, 12-20, 14-77 default values, 12-6 deploy network planning, change group name and ID, 14-24 network time protocol service (NTP service),...
  • Page 469 Index oakcli commands (continued) odaadmcli commands (continued) show storage, 14-48 storage, 13-117 show validation storage, 14-49 stordiag, 13-124 show validation storage errors, 14-49 odacli commands show validation storage failures, 14-49 appliance, 13-28 show vdisk, 12-13, 14-65 apply patch, 13-10 show version, 14-50 backup, 13-35...
  • Page 470 14-9 update-schedule, 13-53 display configuration details, 14-37 update-server, 13-26 test asr, 14-54 update-storage, 13-27 Oracle ASR (Oracle Auto Service Request), upgrade-database, 13-67 Oracle Automatic Storage Management validate storage topology, 13-111 See Oracle ASM Oracle Database validate-storagetopology, 13-111 See database odacli create-appliance...
  • Page 471 13-86 OSDBA for ASM group, Scheduling Database Backups, 11-18 OSDBA group, secure erase tool, OSOPER groups, odaeraser.py, over-subscribed CPU pool, 12-45 sending log files to Oracle Support Services, 15-12 server display details, 14-48 patches shared repositories software inventory, about, 12-4...
  • Page 472 5-2, 12-2 troubleshooting, 15-5 virtualized platform expander, 14-44 deployment options, hrd disk diagnostic tool, 15-8 VLAN log files for Oracle Support Services, 15-12 CLI commands, 14-81 network validation, 5-12 display details, 14-83 trace file analyzer, 15-8 vm templates turning on Oracle Database Appliance,...
  • Page 473 Index Web Console (continued) web interface (continued) actions, Windows web interface and virtualization, 12-2 Oracle Enterprise Manager Database Express, 9-19...

Table of Contents

Save PDF