com.sun.esb.management.impl.installation

Class InstallationServiceImpl

java.lang.Object

com.sun.esb.management.base.services.AbstractServiceImpl

com.sun.esb.management.base.services.BaseServiceImpl

com.sun.esb.management.impl.installation.InstallationServiceImpl

All Implemented Interfaces:

InstallationService, Serializable

public class InstallationServiceImpl
extends BaseServiceImpl
implements Serializable, InstallationService

Defines client operations for common installation services for the client.

Author:

graj

See Also:

Serialized Form

Field Summary

Fields inherited from class com.sun.esb.management.base.services.BaseServiceImpl

mLastUploadId

Fields inherited from class com.sun.esb.management.base.services.AbstractServiceImpl

CANNED_RESPONSE, I18NBUNDLE, isRemoteConnection, remoteConnection

Constructor Summary

Constructors

Constructor and Description
InstallationServiceImpl() Constructor - Constructs a new instance of InstallationServiceImpl
InstallationServiceImpl(MBeanServerConnection serverConnection) Constructor - Constructs a new instance of InstallationServiceImpl
InstallationServiceImpl(MBeanServerConnection serverConnection, boolean isRemoteConnection) Constructor - Constructs a new instance of InstallationServiceImpl

Method Summary

Methods

Modifier and Type	Method and Description
String	installComponent(String zipFilePath, Properties paramProps, String targetName) installs component (service engine, binding component)
Map<String,String>	installComponent(String zipFilePath, Properties paramProps, String[] targetNames) installs component ( service engine, binding component)
String	installComponent(String zipFilePath, String targetName) installs component (service engine, binding component)
Map<String,String>	installComponent(String zipFilePath, String[] targetNames) installs shared library
String	installComponentFromDomain(String componentName, Properties properties, String targetName) installs component (service engine, binding component) from the domain target
Map<String,String>	installComponentFromDomain(String componentName, Properties properties, String[] targetNames) installs component from Domain( service engine, binding component)
String	installComponentFromDomain(String componentName, String targetName) installs component (service engine, binding component) from the domain target
Map<String,String>	installComponentFromDomain(String componentName, String[] targetNames) installs component from Domain( service engine, binding component)
String	installSharedLibrary(String zipFilePath, String targetName) installs shared library
Map<String,String>	installSharedLibrary(String zipFilePath, String[] targetNames) installs shared library
String	installSharedLibraryFromDomain(String libraryName, String targetName) installs shared library from domain target
Map<String,String>	installSharedLibraryFromDomain(String libraryName, String[] targetNames) installs shared library
static void	main(String[] args)
String	uninstallComponent(String componentName, boolean forceDelete, boolean retainInDomain, String targetName) uninstalls component (service engine, binding component) with option to retain in domain target and option to forcibly remove from specified target
Map<String,String>	uninstallComponent(String componentName, boolean forceDelete, boolean retainInDomain, String[] targetNames) uninstalls component ( service engine, binding component)
String	uninstallComponent(String componentName, boolean forceDelete, String targetName) uninstalls component (service engine, binding component) with forcibly remove option
Map<String,String>	uninstallComponent(String componentName, boolean forceDelete, String[] targetNames) uninstalls component ( service engine, binding component)
String	uninstallComponent(String componentName, String targetName) uninstalls component (service engine, binding component)
Map<String,String>	uninstallComponent(String componentName, String[] targetNames) uninstalls component ( service engine, binding component)
String	uninstallSharedLibrary(String sharedLibraryName, boolean forceDelete, boolean retainInDomain, String targetName) uninstalls shared library with option to retain in domain target and option to forcibly remove from specified target
Map<String,String>	uninstallSharedLibrary(String sharedLibraryName, boolean forceDelete, boolean retainInDomain, String[] targetNames) uninstalls shared library
String	uninstallSharedLibrary(String sharedLibraryName, boolean forceDelete, String targetName) uninstalls shared library with option to forcibly remove
Map<String,String>	uninstallSharedLibrary(String sharedLibraryName, boolean forceDelete, String[] targetNames) uninstalls shared library
String	uninstallSharedLibrary(String sharedLibraryName, String targetName) uninstalls shared library
Map<String,String>	uninstallSharedLibrary(String sharedLibraryName, String[] targetNames) uninstalls shared library
String	upgradeComponent(String componentName, String zipFilePath) upgrades component (service engine, binding component) Upgrades a component in a way that actually involves the component.

Methods inherited from class com.sun.esb.management.base.services.BaseServiceImpl

downloadFile, removeUploadedFile, uploadFile

Methods inherited from class com.sun.esb.management.base.services.AbstractServiceImpl

getAdministrationServiceMBeanObjectName, getConfigurationServiceMBeanObjectName, getDeploymentServiceMBeanObjectName, getI18NBundle, getInstallationServiceMBeanObjectName, getMBeanServerConnection, getNotificationServiceMBeanObjectName, getPerformanceMeasurementServiceMBeanObjectName, getRuntimeManagementServiceMBeanObjectName, invokeMBeanOperation, invokeMBeanOperation, isRegistered, isRemoteConnection, listTargetNames, queryNames

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InstallationServiceImpl

public InstallationServiceImpl()

Constructor - Constructs a new instance of InstallationServiceImpl

InstallationServiceImpl

public InstallationServiceImpl(MBeanServerConnection serverConnection)

Constructor - Constructs a new instance of InstallationServiceImpl

Parameters:

serverConnection -

InstallationServiceImpl

public InstallationServiceImpl(MBeanServerConnection serverConnection,
                       boolean isRemoteConnection)

Constructor - Constructs a new instance of InstallationServiceImpl

Parameters:

serverConnection -

isRemoteConnection -

Method Detail

installComponent

public String installComponent(String zipFilePath,
                      Properties paramProps,
                      String targetName)
                        throws ManagementRemoteException

installs component (service engine, binding component)

Specified by:

installComponent in interface InstallationService

Parameters:

paramProps - Properties object contains name/value pair.

zipFilePath - archive file in a zip format

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponent(java.lang.String, java.util.Properties, java.lang.String)

installComponent

public String installComponent(String zipFilePath,
                      String targetName)
                        throws ManagementRemoteException

installs component (service engine, binding component)

Specified by:

installComponent in interface InstallationService

Parameters:

zipFilePath - archive file in a zip format

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponent(java.lang.String, java.lang.String)

installComponent

public Map<String,String> installComponent(String zipFilePath,
                                  Properties paramProps,
                                  String[] targetNames)
                                    throws ManagementRemoteException

installs component ( service engine, binding component)

Specified by:

installComponent in interface InstallationService

Parameters:

paramProps - Properties object contains name/value pair.

zipFilePath - archive file in a zip format

targetNames -

Returns:

name of the component as map of [targetName,string].

Throws:

ManagementRemoteException - on error *

See Also:

InstallationService.installComponent(java.lang.String, java.util.Properties, java.lang.String[])

installComponent

public Map<String,String> installComponent(String zipFilePath,
                                  String[] targetNames)
                                    throws ManagementRemoteException

installs shared library

Specified by:

installComponent in interface InstallationService

Parameters:

zipFilePath - archive file in a zip format

targetNames -

Returns:

shared library name as map of [targetName,string].

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponent(java.lang.String, java.lang.String[])

installComponentFromDomain

public String installComponentFromDomain(String componentName,
                                Properties properties,
                                String targetName)
                                  throws ManagementRemoteException

installs component (service engine, binding component) from the domain target

Specified by:

installComponentFromDomain in interface InstallationService

Parameters:

componentName - name of the component.

component - configuration properties

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponentFromDomain(java.lang.String, java.util.Properties, java.lang.String)

installComponentFromDomain

public String installComponentFromDomain(String componentName,
                                String targetName)
                                  throws ManagementRemoteException

installs component (service engine, binding component) from the domain target

Specified by:

installComponentFromDomain in interface InstallationService

Parameters:

componentName - name of the component.

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponentFromDomain(java.lang.String, java.lang.String)

installComponentFromDomain

public Map<String,String> installComponentFromDomain(String componentName,
                                            String[] targetNames)
                                              throws ManagementRemoteException

installs component from Domain( service engine, binding component)

Specified by:

installComponentFromDomain in interface InstallationService

Parameters:

componentName - name of the component

targetNames - array of targets for this operation

Returns:

Map of targetName and component name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponentFromDomain(java.lang.String, java.lang.String[])

installComponentFromDomain

public Map<String,String> installComponentFromDomain(String componentName,
                                            Properties properties,
                                            String[] targetNames)
                                              throws ManagementRemoteException

installs component from Domain( service engine, binding component)

Specified by:

installComponentFromDomain in interface InstallationService

Parameters:

componentName - name of the component

properties - configuration properties

targetNames - array of targets for this operation

Returns:

Map of targetName and component name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installComponentFromDomain(java.lang.String, java.util.Properties, java.lang.String[])

installSharedLibrary

public String installSharedLibrary(String zipFilePath,
                          String targetName)
                            throws ManagementRemoteException

installs shared library

Specified by:

installSharedLibrary in interface InstallationService

Parameters:

zipFilePath - archive file in a zip format

targetName - name of the target for this operation

Returns:

shared library name string.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installSharedLibrary(java.lang.String, java.lang.String)

installSharedLibrary

public Map<String,String> installSharedLibrary(String zipFilePath,
                                      String[] targetNames)
                                        throws ManagementRemoteException

installs shared library

Specified by:

installSharedLibrary in interface InstallationService

Parameters:

zipFilePath - archive file in a zip format

targetNames -

Returns:

shared library name as map of [targetName,string].

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installSharedLibrary(java.lang.String, java.lang.String[])

installSharedLibraryFromDomain

public String installSharedLibraryFromDomain(String libraryName,
                                    String targetName)
                                      throws ManagementRemoteException

installs shared library from domain target

Specified by:

installSharedLibraryFromDomain in interface InstallationService

Parameters:

libraryName - Shared Library Name

targetName - name of the target for this operation

Returns:

shared library name string.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installSharedLibraryFromDomain(java.lang.String, java.lang.String)

installSharedLibraryFromDomain

public Map<String,String> installSharedLibraryFromDomain(String libraryName,
                                                String[] targetNames)
                                                  throws ManagementRemoteException

installs shared library

Specified by:

installSharedLibraryFromDomain in interface InstallationService

Parameters:

libraryName - name of the library

targetName - name of the target for this operation

Returns:

Map of targetName and shared library name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.installSharedLibraryFromDomain(java.lang.String, java.lang.String[])

uninstallComponent

public String uninstallComponent(String componentName,
                        boolean forceDelete,
                        boolean retainInDomain,
                        String targetName)
                          throws ManagementRemoteException

uninstalls component (service engine, binding component) with option to retain in domain target and option to forcibly remove from specified target

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

forceDelete - true to delete, false to not

retainInDomain - true to not delete it from the domain target, false to also delete it from the domain target.

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, boolean, boolean, java.lang.String)

uninstallComponent

public String uninstallComponent(String componentName,
                        boolean forceDelete,
                        String targetName)
                          throws ManagementRemoteException

uninstalls component (service engine, binding component) with forcibly remove option

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

forceDelete - true to delete, false to not

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, boolean, java.lang.String)

uninstallComponent

public String uninstallComponent(String componentName,
                        String targetName)
                          throws ManagementRemoteException

uninstalls component (service engine, binding component)

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

targetName - name of the target for this operation

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, java.lang.String)

uninstallComponent

public Map<String,String> uninstallComponent(String componentName,
                                    String[] targetNames)
                                      throws ManagementRemoteException

uninstalls component ( service engine, binding component)

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

targetNames -

Returns:

name of the component as [targetName, String] map.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, java.lang.String[])

uninstallComponent

public Map<String,String> uninstallComponent(String componentName,
                                    boolean forceDelete,
                                    String[] targetNames)
                                      throws ManagementRemoteException

uninstalls component ( service engine, binding component)

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

forceDelete - true to delete, false to not

targetName - name of the target for this operation

Returns:

Map of targetName and component name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, boolean, java.lang.String[])

uninstallComponent

public Map<String,String> uninstallComponent(String componentName,
                                    boolean forceDelete,
                                    boolean retainInDomain,
                                    String[] targetNames)
                                      throws ManagementRemoteException

