Contents

Title and Copyright Information

Preface

• Audience
• What's New in This Release
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction

• 1.1 Introduction to Oracle Virtual Assembly Builder
  • 1.1.1 What is Virtualization?
  • 1.1.2 Middleware Virtualization Challenges
  • 1.1.3 What is Oracle Virtual Assembly Builder?
  • 1.1.4 Software Appliances
  • 1.1.5 Software Assemblies
  • 1.1.6 The Role of Oracle Virtual Assembly Builder
  • 1.1.7 Using Oracle Virtual Assembly Builder
    • 1.1.7.1 Introspect
    • 1.1.7.2 Configure
    • 1.1.7.3 Prepare
    • 1.1.7.4 Deploy
• 1.2 Understanding Oracle Virtual Assembly Builder
  • 1.2.1 Appliances and Assemblies
  • 1.2.2 External Appliances
  • 1.2.3 Introspection
  • 1.2.4 Catalog
  • 1.2.5 External Resources
  • 1.2.6 Packaging
  • 1.2.7 Virtual Machine Templates
  • 1.2.8 Resource Managers and Resource Pools
  • 1.2.9 Deployment Plans
  • 1.2.10 Deployment Life Cycle

2 Using Oracle Virtual Assembly Builder

• 2.1 Oracle Virtual Assembly Builder Interfaces
  • 2.1.1 Accessing Oracle Virtual Assembly Builder Studio
  • 2.1.2 Accessing the abctl Command-Line Tool
  • 2.1.3 Differences Between the Interfaces
  • 2.1.4 Naming Rules
    • 2.1.4.1 Resolving Naming Conflicts
  • 2.1.5 Symbolic Links
• 2.2 Typical Workflow
• 2.3 Oracle Virtual Assembly Builder Operations
  • 2.3.1 Introspect a Reference System
    • 2.3.1.1 No Support for Mounted NFS File Systems
    • 2.3.1.2 Custom Reconfiguration Scripts
    • 2.3.1.3 Introspect Using Oracle Virtual Assembly Builder Studio
    • 2.3.1.4 Introspect Additional Appliances
    • 2.3.1.5 Introspect Using abctl
  • 2.3.2 Package an Appliance or an Assembly
    • 2.3.2.1 File Permission Considerations During Packaging
    • 2.3.2.2 Package Using Oracle Virtual Assembly Builder Studio
    • 2.3.2.3 Package Using abctl
  • 2.3.3 Create Templates for an Appliance or an Assembly
    • 2.3.3.1 Create Templates Using Oracle Virtual Assembly Builder Studio
    • 2.3.3.2 Create Templates Using abctl
  • 2.3.4 Edit an Assembly
    • 2.3.4.1 Edit an Assembly Using Oracle Virtual Assembly Builder Studio
  • 2.3.5 Create a Deployment Plan
    • 2.3.5.1 Create a Deployment Plan Using Oracle Virtual Assembly Builder Studio
  • 2.3.6 Create a Resource Pool Connection
    • 2.3.6.1 Create a Resource Pool Connection Using Oracle Virtual Assembly Builder Studio
  • 2.3.7 Register a Template
    • 2.3.7.1 Register Templates Using Oracle Virtual Assembly Builder Studio
    • 2.3.7.2 Register Templates with abctl
  • 2.3.8 Deploy an Assembly
    • 2.3.8.1 Deploy Using Oracle Virtual Assembly Builder Studio
    • 2.3.8.2 Deploy Using abctl
  • 2.3.9 Stop a Deployment
    • 2.3.9.1 Stop an Assembly with Oracle Virtual Assembly Builder Studio
    • 2.3.9.2 Stop an Assembly with abctl
  • 2.3.10 Start a Deployment
    • 2.3.10.1 Start a Deployment with Oracle Virtual Assembly Builder Studio
    • 2.3.10.2 Start a Deployment with abctl
  • 2.3.11 Scale Appliance(s) in a Deployment
    • 2.3.11.1 Scale Appliance(s) in a Deployment with Oracle Virtual Assembly Builder Studio
    • 2.3.11.2 Scale Appliance(s) in a Deployment with abctl
  • 2.3.12 Undeploy a Deployment
    • 2.3.12.1 Undeploy a Deployment with Oracle Virtual Assembly Builder Studio
    • 2.3.12.2 Undeploy a Deployment with abctl
  • 2.3.13 Unregister Template(s) of an Assembly
    • 2.3.13.1 Unregistering Templates with Oracle Virtual Assembly Builder Studio
    • 2.3.13.2 Unregistering Templates with abctl
  • 2.3.14 Export an Appliance or Assembly from a Catalog
    • 2.3.14.1 Exporting an Appliance or Assembly from a Catalog Using Oracle Virtual Assembly Builder Studio
    • 2.3.14.2 Exporting an Appliance or Assembly from a Catalog Using abctl
  • 2.3.15 Import an Appliance or Assembly to a Catalog
    • 2.3.15.1 Importing an Appliance or Assembly to a Catalog Using Oracle Virtual Assembly Builder Studio
    • 2.3.15.2 Importing an Appliance or Assembly Using abctl
    • 2.3.15.3 Importing an External VM Template

