VirtualBox

Ignore:
Timestamp:
Dec 9, 2020 8:25:51 PM (4 years ago)
Author:
vboxsync
Message:

doc/manual: Integrate a collection of documentation improvements: sensitive terminology, diversity statement, clear messaging on what is eligible for enterprise support, OCI integration docs, export to OCI and incorrect UI doc referring to host-only networking when that place allows configuring NAT Networks

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/user_Introduction.xml

    r87049 r87077  
    165165      <listitem>
    166166        <para>
    167           <emphasis role="strong">Host operating system (host
     167          <emphasis role="bold">Host operating system (host
    168168          OS).</emphasis> This is the OS of the physical computer on
    169169          which &product-name; was installed. There are versions of
    … …  
    181181      <listitem>
    182182        <para>
    183           <emphasis role="strong">Guest operating system (guest
     183          <emphasis role="bold">Guest operating system (guest
    184184          OS).</emphasis> This is the OS that is running inside the
    185185          virtual machine. Theoretically, &product-name; can run any x86
    … …  
    200200      <listitem>
    201201        <para>
    202           <emphasis role="strong">Virtual machine (VM).</emphasis> This
    203           is the special environment that &product-name; creates for
    204           your guest OS while it is running. In other words, you run
    205           your guest OS <emphasis>in</emphasis> a VM. Normally, a VM is
    206           shown as a window on your computer's desktop. Depending on
    207           which of the various frontends of &product-name; you use, the
    208           VM might be shown in full screen mode or remotely on another
    209           computer.
     202          <emphasis role="bold">Virtual machine (VM).</emphasis> This is
     203          the special environment that &product-name; creates for your
     204          guest OS while it is running. In other words, you run your
     205          guest OS <emphasis>in</emphasis> a VM. Normally, a VM is shown
     206          as a window on your computer's desktop. Depending on which of
     207          the various frontends of &product-name; you use, the VM might
     208          be shown in full screen mode or remotely on another computer.
    210209        </para>
    211210
    … …  
    228227      <listitem>
    229228        <para>
    230           <emphasis role="strong">Guest Additions.</emphasis> This
    231           refers to special software packages which are shipped with
     229          <emphasis role="bold">Guest Additions.</emphasis> This refers
     230          to special software packages which are shipped with
    232231          &product-name; but designed to be installed
    233232          <emphasis>inside</emphasis> a VM to improve performance of the
    … …  
    672671          <listitem>
    673672            <para>
    674               Red Hat Enterprise Linux 6, 7 and 8
     673              CentOS/Red Hat Enterprise Linux 6, 7 and 8
    675674            </para>
    676675          </listitem>
    … …  
    737736
    738737    <para>
    739       Note that the above list is informal. Oracle support for customers
    740       who have a support contract is limited to a subset of the listed
    741       host OSes. Also, any feature which is marked as
     738      Note that any feature which is marked as
    742739      <emphasis>experimental</emphasis> is not supported. Feedback and
    743740      suggestions about such features are welcome.
    … …  
    791788          functionality of the &product-name; base package. Currently,
    792789          Oracle provides a single extension pack, available from:
    793           <ulink
    794           url="http://www.virtualbox.org" />. The
    795           extension pack provides the following added functionality:
    796         </para>
    797 
    798         <orderedlist>
     790          <ulink url="http://www.virtualbox.org" />. The extension pack
     791          provides the following added functionality:
     792        </para>
     793
     794        <itemizedlist>
    799795
    800796          <listitem>
    … …  
    808804            <para>
    809805              The virtual USB 3.0 (xHCI) device. See
    810               <xref
    811                 linkend="settings-usb" />.
     806              <xref linkend="settings-usb" />.
    812807            </para>
    813808          </listitem>
    … …  
    847842          </listitem>
    848843
    849         </orderedlist>
     844          <listitem>
     845            <para>
     846              Cloud integration features. See <xref linkend="ovf"/>.
     847            </para>
     848          </listitem>
     849
     850        </itemizedlist>
    850851
    851852        <para>
    … …  
    930931    <figure id="fig-vbox-manager-initial">
    931932      <title>VirtualBox Manager Window, After Initial Startup</title>
    932       <mediaobject>
     933    <mediaobject>
    933934        <imageobject>
    934935          <imagedata align="center" fileref="images/virtualbox-main-empty.png"
    … …  
    965966    <figure id="fig-vbox-manager-populated">
    966967      <title>VirtualBox Manager Window, After Creating Virtual Machines</title>
    967       <mediaobject>
     968    <mediaobject>
    968969        <imageobject>
    969970          <imagedata align="center" fileref="images/virtualbox-main.png"
    … …  
    987988    <figure id="fig-new-vm-name">
    988989      <title>Creating a New Virtual Machine: Name and Operating System</title>
    989       <mediaobject>
     990    <mediaobject>
    990991        <imageobject>
    991992          <imagedata align="center" fileref="images/create-vm-1.png"
    … …  
    11111112        <figure id="fig-new-vm-hard-disk">
    11121113          <title>Creating a New Virtual Machine: Hard Disk</title>
    1113          <mediaobject>
     1114        <mediaobject>
    11141115            <imageobject>
    11151116              <imagedata align="center" fileref="images/create-vm-2.png"
    … …  
    12161217        <figure id="fig-new-vm-vdi">
    12171218          <title>Creating a New Virtual Machine: File Location and Size</title>
    1218           <mediaobject>
     1219        <mediaobject>
    12191220            <imageobject>
    12201221              <imagedata align="center" fileref="images/create-vdi-1.png"
    … …  
    14291430          </imageobject>
    14301431        </mediaobject>
     1432
    14311433      </figure>
    14321434
    … …  
    18771879        </imageobject>
    18781880      </mediaobject>
     1881
    18791882    </figure>
    18801883
    … …  
    25672570          <emphasis role="bold">Cloud service formats.</emphasis> Export
    25682571          to and import from cloud services such as &oci; is supported.
    2569           See the following topics:
    2570         </para>
    2571 
    2572         <itemizedlist>
    2573 
    2574           <listitem>
    2575             <para>
    2576               <xref linkend="cloud-export-oci"/>
    2577             </para>
    2578           </listitem>
    2579 
    2580           <listitem>
    2581             <para>
    2582               <xref linkend="cloud-import-oci"/>
    2583             </para>
    2584           </listitem>
    2585 
    2586         </itemizedlist>
    2587 
    2588         <para>
    2589           Before using &product-name; with &oci; there are some initial
    2590           configuration steps you need to consider. See
    2591           <xref linkend="cloud-integration-steps"/>.
    2592         </para>
    2593 
    2594         <para>
    2595           &product-name; can also be used to create new instances from a
    2596           custom image stored on &oci;. See
    2597           <xref linkend="cloud-new-vm"/>
     2572          See <xref linkend="cloud-integration"/>.
    25982573        </para>
    25992574      </listitem>
    … …  
    27252700              </imageobject>
    27262701            </mediaobject>
     2702
    27272703          </figure>
    27282704
    … …  
    29382914    </sect2>
    29392915
     2916  </sect1>
     2917
     2918  <sect1 id="cloud-integration">
     2919
     2920    <title>Integrating with &oci;</title>
     2921
     2922    <para>
     2923      This section describes how to use the features of &product-name;
     2924      to integrate with &oci;.
     2925    </para>
     2926
     2927    <para>
     2928      Integrating with &oci; involves the following steps:
     2929    </para>
     2930
     2931    <itemizedlist>
     2932
     2933      <listitem>
     2934        <para>
     2935          <emphasis role="bold">Prepare for &oci;
     2936          Integration.</emphasis> Before using &product-name; with &oci;
     2937          there are some initial configuration steps you may need to do.
     2938          See <xref linkend="cloud-integration-steps"/>.
     2939        </para>
     2940      </listitem>
     2941
     2942      <listitem>
     2943        <para>
     2944          <emphasis role="bold">Use &product-name; with
     2945          &oci;.</emphasis> <xref linkend="cloud-vbox-oci-tasks"/>
     2946          describes how you can use &product-name; with &oci;.
     2947        </para>
     2948      </listitem>
     2949
     2950    </itemizedlist>
     2951
    29402952    <sect2 id="cloud-integration-steps">
    29412953
    … …  
    29432955
    29442956      <para>
    2945         There are some common configuration steps you need to take
    2946         before using &product-name; to integrate with your &oci;
    2947         account.
    2948       </para>
    2949 
    2950       <itemizedlist>
     2957        Perform the following configuration steps before using
     2958        &product-name; to integrate with your &oci; account.
     2959      </para>
     2960
     2961      <orderedlist>
     2962
     2963        <listitem>
     2964          <para>
     2965            <emphasis role="bold">Install the Extension Pack.</emphasis>
     2966            Cloud integration features are only available when you
     2967            install the &product-name; Extension Pack. See
     2968            <xref linkend="intro-installing"/>.
     2969          </para>
     2970        </listitem>
    29512971
    29522972        <listitem>
    … …  
    29542974            <emphasis role="bold">Create a key pair.</emphasis> Generate
    29552975            an API signing key pair that is used for API requests to
    2956             &oci;.
     2976            &oci;. See <xref linkend="cloud-create-api-keypair"/>.
     2977          </para>
     2978
     2979          <para>
     2980            Upload the public key of the key pair from your client
     2981            device to the cloud service. See
     2982            <xref linkend="cloud-upload-public-key"/>.
     2983          </para>
     2984        </listitem>
     2985
     2986        <listitem>
     2987          <para>
     2988            <emphasis role="bold">Create a cloud profile.</emphasis> The
     2989            cloud profile contains resource identifiers for your cloud
     2990            account, such as your user OCID, and details of your key
     2991            pair. See <xref linkend="cloud-create-cloud-profile"/>.
     2992          </para>
     2993        </listitem>
     2994
     2995      </orderedlist>
     2996
     2997    </sect2>
     2998
     2999    <sect2 id="cloud-create-api-keypair">
     3000
     3001      <title>Creating an API Signing Key Pair</title>
     3002
     3003      <para></para>
     3004
     3005      <para>
     3006        To use the cloud integration features of &product-name;, you
     3007        must generate an API signing key pair that is used for API
     3008        requests to &oci;.
     3009      </para>
     3010
     3011      <para>
     3012        Your API requests are signed with your private key, and &oci;
     3013        uses the public key to verify the authenticity of the request.
     3014        You must upload the public key to the &oci; Console.
     3015      </para>
     3016
     3017      <note>
     3018        <para>
     3019          This key pair is not the same SSH key that you use to access
     3020          compute instances on &oci;.
     3021        </para>
     3022      </note>
     3023
     3024      <orderedlist>
     3025
     3026        <listitem>
     3027          <para>
     3028            (Optional) Create a <filename>.oci</filename> directory to
     3029            store the key pair.
     3030          </para>
     3031
     3032<screen>$ mkdir ~/.oci</screen>
     3033
     3034          <para>
     3035            The key pair is usually installed in the
     3036            <filename>.oci</filename> folder in your home directory. For
     3037            example, <filename>~/.oci</filename> on a Linux system.
     3038          </para>
     3039        </listitem>
     3040
     3041        <listitem>
     3042          <para>
     3043            Generate the private key.
     3044          </para>
     3045
     3046          <para>
     3047            Use the <command>openssl</command> command.
    29573048          </para>
    29583049
    … …  
    29613052            <listitem>
    29623053              <para>
    2963                 The key pair is usually installed in the
    2964                 <filename>.oci</filename> folder in your home directory.
    2965                 For example, <filename>~/.oci</filename> on a Linux
    2966                 system.
     3054                To generate a private key with a passphrase:
    29673055              </para>
     3056
     3057<screen>$ openssl genrsa -out ~/.oci/oci_api_key.pem -aes128 2048 </screen>
    29683058            </listitem>
    29693059
    29703060            <listitem>
    29713061              <para>
    2972                 Upload the public key of the key pair to the cloud
    2973                 service.
     3062                To generate a private key without a passphrase:
    29743063              </para>
     3064
     3065<screen>$ openssl genrsa -out ~/.oci/oci_api_key.pem 2048</screen>
    29753066            </listitem>
    29763067
    29773068          </itemizedlist>
    2978 
    2979           <para>
    2980             For step-by-step instructions for creating and uploading an
    2981             API signing key for &oci;, see:
    2982           </para>
    2983 
    2984           <para>
    2985             <ulink url="https://docs.cloud.oracle.com/iaas/Content/API/Concepts/apisigningkey.htm#How" />
    2986           </para>
    2987         </listitem>
    2988 
    2989         <listitem>
    2990           <para>
    2991             <emphasis role="bold">Create a cloud profile.</emphasis> The
    2992             cloud profile contains resource identifiers for your cloud
    2993             account, such as your user OCID, and the fingerprint for
    2994             your public key. You can create a cloud profile in the
    2995             following ways:
    2996           </para>
    2997 
    2998           <itemizedlist>
    2999 
    3000             <listitem>
    3001               <para>
    3002                 Automatically, by using the <emphasis role="bold">Cloud
    3003                 Profile Manager</emphasis>. See
    3004                 <xref linkend="ovf-cloud-profile-manager"/>.
    3005               </para>
    3006             </listitem>
    3007 
    3008             <listitem>
    3009               <para>
    3010                 Automatically, by using the <command>VBoxManage
    3011                 cloudprofile</command> command. See
    3012                 <xref linkend="vboxmanage-cloudprofile"/>.
    3013               </para>
    3014             </listitem>
    3015 
    3016             <listitem>
    3017               <para>
    3018                 Manually, by creating an <filename>oci_config</filename>
    3019                 file in your &product-name; global configuration
    3020                 directory. For example, this is
    3021                 <filename>$HOME/.config/VirtualBox/oci_config</filename>
    3022                 on a Linux host.
    3023               </para>
    3024             </listitem>
    3025 
    3026             <listitem>
    3027               <para>
    3028                 Manually, by creating a <filename>config</filename> file
    3029                 in your &oci; configuration directory. For example, this
    3030                 is <filename>$HOME/.oci/config</filename> on a Linux
    3031                 host.
    3032               </para>
    3033 
    3034               <para>
    3035                 This is the same file that is used by the &oci; command
    3036                 line interface.
    3037               </para>
    3038 
    3039               <para>
    3040                 &product-name; automatically uses the
    3041                 <filename>config</filename> file if no cloud profile
    3042                 file is present in your global configuration directory.
    3043                 Alternatively, you can import this file manually into
    3044                 the Cloud Profile Manager.
    3045               </para>
    3046             </listitem>
    3047 
    3048           </itemizedlist>
    3049 
    3050           <para>
    3051             For more information about the cloud profile settings used
    3052             by &oci; see:
    3053           </para>
    3054 
    3055           <para>
    3056             <ulink url="https://docs.cloud.oracle.com/iaas/Content/API/Concepts/sdkconfig.htm" />
    3057           </para>
    3058         </listitem>
    3059 
    3060         <listitem>
    3061           <para>
    3062             <emphasis role="bold">Custom Linux images.</emphasis> To
    3063             export a custom Linux image, prepare the VM as described
    3064             here:
    3065           </para>
    3066 
    3067           <para>
    3068             <ulink url="https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/importingcustomimagelinux.htm" />
    3069           </para>
    3070         </listitem>
    3071 
    3072         <listitem>
    3073           <para>
    3074             <emphasis role="bold">Subnets.</emphasis> When exporting a
    3075             VM to cloud, ensure that the subnets that are used by source
    3076             VMs are available in the target compartment on the cloud
    3077             service.
    3078           </para>
    3079         </listitem>
    3080 
    3081       </itemizedlist>
     3069        </listitem>
     3070
     3071        <listitem>
     3072          <para>
     3073            Change permissions for the private key.
     3074          </para>
     3075
     3076<screen>$ chmod 600 ~/.oci/oci_api_key.pem</screen>
     3077
     3078          <para>
     3079            Generate the public key.
     3080          </para>
     3081
     3082<screen>$ openssl rsa -pubout -in ~/.oci/oci_api_key.pem -out ~/.oci/oci_api_key_public.pem</screen>
     3083        </listitem>
     3084
     3085      </orderedlist>
    30823086
    30833087    </sect2>
    30843088
    3085     <sect2 id="cloud-export-oci">
    3086 
    3087       <title>Exporting an Appliance to &oci;</title>
    3088 
    3089       <para>
    3090         &product-name; supports the export of VMs to an &oci; service.
    3091         The exported VM is stored on &oci; as a custom image. You can
    3092         configure whether a cloud instance is created and started after
    3093         the export process has completed.
    3094       </para>
    3095 
    3096       <para>
    3097         Before you can export a VM to &oci; ensure that you have done
    3098         the required preconfiguration tasks, as described in
    3099         <xref linkend="cloud-integration-steps"/>.
    3100       </para>
    3101 
    3102       <para>
    3103         Perform the following steps to export a VM to &oci;:
     3089    <sect2 id="cloud-upload-public-key">
     3090
     3091      <title>Uploading the Public Key to &oci;</title>
     3092
     3093      <para>
     3094        Use the following steps to upload your public key to &oci;.
    31043095      </para>
    31053096
    … …  
    31083099        <listitem>
    31093100          <para>
    3110             Select <emphasis role="bold">File</emphasis>,
    3111             <emphasis role="bold">Export Appliance</emphasis> to open
    3112             the <emphasis role="bold">Export Virtual
    3113             Appliance</emphasis> wizard.
    3114           </para>
    3115 
    3116           <para>
    3117             Select a VM to export and click
    3118             <emphasis role="bold">Next</emphasis> to open the
    3119             <emphasis role="bold">Appliance Settings</emphasis> screen.
    3120           </para>
    3121         </listitem>
    3122 
    3123         <listitem>
    3124           <para>
    3125             From the <emphasis role="bold">Format</emphasis> drop-down
    3126             list, select <emphasis role="bold">&oci;</emphasis>.
    3127           </para>
    3128 
    3129           <para>
    3130             In the <emphasis role="bold">Account</emphasis> drop-down
    3131             list, select your &oci; account.
    3132           </para>
    3133 
    3134           <para>
    3135             You can set up &oci; accounts by using the Cloud Profile
    3136             Manager.
    3137           </para>
    3138 
    3139           <para>
    3140             The list after the <emphasis role="bold">Account</emphasis>
    3141             field shows the profile settings for your cloud account.
    3142           </para>
    3143 
    3144           <figure id="fig-export-appliance-oci">
    3145             <title>Appliance Settings Screen, Showing Cloud Profile and Machine Creation
    3146               Settings</title>
     3101            Log in to the &oci; Console.
     3102          </para>
     3103        </listitem>
     3104
     3105        <listitem>
     3106          <para>
     3107            Display the <emphasis role="bold">User Settings</emphasis>
     3108            page.
     3109          </para>
     3110
     3111          <para>
     3112            Click <emphasis role="bold">Profile</emphasis>,
     3113            <emphasis role="bold">User Settings</emphasis>.
     3114          </para>
     3115        </listitem>
     3116
     3117        <listitem>
     3118          <para>
     3119            Display your current API signing keys.
     3120          </para>
     3121
     3122          <para>
     3123            Click <emphasis role="bold">Resources</emphasis>,
     3124            <emphasis role="bold">API Keys</emphasis>.
     3125          </para>
     3126        </listitem>
     3127
     3128        <listitem>
     3129          <para>
     3130            Upload the public key.
     3131          </para>
     3132
     3133          <para>
     3134            Click <emphasis role="bold">Add Public Key</emphasis>.
     3135          </para>
     3136
     3137          <para>
     3138            The <emphasis role="bold">Add Public Key</emphasis> dialog
     3139            is displayed.
     3140          </para>
     3141
     3142          <figure id="fig-upload-key-oci">
     3143            <title>Upload Public Key Dialog in &oci; Console</title>
    31473144            <mediaobject>
    31483145              <imageobject>
    3149                 <imagedata align="center" fileref="images/export-appliance-oci.png"
     3146                <imagedata align="center" fileref="images/upload-key.png"
    31503147                  width="12cm" />
    31513148              </imageobject>
    … …  
    31553152
    31563153          <para>
    3157             In the <emphasis role="bold">Machine Creation</emphasis>
    3158             field, select an option to configure settings for a cloud
    3159             instance created when you export to &oci;. The options
    3160             enable you to do one of the following:
     3154            Select one of the following options:
    31613155          </para>
    31623156
    … …  
    31653159            <listitem>
    31663160              <para>
    3167                 Configure settings for the cloud instance
    3168                 <emphasis>after</emphasis> you have finished exporting
    3169                 the VM.
     3161                <emphasis role="bold">Choose Public Key File.</emphasis>
     3162                This option enables you to browse to the public key file
     3163                on your local hard disk.
    31703164              </para>
    31713165            </listitem>
    … …  
    31733167            <listitem>
    31743168              <para>
    3175                 Configure settings for the cloud instance
    3176                 <emphasis>before</emphasis> you start to export the VM.
     3169                <emphasis role="bold">Paste Public Keys.</emphasis> This
     3170                option enables you to paste the contents of the public
     3171                key file into the window in the dialog box.
    31773172              </para>
    31783173            </listitem>
    31793174
    3180             <listitem>
    3181               <para>
    3182                 Do not create a cloud instance when you export the VM.
    3183               </para>
    3184             </listitem>
    3185 
    31863175          </itemizedlist>
    31873176
    31883177          <para>
    3189             Click <emphasis role="bold">Next</emphasis> to make an API
    3190             request to the &oci; service and open the
    3191             <emphasis role="bold">Virtual System Settings</emphasis>
    3192             screen.
    3193           </para>
    3194         </listitem>
    3195 
    3196         <listitem>
    3197           <para>
    3198             Optionally edit storage settings used for the exported
    3199             virtual machine in &oci;. You can change the following
    3200             settings:
    3201           </para>
    3202 
    3203           <itemizedlist>
    3204 
    3205             <listitem>
    3206               <para>
    3207                 The name of the bucket used to store the exported files.
    3208               </para>
    3209             </listitem>
    3210 
    3211             <listitem>
    3212               <para>
    3213                 Whether to store the custom image in &oci;.
    3214               </para>
    3215             </listitem>
    3216 
    3217             <listitem>
    3218               <para>
    3219                 The name for the custom image in &oci;.
    3220               </para>
    3221             </listitem>
    3222 
    3223             <listitem>
    3224               <para>
    3225                 The launch mode for the custom image.
    3226               </para>
    3227 
    3228               <para>
    3229                 <emphasis role="bold">Paravirtualized</emphasis> mode
    3230                 gives improved performance and should be suitable for
    3231                 most &product-name; VMs.
    3232               </para>
    3233 
    3234               <para>
    3235                 <emphasis role="bold">Emulated</emphasis> mode is
    3236                 suitable for legacy OS images.
    3237               </para>
    3238             </listitem>
    3239 
    3240           </itemizedlist>
    3241 
    3242           <para>
    3243             Click <emphasis role="bold">Export</emphasis> to export the
    3244             VM to &oci;.
    3245           </para>
    3246 
    3247           <para>
    3248             Depending on the selection in the
    3249             <emphasis role="bold">Machine Creation</emphasis> field, the
    3250             <emphasis role="bold">Cloud Virtual Machine
    3251             Settings</emphasis> screen may be displayed before or after
    3252             export. This screen enables you to configure settings for
    3253             the cloud instance, such as Shape and Disk Size.
    3254           </para>
    3255 
    3256           <para>
    3257             Click <emphasis role="bold">Create</emphasis>. The VM is
    3258             exported to &oci;.
    3259           </para>
    3260 
    3261           <para>
    3262             Depending on the <emphasis role="bold">Machine
    3263             Creation</emphasis> setting, a cloud instance may be started
    3264             after upload to &oci; is completed.
    3265           </para>
    3266         </listitem>
    3267 
    3268         <listitem>
    3269           <para>
    3270             Monitor the export process by using the &oci; Console.
     3178            Click <emphasis role="bold">Add</emphasis> to upload the
     3179            public key.
    32713180          </para>
    32723181        </listitem>
    … …  
    32743183      </orderedlist>
    32753184
    3276       <para>
    3277         You can also use the <command>VBoxManage export</command>
    3278         command to export a VM to &oci;. See
    3279         <xref linkend="vboxmanage-export-cloud"/>.
    3280       </para>
    3281 
    32823185    </sect2>
    32833186
    3284     <sect2 id="cloud-import-oci">
    3285 
    3286       <title>Importing an Instance from &oci;</title>
    3287 
    3288       <para>
    3289         &product-name; supports the import of cloud instances from an
    3290         &oci; service.
    3291       </para>
    3292 
    3293       <para>
    3294         Before you can import an instance from &oci; ensure that you
    3295         have done the required preconfiguration tasks, as described in
    3296         <xref linkend="cloud-integration-steps"/>.
    3297       </para>
    3298 
    3299       <para>
    3300         Perform the following steps to import an instance from &oci;:
    3301       </para>
    3302 
    3303       <orderedlist>
    3304 
    3305         <listitem>
    3306           <para>
    3307             Select <emphasis role="bold">File</emphasis>,
    3308             <emphasis role="bold">Import Appliance</emphasis> to open
    3309             the <emphasis role="bold">Import Virtual
    3310             Appliance</emphasis> wizard.
    3311           </para>
    3312 
    3313           <para>
    3314             In the <emphasis role="bold">Source</emphasis> drop-down
    3315             list, select <emphasis role="bold">&oci;</emphasis>.
    3316           </para>
    3317 
    3318           <para>
    3319             In the <emphasis role="bold">Account</emphasis> drop-down
    3320             list, select your &oci; account.
    3321           </para>
    3322 
    3323           <para>
    3324             You can set up &oci; accounts by using the Cloud Profile
    3325             Manager.
    3326           </para>
    3327 
    3328           <para>
    3329             The list after the <emphasis role="bold">Account</emphasis>
    3330             field shows the profile settings for your cloud account.
    3331           </para>
    3332 
    3333           <para>
    3334             Choose the required cloud instance from the list in the
    3335             <emphasis role="bold">Machines</emphasis> field.
    3336           </para>
    3337 
    3338           <para>
    3339             Click <emphasis role="bold">Next</emphasis> to make an API
    3340             request to the &oci; service and open the
    3341             <emphasis role="bold">Appliance Settings</emphasis> screen.
    3342           </para>
    3343         </listitem>
    3344 
    3345         <listitem>
    3346           <para>
    3347             Optionally edit settings for the new local virtual machine.
    3348           </para>
    3349 
    3350           <para>
    3351             For example, you can edit the VM name and description.
    3352           </para>
    3353 
    3354           <figure id="fig-import-instance-oci">
    3355             <title>Import Cloud Instance Screen, Showing Profile Settings and VM Settings</title>
    3356            <mediaobject>
    3357               <imageobject>
    3358                 <imagedata align="center" fileref="images/import-instance.png"
    3359                   width="12cm" />
    3360               </imageobject>
    3361            </mediaobject>
    3362           </figure>
    3363 
    3364           <para>
    3365             Click <emphasis role="bold">Import</emphasis> to import the
    3366             instance from the cloud service.
    3367           </para>
    3368         </listitem>
    3369 
    3370         <listitem>
    3371           <para>
    3372             Monitor the import process by using the &oci; Console.
    3373           </para>
    3374         </listitem>
    3375 
    3376       </orderedlist>
    3377 
    3378       <para>
    3379         You can also use the <command>VBoxManage import</command>
    3380         command to import an instance from &oci;. See
    3381         <xref linkend="vboxmanage-import-cloud"/>.
    3382       </para>
    3383 
    3384       <simplesect id="import-instance-sequence">
    3385 
    3386         <title>Importing an Instance: Overview of Events</title>
    3387 
    3388         <para>
    3389           The following describes the sequence of events when you import
    3390           an instance from &oci;.
    3391         </para>
    3392 
    3393         <itemizedlist>
    3394 
    3395           <listitem>
    3396             <para>
    3397               A custom image is created from the boot volume of the
    3398               instance.
    3399             </para>
    3400           </listitem>
    3401 
    3402           <listitem>
    3403             <para>
    3404               The custom image is exported to an &oci; object and is
    3405               stored using Object Storage in the bucket specified by the
    3406               user.
    3407             </para>
    3408           </listitem>
    3409 
    3410           <listitem>
    3411             <para>
    3412               The &oci; object is downloaded to the local host. The
    3413               object is a TAR archive which contains a boot volume of
    3414               the instance in QCOW2 format and a JSON file containing
    3415               metadata related to the instance.
    3416             </para>
    3417           </listitem>
    3418 
    3419           <listitem>
    3420             <para>
    3421               The boot volume of the instance is extracted from the
    3422               archive and a new VMDK image is created by converting the
    3423               boot volume into the VMDK format. The VMDK image is
    3424               registered with &product-name;.
    3425             </para>
    3426           </listitem>
    3427 
    3428           <listitem>
    3429             <para>
    3430               A new VM is created using the VMDK image for the cloud
    3431               instance.
    3432             </para>
    3433 
    3434             <para>
    3435               By default, the new VM is not started after import from
    3436               &oci;.
    3437             </para>
    3438           </listitem>
    3439 
    3440           <listitem>
    3441             <para>
    3442               The downloaded TAR archive is deleted after a successful
    3443               import.
    3444             </para>
    3445           </listitem>
    3446 
    3447         </itemizedlist>
    3448 
    3449       </simplesect>
     3187    <sect2 id="cloud-create-cloud-profile">
     3188
     3189      <title>Creating a Cloud Profile</title>
     3190
     3191      <para>
     3192        &product-name; uses a <emphasis>cloud profile</emphasis> to
     3193        connect to &oci;. A cloud profile is a text file that contains
     3194        details of your key files and Oracle Cloud Identifier (OCID)
     3195        resource identifiers for your cloud account, such as the
     3196        following:
     3197      </para>
     3198
     3199      <itemizedlist>
     3200
     3201        <listitem>
     3202          <para>
     3203            <emphasis role="bold">Fingerprint of the public
     3204            key.</emphasis> To obtain the fingerprint, you can use the
     3205            <command>openssl</command> command:
     3206          </para>
     3207
     3208<screen>$ openssl rsa -pubout -outform DER -in ~/.oci/oci_api_key.pem | openssl md5 -c</screen>
     3209        </listitem>
     3210
     3211        <listitem>
     3212          <para>
     3213            <emphasis role="bold">Location of the private key on the
     3214            client device.</emphasis> Specify the full path to the
     3215            private key.
     3216          </para>
     3217        </listitem>
     3218
     3219        <listitem>
     3220          <para>
     3221            <emphasis role="bold">(Optional) Passphrase for the private
     3222            key.</emphasis>. This is only required if the key is
     3223            encrypted.
     3224          </para>
     3225        </listitem>
     3226
     3227        <listitem>
     3228          <para>
     3229            <emphasis role="bold">Region</emphasis>. Shown on the &oci;
     3230            Console. Click
     3231            <emphasis role="bold">Administration</emphasis>,
     3232            <emphasis role="bold">Tenancy Details</emphasis>.
     3233          </para>
     3234        </listitem>
     3235
     3236        <listitem>
     3237          <para>
     3238            <emphasis role="bold">Tenancy OCID.</emphasis> Shown on the
     3239            &oci; Console. Click
     3240            <emphasis role="bold">Administration</emphasis>,
     3241            <emphasis role="bold">Tenancy Details</emphasis>.
     3242          </para>
     3243
     3244          <para>
     3245            A link enables you to copy the Tenancy OCID.
     3246          </para>
     3247        </listitem>
     3248
     3249        <listitem>
     3250          <para>
     3251            <emphasis role="bold">Compartment OCID.</emphasis> Shown on
     3252            the &oci; Console. Click
     3253            <emphasis role="bold">Identity</emphasis>,
     3254            <emphasis role="bold">Compartments</emphasis>.
     3255          </para>
     3256
     3257          <para>
     3258            A link enables you to copy the Compartment OCID.
     3259          </para>
     3260        </listitem>
     3261
     3262        <listitem>
     3263          <para>
     3264            <emphasis role="bold">User OCID.</emphasis> Shown on the
     3265            &oci; Console. Click
     3266            <emphasis role="bold">Profile</emphasis>,
     3267            <emphasis role="bold">User Settings</emphasis>.
     3268          </para>
     3269
     3270          <para>
     3271            A link enables you to copy the User OCID.
     3272          </para>
     3273        </listitem>
     3274
     3275      </itemizedlist>
     3276
     3277      <para>
     3278        You can create a cloud profile in the following ways:
     3279      </para>
     3280
     3281      <itemizedlist>
     3282
     3283        <listitem>
     3284          <para>
     3285            Automatically, by using the <emphasis role="bold">Cloud
     3286            Profile Manager</emphasis>. See
     3287            <xref linkend="cloud-using-cloud-profile-manager"/>.
     3288          </para>
     3289
     3290          <para>
     3291            The Cloud Profile Manager is a component of &product-name;
     3292            that enables you to create, edit, and manage cloud profiles
     3293            for your cloud service accounts.
     3294          </para>
     3295        </listitem>
     3296
     3297        <listitem>
     3298          <para>
     3299            Automatically, by using the <command>VBoxManage
     3300            cloudprofile</command> command. See
     3301            <xref linkend="vboxmanage-cloudprofile"/>.
     3302          </para>
     3303        </listitem>
     3304
     3305        <listitem>
     3306          <para>
     3307            Manually, by creating an <filename>oci_config</filename>
     3308            file in your &product-name; global configuration directory.
     3309            For example, this is
     3310            <filename>$HOME/.config/VirtualBox/oci_config</filename> on
     3311            a Linux host.
     3312          </para>
     3313        </listitem>
     3314
     3315        <listitem>
     3316          <para>
     3317            Manually, by creating a <filename>config</filename> file in
     3318            your &oci; configuration directory. For example, this is
     3319            <filename>$HOME/.oci/config</filename> on a Linux host.
     3320          </para>
     3321
     3322          <para>
     3323            This is the same file that is used by the &oci; command line
     3324            interface.
     3325          </para>
     3326
     3327          <para>
     3328            &product-name; automatically uses the
     3329            <filename>config</filename> file if no cloud profile file is
     3330            present in your global configuration directory.
     3331            Alternatively, you can import this file manually into the
     3332            Cloud Profile Manager.
     3333          </para>
     3334        </listitem>
     3335
     3336      </itemizedlist>
    34503337
    34513338    </sect2>
    34523339
    3453     <sect2 id="ovf-cloud-profile-manager">
    3454 
    3455       <title>The Cloud Profile Manager</title>
    3456 
    3457       <para>
    3458         The Cloud Profile Manager is a component of &product-name; that
    3459         enables you to create, edit, and manage cloud profiles for your
    3460         cloud service accounts.
     3340    <sect2 id="cloud-using-cloud-profile-manager">
     3341
     3342      <title>Using the Cloud Profile Manager</title>
     3343
     3344      <para>
     3345        This section describes how to use the Cloud Profile Manager to
     3346        create a cloud profile.
     3347      </para>
     3348
     3349      <para>
     3350        To open the Cloud Profile Manager click
     3351        <emphasis role="bold">File</emphasis>,
     3352        <emphasis role="bold">Cloud Profile Manager</emphasis> in the
     3353        VirtualBox Manager window.
    34613354      </para>
    34623355
    … …  
    34723365
    34733366      <para>
    3474         To open the Cloud Profile Manager select
    3475         <emphasis role="bold">File</emphasis>,
    3476         <emphasis role="bold">Cloud Profile Manager</emphasis> from the
    3477         VirtualBox Manager window.
    3478       </para>
    3479 
    3480       <para>
    3481         You can use the Cloud Profile Manager to create a new cloud
    3482         profile automatically or to create a cloud profile by importing
    3483         settings from your &oci; configuration file.
    3484       </para>
     3367        You can use the Cloud Profile Manager in the following ways:
     3368      </para>
     3369
     3370      <itemizedlist>
     3371
     3372        <listitem>
     3373          <para>
     3374            To create a new cloud profile automatically
     3375          </para>
     3376        </listitem>
     3377
     3378        <listitem>
     3379          <para>
     3380            To create a cloud profile by importing settings from your
     3381            &oci; configuration file.
     3382          </para>
     3383        </listitem>
     3384
     3385      </itemizedlist>
    34853386
    34863387      <para>
    34873388        Perform the following steps to create a new cloud profile
    3488         automatically:
     3389        automatically, using the Cloud Profile Manager:
    34893390      </para>
    34903391
    … …  
    35253426            </listitem>
    35263427
    3527             <listitem>
     3428<!--       <listitem>
    35283429              <para>
    35293430                (Optional) Passphrase for the private key, if the key is
    35303431                encrypted
    35313432              </para>
    3532             </listitem>
     3433            </listitem>-->
    35333434
    35343435            <listitem>
    … …  
    35753476      <para>
    35763477        Perform the following steps to import an existing &oci;
    3577         configuration file:
     3478        configuration file into the Cloud Profile Manager:
    35783479      </para>
    35793480
    … …  
    36343535
    36353536      </orderedlist>
     3537
     3538    </sect2>
     3539
     3540    <sect2 id="cloud-vbox-oci-tasks">
     3541
     3542      <title>Using &product-name; With &oci;</title>
     3543
     3544      <para>
     3545        This section describes how you can use &product-name; with &oci;
     3546        to do the following tasks:
     3547      </para>
     3548
     3549      <itemizedlist>
     3550
     3551        <listitem>
     3552          <para>
     3553            Export an &product-name; VM to &oci;. See
     3554            <xref linkend="cloud-export-oci"/>.
     3555          </para>
     3556        </listitem>
     3557
     3558        <listitem>
     3559          <para>
     3560            Import a cloud instance into &product-name;. See
     3561            <xref linkend="cloud-import-oci"/>.
     3562          </para>
     3563        </listitem>
     3564
     3565        <listitem>
     3566          <para>
     3567            Create a new cloud instance from a custom image stored on
     3568            &oci;. See <xref linkend="cloud-new-vm"/>.
     3569          </para>
     3570        </listitem>
     3571
     3572        <listitem>
     3573          <para>
     3574            Use the <command>VBoxManage</command> commands to integrate
     3575            with &oci; and perform cloud operations. See
     3576            <xref linkend="cloud-using-cli"/>.
     3577          </para>
     3578        </listitem>
     3579
     3580      </itemizedlist>
     3581
     3582    </sect2>
     3583
     3584    <sect2 id="cloud-export-oci">
     3585
     3586      <title>Exporting an Appliance to &oci;</title>
     3587
     3588      <para>
     3589        &product-name; supports the export of VMs to an &oci; service.
     3590        The exported VM is stored on &oci; as a custom Linux image. You
     3591        can configure whether a cloud instance is created and started
     3592        after the export process has completed.
     3593      </para>
     3594
     3595      <note>
     3596        <para>
     3597          Before you export a VM to &oci;, you must prepare the VM as
     3598          described in <xref linkend="cloud-export-oci-prepare-vm"/>.
     3599        </para>
     3600      </note>
     3601
     3602      <para>
     3603        Use the following steps to export a VM to &oci;:
     3604      </para>
     3605
     3606      <orderedlist>
     3607
     3608        <listitem>
     3609          <para>
     3610            Select <emphasis role="bold">File</emphasis>,
     3611            <emphasis role="bold">Export Appliance</emphasis> to open
     3612            the <emphasis role="bold">Export Virtual
     3613            Appliance</emphasis> wizard.
     3614          </para>
     3615
     3616          <para>
     3617            Select a VM to export and click
     3618            <emphasis role="bold">Next</emphasis> to open the
     3619            <emphasis role="bold">Appliance Settings</emphasis> screen.
     3620          </para>
     3621        </listitem>
     3622
     3623        <listitem>
     3624          <para>
     3625            From the <emphasis role="bold">Format</emphasis> drop-down
     3626            list, select <emphasis role="bold">&oci;</emphasis>.
     3627          </para>
     3628
     3629          <para>
     3630            In the <emphasis role="bold">Account</emphasis> drop-down
     3631            list, select the cloud profile for your &oci; account.
     3632          </para>
     3633
     3634          <para>
     3635            The list after the <emphasis role="bold">Account</emphasis>
     3636            field shows the profile settings for your cloud account.
     3637          </para>
     3638
     3639          <figure id="fig-export-appliance-oci">
     3640            <title>Appliance Settings Screen, Showing Cloud Profile and Machine Creation
     3641              Settings</title>
     3642           <mediaobject>
     3643              <imageobject>
     3644                <imagedata align="center" fileref="images/export-appliance-oci.png"
     3645                  width="12cm" />
     3646              </imageobject>
     3647            </mediaobject>
     3648          </figure>
     3649
     3650          <para>
     3651            In the <emphasis role="bold">Machine Creation</emphasis>
     3652            field, select an option to configure settings for a cloud
     3653            instance created when you export to &oci;. The options
     3654            enable you to do one of the following:
     3655          </para>
     3656
     3657          <itemizedlist>
     3658
     3659            <listitem>
     3660              <para>
     3661                Configure settings for the cloud instance
     3662                <emphasis>after</emphasis> you have finished exporting
     3663                the VM.
     3664              </para>
     3665            </listitem>
     3666
     3667            <listitem>
     3668              <para>
     3669                Configure settings for the cloud instance
     3670                <emphasis>before</emphasis> you start to export the VM.
     3671              </para>
     3672            </listitem>
     3673
     3674            <listitem>
     3675              <para>
     3676                Do not create a cloud instance when you export the VM.
     3677              </para>
     3678            </listitem>
     3679
     3680          </itemizedlist>
     3681
     3682          <para>
     3683            Click <emphasis role="bold">Next</emphasis> to make an API
     3684            request to the &oci; service and open the
     3685            <emphasis role="bold">Virtual System Settings</emphasis>
     3686            screen.
     3687          </para>
     3688        </listitem>
     3689
     3690        <listitem>
     3691          <para>
     3692            (Optional) Edit storage settings used for the exported
     3693            virtual machine in &oci;. You can change the following
     3694            settings:
     3695          </para>
     3696
     3697          <itemizedlist>
     3698
     3699            <listitem>
     3700              <para>
     3701                The name of the bucket used to store the exported files.
     3702              </para>
     3703            </listitem>
     3704
     3705            <listitem>
     3706              <para>
     3707                Whether to store the custom image in &oci;.
     3708              </para>
     3709            </listitem>
     3710
     3711            <listitem>
     3712              <para>
     3713                The name for the custom image in &oci;.
     3714              </para>
     3715            </listitem>
     3716
     3717            <listitem>
     3718              <para>
     3719                The launch mode for the custom image.
     3720              </para>
     3721
     3722              <para>
     3723                <emphasis role="bold">Paravirtualized</emphasis> mode
     3724                gives improved performance and should be suitable for
     3725                most &product-name; VMs.
     3726              </para>
     3727
     3728              <para>
     3729                <emphasis role="bold">Emulated</emphasis> mode is
     3730                suitable for legacy OS images.
     3731              </para>
     3732            </listitem>
     3733
     3734          </itemizedlist>
     3735
     3736          <para>
     3737            Click <emphasis role="bold">Export</emphasis> to continue.
     3738          </para>
     3739        </listitem>
     3740
     3741        <listitem>
     3742          <para>
     3743            Depending on the selection in the
     3744            <emphasis role="bold">Machine Creation</emphasis> field, the
     3745            <emphasis role="bold">Cloud Virtual Machine
     3746            Settings</emphasis> screen may be displayed before or after
     3747            export. This screen enables you to configure settings for
     3748            the cloud instance, such as Shape and Disk Size.
     3749          </para>
     3750
     3751          <para>
     3752            Click <emphasis role="bold">Create</emphasis>. The VM is
     3753            exported to &oci;.
     3754          </para>
     3755
     3756          <para>
     3757            Depending on the <emphasis role="bold">Machine
     3758            Creation</emphasis> setting, a cloud instance may be started
     3759            after upload to &oci; is completed.
     3760          </para>
     3761        </listitem>
     3762
     3763        <listitem>
     3764          <para>
     3765            Monitor the export process by using the &oci; Console.
     3766          </para>
     3767        </listitem>
     3768
     3769      </orderedlist>
     3770
     3771      <para>
     3772        You can also use the <command>VBoxManage export</command>
     3773        command to export a VM to &oci;. See
     3774        <xref linkend="vboxmanage-export-cloud"/>.
     3775      </para>
     3776
     3777      <sect3 id="cloud-export-oci-prepare-vm">
     3778
     3779        <title>Preparing a VM for Export to &oci;</title>
     3780
     3781        <para>
     3782          &oci; provides the option to import a custom Linux image.
     3783          Before an &product-name; image can be exported to &oci;, the
     3784          custom image needs to be prepared to ensure that instances
     3785          launched from the custom image can boot correctly and that
     3786          network connections will work. This section provides advice on
     3787          how to prepare a Linux image for export from &product-name;.
     3788        </para>
     3789
     3790        <para>
     3791          The following list shows some tasks to consider when preparing
     3792          an Oracle Linux VM for export:
     3793        </para>
     3794
     3795        <itemizedlist>
     3796
     3797          <listitem>
     3798            <para>
     3799              <emphasis role="bold">Use DHCP for network
     3800              addresses.</emphasis> Configure the VM to use a DHCP
     3801              server to allocate network addresses, rather than using a
     3802              static IP address. The &oci; instance will then be
     3803              allocated an IP address automatically.
     3804            </para>
     3805          </listitem>
     3806
     3807          <listitem>
     3808            <para>
     3809              <emphasis role="bold">Do not specify a MAC
     3810              address.</emphasis> The network interface configuration
     3811              for the VM must not specify the MAC address.
     3812            </para>
     3813
     3814            <para>
     3815              Remove the HWADDR setting from the
     3816              <filename>/etc/sysconfig/ifcfg-<replaceable>devicename</replaceable></filename>
     3817              network script.
     3818            </para>
     3819          </listitem>
     3820
     3821          <listitem>
     3822            <para>
     3823              <emphasis role="bold">Disable persistent network device
     3824              naming rules.</emphasis> This means that the &oci;
     3825              instance will use the same network device names as the VM.
     3826            </para>
     3827
     3828            <orderedlist>
     3829
     3830              <listitem>
     3831                <para>
     3832                  Change the GRUB kernel parameters.
     3833                </para>
     3834
     3835                <para>
     3836                  Add <literal>net.ifnames=0</literal> and
     3837                  <literal>biosdevname=0</literal> as kernel parameter
     3838                  values to the <literal>GRUB_CMDLINE_LINUX</literal>
     3839                  variable.
     3840                </para>
     3841              </listitem>
     3842
     3843              <listitem>
     3844                <para>
     3845                  Update the GRUB configuration.
     3846                </para>
     3847
     3848<screen># grub2-mkconfig -o /boot/grub2/grub.cfg</screen>
     3849              </listitem>
     3850
     3851              <listitem>
     3852                <para>
     3853                  Disable any <literal>udev</literal> rules for network
     3854                  device naming.
     3855                </para>
     3856
     3857                <para>
     3858                  For example, if an automated <literal>udev</literal>
     3859                  rule exists for <literal>net-persistence</literal>:
     3860                </para>
     3861
     3862<screen># cd /etc/udev/rules.d
     3863# rm -f 70-persistent-net.rules
     3864# ln -s /dev/null /etc/udev/rules.d/70-persistent-net.rules</screen>
     3865              </listitem>
     3866
     3867            </orderedlist>
     3868          </listitem>
     3869
     3870          <listitem>
     3871            <para>
     3872              <emphasis role="bold">Enable the serial
     3873              console.</emphasis> This enables you to troubleshoot the
     3874              instance when it is running on &oci;.
     3875            </para>
     3876
     3877            <orderedlist>
     3878
     3879              <listitem>
     3880                <para>
     3881                  Edit the <filename>/etc/default/grub</filename> file,
     3882                  as follows:
     3883                </para>
     3884
     3885                <itemizedlist>
     3886
     3887                  <listitem>
     3888                    <para>
     3889                      Remove the <literal>resume</literal> setting from
     3890                      the kernel parameters. This setting slows down
     3891                      boot time significantly.
     3892                    </para>
     3893                  </listitem>
     3894
     3895                  <listitem>
     3896                    <para>
     3897                      Replace <literal>GRUB_TERMINAL="gfxterm"</literal>
     3898                      with <literal>GRUB_TERMINAL="console
     3899                      serial"</literal>. This configures use of the
     3900                      serial console instead of a graphical terminal.
     3901                    </para>
     3902                  </listitem>
     3903
     3904                  <listitem>
     3905                    <para>
     3906                      Add <literal>GRUB_SERIAL_COMMAND="serial --unit=0
     3907                      --speed=115200"</literal>. This configures the
     3908                      serial connection.
     3909                    </para>
     3910                  </listitem>
     3911
     3912                  <listitem>
     3913                    <para>
     3914                      Add <literal>console=tty0
     3915                      console=ttyS0,115200</literal> to the
     3916                      <literal>GRUB_CMDLINE_LINUX</literal> variable.
     3917                      This adds the serial console to the Linux kernel
     3918                      boot parameters.
     3919                    </para>
     3920                  </listitem>
     3921
     3922                </itemizedlist>
     3923              </listitem>
     3924
     3925              <listitem>
     3926                <para>
     3927                  Regenerate the GRUB configuration.
     3928                </para>
     3929
     3930<screen># grub2-mkconfig -o /boot/grub2/grub.cfg</screen>
     3931              </listitem>
     3932
     3933              <listitem>
     3934                <para>
     3935                  To verify the changes, reboot the machine and run the
     3936                  <command>dmesg</command> command to look for the
     3937                  updated kernel parameters.
     3938                </para>
     3939
     3940<screen># dmesg |grep console=ttyS0</screen>
     3941              </listitem>
     3942
     3943            </orderedlist>
     3944          </listitem>
     3945
     3946          <listitem>
     3947            <para>
     3948              <emphasis role="bold">Enable paravirtualized device
     3949              support.</emphasis> You do this by adding the
     3950              <literal>virtio</literal> drivers to the
     3951              <literal>initrd</literal> for the VM.
     3952            </para>
     3953
     3954            <orderedlist>
     3955
     3956              <listitem>
     3957                <para>
     3958                  This procedure works only on machines with a Linux
     3959                  kernel of version 3.4 or later. Check that the VM is
     3960                  running a supported kernel:
     3961                </para>
     3962
     3963<screen># uname -a</screen>
     3964              </listitem>
     3965
     3966              <listitem>
     3967                <para>
     3968                  Use the <literal>dracut</literal> tool to rebuild
     3969                  <literal>initrd</literal>. Add the
     3970                  <literal>qemu</literal> module, as follows:
     3971                </para>
     3972
     3973<screen># dracut –-logfile /var/log/Dracut.log –-force –-add qemu</screen>
     3974              </listitem>
     3975
     3976              <listitem>
     3977                <para>
     3978                  Verify that the <literal>virtio</literal> drivers are
     3979                  now present in <literal>initrd</literal>.
     3980                </para>
     3981
     3982<screen> # lsinitrd |grep virtio</screen>
     3983              </listitem>
     3984
     3985            </orderedlist>
     3986          </listitem>
     3987
     3988        </itemizedlist>
     3989
     3990        <para>
     3991          For more information about importing a custom Linux image into
     3992          &oci;, see also:
     3993        </para>
     3994
     3995        <para>
     3996          <ulink url="https://docs.cloud.oracle.com/iaas/Content/Compute/Tasks/importingcustomimagelinux.htm" />
     3997        </para>
     3998
     3999      </sect3>
     4000
     4001    </sect2>
     4002
     4003    <sect2 id="cloud-import-oci">
     4004
     4005      <title>Importing an Instance from &oci;</title>
     4006
     4007      <para>
     4008        Perform the following steps to import a cloud instance from
     4009        &oci; into &product-name;:
     4010      </para>
     4011
     4012      <orderedlist>
     4013
     4014        <listitem>
     4015          <para>
     4016            Select <emphasis role="bold">File</emphasis>,
     4017            <emphasis role="bold">Import Appliance</emphasis> to open
     4018            the <emphasis role="bold">Import Virtual
     4019            Appliance</emphasis> wizard.
     4020          </para>
     4021
     4022          <para>
     4023            In the <emphasis role="bold">Source</emphasis> drop-down
     4024            list, select <emphasis role="bold">&oci;</emphasis>.
     4025          </para>
     4026
     4027          <para>
     4028            In the <emphasis role="bold">Account</emphasis> drop-down
     4029            list, select the cloud profile for your &oci; account.
     4030          </para>
     4031
     4032          <para>
     4033            The list after the <emphasis role="bold">Account</emphasis>
     4034            field shows the profile settings for your cloud account.
     4035          </para>
     4036
     4037          <para>
     4038            Choose the required cloud instance from the list in the
     4039            <emphasis role="bold">Machines</emphasis> field.
     4040          </para>
     4041
     4042          <para>
     4043            Click <emphasis role="bold">Next</emphasis> to make an API
     4044            request to the &oci; service and display the
     4045            <emphasis role="bold">Appliance Settings</emphasis> screen.
     4046          </para>
     4047        </listitem>
     4048
     4049        <listitem>
     4050          <para>
     4051            (Optional) Edit settings for the new local virtual machine.
     4052          </para>
     4053
     4054          <para>
     4055            For example, you can edit the VM name and description.
     4056          </para>
     4057
     4058          <figure id="fig-import-instance-oci">
     4059            <title>Import Cloud Instance Screen, Showing Profile Settings and VM Settings</title>
     4060           <mediaobject>
     4061              <imageobject>
     4062                <imagedata align="center" fileref="images/import-instance.png"
     4063                  width="12cm" />
     4064              </imageobject>
     4065            </mediaobject>
     4066          </figure>
     4067
     4068          <para>
     4069            Click <emphasis role="bold">Import</emphasis> to import the
     4070            instance from &oci;.
     4071          </para>
     4072        </listitem>
     4073
     4074        <listitem>
     4075          <para>
     4076            Monitor the import process by using the &oci; Console.
     4077          </para>
     4078        </listitem>
     4079
     4080      </orderedlist>
     4081
     4082      <para>
     4083        You can also use the <command>VBoxManage import</command>
     4084        command to import an instance from &oci;. See
     4085        <xref linkend="vboxmanage-import-cloud"/>.
     4086      </para>
     4087
     4088      <simplesect id="import-instance-sequence">
     4089
     4090        <title>Importing an Instance: Overview of Events</title>
     4091
     4092        <para>
     4093          The following describes the sequence of events when you import
     4094          an instance from &oci;.
     4095        </para>
     4096
     4097        <itemizedlist>
     4098
     4099          <listitem>
     4100            <para>
     4101              A custom image is created from the boot volume of the
     4102              instance.
     4103            </para>
     4104          </listitem>
     4105
     4106          <listitem>
     4107            <para>
     4108              The custom image is exported to an &oci; object and is
     4109              stored using Object Storage in the bucket specified by the
     4110              user.
     4111            </para>
     4112          </listitem>
     4113
     4114          <listitem>
     4115            <para>
     4116              The &oci; object is downloaded to the local host. The
     4117              object is a TAR archive which contains a boot volume of
     4118              the instance in QCOW2 format and a JSON file containing
     4119              metadata related to the instance.
     4120            </para>
     4121          </listitem>
     4122
     4123          <listitem>
     4124            <para>
     4125              The boot volume of the instance is extracted from the
     4126              archive and a new VMDK image is created by converting the
     4127              boot volume into the VMDK format. The VMDK image is
     4128              registered with &product-name;.
     4129            </para>
     4130          </listitem>
     4131
     4132          <listitem>
     4133            <para>
     4134              A new VM is created using the VMDK image for the cloud
     4135              instance.
     4136            </para>
     4137
     4138            <para>
     4139              By default, the new VM is not started after import from
     4140              &oci;.
     4141            </para>
     4142          </listitem>
     4143
     4144          <listitem>
     4145            <para>
     4146              The downloaded TAR archive is deleted after a successful
     4147              import.
     4148            </para>
     4149          </listitem>
     4150
     4151        </itemizedlist>
     4152
     4153      </simplesect>
    36364154
    36374155    </sect2>
    … …  
    36554173
    36564174      <para>
    3657         Before you can create a new cloud instance in &oci; ensure that
    3658         you have done the required preconfiguration tasks, as described
    3659         in <xref linkend="cloud-integration-steps"/>.
    3660       </para>
    3661 
    3662       <para>
    36634175        Perform the following steps to create a new cloud instance on
    36644176        &oci;:
    … …  
    36854197          <para>
    36864198            In the <emphasis role="bold">Account</emphasis> drop-down
    3687             list, select your &oci; account.
    3688           </para>
    3689 
    3690           <para>
    3691             You can set up &oci; accounts by using the Cloud Profile
    3692             Manager.
     4199            list, select the cloud profile for your &oci; account.
    36934200          </para>
    36944201
    … …  
    37054212          <figure id="fig-newcloudvm">
    37064213            <title>New Cloud VM Wizard, Showing List of Custom Images</title>
    3707            <mediaobject>
     4214            <mediaobject>
    37084215              <imageobject>
    37094216                <imagedata align="center" fileref="images/newcloudvm.png"
    … …  
    37234230        <listitem>
    37244231          <para>
    3725             Optionally edit settings used for the instance on &oci;.
     4232            (Optional) Edit settings used for the new instance on &oci;.
    37264233          </para>
    37274234
    … …  
    37504257        instance</command> command to create and manage instances on a
    37514258        cloud service. See <xref linkend="vboxmanage-cloud"/>.
     4259      </para>
     4260
     4261    </sect2>
     4262
     4263    <sect2 id="cloud-using-cli">
     4264
     4265      <title>Using VBoxManage Commands With &oci;</title>
     4266
     4267      <para>
     4268        This section includes some examples of how
     4269        <command>VBoxManage</command> commands can be used to integrate
     4270        with &oci; and perform common cloud operations.
     4271      </para>
     4272
     4273      <para>
     4274        <emphasis role="bold">Creating a Cloud Profile</emphasis>
     4275      </para>
     4276
     4277      <para>
     4278        To create a cloud profile called <literal>vbox-oci</literal>:
     4279      </para>
     4280
     4281<screen>VBoxManage cloudprofile --provider "OCI" --profile="vbox-oci" add \
     4282--clouduser="ocid1.user.oc1..."  --keyfile="/home/username/.oci/oci_api_key.pem" \
     4283--tenancy="ocid1.tenancy.oc1..."  --compartment="ocid1.compartment.oc1..."  --region="us-ashburn-1"
     4284</screen>
     4285
     4286      <para>
     4287        The new cloud profile is added to the
     4288        <filename>oci_config</filename> file in your &product-name;
     4289        global configuration directory. For example, this is
     4290        <filename>$HOME/.VirtualBox/oci_config</filename> on a Windows
     4291        host.
     4292      </para>
     4293
     4294      <para>
     4295        <emphasis role="bold">Listing Cloud Instances</emphasis>
     4296      </para>
     4297
     4298      <para>
     4299        To list the instances in your &oci; compartment:
     4300      </para>
     4301
     4302<screen>VBoxManage cloud --provider="OCI" --profile="vbox-oci" list instances
     4303</screen>
     4304
     4305      <para>
     4306        <emphasis role="bold">Exporting an &product-name; VM to the
     4307        Cloud</emphasis>
     4308      </para>
     4309
     4310      <para>
     4311        To export a VM called <literal>myVM</literal> and create a cloud
     4312        instance called <literal>myVM_Cloud</literal>:
     4313      </para>
     4314
     4315<screen>VBoxManage export myVM --output OCI:// --cloud 0 --vmname myVM_Cloud \
     4316--cloudprofile "vbox-oci" --cloudbucket myBucket \
     4317--cloudshape VM.Standard2.1 --clouddomain US-ASHBURN-AD-1 --clouddisksize 50  \
     4318--cloudocivcn ocid1.vcn.oc1... --cloudocisubnet ocid1.subnet.oc1... \
     4319--cloudkeepobject true --cloudlaunchinstance true --cloudpublicip true
     4320      </screen>
     4321
     4322      <para>
     4323        <emphasis role="bold">Importing a Cloud Instance Into
     4324        &product-name;</emphasis>
     4325      </para>
     4326
     4327      <para>
     4328        To import a cloud instance and create an &product-name; VM
     4329        called <literal>oci_Import</literal>:
     4330      </para>
     4331
     4332<screen>VBoxManage import OCI:// --cloud --vmname oci_Import --memory 4000
     4333--cpus 3 --ostype FreeBSD_64 --cloudprofile "vbox-oci"
     4334--cloudinstanceid ocid1.instance.oc1... --cloudbucket myBucket
     4335  </screen>
     4336
     4337      <para>
     4338        <emphasis role="bold">Creating a New Cloud Instance From a
     4339        Custom Image</emphasis>
     4340      </para>
     4341
     4342      <para>
     4343        To create a new cloud instance from a custom image on &oci;:
     4344      </para>
     4345
     4346<screen>VBoxManage cloud --provider="OCI" --profile="vbox-oci" instance create \
     4347--domain-name="oraclecloud.com" --image-id="ocid1.image.oc1..." --display-name="myInstance" \
     4348--shape="VM.Standard2.1" --subnet="ocid1.subnet.oc1..."</screen>
     4349
     4350      <para>
     4351        <emphasis role="bold">Terminating a Cloud Instance</emphasis>
     4352      </para>
     4353
     4354      <para>
     4355        To terminate an instance in your compartment on &oci;:
     4356      </para>
     4357
     4358<screen>VBoxManage cloud --provider="OCI" --profile="vbox-oci" instance terminate \
     4359--id="ocid1.instance.oc1..." </screen>
     4360
     4361      <para>
     4362        For more details about the available commands for cloud
     4363        operations, see <xref linkend="vboxmanage-cloud"/>.
    37524364      </para>
    37534365
    … …  
    38204432        <para>
    38214433          <emphasis role="bold">Network.</emphasis> Enables the user to
    3822           configure the details of Host Only Networks.
     4434          configure the details of NAT networks. See
     4435          <xref linkend="network_nat_service"/>.
    38234436        </para>
    38244437      </listitem>
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette