3 Installing Oracle Virtual Assembly Builder

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

3.1 Understanding the Installation Environment

Oracle Virtual Assembly Builder must be installed into an existing Oracle Home, where Application Development Framework (ADF) is installed. Note this Oracle Home, and specify it when installing Oracle Virtual Assembly Builder. See Installing and Configuring the Oracle Fusion Middleware Infrastructure for more information.

3.2 Configuring Secure Communications to Oracle VM Manager

To allow Oracle Virtual Assembly Builder to communicate securely with Oracle VM Manager, you must configure the Java Secure Socket Extension (JSSE) WebLogic SSL implementation. As of WebLogic Server version 12.1.1, JSSE is the only SSL implementation that is supported.

For information on configuring JSSE in previous versions of WebLogic Server, see "Using the JSSE-Based SSL Implementation" in Securing Oracle WebLogic Server.

3.3 Installing 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.

To start installation, launch the installer by calling java -jar ovab_121200.jar. The required Java version is 1.7.

3.3.1 Install and Configure

You can install Oracle Virtual Assembly Builder software in an Oracle Home, and optionally 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. Specify Inventory Directory. This page allows you to specify a directory for installer files. This is called the inventory directory. Within the inventory directory, the installer automatically sets up subdirectories for each product to contain inventory data and will consume typically 150 Kilobytes per product.

    Enter the full path of the inventory directory.

    You can specify an Operating System group that has write permissions to the above directory.

    When you are ready to continue, click OK. A dialog appears warning you that you perform certain actions with root privileges before the installation can continue.

    If you have root privileges, use another window to execute the script createCentralInventory.sh from the inventory directory you specified. When finished, click OK.

    If you do not have root privileges, and want to continue the installation, check the Continue installation with local inventory box and click OK.

  2. 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 Installation Location 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.

  3. Figure 3-2 Installation Location page

    Installation Location page
    Description of "Figure 3-2 Installation Location page"

  4. Installation Location. Specify the Oracle Home directory.

    Select the existing Oracle Home location where you installed Application Development Framework (ADF). The installer checks to verify that the selected Oracle Home is valid.

    Click View to view the installed feature sets for an Oracle Home.

    Click Next. The Installation Type page appears.

    Figure 3-3 Installation Type page

    Instance Type page
    Description of "Figure 3-3 Installation Type page"

  5. Installation Type. Select the installation type as follows:

    • Studio and Deployer installation: install both Oracle Virtual Assembly Builder Studio and Oracle Virtual Assembly Builder Deployer.

    • Studio installation: install only Oracle Virtual Assembly Builder Studio, which provides you the ability to create appliances and assemblies, create appliance templates and assembly archives and create deployment plans.

    • Deployer installation: install only Oracle Virtual Assembly Builder Deployer, which provides the ability to configure deployment targets, upload assembly archives to Deployer, create assembly instances, deploy/undeploy/start/stop assembly instances and scale appliance instances.

    Click Next. The Prerequisite Check page appears showing the progress of the checks, and listing any deficiencies.

    Figure 3-4 Prerequisite Checks page

    Prerequisite Checks page
    Description of "Figure 3-4 Prerequisite Checks page"

  6. Prerequisite 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 the installer to recheck the item.

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

    Figure 3-5 Installation Summary page

    Installation Summary page
    Description of "Figure 3-5 Installation Summary page"

  7. Installation 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.

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

    Figure 3-6 Installation Progress page

    Installation Progress page
    Description of "Figure 3-6 Installation Progress page"

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

    Figure 3-7 Installation Complete page

    Installation Complete page
    Description of "Figure 3-7 Installation Complete page"

  10. Run the script $OH/oracleRoot.sh as root.

  11. If you installed Oracle Virtual Assembly Builder Studio, check Automatically Launch the Configuration Wizard to Create Studio instance, and configure the Studio instance using the procedures in Section 3.3.2, "Configure Oracle Virtual Assembly Builder Studio Instance".

  12. If you installed Oracle Virtual Assembly Builder Deployer, check Automatically Launch the Configuration Wizard to Create Deployer domain, and configure the Deployer using the procedures in Chapter 4, "Configuring Oracle Virtual Assembly Builder Deployer".

  13. Click Finish.

3.3.2 Configure Oracle Virtual Assembly Builder Studio Instance

The configuration wizard launches automatically after you select the Automatically Launch the Configuration Wizard to Create Studio instance option upon completing the Oracle Virtual Assembly Builder installation.

The Welcome page appears.

  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 the instance configuration, click Next. The Instance Configuration page appears.

    Figure 3-9 Instance Configuration page

    Installation Configuration page
    Description of "Figure 3-9 Instance Configuration page"

  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. You can change to another JDK location.

    Click Next. The Template Creation Configuration page appears.

    Figure 3-10 Template Creation Configuration page

    Template Creation Configuration page
    Description of "Figure 3-10 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 URI for the Oracle Enterprise Linux Base Image for Oracle VM.

    Note:

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

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

    • Create following directories inside $ORACLE_HOME directory:

      $ORACLE_HOME/templates/baseImage/OVM/OEL

    • Copy OEL base image files (System.img and vm.cfg) into $ORACLE_HOME/templates/baseImag/OVM/OEL 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/OEL

    • $ORACLE_HOME/templates/baseImage/OVM/OEL

    Configure Oracle Enterprise Linux Base Image: If selected, provide the URI for the OEL Base Image for Oracle VM.

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

    Figure 3-11 Deployer Trust Configuration page

    Deployer Trust Configuration page
    Description of "Figure 3-11 Deployer Trust Configuration page"

  4. Deployer Trust Configuration. Oracle Virtual Assembly Builder Studio uses the keystore as a client when connecting to Oracle Virtual Assembly Builder Deployer over HTTPS. This keystore will be populated with the Oracle Virtual Assembly Builder Deployer's WebLogic certificate when you configure an Oracle Virtual Assembly Builder Deployer connection.

    The password protects the keystore from tampering.

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

    Click Next. The Deployer Connection Configuration page appears.

    Figure 3-12 Deployer Connection Configuration page

    Deployer Connection Configuration page
    Description of "Figure 3-12 Deployer Connection Configuration page"

  5. Deployer Connection Configuration. You can configure a connection to Oracle Virtual Assembly Builder Deployer. If you have not already configured the Oracle Virtual Assembly Builder Deployer using the procedures in the next chapter, Configuring Oracle Virtual Assembly Builder Deployer, you must specify an existing Deployer.

    To configure the connection, check Configure Studio to Deployer Connection and enter the connection information:

    • Connection Name: name of the Deployer connection.

    • Deployer URL: URL of the Deployer Web service.

    • User Name: username to use to authenticate with the Deployer Web service.

    • Password: password to use to authenticate with the Deployer Web service.

    Click Next.

    If you configured a connection, the connection is tested. If you see a connection failure, check that the Oracle Middleware Administration Server is up, and hostname, username, and password are correctly configured.

    The Installation Summary page appears.

  6. Installation 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 Next. The Configuration Progress page appears.

    Figure 3-13 Configuration Progress page

    Configuration Progress page
    Description of "Figure 3-13 Configuration Progress page"

  7. Configuration Progress. This page shows the progress of the instance configuration.

    Figure 3-14 Installation Complete page

    Installation Complete page
    Description of "Figure 3-14 Installation Complete page"

    Click Next. The Configuration Complete page appears. You have completed configuring the Oracle Virtual Assembly Builder Studio instance.

3.3.3 Silent Installation

Silent installation is supported with a set of response files covering all user inputs.

Silent Installation is launched by executing

java -jar ovab_121200.jar -silent -force -responseFile <absolute path to response file>

3.4 Deinstalling

To deinstall Oracle Virtual Assembly Builder, execute this command:

$ORACLE_HOME/oui/bin/deinstall.sh

When you execute deinstall.sh, the deinstallation process starts, and the Distribution to Deinstall page appears.

Figure 3-15 Distribution to Deinstall page

Distribution to Deinstall page
Description of "Figure 3-15 Distribution to Deinstall page"

  1. Select Oracle_Virtual_Assembly_Builder 12.1.2.0.0 and click Deinstall. This action launches the Oracle Fusion Middleware deinstallation wizard and the Welcome page appears.

  2. Click Next. The Deinstallation Summary page appears.

    Figure 3-17 Deinstallation Summary page

    Deinstallation summary page
    Description of "Figure 3-17 Deinstallation Summary page"

  3. Click Deinstall. The Deinstallation Progress page appears. The deinstallation progress is marked by a percentage bar.

    Figure 3-18 Deinstallation Progress page

    Deinstallation Progress page
    Description of "Figure 3-18 Deinstallation Progress page"

  4. When the deinstallation progress is complete (marked by 100% progress, and a check mark for the 'Deinstall' task), click Finish. If you receive errors, click View Log to see a detailed log of the deinstallation.

    The Deinstallation Complete page appears.

    Figure 3-19 Deinstallation Complete

    Deinstallation Complete page
    Description of "Figure 3-19 Deinstallation Complete"

  5. The Deinstallation Complete page lists the feature sets that you have successfully deinstalled. Click Finish.