A Command Line Reference

• A.1 Commands
  • A.1.1 checkResources
    • A.1.1.1 Synopsis
    • A.1.1.2 Description
    • A.1.1.3 Options
    • A.1.1.4 Examples
  • A.1.2 createTemplate
    • A.1.2.1 Synopsis
    • A.1.2.2 Description
    • A.1.2.3 Options
    • A.1.2.4 Examples
  • A.1.3 delete
    • A.1.3.1 Synopsis
    • A.1.3.2 Description
    • A.1.3.3 Options
    • A.1.3.4 Examples
  • A.1.4 deploy
    • A.1.4.1 Synopsis
    • A.1.4.2 Description
    • A.1.4.3 Options
    • A.1.4.4 Examples
  • A.1.5 export
    • A.1.5.1 Synopsis
    • A.1.5.2 Description
    • A.1.5.3 Options
    • A.1.5.4 Examples
  • A.1.6 help
    • A.1.6.1 Synopsis
    • A.1.6.2 Description
    • A.1.6.3 Options
    • A.1.6.4 Examples
  • A.1.7 import
    • A.1.7.1 Synopsis
    • A.1.7.2 Description
    • A.1.7.3 Options
    • A.1.7.4 Examples
  • A.1.8 importExternalTemplate
    • A.1.8.1 Synopsis
    • A.1.8.2 Description
    • A.1.8.3 Options
    • A.1.8.4 Examples
  • A.1.9 introspectCoherenceWeb
    • A.1.9.1 Synopsis
    • A.1.9.2 Description
    • A.1.9.3 Options
    • A.1.9.4 Examples
  • A.1.10 introspectOHS
    • A.1.10.1 Synopsis
    • A.1.10.2 Description
    • A.1.10.3 Options
    • A.1.10.4 Examples
  • A.1.11 introspectSIDB
    • A.1.11.1 Synopsis
    • A.1.11.2 Description
    • A.1.11.3 Options
    • A.1.11.4 Examples
  • A.1.12 introspectWebCache
    • A.1.12.1 Synopsis
    • A.1.12.2 Description
    • A.1.12.3 Options
    • A.1.12.4 Examples
  • A.1.13 introspectWLS
    • A.1.13.1 Synopsis
    • A.1.13.2 Description
    • A.1.13.3 Extensions
    • A.1.13.4 Options
    • A.1.13.5 Examples
  • A.1.14 list
    • A.1.14.1 Synopsis
    • A.1.14.2 Description
    • A.1.14.3 Options
    • A.1.14.4 Examples
  • A.1.15 listDeployments
    • A.1.15.1 Synopsis
    • A.1.15.2 Description
    • A.1.15.3 Options
    • A.1.15.4 Examples
  • A.1.16 listDeploymentPlans
    • A.1.16.1 Synopsis
    • A.1.16.2 Description
    • A.1.16.3 Options
    • A.1.16.4 Examples
  • A.1.17 listResourceManagers
    • A.1.17.1 Synopsis
    • A.1.17.2 Description
    • A.1.17.3 Options
    • A.1.17.4 Examples
  • A.1.18 listTemplates
    • A.1.18.1 Synopsis
    • A.1.18.2 Description
    • A.1.18.3 Options
    • A.1.18.4 Examples
  • A.1.19 package
    • A.1.19.1 Synopsis
    • A.1.19.2 Description
    • A.1.19.3 Options
    • A.1.19.4 Examples
  • A.1.20 registerTemplates
    • A.1.20.1 Synopsis
    • A.1.20.2 Description
    • A.1.20.3 Options
    • A.1.20.4 Examples
  • A.1.21 scaleAppliance
    • A.1.21.1 Synopsis
    • A.1.21.2 Description
    • A.1.21.3 Options
    • A.1.21.4 Examples
  • A.1.22 start
    • A.1.22.1 Synopsis
    • A.1.22.2 Description
    • A.1.22.3 Options
    • A.1.22.4 Examples
  • A.1.23 stop
    • A.1.23.1 Synopsis
    • A.1.23.2 Description
    • A.1.23.3 Options
    • A.1.23.4 Examples
  • A.1.24 undeploy
    • A.1.24.1 Synopsis
    • A.1.24.2 Description
    • A.1.24.3 Options
    • A.1.24.4 Examples
  • A.1.25 unregisterTemplates
    • A.1.25.1 Synopsis
    • A.1.25.2 Description
    • A.1.25.3 Options
    • A.1.25.4 Examples
  • A.1.26 Version
    • A.1.26.1 Synopsis
    • A.1.26.2 Description
    • A.1.26.3 Example
