A Command Line Tools

This Appendix contains reference information for Oracle VM Template Builder command line tools and scripts, and contains:

• oraclevm-template

---

oraclevm-template

The ovm-template-config RPM (included with Oracle VM Template Builder) includes a template configuration script, oraclevm-template. This script configures a template's operating system, and calls application software configuration scripts. When a guest virtual machine created from a template is started, the following script is automatically run:

/etc/rc.d/init.d/oraclevm-template

This script calls the /usr/sbin/oraclevm-template script with the --config parameter to perform the operating system, and application software configuration.

You can run this script at any time as the root user. The syntax for this script is:

/usr/sbin/oraclevm-template [option]

Options

--config

Performs the following configuration on the guest virtual machine:

• Regenerates the up2date UUID

• Regenerates the SSH host key

• Runs the template configuration script if it is specified in the TEMPLATE_CONFIG_SCRIPT parameter in the template configuration file, and found on the guest virtual machine. If no template configuration script is specified or found, this parameter sets up the network to use either DHCP or a static IP address by requesting this information from the user at the command console.

--enable

Runs the template configuration script the next time the guest virtual machine is started. Sets the RUN_TEMPLATE_CONF parameter in the template configuration file to YES.

--disable

Disables the template configuration script the next time the guest virtual machine is started. Sets the RUN_TEMPLATE_CONF parameter in the template configuration file to NO.

--status

Displays whether the template configuration script runs the next the time the guest virtual machine is started.

--cleanup

Performs the following clean up actions on the guest virtual machine:

• If a clean up script is specified in the TEMPLATE_CLEANUP_SCRIPT parameter in the template configuration file, and the script is found, runs this script

• Cleans up the operating system log files in /var/log

• Deletes the systemid from the up2date configuration file

• Deletes the yum cache

• Deletes any DHCP client cache

• Deletes the root user's SSH configuration file and bash history files

• Deletes the /etc/resolv.conf file

• Resets the /etc/hostnames file to the default

• Resets the network configuration to DHCP

• Shuts down the network service