C Troubleshooting

This Appendix contains troubleshooting information for Oracle VM Template Builder and contains:

• Security Settings

• Template Builds May Fail

• Resetting Oracle VM Template Builder

• Known Issues

C.1 Security Settings

The Oracle VM Template Builder guest virtual machine opens the httpd and sshd ports. These are required to be open to access the web-based user interface and to log in remotely to the command-line shell, respectively.

C.2 Template Builds May Fail

If you can access the Oracle VM Template Builder web interface, but cannot perform template builds, make sure both the Oracle VM Template Builder service, and the web server service are started.

The Oracle VM Template Builder service (ovmtb) starts the daemon which performs the template builds. The ovmtb service is separate to the web server (httpd) service, which serves up the Oracle VM Template Builder user interface. You must have both the ovmtb and httpd services running to build templates in Oracle VM Template Builder. See Section 2.8, "Starting and Stopping Oracle VM Template Builder" for information on how to start the services.

The template build log file is, by default, located in:

/var/log/ovmtb/

C.3 Resetting Oracle VM Template Builder

If you must reset Oracle VM Template Builder to the initial setup, use the ovmtb-reconfig.sh script. As the root user, enter

# /var/www/html/ovmtb/scripts/ovmtb-reconfig.sh

Oracle VM Template Builder is reset back to the initial installation configuration settings.

C.4 Known Issues

This section describes the known issues in Oracle VM Template Builder and any known workarounds. The known issues are:

• No Online Help In User Interface

• Admin User Does Not Receive Emails When Using DHCP

• Building Multiple Templates Simultaneously May Cause Unexpected Errors

• Template Build Progress Percentage Not Accurate

• Changing Configuration File May Cause Unexpected Errors

• Only One Additional Disk Is Included In a Template

C.4.1 No Online Help In User Interface

There is no online help provided in this release of Oracle VM Template Builder. Online help will be provided in future releases.

C.4.2 Admin User Does Not Receive Emails When Using DHCP

The Oracle VM Template Builder admin user's email address may fail to receive emails if you have installed Oracle VM Template Builder on to a guest virtual machine which uses DHCP to obtain an IP address.

Workaround: Modify the Oracle VM Template Builder email configuration settings and restart Oracle VM Template Builder and sendmail:

1. Modify the /var/www/html/ovmtb/setting.py file to contain the host name of the guest virtual machine on which Oracle VM Template Builder is installed. For example, if the email address is [e-mail] on host.example.com, enter:

   DEFAULT_FROM_EMAIL='[e-mail]'
   EMAIL_HOST='host.example.com'
   

2. Restart Oracle VM Template Builder and sendmail:

   # service ovmtb stop
   # service httpd stop
   # /etc/init.d/sendmail restart
   # service httpd start
   # service ovmtb start
   

C.4.3 Building Multiple Templates Simultaneously May Cause Unexpected Errors

The following error may be displayed when building a template:

...
Mounting VM image...
ERROR: losetup error - Please check the log (/var/log/modifyjeos.log) file!
 
ERROR creating JeOS image files...

This error may occur when multiple templates are being built at the same time and all available loop devices are in use. If all loop devices are in use, Oracle VM Template Builder is unable to mount the disk image files, so cannot complete the build process.

Workaround: Modify the number of loop devices on the system by adding the following line to the /etc/modprobe.conf file and restarting the operating system.

options loop max_loop=64

C.4.4 Template Build Progress Percentage Not Accurate

The template build progress percentage displayed in the Template Projects table on the Template Projects screen, and in the template build log pages does not accurately display the time remaining for a template build. Depending on the configuration of the template, certain steps in the build process may take some time to complete while others may complete quickly.

C.4.5 Changing Configuration File May Cause Unexpected Errors

Care should be taken when changing the parameters in the Oracle VM Template Builder configuration file, /var/www/html/ovmtb/settings.py. Changing the values in this file may result in failed builds, the inability to access completed builds from the web user interface, and SuspiciousOperation exceptions within the application. If more file system space is needed to hold the builds, it is recommended that you retain the default configuration parameters and, instead, add a new disk to the Oracle VM Template Builder guest virtual machine. To customize the guest virtual machine, see Section 2.9, "Customizing the Oracle VM Template Builder Guest Virtual Machine".

Future releases of the Oracle VM Template Builder will allow more fine grained control over the configuration settings.

C.4.6 Only One Additional Disk Is Included In a Template

Only one additional disk image is included in a template, even if multiple additional disks are requested to be included using the template build wizard.

Workaround: Edit the template configuration file (vm.cfg) to include the additional disks.