<?xml version="1.0" encoding="UTF-8"?>
<cheatsheet title="Create deployment plan">
<intro>
	<description>
		Generate the instance specification of the system and its internal parts, specify values for configuration attributes and finally
		allocate to nodes
	</description>
</intro>
   
<item title="Create initial deployment plan" skip="false">
	<description>
		Up to now, we have modeled components and their composition, but we have not yet instantiated these.
		The convention in Designer is that a single component, typically called System, is the primary
		instance. The instantiation of this component implies an instantiation of its parts which
		in turn will instantiate their parts (if composites). This instantiation process is
		automated by Papyrus designer. The generated instances are part of a package which we call deployment plan
		in the sequence.
		<br/>
		The automatic generation of the initial deployment plan is performed as follows:
		Right click on your "system" component > Instantiate system (create deployment plan).
		As a result, a "newDeploymentPlan" package is created within "DeploymentPlans". Note that a
		deployment plan is a stereotyped UML package serving as a container for the instance
		specifications. A stereotype attribute points to the main instance.
	</description>
</item>

<item title="Configure instance specifications" skip="true">
	<description>
		The initial deployment plan contains information about the instances within their system (along with their allocation
		to a node, see next step). Each instance may have a set of attributes that are subject to configuration, e.g. a FIFO
		component might have an attribute that denotes its size or the application of a specific policy. By default, all
		attributes that are part of a component type, are considered as configuration attributes, attributes of implementations
		need to be marked explicitly by the stereotype FCM::ConfigProperty. UML supports the specification of values via slots.
		This is done in Papyrus designer as well, a custom dialog facilitates this configuration:
		Right click on your "system" component > Configure instantiate properties.
		The dialog displays a set of instance specifications that are associated with the property. The
		previous operation should have created these instances (there should be one instance per deployment plan).
		Once an instance is selected, the user can select a configuration attribute and provide a value for it. If the attribute
		has an attached comment, it is assumed to be a description of the configuration attribute and displayed in the dialog
		(this is the case for elements of the designer library). 
	</description>	 
</item>

<item title="Allocate instance specifications to nodes" skip="true">
	<description>
		In order to deploy the system, the instances created before need to be allocated to a
		node. The allocation relationship is transitive in two directions: if a composite component
		instance is allocated to a node, all sub-instances (= instances of contained parts) are
		implicitly also allocated on this node. Vice versa, a composite needs to exist on all
		instances where its sub-instances are allocated.
		<br></br>
		Designer supports the allocation by means of a specific dialog. It is available in the
		context menu of a deployment plan.
	</description>
</item>

</cheatsheet>