|
| |
|
| java.lang.Object
 com.sun.jbi.management.system.ModelSystemService
com.sun.jbi.management.system.InstallationService
| InstallationService | | public class InstallationService extends ModelSystemService implements com.sun.jbi.management.InstallationServiceMBean(Code) | | The installation service MBean allows administrative tools to manage
component and shared library installations. The tasks supported are:
- Installing (and uninstalling) a shared library
- Creating (loading) and destroying (unloading) a component installer
MBean.
- Finding an existing component installer MBean.
Installing and uninstalling components is accomplished using
InstallerMBean s, loaded by this MBean. An individual installer MBean
is needed for each component installation / uninstallation. This is to support
the more complex installation process that some components require.
author:
JSR208 Expert Group |
| bootStrapComponent | | ObjectName bootStrapComponent(URL aComponentURL) throws javax.jbi.JBIException(Code) | | Create the Component Installation Context and load the bootstrap.
Parameters:
aComponentURL - the component .jar specification
Parameters:
isSharedLib - - true iff the component is a shared library. the ID of the component/library
throws:
javax.jbi.JBIException - if an error occurs |
| closeJarFile | | void closeJarFile(JarFile aJarFile)(Code) | | Close the given (open) JarFile, ignoring IOExceptions
Parameters:
aJarFile - - an open Jar file |
| initModelSystemService | | protected void initModelSystemService(com.sun.jbi.EnvironmentContext anEnv)(Code) | | local model init - called by constructor - create custom mbeans.
Parameters:
anEnv - is the ManagementContext |
| installSharedLibrary | | public synchronized String installSharedLibrary(String slZipURL)(Code) | | Install a shared library installation package.
The return value is the unique name for the shared-library, as found
in the the value of the installation descriptor's
<identification><name> element.
Parameters:
slZipURL - URL locating a zip file containing a shared libraryinstallation package; must be non-null, non-empty, and a legalURL the unique name of the shared library loaded from slZipURL; mustbe non-null and non-empty |
| installSharedLibraryFromRepository | | public String installSharedLibraryFromRepository(String sharedLibraryName) throws javax.jbi.JBIException(Code) | | Install a shared library from the Repository. This method is not implemented and never
called by the facade MBeans.
Parameters:
sharedLibraryName - - name of the registered shared library. the shared library name
exception:
javax.jbi.JBIException - if the shared library is not registered oruninstall fails. |
| loadInstaller | | public synchronized ObjectName loadInstaller(String componentName)(Code) | | 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
InstallationService.loadNewInstaller(String) ).
Parameters:
componentName - the component name identifying the installer to load; must be non-null and non-empty the JMX ObjectName of the InstallerMBean loaded from an existinginstallation context; null if the installer MBeandoesn't exist |
| loadInstallerFromRepository | | public ObjectName loadInstallerFromRepository(String componentName) throws javax.jbi.JBIException(Code) | | 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. the ObjectName of Installer MBean for the registered component
exception:
javax.jbi.JBIException - if the component is not registered. |
| loadNewInstaller | | public synchronized ObjectName loadNewInstaller(String installZipURL)(Code) | | Load the installer for a new component for the given component
installation package.
Parameters:
installZipURL - URL locating a ZIP file containing theJBI Installation package to be installed; must be non-null, non-empty, and a legal URL the JMX ObjectName of the InstallerMBean loaded frominstallZipURL; must be non-null |
| uninstallSharedLibrary | | public synchronized boolean uninstallSharedLibrary(String slName)(Code) | | Uninstall a previously installed shared library.
Parameters:
slName - the name of the shared name space to uninstall; must benon-null and non-empty true if the uninstall was successful |
| uninstallSharedLibrary | | public boolean uninstallSharedLibrary(String slName, boolean keep)(Code) | | Uninstall a previously installed shared library. The facade InstallationService
never invokes this operation.
Parameters:
slName - the name of the shared name space to uninstall; must benon-null and non-empty
Parameters:
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. true if the uninstall was successful |
| unloadInstaller | | public synchronized boolean unloadInstaller(String componentName, boolean isToBeDeleted)(Code) | | Unload an InstallerMBean previously loaded for a component.
Parameters:
componentName - the component name identifying the installer to unload; must be non-null and non-empty
Parameters:
isToBeDeleted - true if the component is to be deleted as well true if the operation was successful, otherwise false |
| upgradeComponent | | public String upgradeComponent(String componentName, String installZipPath) throws javax.jbi.JBIException(Code) | | Upgrade a component. This is used to perform an upgrade 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.
Parameters:
installZipURL - The URL to the component archive. a status management message that contains component upgrade result
throws:
JBIException - if there is a problem with the upgrade. |
| upgradeComponent | | public void upgradeComponent(String componentName, long upgradeNumber) throws javax.jbi.JBIException(Code) | | Set a component's upgrade number.
This method is used by synchronization to set the component upgrade number
Parameters:
componentName - The name of the component.
throws:
JBIException - if there is a problem with the upgrade. |
|
|
|