|
Oracle Fusion Middleware Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DeploymentManagerMBean
This MBean provides deployment operations.
A DeploymentManager object is a stateless interface into the WebLogic Server deployment framework. It currently provides access to the AppDeploymentRuntimeMBeans that allow the user to start and stop deployments. In the future, this MBean may be enhanced with operations to support deployment applications to the domain, as well as extended WebLogic Server deployment features, such as production redeployment and partial deployment of modules in an enterprise application.
This MBean emits notifications when an application is created or removed and when the application state changes. The notification types are:
The userdata is the object name of the application.
Method Summary | |
---|---|
abstract String |
confirmApplicationName(Boolean isRedeployment, String appSource, String altAppDescriptor, String tentativeName, String tentativeApplicationId) Used by the deployment subsystem to confirm an application name. |
abstract String |
confirmApplicationName(Boolean isRedeployment, String appSource, String altAppDescriptor, String tentativeName, String tentativeApplicationId, Properties deploymentOptions) Used by the deployment subsystem to confirm an application name. |
abstract DeploymentProgressObjectMBean |
deploy(String name, String applicationPath, String plan) A convenience method for distributing and starting an application. |
abstract DeploymentProgressObjectMBean |
deploy(String name, String applicationPath, String[] targets, String plan, Properties deploymentOptions) A convenience method for distributing and starting an application. |
abstract DeploymentProgressObjectMBean |
distribute(String name, String applicationPath, String plan) Distribute an application. |
abstract DeploymentProgressObjectMBean |
distribute(String name, String applicationPath, String[] targets, String plan, Properties deploymentOptions) Distribute an application. |
abstract AppDeploymentRuntimeMBean[] |
getAppDeploymentRuntimes() Provides access to the applications that are deployed in the domain. |
abstract DeploymentProgressObjectMBean[] |
getDeploymentProgressObjects() Provides access to the deployment operations that have been performed on this domain. |
abstract LibDeploymentRuntimeMBean[] |
getLibDeploymentRuntimes() Provides access to the libraries that are deployed to the domain. |
abstract int |
getMaximumDeploymentProgressObjectsCount() The maximum number of progress objects allowed. |
abstract AppDeploymentRuntimeMBean |
lookupAppDeploymentRuntime(String appName) Finds the application deployment runtime MBean for an application. |
abstract AppDeploymentRuntimeMBean |
lookupAppDeploymentRuntime(String appName, Properties deploymentOptions) Finds the application deployment runtime MBean for an application based on the deploymentOptions parameter. |
abstract LibDeploymentRuntimeMBean |
lookupLibDeploymentRuntime(String libName) Find the library deployment runtime MBean for a library. |
abstract void |
purgeCompletedDeploymentProgressObjects() Removes progress objects for completed operations. |
abstract DeploymentProgressObjectMBean |
redeploy(String name, String plan, Properties deploymentOptions) Redeploy the application that is deployed to a resource group template in the background for the targets specified with the options specified. |
abstract void |
removeDeploymentProgressObject(String appName) Removes a progress object. |
abstract void |
setMaximumDeploymentProgressObjectsCount(int maxCount) Sets the maximum number of progress objects allowed. |
abstract DeploymentProgressObjectMBean |
undeploy(String name, Properties deploymentOptions) Undeploy the application that is deployed to a resource group template in the background with the options specified. |
abstract DeploymentProgressObjectMBean |
undeploy(String name, String template) Undeploy the application that is deployed to a resource group template using the default options. |
abstract DeploymentProgressObjectMBean |
update(String name, String plan, Properties deploymentOptions) Allows for updating an application configuration using an changed deployment plan for applications deployed to a resource group template. |
Methods inherited from interface weblogic.management.runtime.RuntimeMBean |
---|
addPropertyChangeListener, removePropertyChangeListener |
Methods inherited from interface weblogic.management.WebLogicMBean |
---|
getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent |
Methods inherited from interface javax.management.DynamicMBean |
---|
getAttribute, getAttributes, invoke, setAttribute, setAttributes |
Methods inherited from interface javax.management.MBeanRegistration |
---|
postDeregister, postRegister, preDeregister, preRegister |
Methods inherited from interface javax.management.NotificationBroadcaster |
---|
addNotificationListener, getNotificationInfo, removeNotificationListener |
Field Detail |
---|
static final String APPDEPLOYMENT_CREATED
static final String APPDEPLOYMENT_DELETED
static final String APPDEPLOYMENT_NEW
static final String APPDEPLOYMENT_PREPARED
static final String APPDEPLOYMENT_ADMIN
static final String APPDEPLOYMENT_ACTIVE
static final String APPDEPLOYMENT_RETIRED
static final String APPDEPLOYMENT_FAILED
static final String APPDEPLOYMENT_UPDATE_PENDING
static final String APPDEPLOYMENT_UNKNOWN
static final String LIBDEPLOYMENT_CREATED
static final String LIBDEPLOYMENT_DELETED
static final String ADMIN_MODE
static final String ALT_DD
static final String ALT_WLS_DD
static final String APP_VERSION
static final String CREATE_PLAN
static final String CLUSTER_DEPLOYMENT_TIMEOUT
static final String DEFAULT_SUBMODULE_TARGETS
static final String DEPLOYMENT_PRINCIPAL_NAME
static final String DEPLOYMENT_ORDER
static final String FORCE_UNDEPLOYMENT_TIMEOUT
static final String GRACEFUL_IGNORE_SESSIONS
static final String GRACEFUL_PRODUCTION_TO_ADMIN
static final String NO_VERSION
static final String PLAN_VERSION
static final String LIB_SPEC_VERSION
static final String LIB_IMPL_VERSION
static final String LIBRARY
static final String RETIRE_GRACEFULLY
static final String RETIRE_TIMEOUT
static final String RMI_GRACE_PERIOD
static final String SECURITY_MODEL
static final String SECURITY_VALIDATION_ENABLED
static final String STAGE_MODE
static final String SUB_MODULE_TARGETS
static final String TASK_ID
static final String TIMEOUT
static final String USE_NONEXCLUSIVE_LOCK
static final String VERSION_IDENTIFIER
static final String STATIC_DEPLOYMENT
static final String CACHE_IN_APP_DIRECTORY
static final String SPECIFIED_TARGETS_ONLY
static final String PARTITION
static final String EDIT_SESSION
static final String RESOURCE_GROUP
static final String RESOURCE_GROUP_TEMPLATE
static final String REMOVE_PLAN_OVERRIDE
static final String START_TASK
Method Detail |
---|
DeploymentProgressObjectMBean deploy(String name, String applicationPath, String plan) throws RuntimeException
A convenience method for distributing and starting an application.
The application source files and deployment plan are distributed to the deployment targets using the default options. This is a synchronous operation that returns when the deploy operation has completed. If distribution is successful, the application is then started on each of the targets. Successful deployment requires that all targets receive both the archive and deployment plan.
The default options are
If any modules are currently running, this method immediately restarts those modules using the newer files. Restarting modules in this manner is not the same as redeployment, because session state is not preserved for the active modules.
name
- The name of the applicationapplicationPath
- A supported Java EE application or module archive, or a root directory for the application or module.plan
- The deployment plan for this application. May be null.RuntimeException.
- All other errors are reported via the returned DeploymentProgressObjectMBean.RuntimeException
DeploymentProgressObjectMBean deploy(String name, String applicationPath, String[] targets, String plan, Properties deploymentOptions) throws RuntimeException
A convenience method for distributing and starting an application. The application source files and deployment plan are distributed to the deployment targets using the options specified. This is an asynchronous operation that returns immediately. If distribution is successful, the application is then started on each of the targets. Successful deployment requires that all targets receive both the archive and deployment plan.
If any modules are currently running, this method immediately restarts those modules using the newer files. Restarting modules in this manner is not the same as redeployment, because session state is not preserved for the active modules.
name
- The name of the applicationapplicationPath
- A supported Java EE application or module archive, or a root directory for the application or module.targets
- The targets on which to deploy the application. This would be server names, cluster names, or module names in a similar format to weblogic.Deployer (i.e. module1@server1). If null, the application will be redeployed on all configured targets.plan
- The deployment plan for this application. May be null.deploymentOptions
- Allows for overriding the deployment options. If null, default options will be used. The values should all be of type The keys, units and default values for options are clusterDeploymentTimeout milliseconds 3600000, gracefulIgnoreSessions boolean false, gracefulProductionToAdmin boolean false, retireGracefully boolean true, retireTimeout seconds -1 (no timeout), adminMode boolean false, timeout milliseconds 0 (no timeout)RuntimeException.
- All other errors are reported via the returned DeploymentProgressObjectMBean.RuntimeException
DeploymentProgressObjectMBean distribute(String name, String applicationPath, String plan) throws RuntimeException
Distribute an application.
The application source files and deployment plan are distributed to the deployment targets using the default options. This is a synchronous operation that returns when the distribute operation has completed.
The default options are:
name
- The name of the applicationapplicationPath
- A supported Java EE application or module archive, or a root directory for the application or module.plan
- The deployment plan for this application. May be null.RuntimeException.
- All other errors are reported via the returned DeploymentProgressObjectMBean.RuntimeException
DeploymentProgressObjectMBean distribute(String name, String applicationPath, String[] targets, String plan, Properties deploymentOptions) throws RuntimeException
Distribute an application. The application source files and deployment plan are distributed to the deployment targets using the options specified. This is an asynchronous operation that returns immediately.
name
- The name of the applicationapplicationPath
- A supported Java EE application or module archive, or a root directory for the application or module.targets
- The targets on which to deploy the application. This would be server names, cluster names, or module names in a similar format to weblogic.Deployer (i.e. module1@server1). If null, the application will be distributed on all configured targets.plan
- The deployment plan for this application. May be null.deploymentOptions
- Allows for overriding the deployment options. If null, default options will be used. The values should all be of type The keys, units and default values for options are clusterDeploymentTimeout milliseconds 3600000, gracefulIgnoreSessions boolean false, gracefulProductionToAdmin boolean false, retireGracefully boolean true, retireTimeout seconds -1 (no timeout), adminMode boolean false, timeout milliseconds 0 (no timeout)RuntimeException.
- All other errors are reported via the returned DeploymentProgressObjectMBean.RuntimeException
DeploymentProgressObjectMBean undeploy(String name, String template) throws RuntimeException
Undeploy the application that is deployed to a resource group template using the default options. This is a synchronous operation that returns when the undeploy operation has completed. The default options are clusterDeploymentTimeout: 3600000 milliseconds, gracefulIgnoreSessions: false, gracefulProductionToAdmin: false, retireGracefully: true, retireTimeout: no timeout, adminMode: false, timeout: no timeout
name
- The application nametemplate
- The resource group templateDeploymentProgressObjectMBean
An object that provides the state of the undeploy operation.RuntimeExceptionm
- if the operation cannot be started All other errors are reported via the returned DeploymentProgressObjectMBean.RuntimeException
DeploymentProgressObjectMBean undeploy(String name, Properties deploymentOptions) throws RuntimeException
Undeploy the application that is deployed to a resource group template in the background with the options specified. This is an asynchronous operation that returns immediately. The returned DeploymentProgressObjectMBean
can be used to determine when the operation is completed.
Note that this API is only for undeploying applications that are deployed to a resource group template, and a resourceGroupTemplate property value must be provided in deploymentOptions. AppDeploymentRuntimeMBean should be used for undeploying applications that are not deployed to a resource group template.
name
- The application namedeploymentOptions
- Allows for overriding the deployment options. The keys, units and default values for options are clusterDeploymentTimeout milliseconds 3600000, gracefulIgnoreSessions boolean false, gracefulProductionToAdmin boolean false, retireGracefully boolean true, retireTimeout seconds -1 (no timeout), adminMode boolean false, timeout milliseconds 0 (no timeout) resourceGroupTemplate this value is requiredRuntimeException
- if the operation cannot be started All other errors are reported via the returned DeploymentProgressObjectMBean.DeploymentProgressObjectMBean redeploy(String name, String plan, Properties deploymentOptions) throws RuntimeException
Redeploy the application that is deployed to a resource group template in the background for the targets specified with the options specified. This is an asynchronous operation that returns immediately. The returned DeploymentProgressObjectMBean
can be used to determine when the operation is completed.
Note that this API is only for redeploying applications or libraries that are deployed to a resource group template, and a resourceGroupTemplate property value must be provided in deploymentOptions. AppDeploymentRuntimeMBean should be used for redeploying applications that are not deployed to a resource group template, and LibDeploymentRuntimeMBean should be used for redeploying libraries that are not deployed to a resource group template.
name
- The application nameplan
- The deployment plan for this application. May be null.deploymentOptions
- Allows for overriding the deployment options. The keys, units and default values for options are clusterDeploymentTimeout milliseconds 3600000, gracefulIgnoreSessions boolean false, gracefulProductionToAdmin boolean false, retireGracefully boolean true, retireTimeout seconds -1 (no timeout), adminMode boolean false, timeout milliseconds 0 (no timeout) resourceGroupTemplate this value is requiredRuntimeException
- if the operation cannot be started All other errors are reported via the returned DeploymentProgressObjectMBean.DeploymentProgressObjectMBean update(String name, String plan, Properties deploymentOptions) throws RuntimeException
Allows for updating an application configuration using an changed deployment plan for applications deployed to a resource group template.
A configuration update is equivalent to replacing the application's deployment plan. The deployment plan is redeployed in-place. A new version of the application is not started, even if the new deployment plan has a different version.
The update succeeds only if changes to the deployment plan do not require the application to be restarted. Configuration changes in the new deployment plan must be limited to tuning the application. Changes to resource bindings causes the update to fail. Use DeploymentManagerMBean.redeploy(String, String, Properties)
to apply resource binding changes to a production application.
This method targets only root modules. Module level targeting is not supported.
Note that this API is only for updating applications that are deployed to a resource group template, and a resourceGroupTemplate property value must be provided in deploymentOptions. AppDeploymentRuntimeMBean should be used for updating applications that are not deployed to a resource group template.
name
- The application nameplan
- The deployment plan for this application. May be null.deploymentOptions
- Allows for overriding the deployment options. The keys, units and default values for options are clusterDeploymentTimeout milliseconds 3600000, gracefulIgnoreSessions boolean false, gracefulProductionToAdmin boolean false, retireGracefully boolean true, retireTimeout seconds -1 (no timeout), adminMode boolean false, timeout milliseconds 0 (no timeout) resourceGroupTemplate this value is requiredRuntimeException
- if the operation cannot be started All other errors are reported via the returned DeploymentProgressObjectMBean.AppDeploymentRuntimeMBean[] getAppDeploymentRuntimes()
Provides access to the applications that are deployed in the domain.
AppDeploymentRuntimeMBean lookupAppDeploymentRuntime(String appName)
Finds the application deployment runtime MBean for an application.
appName
- The name of the applicationAppDeploymentRuntimeMBean lookupAppDeploymentRuntime(String appName, Properties deploymentOptions)
Finds the application deployment runtime MBean for an application based on the deploymentOptions parameter.
appName
- The name of the applicationdeploymentOptions
- Used to specify a partition.LibDeploymentRuntimeMBean[] getLibDeploymentRuntimes()
LibDeploymentRuntimeMBean lookupLibDeploymentRuntime(String libName)
libName
- The name of the libraryDeploymentProgressObjectMBean[] getDeploymentProgressObjects()
Provides access to the deployment operations that have been performed on this domain.
void setMaximumDeploymentProgressObjectsCount(int maxCount)
Sets the maximum number of progress objects allowed.
maxCount
- The maximum number of progress objects allowedint getMaximumDeploymentProgressObjectsCount()
The maximum number of progress objects allowed.
void purgeCompletedDeploymentProgressObjects()
Removes progress objects for completed operations.
void removeDeploymentProgressObject(String appName)
Removes a progress object.
appName
- The name of the application that the progress object is forString confirmApplicationName(Boolean isRedeployment, String appSource, String altAppDescriptor, String tentativeName, String tentativeApplicationId) throws RuntimeException
isRedeployment
- should be true in the case where this function is called for a redeployment.appSource
- is a the path to the application.optional
- alternate application descriptor pathtentativeName
- The name proposed for the application (provided by the user, or through the manifest). Null if no name was specified by the user or through the manifest.tentativeApplicationId
- The tentative application ID. May only be null if the application is not versioned. If tentativeName is null and the application is versioned, this should be just the version string (which includes both the implementation and specification versions).RuntimeException
String confirmApplicationName(Boolean isRedeployment, String appSource, String altAppDescriptor, String tentativeName, String tentativeApplicationId, Properties deploymentOptions) throws RuntimeException
isRedeployment
- should be true in the case where this function is called for a redeployment.appSource
- is a the path to the application.optional
- alternate app descriptor.tentativeName
- The name proposed for the application (provided by the user, or through the manifest). Null if no name was specified by the user or through the manifest.tentativeApplicationId
- The tentative application ID. May only be null if the application is not versioned. If tentativeName is null and the application is versioned, this should be just the version string (which includes both the implementation and specification versions).deploymentOptions
- deployment optionsRuntimeException
|
Copyright 1996, 2015, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Fusion Middleware Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |