org.apache.brooklyn.launcher.common

Class BasicLauncher<T extends BasicLauncher<T>>

java.lang.Object

org.apache.brooklyn.launcher.common.BasicLauncher<T>

Direct Known Subclasses:

BrooklynLauncher, OsgiLauncherImpl

public class BasicLauncher<T extends BasicLauncher<T>>
extends java.lang.Object

Example usage is: *

 {@code
 BasicLauncher launcher = BasicLauncher.newInstance()
     .application(new WebClusterDatabaseExample().appDisplayName("Web-cluster example"))
     .location("localhost")
     .start();
 
 Dumper.dumpInfo(launcher.getApplications());
 

Constructor Summary

Constructors

Constructor and Description
BasicLauncher()

Method Summary

Modifier and Type	Method and Description
T	application(EntitySpec<? extends Application> appSpec) Specifies that the launcher should build and manage the Brooklyn application described by the given spec.
T	application(java.lang.String yaml) Specifies that the launcher should build and manage the Brooklyn application described by the given YAML blueprint.
T	brooklynProperties(BrooklynProperties brooklynProperties) Specifies the brooklyn properties to be used.
<C> T	brooklynProperties(ConfigKey<C> key, C value)
T	brooklynProperties(java.lang.String field, java.lang.Object value) Specifies a property to be added to the brooklyn properties
T	catalogInitialization(CatalogInitialization catInit)
void	cleanOrphanedState(java.lang.String destinationDir, java.lang.String destinationLocationSpec)
void	copyPersistedState(java.lang.String destinationDir)
void	copyPersistedState(java.lang.String destinationDir, java.lang.String destinationLocation)
void	copyPersistedState(java.lang.String destinationDir, java.lang.String destinationLocationSpec, CompoundTransformer transformer)
java.util.List<Application>	getApplications()
BrooklynProperties	getBrooklynProperties()
BrooklynProperties.Factory.Builder	getBrooklynPropertiesBuilder()
CampPlatform	getCampPlatform()
java.util.List<Location>	getLocations()
ManagementContext	getManagementContext()
PersistMode	getPersistMode()
T	haHeartbeatPeriod(Duration val) Controls both the frequency of heartbeats, and the frequency of checking the health of other nodes.
T	haHeartbeatTimeout(Duration val)
T	highAvailabilityMode(HighAvailabilityMode highAvailabilityMode)
T	ignoreAppErrors(boolean ignoreAppErrors)
T	ignoreCatalogErrors(boolean ignoreCatalogErrors)
T	ignorePersistenceErrors(boolean ignorePersistenceErrors)
boolean	isStarted()
T	location(Location location) Adds a location to be passed in on start(), when that calls application.start(locations).
T	location(java.lang.String spec) Give the spec of an application, to be created.
T	locations(java.util.List<java.lang.String> specs)
T	managementContext(ManagementContext context) Specifies the management context this launcher should use.
T	persistenceDir(java.io.File persistenceDir)
T	persistenceDir(java.lang.String persistenceDir)
T	persistenceLocation(java.lang.String persistenceLocationSpec)
T	persistMode(PersistMode persistMode)
T	persistPeriod(Duration persistPeriod)
void	persistState(BrooklynMementoRawData memento, java.lang.String destinationDir, java.lang.String destinationLocationSpec) Deprecated. since 0.7.0 use copyPersistedState(java.lang.String) instead
BrooklynMementoRawData	retrieveState() Deprecated. since 0.7.0 use copyPersistedState(java.lang.String) instead
void	setBrooklynPropertiesBuilder(BrooklynProperties.Factory.Builder brooklynPropertiesBuilder)
T	start() Starts the web server (with web console) and Brooklyn applications, as per the specifications configured.
T	startBrooklynNode(boolean val)

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicLauncher

public BasicLauncher()

Method Detail

getManagementContext

public ManagementContext getManagementContext()

getApplications

public java.util.List<Application> getApplications()

application

public T application(EntitySpec<? extends Application> appSpec)

Specifies that the launcher should build and manage the Brooklyn application described by the given spec. The application will not be started as part of this call (callers can subsequently call start() or getApplications().

application

public T application(java.lang.String yaml)

Specifies that the launcher should build and manage the Brooklyn application described by the given YAML blueprint. The application will not be started as part of this call (callers can subsequently call start() or getApplications().

See Also:

#application(Application)

location

public T location(Location location)

Adds a location to be passed in on start(), when that calls application.start(locations).

location

public T location(java.lang.String spec)

Give the spec of an application, to be created.

See Also:

location(Location)

locations

public T locations(java.util.List<java.lang.String> specs)

persistenceLocation

public T persistenceLocation(@Nullable
                             java.lang.String persistenceLocationSpec)

managementContext

public T managementContext(ManagementContext context)

Specifies the management context this launcher should use. If not specified a new one is created automatically.

brooklynProperties

public T brooklynProperties(BrooklynProperties brooklynProperties)

Specifies the brooklyn properties to be used. Must not be set if managementContext is explicitly set.

brooklynProperties

public T brooklynProperties(java.lang.String field,
                            java.lang.Object value)

Specifies a property to be added to the brooklyn properties

brooklynProperties

public <C> T brooklynProperties(ConfigKey<C> key,
                                C value)

ignorePersistenceErrors

public T ignorePersistenceErrors(boolean ignorePersistenceErrors)

ignoreCatalogErrors

public T ignoreCatalogErrors(boolean ignoreCatalogErrors)

ignoreAppErrors

public T ignoreAppErrors(boolean ignoreAppErrors)

catalogInitialization

public T catalogInitialization(CatalogInitialization catInit)

persistMode

public T persistMode(PersistMode persistMode)

highAvailabilityMode

public T highAvailabilityMode(HighAvailabilityMode highAvailabilityMode)

persistenceDir

public T persistenceDir(@Nullable
                        java.lang.String persistenceDir)

persistenceDir

public T persistenceDir(@Nullable
                        java.io.File persistenceDir)

persistPeriod

public T persistPeriod(Duration persistPeriod)

haHeartbeatTimeout

public T haHeartbeatTimeout(Duration val)

startBrooklynNode

public T startBrooklynNode(boolean val)

haHeartbeatPeriod

public T haHeartbeatPeriod(Duration val)

Controls both the frequency of heartbeats, and the frequency of checking the health of other nodes.

copyPersistedState

public void copyPersistedState(java.lang.String destinationDir)

Parameters:

destinationDir - Directory for state to be copied to

copyPersistedState

public void copyPersistedState(java.lang.String destinationDir,
                               @Nullable
                               java.lang.String destinationLocation)

Parameters:

destinationDir - Directory for state to be copied to

destinationLocation - Optional location if target for copied state is a blob store.

copyPersistedState

public void copyPersistedState(java.lang.String destinationDir,
                               @Nullable
                               java.lang.String destinationLocationSpec,
                               @Nullable
                               CompoundTransformer transformer)

Parameters:

destinationDir - Directory for state to be copied to

destinationLocationSpec - Optional location if target for copied state is a blob store.

transformer - Optional transformations to apply to retrieved state before it is copied.

cleanOrphanedState

public void cleanOrphanedState(java.lang.String destinationDir,
                               @Nullable
                               java.lang.String destinationLocationSpec)

retrieveState

@Deprecated
public BrooklynMementoRawData retrieveState()

Deprecated. since 0.7.0 use copyPersistedState(java.lang.String) instead

persistState

@Deprecated
public void persistState(BrooklynMementoRawData memento,
                                     java.lang.String destinationDir,
                                     @Nullable
                                     java.lang.String destinationLocationSpec)

Deprecated. since 0.7.0 use copyPersistedState(java.lang.String) instead

Parameters:

memento - The state to copy

destinationDir - Directory for state to be copied to

destinationLocationSpec - Optional location if target for copied state is a blob store.

start

public T start()

Starts the web server (with web console) and Brooklyn applications, as per the specifications configured.

Returns:

An object containing details of the web server and the management context.

isStarted

public boolean isStarted()

getPersistMode

public PersistMode getPersistMode()

getLocations

public java.util.List<Location> getLocations()

getCampPlatform

public CampPlatform getCampPlatform()

setBrooklynPropertiesBuilder

public void setBrooklynPropertiesBuilder(BrooklynProperties.Factory.Builder brooklynPropertiesBuilder)

getBrooklynPropertiesBuilder

public BrooklynProperties.Factory.Builder getBrooklynPropertiesBuilder()

getBrooklynProperties

public BrooklynProperties getBrooklynProperties()