uninstalls component ( service engine, binding component)

Specified by:

uninstallComponent in interface InstallationService

Parameters:

componentName - name of the component

forceDelete - true to delete, false to not

retainInDomain - true to not delete it from the domain target, false to also delete it from the domain target.

targetNames - array of targets for this operation

Returns:

Map of targetName and component name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallComponent(java.lang.String, boolean, boolean, java.lang.String[])

uninstallSharedLibrary

public String uninstallSharedLibrary(String sharedLibraryName,
                            boolean forceDelete,
                            boolean retainInDomain,
                            String targetName)
                              throws ManagementRemoteException

uninstalls shared library with option to retain in domain target and option to forcibly remove from specified target

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

forceDelete - true to delete, false to not

retainInDomain - true to not delete it from the domain target, false to also delete it from the domain target.

targetName - name of the target for this operation

Returns:

shared library name string.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, boolean, boolean, java.lang.String)

uninstallSharedLibrary

public String uninstallSharedLibrary(String sharedLibraryName,
                            boolean forceDelete,
                            String targetName)
                              throws ManagementRemoteException

uninstalls shared library with option to forcibly remove

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

forceDelete - true to delete, false to not

targetName - name of the target for this operation

Returns:

shared library name string.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, boolean, java.lang.String)

uninstallSharedLibrary

public String uninstallSharedLibrary(String sharedLibraryName,
                            String targetName)
                              throws ManagementRemoteException

uninstalls shared library

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

targetName - name of the target for this operation

Returns:

shared library name string.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, java.lang.String)

uninstallSharedLibrary

public Map<String,String> uninstallSharedLibrary(String sharedLibraryName,
                                        String[] targetNames)
                                          throws ManagementRemoteException

uninstalls shared library

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

targetNames -

Returns:

shared library name as [targetName, string] map.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, java.lang.String[])

uninstallSharedLibrary

public Map<String,String> uninstallSharedLibrary(String sharedLibraryName,
                                        boolean forceDelete,
                                        String[] targetNames)
                                          throws ManagementRemoteException

uninstalls shared library

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

forceDelete - true to delete, false to not

targetNames - list of names of targets for this operation

Returns:

Map of targetName and shared library name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, boolean, java.lang.String[])

uninstallSharedLibrary

public Map<String,String> uninstallSharedLibrary(String sharedLibraryName,
                                        boolean forceDelete,
                                        boolean retainInDomain,
                                        String[] targetNames)
                                          throws ManagementRemoteException

uninstalls shared library

Specified by:

uninstallSharedLibrary in interface InstallationService

Parameters:

sharedLibraryName - name of the shared library

forceDelete - true to delete, false to not

retainInDomain - true to not delete it from the domain target, false to also delete it from the domain target.

targetNames - array of targets for this operation

Returns:

Map of targetName and shared library name strings.

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.uninstallSharedLibrary(java.lang.String, boolean, boolean, java.lang.String[])

upgradeComponent

public String upgradeComponent(String componentName,
                      String zipFilePath)
                        throws ManagementRemoteException

upgrades component (service engine, binding component) Upgrades a component in a way that actually involves the component. During the upgrade processing, the component's implementation of the new upgrade SPI will be invoked to give the component the opportunity to perform any special processing necessary to complete the upgrade. Components which do not provide an implementation of the upgrade SPI can still be updated using the updateComponent API. Also, in the upgrade implementation, changes in the component's installation descriptor will be allowed, with the exception of the component name (for obvious reasons). This allows new shared library dependencies, changes to the class names of the component's SPI implementations, and changes to the component's class loading preferences (class path and class loading order). These changes are allowed regardless of whether or not the component provides an implementation of the new upgrade SPI.

Specified by:

upgradeComponent in interface InstallationService

Parameters:

componentName - Name of the component to update.

zipFilePath - archive file in a zip format

Returns:

The name of the component if successful

Throws:

ManagementRemoteException - on error

See Also:

InstallationService.upgradeComponent(java.lang.String, java.lang.String)

main

public static void main(String[] args)

Parameters:

args -