|Oracle® Virtual Assembly Builder Installation Guide
11g Release 1.1 (11.1.1)
Part Number E18705-01
The following sections describe how to do a complete installation of Oracle Virtual Assembly Builder.
The user who installs should be a trusted user, and a member of a trusted OS group.
The template creation process does a security check to see that the Operating System (OS) user attempting to create the template is the same OS user who owns the Oracle Virtual Assembly Builder
bin directory. Having the OS user who installs the product be the same OS user who creates templates ensures that the security check will succeed.
Before using Oracle Virtual Assembly Builder, ensure that your environment meets the following prerequisites. These items are not required for installation, but are necessary environmental components for the use of Oracle Virtual Assembly Builder.
Note:Virtual introspection can only be performed on non-Oracle JRockit Virtual Edition deployments.
Introspection on a deployed virtual machine (VM) can fail to complete when the temporary directory used for introspection is a mounted NFS share with NFS file locking. To avoid this problem, remount the NFS file system with locking turned off:
mount -o nolock example:/scratch /net/example/scratch
You must ensure that the reference system on the virtual machine has enough space for an image of itself. If this is an issue, you can resolve it by using one of the following options:
System.img to Oracle Virtual Assembly Builder host and run
modifyjeos to increase the disk size to handle the snapshot of the product installation. Then redeploy the image and restart it. This will provide enough space in the /tmp directory.
If the previous option is not feasible, mount an NFS disk of suitable size, and place the catalog on it. For remote packaging, use the NFS disk location, rather than /tmp.
In order to deploy your applications into virtualized environments, you must also have appropriate Reference Systems set up (for Introspection), and an Oracle VM environment ready to deploy your applications.
Oracle Coherence*Web (
Oracle RDBMS (single instance) (
Oracle Web Cache (
Oracle HTTP Server (
Oracle WebLogic Server (
Install and configure Oracle Virtual Assembly Builder (this Guide).
Install and configure your deployment environment. See also Oracle VM (
http://www.oracle.com/technetwork/server-storage/vm) for more information.
Ensure your environment meets all requirements before starting the installation.
This certification document details supported installation types, platforms, operating systems, databases, and JDKs. See Virtual Assembly Builder in Oracle Fusion Middleware 11g Release 1 (at
The following operating systems are supported:
Oracle Enterprise Linux 5 (UL3+) (32-bit. 64 bit supported in 32-bit mode)
Red Hat Enterprise Linux 5 (UL3+) (32-bit. 64 bit supported in 32-bit mode)
You can verify your operating system version using the commands listed here.
Oracle Enterprise Linux:
# cat /etc/enterprise-release
Red Hat Enterprise Linux:
# cat /etc/redhat-release
Oracle Universal Installer includes Sun JDK for Linux. You can choose to install it (the JDK) during installation and use it with Oracle Virtual Assembly Builder. You can also choose to us your own JDK installation.
Download and install Oracle Enterprise Linux JeOS from:
http://edelivery.oracle.com/oraclevm. If this is your first time using eDelivery, you will be required to register. Register, then continue.
On the Welcome screen, click Continue. The Media Pack Search screen appears.
Select a Product Pack (Oracle Linux), and Platform (x86 32 bit). Click Go. The Results are displayed.
Select Oracle Linux JeOS for Building Oracle VM templates for x86 (32 bit). Click Continue. Available downloads appear.
Download JeOS Base x86 and x86_64, by clicking Download. The file is downloaded.
Unzip the downloaded zip file.
(As root) install the RPM packages using the
rpm command with the
Depending on the type of operating system you choose for your appliance at template creation time, you may need the Oracle Enterprise Linux Base Image or Oracle WebLogic Server on Oracle JRockit Virtual Edition Base Image (or both).
Note:You have a choice of downloading an Oracle provided sample Oracle Enterprise Linux Base Image, or creating your own. The sample image is available on Oracle Technology Network:
Ensure that the base image architecture matches your component software. That is, use a 32-bit base image if your component software is 32-bit; 64-bit base image for 64-bit component software.
To create the appropriate Base Image(s):
Oracle Enterprise Linux Base Image, see:
http://www.oracle.com/technetwork/server-storage/vm/overview/templates-101937.htmlThe information on this, and referenced pages, will provide the information you need to create your own System Base Image.
When specifying a base image, the image must meet the following requirements:
Oracle Enterprise Linux 5 (UL3+)
At least 250MB of free space for /tmp. (depending on the type of product your are creating appliance for and deploying, you may need more free space. Refer to appropriate product install guide for specific free space requirement)
At least 500MB of swap space
You must have installed the following packages (RPMs):
In addition, for deploying virtual machines for FMW components, you must have installed:
For deploying virtual machines for Oracle Database, you must have installed:
For FMW components, the following shell parameters must be set:
For Oracle database, the following shell parameters must be set
For Oracle database, the following kernel parameters must be set:
semmni=128 # max number of arrays; default is 128 semmsl=250 # max semaphores per array. default is 250 semmns=32000 # max semaphores system wide; default is 32000 semopm=100 # max ops per semop call; default is 32
Shared Memory Limits
shmmni=4096 # max number of segments; default is 4096 shmmax=0.5GB # max seg size (kbytes); default is 4194303, which is 3GB shmall=2097152 # max total shared memory (kbytes); default is 1073741824
file-max=6815744 # system wide file descriptors; default is 204573; aio-max-nr=Maximum:1048576 # default is 65536; ip_local_port_range=9000 65500 # default is 32768 61000; rmem_default=262144 # default is 109568; rmem_max=4194304 # default is 131071; wmem_default=262144 # default is 105968 wmem_max=1048576 # default is 131071
Additional database requirements:
Name Resolution: Ensure that host names are resolved through the /etc/hosts file. Note that this is not what base image can preset.
Add the following line in the
session required pam_limits.so
You must turn on
oraclevm-templates while creating the image.
Oracle recommends that you turn off
iptables while creating the image.
The base image must have the user oracle. One example of meeting this requirement is to boot the base image, log on to it as root, and call
Note:The primary group for oracle user must be oracle. By default, when you create the oracle user, it is automatically set. To set it manually, create the group and assign it to oracle user by executing:
/usr/sbin/groupadd oracle /usr/sbin/usermod -g oracle -a -G oracle oracle
Oracle WebLogic Server on Oracle JRockit Virtual Edition Base Image is included in the Oracle WebLogic Server on Oracle JRockit Virtual Edition bundle. Unzip the product's zip file, and find the
vm.cfg files (in the
wlsve sub-directory of the structure into which you unzipped the files).
Note:The base image (
system.img) must not have an executable bit. Otherwise, export/import may not work properly. You must set the permission of base images properly, for example, to 644:
$ chmod 644 System.img $ ls -l System.img -rw-r--r-- 1 jdoe g900 748500480 Apr 22 12:52 System.img