N1 Grid Service Provisioning System 5.0 User's Guide for the BEA WebLogic Plug-In

Component Types

The BEA WebLogic Plug-In includes several WebLogic-specific component types. These component types enable you to quickly model many of the most common WebLogic application components and to automatically associate install, uninstall, export, and snapshot behavior with a particular resource. Many of the component types are used by the software when you create and manage servers and clusters. As a result, there are only a few component types that you will work with directly:

Enterprise application (EAR)
Web application (WAR)
Java Archive (JAR) files that contain Enterprise JavaBeans (EJB)

Enterprise Application (EAR) Component Type

A component of this type models an enterprise application. The component can contain either an enterprise application archive (EAR) or the expanded version of an EAR as a package.

Browsing for an Enterprise Application

You can use one of the following browsers to select your enterprise application for this component type:

An admin server browser from which you can select one of the installed applications and its relevant settings. The admin server browser provides an alphabetical list of enterprise applications on the admin server. You can choose one enterprise application for a component.
A file system browser from which you can select the EAR file to create a component that does not include settings. The file system browser provides a list of files and directories from which you can choose. You can choose to see only those files or type *.ear in the browser.

Installing an Enterprise Application

To install an enterprise application component, you must use a WebLogic server or cluster as the target host. The installation process performs three main tasks:

Install the EAR file on that target.
Register the EAR with the WebLogic admin server.
Apply any properties previously captured during domain browse.

Uninstalling an Enterprise Application

When you uninstall an enterprise application component, the enterprise application is untargeted from the target. If the enterprise application is not targeted elsewhere, the registration component is removed from the admin sever.

Error Conditions

Table 3–1 WebLogic Enterprise Application Error Conditions


Action	Condition	Result
Install	The topology is incorrectly configured (target host does not point at correct domain host)	Targeting fails
Install	The target host is not a valid WebLogic target.	Installation prohibited
Browsing/Install/Uninstall	Credentials are not properly configured.	Operation fails
Browsing	Path not correctly configured in domain host.	Browsing fails

Web Application (WAR) Component Type

A component of this type includes a web application. The component can contain either a web application and its elevant settings or the web application without its settings.

Browsing for a Web Application

You can use one of the following browsers to select your web application for this component type:

An admin server browser from which you can select one of the installed applications and its relevant settings. The admin server browser provides an alphabetical list of web applications on the admin server. You can choose one web application for a component.
A file system browser from which you can select the WAR file to create a component that does not include settings. The file system browser provides a list of files and directories from which you can choose. You can choose to see only those files or type *.war in the browser.

Installing a Web Application

To install a web application component, you must use a WebLogic server or cluster as the target host. The installation process will install the component on that target, and install the contained registration component on the admin server of the target.

Uninstalling a Web Application

When you uninstall a web application component, the web application is untargeted from the target. If the web application is not targeted elsewhere, the registration component is removed from the admin sever.

Error Conditions

Table 3–2 WebLogic Web Application Error Conditions


Action	Condition	Result
Install	The topology is incorrectly configured (target host doesn't point at correct domain host)	Targeting fails.
Install	The target host is not a valid WL target.	Installation prohibited.
Browsing/Install/Uninstall	Credentials aren't properly configured.	Operation fails.
Browsing	Path not correctly configured in domain host.	Browsing fails.

Java Archive Files Containing EJBs Component Type

Browsing

You can use one of the following browsers to select your EJB or JAR files for this component type:

An admin server browser from which you can select one of the installed applications and its relevant settings. The admin server browser provides an alphabetical list of applications on the admin server. You can choose one EJB for a component.
A file system browser from which you can select the JAR file to create a component that does not include settings. The file system browser provides a list of files and directories from which you can choose. You can choose to see only those files or type *.jar in the browser.

Installation

When you install a component of this type, the file or directory is copied to the filesystem based on the install path. Once that copy finishes, the file or directory is registered with the WebLogic admin server.

Uninstall

When you uninstall a component of this type, the file or directory is removed from the master server.

Error Conditions

Table 3–3 WebLogic EJB container Error Conditions


Action	Condition	Result
Uninstall	A dependant WebLogic EJB is still installed.	Uninstall fails indicating the dependency.