summaryrefslogtreecommitdiff
path: root/doc/rtd/topics/datasources/oracle.rst
blob: 98c4657c650f32acc47dfe5b225ea1ddfaff852c (plain)
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
.. _datasource_oracle:

Oracle
======

This datasource reads metadata, vendor-data and user-data from
`Oracle Compute Infrastructure`_ (OCI).

Oracle Platform
---------------
OCI provides bare metal and virtual machines.  In both cases,
the platform identifies itself via DMI data in the chassis asset tag
with the string 'OracleCloud.com'.

Oracle's platform provides a metadata service that mimics the 2013-10-17
version of OpenStack metadata service.  Initially support for Oracle
was done via the OpenStack datasource.

Cloud-init has a specific datasource for Oracle in order to:
 a. allow and support future growth of the OCI platform.
 b. address small differences between OpenStack and Oracle metadata
    implementation.


Configuration
-------------

The following configuration can be set for the datasource in system
configuration (in ``/etc/cloud/cloud.cfg`` or ``/etc/cloud/cloud.cfg.d/``).

The settings that may be configured are:

* **configure_secondary_nics**: A boolean, defaulting to False.  If set
  to True on an OCI Virtual Machine, cloud-init will fetch networking
  metadata from Oracle's IMDS and use it to configure the non-primary
  network interface controllers in the system.  If set to True on an
  OCI Bare Metal Machine, it will have no effect (though this may
  change in the future).

An example configuration with the default values is provided below:

.. sourcecode:: yaml

  datasource:
   Oracle:
    configure_secondary_nics: false

.. _Oracle Compute Infrastructure: https://cloud.oracle.com/
.. vi: textwidth=78