Important Notes Before You Begin

Read the following notes before you start modifying Exalogic VM images:

• Do not modify any of the Exalogic Control VM images. If you wish to modify them, contact Oracle Support.

• Do not modify templates that are already imported and registered in the Oracle VM (OVM) repository. If you wish to modify a Exalogic guest base template, you should start with the tgz file.

  Alternatively, copy artifacts from the Exalogic OVM repository to a host outside Exalogic, as follows:

  Note:

  This procedure uses example names. You should use the appropriate template names and paths.

  1. Identify the vm.cfg file corresponding to the template being modified. For example, run the following command:

     grep Exalogic_Base_Template /OVS/Repositories/*/Templates/*/vm.cfg

     The example output is as follows:

     /OVS/Repositories/0004fb0000030000986539c7d4fe8a92/Templates/0004fb00001400000f5e855e6e5dbb32/vm.cfg:OVM_simple_name = 'Exalogic_Base_Template'

  2. Find the disks corresponding to the vm.cfg file as follows:

     grep disk /OVS/Repositories/0004fb0000030000986539c7d4fe8a92/Templates/0004fb00001400000f5e855e6e5dbb32/vm.cfg

     The example output is as follows:

     disk = ['file:/OVS/Repositories/0004fb0000030000986539c7d4fe8a92/VirtualDisks/4d84c59e-fbb3-4c3b-92c7-fe7bd591ae38.img,hda,w','file:/OVS/Repositories/0004fb0000030000986539c7d4fe8a92/VirtualDisks/b0ed1dee-7323-420d-b7f2-364d1ec70194.img,hdb,w']

  3. Copy all of these artifacts to a host outside Exalogic.

  4. Edit the vm.cfg file, as necessary.

  5. Edit the template using modifyjeos or manually.

  6. Create a tar file after making all modifications.

• To modify a VM image, you can use the modifyjeos command, which is included in one of the RPMs packaged with the VM image. Alternatively, you can modify the VM image manually.

  Note:

  modifyjeos does not work for LVM-based templates.

  When using modifyjeos to customize a VM image, ensure that the VM is not running. In addition, back up the vm.cfg and System.img files before running modifyjeos.

  To locate the configuration file for a VM (vm.cfg), complete the following steps:

  1. Determine the ID of the VM as follows:

     a. Log in to Exalogic Control web interface.

     b. Under Assets in the navigation pane on the left, select your Exalogic machine (for example, Oracle Exalogic X2-2AK00026800), and expand Servers. Under Servers, identify the VM whose ID you want to collect. See the Virtual Machine Display Name, which is different from the Virtual Machine Name.

     c. After determining the VM, click the Summary tab on the Center pane. This pane displays both Virtual Machine Name and Virtual Machine Display Name. An example Virtual Machine Name is 0004fb000006000021e3117abee1b9df.

  2. Use SSH to connect to any of the compute nodes in the server pool exelpool1 that hosts the VM.

  3. After logging in, move to the following directory:

     # cd /OVS/Repositories/*/VirtualMachines/<ID>

     For example,

     # cd /OVS/Repositories/*/VirtualMachines/0004fb0000060000dcda55f345cc8ec3

     This directory contains a single file named vm.cfg that contains the configuration information for the VM.