• A.2 Help
  • A.2.1 Synopsis
  • A.2.2 Description
  • A.2.3 Options
  • A.2.4 Examples
    • A.2.4.1 No Arguments
    • A.2.4.2 Help with a -command parameter specified
    • A.2.4.3 Help with a -command parameter specified and -usage flag specified
• A.3 Command Quick Reference

B Oracle Virtual Assembly Builder Introspection Plug-ins

• B.1 Oracle WebLogic Server Plug-in
  • B.1.1 Versions Supported
  • B.1.2 Oracle WebLogic Server Introspection Parameters
  • B.1.3 Reference System Prerequisites
  • B.1.4 Requirements
    • B.1.4.1 Oracle WebLogic Server Domain Requirements
    • B.1.4.2 Requirement for Remote User Specified for Remote Introspection of Oracle WebLogic Server
    • B.1.4.3 Requirements for SSL Certificate and Hostname Validation
    • B.1.4.4 Requirement to Update Applications Accessing Web Services
    • B.1.4.5 Requirement Not to Create Templates on Individual Servers
    • B.1.4.6 Requirement to Specify Admin URL When Managed Server Not Running
  • B.1.5 Resulting Artifact Type
  • B.1.6 Wiring
  • B.1.7 Wiring Properties
  • B.1.8 Oracle WebLogic Server Appliance Properties
    • B.1.8.1 Assembly-Level System Properties
    • B.1.8.2 Properties Common to Admin and Managed Server Appliances
    • B.1.8.3 Admin Server Appliance Properties
  • B.1.9 Extensions of the Plugin
  • B.1.10 Supported Template Types
• B.2 Oracle Coherence*Web Extension
  • B.2.1 Versions Supported
  • B.2.2 Oracle Coherence*Web Introspection Parameters
  • B.2.3 Reference System Prerequisites
  • B.2.4 Requirements
    • B.2.4.1 Deployment Model Requirement
    • B.2.4.2 Requirement to Manually Update Custom Cluster Configuration Files
  • B.2.5 Resulting Artifact Type
  • B.2.6 Wiring
  • B.2.7 Wiring
  • B.2.8 Oracle Coherence*Web Appliance Properties
  • B.2.9 Supported Template Types
• B.3 Oracle HTTP Server Introspector Plug-in
  • B.3.1 Oracle HTTP Server Introspection Parameters
  • B.3.2 Resulting Artifact Type
  • B.3.3 Wiring
  • B.3.4 Wiring Properties
  • B.3.5 Oracle HTTP Server Appliance Properties
  • B.3.6 Extensions of the Plug-in
  • B.3.7 Supported Template Types
• B.4 Oracle Web Cache Plug-in
  • B.4.1 Versions Supported
  • B.4.2 Oracle Web Cache Introspection Parameters
  • B.4.3 Reference System Prerequisites
  • B.4.4 Requirements
    • B.4.4.1 Requirement to Update Virtual Host Map Properties
  • B.4.5 Resulting Artifact Type
  • B.4.6 Wiring
  • B.4.7 Wiring Properties
  • B.4.8 Oracle Web Cache Appliance Properties
  • B.4.9 Extensions of the Plug-in
  • B.4.10 Supported Template Types
• B.5 Oracle Database Plug-in
  • B.5.1 Versions Supported
  • B.5.2 Oracle Database Introspection Parameters
  • B.5.3 Reference System Prerequisites
  • B.5.4 Requirements
    • B.5.4.1 Database Configuration Support
  • B.5.5 Resulting Artifact Type
  • B.5.6 Wiring
  • B.5.7 Wiring Properties
  • B.5.8 Oracle Database Appliance Properties
  • B.5.9 Extensions of the Plug-in
  • B.5.10 Supported Template Types

C Common Properties for Oracle Virtual Assembly Builder Components

• C.1 Common Properties
• C.2 System Properties
• C.3 External Resource Properties
  • C.3.1 Common Properties
  • C.3.2 foreignJMS Properties
  • C.3.3 jmsBridgeDestination Properties
  • C.3.4 LDAP Properties
  • C.3.5 Non-Oracle JDBC Properties
  • C.3.6 JDBC Properties
• C.4 Deployer Properties

D Third-Party Licensing

• D.1 Velocity
  • D.1.1 Apache License Version 2.0
• D.2 Java Secure Channel (JSCH) for SSH2

Index