Deploying Assemblies in an Exalogic vDC Using the OVAB Deployer

This section contains the following topics:

Configuring a User and Connection for OVAB Deployer on Exalogic

When OVAB Deployer is installed in the Exalogic Controller vServer in an Exalogic vDC, a single target (named exalogic) is preconfigured. In addition, a default security realm is created in the Oracle WebLogic Server that hosts the OVAB Deployer application. The required OVAB-specific user groups—Application Admins and Cloud Admins—are preconfigured in the default security realm.

Before using OVAB Deployer on Exalogic, complete the following steps:

  1. In the Exalogic vDC, identify the following:

    • A Cloud User that you want to use to access the OVAB Deployer.

      Note:

      If you want more than one Cloud User to be able to access the OVAB Deployer, you must repeat the procedure described in this section separately for each such user.

    • The UUID of an account to which the selected user is assigned.

      This account that will be used for deploying assemblies, and the resulting vServers will be displayed in the Exalogic Control BUI under this account.

    To find out the UUID of an account in the Exalogic vDC, do the following:

    1. Log in to the Exalogic Control browser user interface (BUI) as a Cloud Admin user.

      The URL for the Exalogic Control BUI is:

      https://ec-vm/emoc

      In this URL, ec-vm is the IP address of the Exalogic Control VM on the EoIB-external-mgmt network on the Exalogic machine.

    2. In the navigation pane on the left, expand vDC Management, expand the name of the vDC (say, MyCloud), and select Accounts.

      The available accounts are listed in the main pane.

    3. Hover the mouse pointer over the name of the account for which you want to find the UUID.

      The resulting display box shows the details of the account, including its UUID (example: ACC-bbc4ea03-70c5-4fe8-8148-8e770e1b2ec2).

    If you want to use a new Cloud User and a new account, create the required user and account as described in Creating and Managing Users and Roles, and assign the user to the account, as described in Establishing Cloud Accounts.

  2. Create a user in the Oracle WebLogic Server that hosts the OVAB Deployer on Exalogic:

    1. Log in to the Oracle WebLogic Server Administration Console as the weblogic user with the administration password. If you do not know the password for the weblogic user, contact Oracle Support.

      The URL for the Oracle WebLogic Server Administration Console is:

      http://ec-vm:9001/console/login/LoginForm.jsp

      In this URL, ec-vm is the IP address of the Exalogic Control VM on the EoIB-external-mgmt network on the Exalogic machine.

    2. Create a user, as described in "Create users" in the Oracle WebLogic Server Administration Console Online Help.

    3. Assign the new user to the Application Admins group, as described in "Add users to groups" in the Oracle WebLogic Server Administration Console Online Help.

    The Oracle WebLogic Server Administration Console Online Help is available at:

    http://docs.oracle.com/cd/E23943_01/apirefs.1111/e13952/core/index.html

  3. Create a connection from an OVAB Studio installation to OVAB Deployer running on Exalogic:

    $ abctl createDeployerConnection -name connection_name -url http://ec-vm:9001 -username wls_user

    • wls_user is the user that you created in step 2.

    • connection_name is the name of the connection that you are creating.

    • ec-vm is the IP address of the Exalogic Control VM on the EoIB-external-mgmt network on the Exalogic machine.

    A prompt to enter the password is displayed. Enter the password that you defined while creating the user in step 2.

  4. From the OVAB Studio installation, add the user (that you created in step 2) to the preconfigured target named exalogic:

    $ abctl addTargetUser -connectionName connection_name -user wls_user
 -target exalogic -properties exalogic.user=cloud_user
 exalogic.pwd=cloud_user_password exalogic.tenancy=account_UUID

    • connection_name is the connection that you defined in step 3.

    • wls_user is the user that you created in step 2.

    • cloud_user is the user that you identified (or created) in step 1.

    • cloud_user_pasword is the password for the user you identified (or created) in step 1.

    • account_UUID is the UUID of the account to which the specified Cloud User is assigned, as identified in step 1.

  5. Verify the configuration by running the following command:

    $ abctl describeTargets -connectionName connection_name

    This command displays the name, type, and status of the exalogic target. It also displays information about the available networks, volumes, and memory.

Accessing the OVAB Deployer Interfaces

OVAB Deployer provides a web console and a command-line interface (CLI) for deploying assemblies on Exalogic.

Note:

You can also use OVAB Studio and OVAB web-service APIs for the deployer operations. For more information, see the following documentation:

Accessing the OVAB Deployer Web Console

To access the web console for OVAB Deployer on Exalogic, do the following:

  1. Ensure that a user and connection have been configured for OVAB Deployer as described in Configuring a User and Connection for OVAB Deployer on Exalogic.
  2. Go to the following URL: 
    http://ec-vm:9001/ovab/login.jsp

    In this URL, ec-vm is the IP address of the Exalogic Control VM on the EoIB-external-mgmt network on the Exalogic machine.

    The login page is displayed.

  3. Specify the user name and password that you defined earlier, as described in step 2 of Configuring a User and Connection for OVAB Deployer on Exalogic.

On the resulting page, you can perform the assembly deployment operations. For more information, see Using the OVAB Deployer Web Console.

Using OVAB Deployer-Related abctl CLI Commands

To run OVAB Deployer-related abctl CLI commands, you must use the OVAB Studio installation from which you defined a connection to OVAB Deployer on Exalogic as described in step 3 of Configuring a User and Connection for OVAB Deployer on Exalogic.

