Skip Headers
Oracle® Virtual Assembly Builder Installation Guide
11g Release 1.1 (11.1.1)

Part Number E18705-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

1 Prepare for Installation

The following sections describe how to do a complete installation of Oracle Virtual Assembly Builder.

1.1 Security Precautions

Read this section before proceeding. It contains vital security information and precautions. Failure to read and understand these items may cause security vulnerabilities.

1.2 Before you Begin

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.

1.2.1 Virtual to Virtual Introspection and Deployment Requirements

The following are requirements for virtual to virtual introspection and deployment.

Note:

Virtual introspection can only be performed on non-Oracle JRockit Virtual Edition deployments.

1.2.1.1 Introspection

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

1.2.1.2 Base Image Template Sizing

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:

  • Copy 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.

1.2.2 Unzip Utility on Reference Systems

Oracle Virtual Assembly Builder requires that the Unzip utility be present on reference systems in order for remote introspection to work properly.

1.2.3 SSH Port Forwarding Must be Enabled

Oracle Virtual Assembly Builder requires that SSH port forwarding be enabled on reference systems in order for remote operations (such as introspection and packaging) to work properly.

1.3 Installation Overview

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.

1.3.1 Installation Road Map

This document details the steps you must complete in order to install and configure Oracle Virtual Assembly Builder. The entire process is comprised of the following steps:

1.4 Certification and System Requirements

Ensure your environment meets all requirements before starting the installation.

1.4.1 Certification

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 http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html).

1.4.2 System Requirements

Please ensure you meet the following requirements.

1.4.2.1 Operating Systems

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
    

1.4.2.2 Java Development Kit

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.

1.4.2.3 Oracle Enterprise Linux JeOS

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.

  1. On the Welcome screen, click Continue. The Media Pack Search screen appears.

  2. Select a Product Pack (Oracle Linux), and Platform (x86 32 bit). Click Go. The Results are displayed.

  3. Select Oracle Linux JeOS for Building Oracle VM templates for x86 (32 bit). Click Continue. Available downloads appear.

  4. Download JeOS Base x86 and x86_64, by clicking Download. The file is downloaded.

  5. Unzip the downloaded zip file.

  6. (As root) install the RPM packages using the rpm command with the -i option.

1.4.2.4 System Base Images

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: http://www.oracle.com/technology/products/ovab

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):

      • nc

      • libaio

      • zip

      • unzip

      • nfs-utils

      • xen-tool

    • In addition, for deploying virtual machines for FMW components, you must have installed:

      • gcc

      • gcc-c++

      • setarch

      • sysstat

      • libaio

      • libaio-devel

      • libstdc++

      • libstdc++-devel

      • compat-libstdc++

      • compat-db

      • control-center

      • glibc-common

      • binutils

      • make

    • For deploying virtual machines for Oracle Database, you must have installed:

      • binutils

      • compat-libstdc++

      • elfutils-libelf

      • elfutils-libelf-devel

      • gcc

      • gcc-c++

      • glibc

      • glibc-common

      • glibc-devel

      • glibc-headers

      • libaio

      • libaio-devel

      • libgcc

      • libstdc++

      • libstdc++-devel

      • make

      • numactl-devel

      • sysstat

      • ksh

    • For FMW components, the following shell parameters must be set:

      • soft=4096

      • hard=4096

    • For Oracle database, the following shell parameters must be set

      • nproc-soft=2047

      • nproc=hard=16384

      • nofile-soft=1024

      • nofile-hard=65536

      • maxproc(ulimit -p)=16384

      • descriptors(ulimit -n)=65536

    • For Oracle database, the following kernel parameters must be set:

      • Semaphore Limits

        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 Descriptors

        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 /etc/pam.d/login file:

        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 /usr/sbin/useradd oracle.

      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
      

      Refer to your modifyjeos documentation for instructions on creating a base image.

    • 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 system.img and 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