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

2 Install

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

2.1 Install Oracle Virtual Assembly Builder

Follow these steps to install and configure Oracle Virtual Assembly Builder.

Note:

These installation instructions are limited to installing Oracle Virtual Assembly Builder on Oracle Enterprise Linux 5 (UL3+). You can adapt them for your local environment.

You can install and configure all at once (recommended) using Oracle Universal Installer, or you can choose to install only and configure at another time.

To start installation, launch Oracle Universal Installer (.Disk1/runInstaller).

2.1.1 Install and Configure

You can choose to install Oracle Virtual Assembly Builder software in an Oracle Home as well as configure an Oracle Virtual Assembly Builder instance Home with various details provided. To install and configure Oracle Virtual Assembly Builder, start the installer, then follow these steps:

  1. Welcome. This page introduces the installation. The flow of installation appears in the left panel, and control buttons appear along the bottom.

    Figure 2-1 Installation Welcome page

    Installation Welcome page
    Description of "Figure 2-1 Installation Welcome page"

    When you are ready to begin installation, click Next. The Install Software Updates page appears.

    Note:

    Help is available on all of the pages. Use it to learn about what you can do in that page, field descriptions, possible values, and other information.
  2. Software Updates. Before continuing with installation, you should ensure that your Oracle software is up to date. You have the option to skip this step by selecting the Skip Software Updates radio button, but only skip updates if you are sure that all of your software is up to date.

    Figure 2-2 Install Software Updates page

    Install Software Updates page
    Description of "Figure 2-2 Install Software Updates page"

    Enter your Oracle Support user name and password, then click Test Connection to test your credentials.

    Click Proxy Settings (optional) if your computer is behind a firewall or a proxy and not in direct contact with the Internet.

    Figure 2-3 Proxy Settings page

    Proxy Settings page
    Description of "Figure 2-3 Proxy Settings page"

    Enter proxy information and test the connection and/or click OK.

    Click Skip Software Updates if you do not want to search for any software updates.

    Click Next. Updates are installed, and the Select Installation Type page appears.

    Figure 2-4 Select Installation Type page

    Installation Types page
    Description of "Figure 2-4 Select Installation Type page"

  3. Installation Type. Use this page to choose whether you want to install and configure at this time, or just to install and configure at a later time. Since this section covers install and configure, choose the Install and Configure radio button, then click Next. The Prerequisite Checks page appears showing the progress of the checks, and listing any deficiencies.

    Figure 2-5 Prerequisite Checks page

    Prerequisites Checks page
    Description of "Figure 2-5 Prerequisite Checks page"

  4. Prerequisites Checks. Checks begin automatically. Progress notes inform you about what is being checked, and what the outcome of the check is. You can abort, retry, or continue checks using the buttons on the page. For example, if a physical memory check fails, you can go and correct the problem, then click Retry to direct Oracle Universal Installer to recheck the item.

    Click Next when the prerequisite checks are complete. The Specify Installation Location page appears.

    Figure 2-6 Specify Installation Location page

    Installation Location page
    Description of "Figure 2-6 Specify Installation Location page"

  5. Specify Installation Location. You can select an existing Oracle Home location, or you can specify a new one. If you want to use a new directory, ensure that the directory is empty.

    Note:

    Existing Oracle Homes:
    • Installing into an existing Oracle Home is limited; that is, users can install only into the same type of Oracle Home (in this case, an OVAB Oracle Home). You cannot install into another type of Oracle Home (such as an Oracle Home for SOA).

    • Installing into an existing Oracle Home is typically done to reinstall binaries, and in some cases, to upgrade an Oracle Home from one release to another.

    • Oracle Universal Installer checks non-empty Oracle Homes to verify that the selected Oracle Home is valid.

    Click Next. The Instance Configuration page appears.

    Figure 2-7 Instance Configuration page

    Instance Configuration page
    Description of "Figure 2-7 Instance Configuration page"

  6. Instance Configuration. Enter, or choose, the Oracle Virtual Assembly Builder Instance Home, and the Oracle Virtual Assembly Builder Java Home.

    Oracle Virtual Assembly Builder Instance Home: The home of an Oracle Virtual Assembly Builder instance.

    Oracle Virtual Assembly Builder Java Home: The Java Home for Oracle Virtual Assembly Builder.

    Note:

    If you start installation without an explicit JRE location, the JAVA_HOME location will default to $ORACLE_HOME/jdk (the location where JDK will be installed). You can change to another JDK location, in which case the JDK will NOT be installed.

    Click Next. The Template Creation Configuration page appears.

    Figure 2-8 Template Creation Configuration page

    Template Creation Configuration page
    Description of "Figure 2-8 Template Creation Configuration page"

  7. Template Creation Configuration. This page enables you to define base images that you will use to create new appliances. On this page, you provide the URIs for the OEL and JRVE Base Images.

    Note:

    When you choose to configure OEL and JRVE base images, Oracle Installer copies a user-provided OEL base image in $AB_INSTANCE/templates/baseImage/OVM/OEL and JRVE base image in the $AB_INSTANCE/templates/baseImage/OVM/JRVE directory. These base images will be available as the default base images for this OVAB instance.

    If you want to have base images shared across all Oracle Virtual Assembly Builder instances, do not select to configure OEL and JRVE base images here and do this after install completes:

    • Create following directories inside $ORACLE_HOME directory:

      $ORACLE_HOME/templates/baseImage/OVM/OEL

      $ORACLE_HOME/templates/baseImage/OVM/JRVE

    • Copy OEL base image files (System.img and vm.cfg) into $ORACLE_HOME/templates/baseImag/OVM/OEL directory

    • Copy JRVE base image files (system.img and vm.cfg) into $ORACLE_HOME/templates/baseImage/OVM/JRVE directory

    Note:

    Base images are stored in either $AB_INSTANCE, or in $ORACLE_HOME. Here is the order of precedence for base image detection:
    • location specified by -baseImage flag

    • $AB_INSTANCE/templates/baseImage/OVM/[JRVE|OEL]

    • $ORACLE_HOME/templates/baseImage/OVM/[JRVE|OEL]

    Configure OEL Base Image: If selected, provide the URI for OEL Base Image.

    Configure JRVE Base Image: If selected, provide the URI for JRVE Base Image.

    After entering (or selecting) the locations, click Next. The Deployer Trust Configuration page appears.

    Figure 2-9 Deployer Trust Configuration page

    Deployer Trust Configuration page
    Description of "Figure 2-9 Deployer Trust Configuration page"

  8. Deployer Trust Configuration. The Deployer uses this keystore to identify trusted servers.

    Enter, and confirm, the password for the Deployer Trust Keystore.

    Click Next. The OVAB Supplied Demo Deployer Identity Options page appears.

    Figure 2-10 Deployer Identity Options page

    Deployer Identity Options page
    Description of "Figure 2-10 Deployer Identity Options page"

  9. Deployer Identity Options. On this page the deployer identity options are required. In order to have a valid SSL connection with Oracle Virtual Machine, the Oracle Virtual Assembly Builder Deployer must provide its identity as part of the connect. You can use your own keystore containing an identity certificate or choose the less secure option of using the Oracle Virtual Assembly Builder-generated self-signed Deployer Identity certificate. The following options are available:

    • Customer Supplied Deployer Identity Keys: Selecting this option uses the custom identity keystore supplied by you. When you choose Customer Supplied Deployer Identity Keys, the Customer Supplied Deployer Identity Keys page appears.

      Note:

      Customer Supplied Deployer Identity Keys is the default keystore option. It is much more secure than using the demo self-signed certificates.

      Figure 2-11 Customer Supplied Deployer Identity Keys page

      Customer Supplied Deployer Identity Keys page
      Description of "Figure 2-11 Customer Supplied Deployer Identity Keys page"

      Enter or select:

      • Path to Existing Deployer Identity Keystore: The location of .jks file.

      • Keystore Type: Defaulted to JKS (User-modifiable)

      • Password for Identity Keystore (enter and confirm)

      • Key Alias: Defaulted to MyKey (User-modifiable)

      • Identity Key (enter and confirm)

    • Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys: Selecting this option uses the self-signed generated identity keystore supplied by the install program; it is less secure than an identity certificate signed by a recognized Certificate Authority. When you select Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys, the Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys page appears.

      Figure 2-12 OVAB Supplied Demo Deployer Identity Keys

      OVAB Supplied Demo Deployer Identity Keys page

      Enter or select:

      • Password for Identity Keystore (enter and confirm)

      • Identity Key (enter and confirm)

      Click Next. The Installation Summary page appears.

      Figure 2-13 Installation Summary page

      Installation Summary page
      Description of "Figure 2-13 Installation Summary page"

  10. Summary. The Installation Summary page lists the components and locations for install.You can save the response file by clicking Save.

    If you want to change any of your installation or configuration choices, you can select the item from the left pane, make the changes, then return to the Summary page.

    Click Install to start the installation process.

  11. Depending on your selections, an Installation Progress page appears with relevant information.

    Figure 2-14 Installation Progress page

    Configuration Progress page
    Description of "Figure 2-14 Installation Progress page"

  12. As installation progresses, a pop-up message will appear, instructing you to run a configuration script. Follow the instructions in the message.

    Figure 2-15 Configuration script pop-up message

    Configuration script pop-up message
    Description of "Figure 2-15 Configuration script pop-up message"

  13. After you run the script, a Configuration Progress page appears.

    Figure 2-16 Configuration Progress page

    Configuration progress page
    Description of "Figure 2-16 Configuration Progress page"

  14. When installation is complete, the Installation Complete page appears.