The abctl commands that are available for OVAB Deployer on Exalogic are the same as the commands that are available in a deployer-only installation of the generally available OVAB Deployer release, except for the differences noted in Differences Between the Generally Available OVAB Release and OVAB Deployer 11.1.1.6.2.

For more information about the OVAB Deployer-related abctl commands, see "Command Line Reference" in the Oracle Virtual Assembly Builder User's Guide.

You can also view help for individual commands directly at the console, by running the following command:

./abctl help -command command

Assembly Deployment Workflow

Table 11-2 provides an overview of the typical workflow for deploying an assembly in an Exalogic vDC by using the OVAB Deployer, and contains pointers to the sections describing the procedures for performing the tasks in the workflow by using the OVAB Deployer web console. The table also lists the abctl CLI commands that you can use to perform the deployment tasks. For more information about the CLI commands, see the Oracle Virtual Assembly Builder User's Guide.

Note that, before deploying an assembly, you must create a deployment plan. For more information, see "Operations Related to Deployment" in the Oracle Virtual Assembly Builder User's Guide.

Table 11-2 Assembly Deployment Workflow

Workflow Sequence Task Procedure Using the Web Console CLI Command/s

1

Upload the assembly archive to the OVAB Deployer on Exalogic.

Uploading an Assembly Archive

uploadAssemblyArchive

2

Register the assembly with the Exalogic target.

Registering an Assembly Archive

registerAssemblyArchive

3

Create an assembly instance.

Create an Assembly Instance

createAssemblyInstance

4

Deploy the assembly instance.

Deploying an Assembly Instance

deployAssemblyInstance

5

Start, stop, restart, or redeploy the assembly instance.

Starting, Stopping, Restarting, and Redeploying Assembly Instances

startAssemblyInstance

stopAssemblyInstance

restartAssemblyInstance

redeployAssemblyInstance

6

Scale appliances.

Scaling an Appliance

scale

Using the OVAB Deployer Web Console

This section describes the procedures to perform various assembly lifecycle-related tasks by using the OVAB Deployer web console.

This section contains the following subsections:

Viewing a List of Uploaded Assembly Archives

To view a list of assembly archives that are currently uploaded to the OVAB Deployer, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Archives tab.

Uploading an Assembly Archive

To upload an assembly archive to OVAB Deployer, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Archives tab.
  3. Click the Upload button on the toolbar.
  4. On the resulting page, specify a name and description for the archive, and the location, on the local host, of the archive file.
  5. Click Upload.

Downloading an Assembly Archive

To download an assembly archive from OVAB Deployer, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Archives tab.
  3. Select the assembly archive that you want to download.
  4. Click the Download button on the toolbar.
  5. In the resulting dialog box, specify the location, on the local host, to which the assembly archive should be downloaded.

Deleting an Assembly Archive

To delete an assembly archive from OVAB Deployer, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Archives tab.
  3. Select the assembly archive that you want to delete.
  4. Click the Delete button on the toolbar.

Registering an Assembly Archive

To register an assembly archive to the Exalogic target, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.

  2. Click the Registrations tab.

  3. Click the Register button on the toolbar.

  4. On the resulting page, do the following:

    1. In the Assembly field, select the assembly for which you want to register.

    2. In the Version field, select the assembly version number.

    3. In the Plan field, specify the location of the deployment plan.

    4. Click Register.

Unregistering an Assembly Archive

To unregister an assembly archive, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Registrations tab.
  3. Select the assembly archive that you want to unregister.
  4. Click the Unregister button on the toolbar.

Create an Assembly Instance

To create an assembly instance, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.

  2. Click the Deployments tab.

  3. Click the Create button on the toolbar.

  4. On the resulting page, do the following:

    1. In the Assembly field, select the assembly for which you want to create an instance.

    2. In the Version field, select the assembly version number.

    3. In the Plan field, specify the location of the deployment plan.

    4. Click Create.

Viewing a List of Assembly Instances

To view a list of assembly instances, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Deployments tab.

Deleting an Assembly Instance

To delete an assembly instance, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Deployments tab.
  3. Select the assembly instance that you want to delete.
  4. Click the Delete button on the toolbar.

Deploying an Assembly Instance

To deploy an instance of an assembly, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Deployments tab.
  3. Select the assembly for which you want to create an assembly instance.
  4. Click the Deploy button on the toolbar.

Undeploying an Assembly Instance

To undeploy an assembly instance, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Deployments tab.
  3. Select the assembly instance that you want to undeploy.
  4. Click the Undeploy button on the toolbar.

Starting, Stopping, Restarting, and Redeploying Assembly Instances

To start, stop, restart, or redeploy an assembly instance, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Deployments tab.
  3. Select the assembly instance that you want to start, stop, restart, or redeploy.
  4. Click the appropriate button on the toolbar.

Viewing the Status of Deployment Requests

To view the status of deployment requests, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Requests tab.

Deleting a Completed Deployment Request

To delete a deployment request that has been completed, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Requests tab.
  3. Select the request that you want to delete.
  4. Click the Delete button on the toolbar.

Viewing a List of Appliances

To view a list of appliances, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Appliances tab.

Deleting a Failed Appliance

To delete an appliance that is in the failed state, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Appliances tab.
  3. Select the appliance that you want to delete.
  4. Click the Delete button on the toolbar.

Scaling an Appliance

To scale an appliance, do the following:

  1. Log in to the OVAB Deployer web console, as described in Accessing the OVAB Deployer Interfaces.
  2. Click the Appliances tab.
  3. Select the appliance that you want to scale.
  4. Click the Scale button on the toolbar.
  5. On the resulting page, specify the scaling parameters.