com.sun.jbi.management

Interface InstallationServiceMBean

All Superinterfaces:

InstallationServiceMBean

public interface InstallationServiceMBean
extends InstallationServiceMBean

This InstallationServiceMBean extends the public InstallationService interface. This has additional operations to :

• Install a component from the repository
• Install a shared library from the repository
• Allow forceful uninstall of shared libraries

Author:

Sun Microsystems, Inc.

Method Summary

Methods

Modifier and Type	Method and Description
String	installSharedLibraryFromRepository(String sharedLibraryName) Install a shared library from the Repository.
ObjectName	loadInstaller(String componentName, boolean force) Load the InstallerMBean for a previously installed component.
ObjectName	loadInstallerFromRepository(String componentName) Load the installer for a component from the Repository.
boolean	uninstallSharedLibrary(String slName, boolean keep) Uninstall a previously installed shared library.
String	upgradeComponent(String componentName, String installZipURL) Upgrade a component.

Methods inherited from interface javax.jbi.management.InstallationServiceMBean

installSharedLibrary, loadInstaller, loadNewInstaller, uninstallSharedLibrary, unloadInstaller

Method Detail

loadInstaller

ObjectName loadInstaller(String componentName,
                       boolean force)

Load the InstallerMBean for a previously installed component.

The "component name" refers to the <identification><name> element value from the component's installation package (see InstallationServiceMBean.loadNewInstaller(String)).

Parameters:

componentName - the component name identifying the installer to load; must be non-null and non-empty

force - set to true when this is being called as part of a forced uninstall, causing a failure to load the component's bootstrap class to be ignored.

Returns:

the JMX ObjectName of the InstallerMBean loaded from an existing installation context; null if the installer MBean doesn't exist

loadInstallerFromRepository

ObjectName loadInstallerFromRepository(String componentName)
                                       throws JBIException

Load the installer for a component from the Repository. The component archive from the repository is uploaded to the target instance(s), loadNewInstaller() in invoked on the remote instance(s). The object name of the Installer MBean is returned.
If the component is not there in the DAS repository a exception will be thrown.

Parameters:

componentName - - name of the registered component.

Returns:

the ObjectName of Installer MBean for the registered component

Throws:

JBIException - if the component is not registered.

installSharedLibraryFromRepository

String installSharedLibraryFromRepository(String sharedLibraryName)
                                          throws JBIException

Install a shared library from the Repository. The library archive from the repository is uploaded to the target instance(s) and installSharedLibrary() is invoked on the remote instance InstallationService with the uploaded file name.
If the shared library is not there in the DAS repository an exception will be thrown.

Parameters:

sharedLibraryName - - name of the registered shared library.

Returns:

the shared library name

Throws:

JBIException - if the shared library is not registered or uninstall fails.

uninstallSharedLibrary

boolean uninstallSharedLibrary(String slName,
                             boolean keep)

Uninstall a previously installed shared library.

Parameters:

slName - the name of the shared name space to uninstall; must be non-null and non-empty

keep - if true the shared libray is not deleted from the domain. If false, the shared library is deleted from the repository if after this uninstall it is not installed on any targets.

Returns:

true if the uninstall was successful

upgradeComponent

String upgradeComponent(String componentName,
                      String installZipURL)
                        throws JBIException

Upgrade a component. This is used to perform an update of the runtime files of a component without requiring undeployment of Service Assemblies with Service Units deployed to the component.

Parameters:

componentName - The name of the component.

installZipURL - The URL to the component archive.

Returns:

a status management message that contains component upgrade result

Throws:

JBIException - if there is a problem with the upgrade.