org.apache.brooklyn.launcher

Class BrooklynLauncher

java.lang.Object

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

org.apache.brooklyn.launcher.BrooklynLauncher

public class BrooklynLauncher
extends BasicLauncher<BrooklynLauncher>

Example usage is: *

 
 BrooklynLauncher launcher = BrooklynLauncher.newInstance()
     .application(new WebClusterDatabaseExample().appDisplayName("Web-cluster example"))
     .location("localhost")
     .start();
 
 Entities.dumpInfo(launcher.getApplications());
 
 

Field Summary

Fields inherited from class org.apache.brooklyn.launcher.common.BasicLauncher

started, startedPartTwo

Constructor Summary

Constructors

Constructor and Description
BrooklynLauncher()

Method Summary

Modifier and Type	Method and Description
BrooklynLauncher	bindAddress(InetAddress bindAddress) Specifies the NIC where the web console (and any additional webapps specified) will be bound; default 0.0.0.0, unless no security is specified (e.g.
BrooklynLauncher	brooklynPropertiesSupplier(com.google.common.base.Supplier<Map<?,?>> brooklynPropertiesSupplier) Poperties returned by the supplier have less precedence (get overwritten) by global & local properties
protected EntitySpec<LocalBrooklynNode>	customizeBrooklynNodeSpec(EntitySpec<LocalBrooklynNode> brooklynNodeSpec)
BrooklynLauncher	customizeManagement(com.google.common.base.Function<ManagementContext,Void> customizeManagement)
BrooklynServerDetails	getServerDetails()
BrooklynLauncher	globalBrooklynPropertiesFile(String file)
BrooklynLauncher	ignoreWebErrors(boolean ignoreWebErrors)
protected void	initBrooklynPropertiesBuilder()
protected void	initManagementContext()
BrooklynLauncher	installSecurityFilter(Boolean val)
BrooklynLauncher	localBrooklynPropertiesFile(String file)
static BrooklynLauncher	newInstance() Creates a configurable (fluent API) launcher for use starting the web console and Brooklyn applications.
BrooklynLauncher	publicAddress(InetAddress publicAddress) Specifies the address that the management context's REST API will be available on.
BrooklynLauncher	shutdownHandler(ShutdownHandler shutdownHandler) A listener to call when the user requests a shutdown (i.e.
BrooklynLauncher	shutdownOnExit(boolean val)
protected void	startApps()
protected void	startBrooklynNode()
protected void	startingUp()
protected void	startWebApps()
BrooklynLauncher	stopWhichAppsOnShutdown(StopWhichAppsOnShutdown stopWhich)
void	terminate() Terminates this launch, but does not stop the applications (i.e.
BrooklynLauncher	webapp(String contextPath, String warUrl) Specifies an additional webapp to host on the webconsole port.
BrooklynLauncher	webapp(WebAppContextProvider contextProvider)
BrooklynLauncher	webconsole(boolean startWebApps) Specifies whether the launcher will start the Brooklyn web console (and any additional webapps specified); default true.
BrooklynLauncher	webconsoleHttps(Boolean useHttps) Specifies whether the webconsole should use https.
BrooklynLauncher	webconsolePort(int port) As webconsolePort(PortRange) taking a single port
BrooklynLauncher	webconsolePort(PortRange port) Specifies the port where the web console (and any additional webapps specified) will listen; default (null) means "8081+" being the first available >= 8081 (or "8443+" for https).
BrooklynLauncher	webconsolePort(String port) As webconsolePort(PortRange) taking a string range
BrooklynLauncher	webServerFlags(Map<String,?> webServerFlags) Specifies additional flags to be passed to BrooklynWebServer.

Methods inherited from class org.apache.brooklyn.launcher.common.BasicLauncher

addLocations, application, application, brooklynProperties, brooklynProperties, brooklynProperties, catalogInitialization, cleanOrphanedState, copyPersistedState, copyPersistedState, copyPersistedState, createApps, getApplications, getBrooklynProperties, getBrooklynPropertiesBuilder, getCampPlatform, getLocations, getManagementContext, getPersistMode, haHeartbeatPeriod, haHeartbeatTimeout, handlePersistence, handleSubsystemStartupError, highAvailabilityMode, ignoreAppErrors, ignoreCatalogErrors, ignorePersistenceErrors, initApps, initBrooklynNode, initCamp, initPersistence, isStarted, location, location, locations, managementContext, markCatalogStartingUp, markStartupComplete, persist, persistenceDir, persistenceDir, persistenceLocation, persistMode, persistPeriod, persistState, populateCatalog, retrieveState, setBrooklynPropertiesBuilder, start, startBrooklynNode, startPartOne, startPartTwo, startPersistence

Methods inherited from class java.lang.Object

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

Constructor Detail

BrooklynLauncher

public BrooklynLauncher()

Method Detail

newInstance

public static BrooklynLauncher newInstance()

Creates a configurable (fluent API) launcher for use starting the web console and Brooklyn applications.

getServerDetails

public BrooklynServerDetails getServerDetails()

webconsole

public BrooklynLauncher webconsole(boolean startWebApps)

Specifies whether the launcher will start the Brooklyn web console (and any additional webapps specified); default true.

installSecurityFilter

public BrooklynLauncher installSecurityFilter(Boolean val)

webconsolePort

public BrooklynLauncher webconsolePort(int port)

As webconsolePort(PortRange) taking a single port

webconsolePort

public BrooklynLauncher webconsolePort(String port)

As webconsolePort(PortRange) taking a string range

webconsolePort

public BrooklynLauncher webconsolePort(PortRange port)

Specifies the port where the web console (and any additional webapps specified) will listen; default (null) means "8081+" being the first available >= 8081 (or "8443+" for https).

webconsoleHttps

public BrooklynLauncher webconsoleHttps(Boolean useHttps)

Specifies whether the webconsole should use https.

bindAddress

public BrooklynLauncher bindAddress(InetAddress bindAddress)

Specifies the NIC where the web console (and any additional webapps specified) will be bound; default 0.0.0.0, unless no security is specified (e.g. users) in which case it is localhost.

publicAddress

public BrooklynLauncher publicAddress(InetAddress publicAddress)

Specifies the address that the management context's REST API will be available on. Defaults to bindAddress if it is not 0.0.0.0.

See Also:

bindAddress(java.net.InetAddress)

webServerFlags

public BrooklynLauncher webServerFlags(Map<String,?> webServerFlags)

Specifies additional flags to be passed to BrooklynWebServer.

webapp

public BrooklynLauncher webapp(String contextPath,
                               String warUrl)

Specifies an additional webapp to host on the webconsole port.

Parameters:

contextPath - The context path (e.g. "/hello", or equivalently just "hello") where the webapp will be hosted. "/" will override the brooklyn console webapp.

warUrl - The URL from which the WAR should be loaded, supporting classpath:// protocol in addition to file:// and http(s)://.

webapp

public BrooklynLauncher webapp(WebAppContextProvider contextProvider)

See Also:

webapp(String, String)

ignoreWebErrors

public BrooklynLauncher ignoreWebErrors(boolean ignoreWebErrors)

stopWhichAppsOnShutdown

public BrooklynLauncher stopWhichAppsOnShutdown(StopWhichAppsOnShutdown stopWhich)

customizeManagement

public BrooklynLauncher customizeManagement(com.google.common.base.Function<ManagementContext,Void> customizeManagement)

shutdownOnExit

public BrooklynLauncher shutdownOnExit(boolean val)

shutdownHandler

public BrooklynLauncher shutdownHandler(ShutdownHandler shutdownHandler)

A listener to call when the user requests a shutdown (i.e. through the REST API)

initManagementContext

protected void initManagementContext()

Overrides:

initManagementContext in class BasicLauncher<BrooklynLauncher>

initBrooklynPropertiesBuilder

protected void initBrooklynPropertiesBuilder()

startingUp

protected void startingUp()

Overrides:

startingUp in class BasicLauncher<BrooklynLauncher>

startWebApps

protected void startWebApps()

startBrooklynNode

protected void startBrooklynNode()

Overrides:

startBrooklynNode in class BasicLauncher<BrooklynLauncher>

customizeBrooklynNodeSpec

protected EntitySpec<LocalBrooklynNode> customizeBrooklynNodeSpec(EntitySpec<LocalBrooklynNode> brooklynNodeSpec)

Overrides:

customizeBrooklynNodeSpec in class BasicLauncher<BrooklynLauncher>

startApps

protected void startApps()

Overrides:

startApps in class BasicLauncher<BrooklynLauncher>

terminate

public void terminate()

Terminates this launch, but does not stop the applications (i.e. external processes are left running, etc). However, by terminating the management console the brooklyn applications become unusable.

globalBrooklynPropertiesFile

public BrooklynLauncher globalBrooklynPropertiesFile(String file)

localBrooklynPropertiesFile

public BrooklynLauncher localBrooklynPropertiesFile(String file)

brooklynPropertiesSupplier

public BrooklynLauncher brooklynPropertiesSupplier(com.google.common.base.Supplier<Map<?,?>> brooklynPropertiesSupplier)

Poperties returned by the supplier have less precedence (get overwritten) by global & local properties