Oracle VM 3 Template (OVF) for Oracle Linux 7 Media Pack v2 for x86_64 (64-bit) =============================================================================== Contents 1. About the Template 2. Creating an Oracle VM Guest Virtual Machine From the Template 3. Creating an Oracle VM VirtualBox Guest Virtual Machine From a Template 4. Known Issues 5. Older Template Version Information 1. About the Template ===================== Oracle Linux VM Templates are provided as standard Open Virtualization Format Archive (.ova) files. The Oracle Linux 7 Media Pack contains the following file: File Version Description ---- ------- ----------- OVM_OL7U2_X86_64_PVHVM.ova 1.2 Hardware virtualized template with PV drivers The hardware virtualized template contains a kernel that is not recompiled for the virtual environment, but contains additional paravirtualized (PV) drivers for improved performance. Template virtual machine configuration: Template Name Kernel VCPU RAM Storage ----------------------- ---------------------- ---- --- ------- OVM_OL7U2_X86_64_PVHVM 3.8.13-118.2.1.el7uek 2 2GB 15GB Oracle Linux configuration: * Oracle Linux is installed using the Minimal Install base environment. * The latest available errata are installed for all packages. * The default boot target is multi-user.target (equivalent to run level 3 in previous Oracle Linux releases). * The firewall is enabled. The SELinux option is set to permissive. * The default boot kernel is Oracle Unbreakable Enterprise Kernel Release 3 (kernel-uek-3.8.13-118.2.1.el7uek). The template also includes the Red Hat Compatible Kernel (kernel-3.10.0-327.3.1.el7). * The Oracle VM Guest Additions (also known as ovmapi) are installed in the template with Oracle Unbreakable Enterprise Kernel (UEK). The Guest Additions are a set of packages that help with the automatic configuration of a guest virtual machine when it boots for the first time with UEK. The following packages are installed: kmod-ovmapi-uek libovmapi libovmapi-devel ovmd ovm-template-config ovm-template-config-authentication ovm-template-config-datetime ovm-template-config-firewall ovm-template-config-network ovm-template-config-selinux ovm-template-config-ssh ovm-template-config-system ovm-template-config-user python-simplejson xenstoreprovider * When a guest virtual machine is booted for the first time, you are prompted to change the password for the 'root' user. You must enter a new, non-blank password, or the guest will not continue to boot. 2. Creating an Oracle VM Guest Virtual Machine From a Template ============================================================== 1. Import the .ova file to Oracle VM as an assembly. https://docs.oracle.com/cd/E50245_01/E50248/html/vmgsg-resources-assembly.html 2. Create a template from the assembly. https://docs.oracle.com/cd/E50245_01/E50248/html/vmgsg-vms-create-assembly.html 3. Create a guest virtual machine from the template. https://docs.oracle.com/cd/E50245_01/E50248/html/vmgsg-vms-create-template.html When a guest virtual machine first boots, you are asked to input configuration parameters. This can be done in the virtual machine console. Alternatively, you also can send the configuration parameters to the virtual machine by using the Oracle VM Utilities or the Oracle VM CLI. The com.oracle.linux.root-password parameter is a required parameter. Once you enter this parameter, the Oracle Linux VM Template configuration wizard does not accept any further parameters, and executes the configuration scripts. To ensure that the optional parameters are applied, always enter the com.oracle.linux.root-password parameter last. The following are the available configuration parameters: Key Description --- ----------- com.oracle.linux.network.hostname System host name com.oracle.linux.network.device.0 Network device to configure, for example: eth0 com.oracle.linux.network.onboot.0 Activate interface on system boot: yes or no com.oracle.linux.network.bootproto.0 Boot protocol: dhcp or none com.oracle.linux.network.ipaddr.0 IP address com.oracle.linux.network.netmask.0 Netmask com.oracle.linux.network.gateway.0 Gateway IP address com.oracle.linux.network.dns-servers.0 DNS servers separated by comma, for example: 8.8.8.8,8.8.4.4 com.oracle.linux.root-password System root password 3. Creating an Oracle VM VirtualBox Guest Virtual Machine From a Template ========================================================================= Import the .ova file to VirtualBox as an appliance: 1. In Oracle VM VirtualBox Manager, select Import Appliance from the File menu. The Import Virtual Appliance wizard is displayed. 2. Select the .ova file and click Next to display the Appliance Settings screen. 3. (Optional) Change the guest virtual machine settings. 4. Click Import. VirtualBox creates the guest virtual machine and copies the disk image. 4. Known Issues =============== Oracle VM Guest Additions ------------------------- To use the Oracle VM Guest Additions requires Oracle VM 3.1.1 or later. The Guest Additions are not supported on Oracle VM 3.0. Issues With PVM Guests ---------------------- There may be issues with paravirtualized (PVM) guests. The template uses hardware virtualized with paravirtualized drivers (PVHVM) mode by default and this is the recommended mode for guests. Converting a PHVM guest to PVM mode is not supported. Console Issues In Emergency Boot Mode [Bug 20861210] --------------------------------------------------- This issue occurs only in the released Oracle Linux 7 Update 1 template. In emergency boot mode, you might experience issues with the console, such as additional new lines. This can occur when there is a systemd error in emergency mode, for example, if systemd fails to mount a disk specified in /etc/fstab these console issues might appear. Network Time Configuration -------------------------- The Oracle Linux 7 template uses chrony instead of NTP for network time configuration. This means you cannot use the Oracle VM Template Configuration Script (ovm-template-config) to configure NTP. You need to configure chrony manually by editing /etc/chrony.conf. For more information, see the Oracle Linux 7 Administrator's Guide: http://docs.oracle.com/cd/E52668_01/E54669/html/ol7-about-chrony.html 5. Older Template Version Information ===================================== Oracle Linux 7 Update 1 ----------------------- File Version ---- ------- OVM_OL7U1_X86_64_PVHVM.ova 1.1 Configuration Details: Template Name Kernel VCPU RAM Storage ----------------------- ---------------------- ---- --- ------- OVM_OL7U1_X86_64_PVHVM 3.8.13-68.1.2.el7uek 2 2GB 10GB Notes for Oracle Linux VM Templates Unless otherwise noted, the information found in section 1 for 'configuration details' applies to all versions. In addition to the data provided in section 1, the following information is applicable to this image: * For Oracle Linux 7 Update 1 template, The default boot kernel is Oracle * Unbreakable Enterprise Kernel Release 3 (kernel-uek-3.8.13-68.1.2.el7uek). The template also includes the Red Hat Compatible Kernel (kernel-3.10.0-229.1.2.el7).