11.28 PuDeploymentOption Object
| Used on |
|
| Description | A deployment-option as its name suggest is used when deploying a GigaSpace application. The deployment-option contains the
settings needed to allow the application to be deployed in the user's preferred structure - cluster schema, number of partitions
and backups etc. The properties are intended to capture high level concepts rather than GigaSpace specific names so that the same
settings can be used for other grid/space implementations.
The pu-deployment-option is available on a processing unit; the deployment-option is available on the application.
The difference between the two is that only the deployment-option allows the specification of
- the target (type of deployment)
- the 'startUi' flag, and
- the target directories for machines.
In the GigaSpace implementation, the only schemas supported are 'primary_backup', 'partitioned' and 'partitioned-sync2backup'
The schema to use is derived from 'number-of-partitions' and 'number-of-backups'.
|
11.28.1 Property 'configProperties'
|
| Description | There are three configProperties values available:
- in the application - this gives an overall default for any values that are not specified at a lower level
- in the deployment - this gives a per-deployment value.
For example, deployments to Amazon EC2 and to in-house machines will need different values for the transaction logger.
You could specify one value in the application's configProperties for in-house testing,
and then override it with per-deployment values for Amazon deployments.
- puDeployment values. This is the most precedent value.
There aren't many CloudTran properties that need specifying at this level.
However there may be application-specific test values that need specifying at the PU deployment level.
This property is a multi-line value, which should be in the format of Java properties (i.e. lines of "property=value").
|
| Type | String |
11.28.2 Property 'description'
|
11.28.3 Property 'maxInstancesPerMachine'
|
| Description | This is the number of processing unit instances of this type (including backups) that can that can exist on a single machine.
So in the warehouse example if the deployment scenarion is 2,3 (2 primary each with 3 backups) max-instances-per-machine=2 this means that no machine can have
more than 2 instances of the warehouse (either primarys or backups) can run on any one machine.
This maps to -max-instances-per-machine option the GigaSpaces 'deploy' command.
|
| Type | Integer |
11.28.4 Property 'name'
|
| Description | This is the name of this deployment option.
It is possible to have multiple deployment options and the name is used to distinguish between them.
Generated deployment configurations are identified by the names of deployment options modelled at the application level.
However, this does not apply if the name is not specified or is empty (0-length); this deployment option is used to specfy defaults.
A named deployment option at the PU level does not automatically lead to a deployment option being generated;
there must be a deployment option of the same name at the application level for that to happen.
However, deployment options at the PU level define specific properties in the deployment configuration for that PU.
See the documentation for the details of the defaulting strategy, but in same the priority order for a specific configuration value is
(1) in a named PU-level deployment option
(2) in a unnamed PU-level deployment option
(3) in a named application-level deployment option
(4) in a named application-level deployment option.
|
| Type | String |
11.28.5 Property 'numberOfBackups'
|
| Description | This is the number of backups that the each space will have. The default value is '0', which means there are no backups.
A value of Y where Y > 0 means there will be a Y backups per space in the cluster
For a GigaSpaces deployment this will value will be used in total-members setting e.g. total-members=X,Y.
|
| Type | String |
11.28.6 Property 'numberOfPartitions'
|
| Description | This is the number of partitions that will be used in this cluster. The default value is '1', which means there will be no
partitioning. Similarly a value of '0' means . A value of X where X > 1 means the cluster will be partitioned and there will be X
partitions. For a GigaSpaces deployment this will value will be used in total-members setting such that total-members=X,Y. In this
example where Y is the number of backups. See 'number-of-backups' for more information.
|
| Type | String |
11.28.7 Property 'text'
|
11.28.8 Property 'vmArguments'
|
| Description | <p>
These are the arguments to be passed to the Java VM, such as "-Xmx2048m" or "-DoverallLoaderClass=com.my.overallLoader".
These arguments are passed on the command line to the JVM before the name of the main program class and
are as described in <a href="http://java.sun.com/javase/6/docs/">the Java documentation</a>.
</p>
<p>
The program arguments that you would normally find in a Java program do not apply in a CloudTran environment,
becaused there is no "main" entry point - that is inside the GigaSpaces components.
Therefore, if you do need to pass arguments to the program, you must do it either via these VMArguments (recommended)
or via a generic setting in the config.properties file (expert use only).
|
| Type | String |
|