Figure 2-17 Installation Complete page

Installation Complete page
Description of "Figure 2-17 Installation Complete page"

2.1.2 Install Only

This option is used to install the Oracle Virtual Assembly Builder binaries into an Oracle Home. To install Oracle Virtual Assembly Builder and configure it later, start the installer, then follow these steps:

  1. Welcome. This page introduces the installation. The flow of installation appears in the left panel, and control buttons appear along the bottom.

    When you are ready to begin installation, click Next. The Install Software Updates page appears.

    Figure 2-19 Software Updates page

    Software Updates page
    Description of "Figure 2-19 Software Updates page"

    Note:

    Help is available on all of the pages. Use it to learn about what you can do in that page, field descriptions, possible values, and other information.
  2. Software Updates. Before continuing with installation, you should ensure that your Oracle software is up to date. You have the option to skip this step by selecting the Skip Software Updates radio button, but only skip updates if you are sure that all of your software is up to date.

    Enter your Oracle Support user name and password, then click Test Connection to test your credentials.

    Click Proxy Settings (optional) if your computer is behind a firewall or a proxy and not in direct contact with the Internet.

    Figure 2-20 Proxy Settings page

    Proxy Settings page
    Description of "Figure 2-20 Proxy Settings page"

    Enter proxy information and test the connection and/or click OK.

    Click Next. Updates are installed, and the Select Installation Type page appears.

    Figure 2-21 Select Installation Type page

    Install type page
    Description of "Figure 2-21 Select Installation Type page"

  3. Installation Type. Use this page to choose whether you want to install and configure at this time, or just to install and configure at a later time. Since this section covers install only, choose the Install Software - Do Not Configure radio button.

    A message appears reminding you that you'll need to use manual configuration steps later to configure your software. The Prerequisite Checks page appears.

    Figure 2-22 Prerequisite Checks page

    Prerequisites checks page
    Description of "Figure 2-22 Prerequisite Checks page"

  4. Prerequisites Checks. Checks begin automatically. Progress notes inform you about what is being checked, and what the outcome of the check is. You can abort, retry, or continue checks using the buttons on the page. For example, if a physical memory check fails, you can go and correct the problem, then click Retry to direct Oracle Universal Installer to recheck the item.

    Click Next when the prerequisite checks are complete. The Specify Installation Location page appears.

    Figure 2-23 Specify Installation Location page

    Install location page
    Description of "Figure 2-23 Specify Installation Location page"

  5. Specify Installation Location. You can select an existing Oracle Home location, or you can specify a new one. If you want to use a new directory, ensure that the directory is empty.

    Note:

    Existing Oracle Homes:
    • Installing into an existing Oracle Home is limited; that is, users can install only into the same type of Oracle Home (in this case, an OVAB Oracle Home). You cannot install into another type of Oracle Home (such as an Oracle Home for SOA).

    • Installing into an existing Oracle Home is typically done to reinstall binaries, and in some cases, to upgrade an Oracle Home from one release to another.

    • Oracle Universal Installer checks non-empty Oracle Homes to verify that the selected Oracle Home is valid.

    Click Next. The Installation Summary page appears.

    Figure 2-24 Installation Summary page

    Installation summary page
    Description of "Figure 2-24 Installation Summary page"

  6. Summary. The Installation Summary page lists the components and locations for install.You can save the response file by clicking Save.

    If you want to change any of your installation or configuration choices, you can select the item from the left pane, make the changes, then return to the Installation Summary page.

    Click Install to start the installation process. An Installation Progress page appears with relevant information.

    Figure 2-25 Installation Progress page

    Configuration Progress page
    Description of "Figure 2-25 Installation Progress page"

  7. As installation progresses, a pop-up message will appear, instructing you to run a configuration script. Follow the instructions in the message.

    Figure 2-26 Configuration script pop-up message

    Configuration script pop-up message
    Description of "Figure 2-26 Configuration script pop-up message"

  8. When installation is complete, the Installation Complete page appears.

    Figure 2-27 Installation Complete page

    Description of Figure 2-27 follows
    Description of "Figure 2-27 Installation Complete page"

