summaryrefslogtreecommitdiff
path: root/doc/manual/en_US/dita/topics/cloud-export-oci.dita
blob: f7ec049e1c2151b8c8c8478842aabcd1dd34c2cc (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
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
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="cloud-export-oci">
  <title>Exporting an Appliance to Oracle Cloud Infrastructure</title>
  
  <body>
    <p>
        Oracle VM VirtualBox supports the export of VMs to an Oracle Cloud Infrastructure service.
        The exported VM is stored on Oracle Cloud Infrastructure as a custom Linux image. You
        can configure whether a cloud instance is created and started
        after the export process has completed.
      </p>
    <note>
      <p>
          Before you export a VM to Oracle Cloud Infrastructure, you must prepare the VM as
          described in <xref href="cloud-export-oci-prepare-vm.dita#cloud-export-oci-prepare-vm"/>.
        </p>
    </note>
    <p>
        Use the following steps to export a VM to Oracle Cloud Infrastructure:
      </p>
    <ol>
      <li>
        <p>
            Select <b outputclass="bold">File</b>,
            <b outputclass="bold">Export Appliance</b> to open
            the <b outputclass="bold">Export Virtual
            Appliance</b> wizard.
          </p>
        <p>
            Select a VM to export and click
            <b outputclass="bold">Next</b> to display the
            <b outputclass="bold">Format Settings</b> page.
          </p>
      </li>
      <li>
        <p>
            From the <b outputclass="bold">Format</b> drop-down
            list, select <b outputclass="bold">Oracle Cloud Infrastructure</b>.
          </p>
        <p>
            In the <b outputclass="bold">Profile</b> drop-down
            list, select the cloud profile used for your Oracle Cloud Infrastructure account.
          </p>
        <fig id="fig-export-appliance-oci">
          <title>Export Virtual Appliance Wizard: Format Settings</title>
          <xref href="images/export-appliance-oci.png" format="png" platform="htmlhelp">
            <image href="images/export-appliance-oci.png" width="12cm" placement="break">
              <alt>Export Virtual Appliance Wizard: Format Settings</alt>
            </image>
          </xref>
          <image href="images/export-appliance-oci.png" width="12cm" placement="break" platform="ohc">
            <alt>Export Virtual Appliance Wizard: Format Settings</alt>
          </image>
        </fig>
        <p>
            In the <b outputclass="bold">Machine Creation</b>
            field, select an option to configure settings for the cloud
            instance created when you export to Oracle Cloud Infrastructure. The options
            enable you to do one of the following:
          </p>
        <ul>
          <li>
            <p>
                Configure settings for the cloud instance
                <i>after</i> you have finished exporting
                the VM.
              </p>
          </li>
          <li>
            <p>
                Configure settings for the cloud instance
                <i>before</i> you start to export the VM.
              </p>
          </li>
          <li>
            <p>
                Do not create a cloud instance when you export the VM.
              </p>
          </li>
        </ul>
        <p>
            Click <b outputclass="bold">Next</b> to make an API
            request to the Oracle Cloud Infrastructure service and open the
            <b outputclass="bold">Appliance Settings</b> page.
          </p>
      </li>
      <li>
        <p>
            (Optional) Edit storage settings used for the exported
            virtual machine in Oracle Cloud Infrastructure. You can change the following
            settings:
          </p>
        <ul>
          <li>
            <p>
                The name of the bucket used to store the exported files.
              </p>
          </li>
          <li>
            <p>
                Whether to store the custom image in Oracle Cloud Infrastructure.
              </p>
          </li>
          <li>
            <p>
                The display name for the custom image in Oracle Cloud Infrastructure.
              </p>
          </li>
          <li>
            <p>
                The launch mode for the custom image.
              </p>
            <p><b outputclass="bold">Paravirtualized</b> mode
                gives improved performance and should be suitable for
                most Oracle VM VirtualBox VMs.
              </p>
            <p><b outputclass="bold">Emulated</b> mode is
                suitable for legacy OS images.
              </p>
          </li>
        </ul>
        <p>
            Click <b outputclass="bold">Finish</b> to continue.
          </p>
      </li>
      <li>
        <p>
            (Optional) Depending on the selection in the
            <b outputclass="bold">Machine Creation</b> field, the
            <b outputclass="bold">Appliance Settings</b> page may
            be displayed before or after export. This screen enables you
            to configure settings for the cloud instance, such as Shape
            and Disk Size.
          </p>
        <p>
            Click <b outputclass="bold">Finish</b>. The VM is
            exported to Oracle Cloud Infrastructure.
          </p>
        <p>
            Depending on the <b outputclass="bold">Machine
            Creation</b> setting, a cloud instance may be started
            after upload to Oracle Cloud Infrastructure is completed.
          </p>
      </li>
      <li>
        <p>
            Monitor the export process by using the Oracle Cloud Infrastructure Console.
          </p>
      </li>
    </ol>
    <p>
        You can also use the <userinput>VBoxManage export</userinput>
        command to export a VM to Oracle Cloud Infrastructure. See
        <xref href="man_VBoxManage-export.dita"/>.
      </p>
  </body>
</topic>