2.1.3 Configure Only

This Installation option (in which only instance configuration occurs) is available when a user launches the Configuration Wizard after completing a software installation. To begin Configure Only, execute config.sh from the $ORACLE_HOME/bin folder. Follow these steps:

  1. Welcome. This page introduces the installation. The flow of installation appears in the left panel, and control buttons appear along the bottom.

    Figure 2-28 Installation Welcome page

    Welcome page
    Description of "Figure 2-28 Installation Welcome page"

    When you are ready to begin installation, click Next. The Instance Configuration page appears.

    Note:

    Help is available on all of the pages. Use it to learn about what you can do in that page, field descriptions, possible values, and other information.
    Instance Configuration page
    Description of the illustration instanceconfigconfigonly.gif

  2. Instance Configuration. Enter, or choose, the Oracle Virtual Assembly Builder Instance Home, and the Oracle Virtual Assembly Builder Java Home.

    Oracle Virtual Assembly Builder Instance Home: The home of an Oracle Virtual Assembly Builder instance.

    Oracle Virtual Assembly Builder Java Home: The Java Home for Oracle Virtual Assembly Builder.

    Note:

    If you start installation without an explicit JRE location, the JAVA_HOME location will default to $ORACLE_HOME/jdk (the location where JDK will be installed). You can change to another JDK location, in which case the JDK will NOT be installed.

    Click Next. The Template Creation Configuration page appears.

    Figure 2-29 Template Creation Configuration page

    Template configuration page
    Description of "Figure 2-29 Template Creation Configuration page"

  3. Template Creation Configuration. This page enables you to define base images that you will use to create new appliances. On this page, you provide the URIs for the OEL and JRVE Base Images.

    Note:

    When you choose to configure OEL and JRVE base images, Oracle Installer copies a user-provided OEL base image in $AB_INSTANCE/templates/baseImage/OVM/OEL and JRVE base image in the $AB_INSTANCE/templates/baseImage/OVM/JRVE directory. These base images will be available as the default base images for this OVAB instance.

    If you want to have base images shared across all Oracle Virtual Assembly Builder instances, do not select to configure OEL and JRVE base images here and do this after install completes:

    • Create following directories inside $ORACLE_HOME directory:

      $ORACLE_HOME/templates/baseImage/OVM/OEL

      $ORACLE_HOME/templates/baseImage/OVM/JRVE

    • Copy OEL base image files (System.img and vm.cfg) into $ORACLE_HOME/templates/baseImag/OVM/OEL directory

    • Copy JRVE base image files (system.img and vm.cfg) into $ORACLE_HOME/templates/baseImage/OVM/JRVE directory

    Note:

    Base images are stored in either $AB_INSTANCE, or in $ORACLE_HOME. Here is the order of precedence for base image detection:
    • location specified by -baseImage flag

    • $AB_INSTANCE/templates/baseImage/OVM/[JRVE|OEL]

    • $ORACLE_HOME/templates/baseImage/OVM/[JRVE|OEL]

    Configure OEL Base Image: If selected, provide the URI for OEL Base Image.

    Configure JRVE Base Image: If selected, provide the URI for JRVE Base Image.

    After entering (or selecting) the locations, click Next. The Deployer Trust Configuration page appears.

    Figure 2-30 Deployer Trust Configuration page

    Deployer trust configuration page
    Description of "Figure 2-30 Deployer Trust Configuration page"

  4. Deployer Trust Configuration. The Deployer uses this keystore to identify trusted servers.

    Enter, and confirm, the password for the Deployer Trust Keystore.

    On this page the deployer identity options are required. When the code running in Oracle Virtual Machine connects to the Oracle Virtual Assembly Builder Deployer using https to retrieve templates and pass phone home information, the Deployer's https server must pass its identity to the client. You can use the Oracle Virtual Assembly Builder-generated Deployer Identity (signed by the root certificate) or supply your own keystore. The following options are available:

    • Customer Supplied Deployer Identity Keys: Selecting this option uses the custom identity keystore supplied by the customer. The keystore details are asked in a subsequent screen. This option will be the default option in the screen.

    • Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys: Selecting this option uses the self-signed generated identity keystore supplied by the install program; it is less secure than an identity certificate signed by a recognized Certificate Authority.

    Click Next. The OVAB Supplied Demo Deployer Identity Keys page appears.

    Figure 2-31 OVAB Supplied Demo Deployer Identity Keys page

    OVAB Demo Deployer Keys page
    Description of "Figure 2-31 OVAB Supplied Demo Deployer Identity Keys page"

  5. Demo Deployer Identity Keys. This screen will appear only if you selected Customer Supplied Deployer Identity Keys in the previous screen. The Keystores are used by the Deployer to store SSL credentials. Select Customer Supplied Deployer Identity Keys (default), or Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys.

    After choosing your option, click Next. Depending on which option you chose, different pages will appear (for Customer-Supplied or OVAB-Supplied).

    If you choose Customer Supplied Deployer Identity Keys enter or select:

    • Path to Existing Deployer Identity Keystore: The location of .jks file.

    • Keystore Type: Defaulted to JKS (User-modifiable)

    • Password for Identity Keystore (enter and confirm)

    • Key Alias: Defaulted to MyKey (User-modifiable)

    • Identity Key (enter and confirm)

    If you choose Oracle Virtual Assembly Builder Supplied Demo Deployer Identity Keys enter or select:

    • Password for Identity Keystore (enter and confirm)

    • Identity Key (enter and confirm)

    Click Next. The Installation Summary page appears.

    Figure 2-32 Installation Summary page

    Installation Summary page
    Description of "Figure 2-32 Installation Summary page"

  6. Summary. The Installation Summary page lists the components and locations for install.You can save the response file by clicking Save.

    If you want to change any of your installation or configuration choices, you can select the item from the left pane, make the changes, then return to the Summary page.

    Click Configure to start the configuration process.

  7. A Configuration Progress page appears.

    Figure 2-33 Configuration Progress page

    Configuration Progress age
    Description of "Figure 2-33 Configuration Progress page"

  8. When installation is complete, the Installation Complete page appears.

    Figure 2-34 Installation Complete page

    Installation Complete page
    Description of "Figure 2-34 Installation Complete page"

2.1.4 Silent Installation

Silent installation is supported with a set of response files covering all user inputs. The templates of silent response files are provided in the Disk1/stage/Response folder.

Silent Installation is launched by executing

/runInstaller -silent -responseFile <absolute path to response file>

2.2 Deinstall

To deinstall Oracle Virtual Assembly Builder, execute this command:

$ORACLE_HOME/oui/bin/runInstaller –deinstall

In silent mode:

$ORACLE_HOME/oui/bin/runInstaller -deinstall -silent -responseFile <absolute path of response file>

When you execute the deinstall command, Oracle Universal Installer starts. The Welcome page appears.

Figure 2-35 Deinstall Welcome page

Deinstall Welcome page
Description of "Figure 2-35 Deinstall Welcome page"

  1. Click Next. The Select Deinstallation Type page appears.

    Figure 2-36 Select Deinstallation Type page

    Select Deinstallation Type page
  2. Depending on what you want to deinstall, different pages will appear.

  3. When the deinstallation progress is complete, click Finish. The Deinstallation Complete page appears.

    Figure 2-42 Deinstallation Complete page

    Deinstallation Complete page
    Description of "Figure 2-42 Deinstallation Complete page"

  4. When deinstallation is complete, the Deinstallation Complete page appears. Click Finish.