Shell Commands › Application Control › provision (Application Control and Management)--Provision Application

provision (Application Control and Management)--Provision Application

Provision, configure, and start an application. Application configuration parameters may be specified for the new application and sizes for application user and singleton class volumes.

Syntax

app provision <template-app> <target-app> [<option>]* [<prop>=<val>]* [<vol>.[parN.]size=<val>]* 

Parameters

<template-app>

Name of existing application to use as a template.

<target-app>

name of the application that is to be created - the application must not currently exist.

<prop>=<val>

Config parameter pairs as used for the 'app config' command.

<vol>.[parN.]size=<val>

Specify new size for application user or singleton class volumes. Units may be specified (for example, 128M[B], 2G[B]). If units are not provided, it is assumed that the size is in MB. 'parN' specifies the size for partition N. The value can be absolute (that is, 20G) or relative (that is, +10G). parN refers to a primary, extended or logical partition or an lvm logical volume. For primary partitions, this can be specified as parN.size, for logical partitions, the syntax is parN.parM.size (N is the number of the extended partition, M is the number of the logical partition on it starting from 1).For lvm logical volumes the syntax is parN.lv_name.size.

--skipstart

Skip starting of new application

--fscpy

Force copying of volumes using filesystem-level copy. If not specified, volumes are copied using filesystem-level copy only if they are being resized.

--prefill

Allocate ALL blocks for copied volumes. This option is only valid if --fscpy is specified; otherwise it is ignored.

Examples

app provision crm crm2 user_ip=64.4.47.21 out_ip=64.4.47.22
app provision myapp myapp-new data.size=128M mysql.data.size=256M
app provision myapp myapp-new data.size=128M mysql.boot.par1.size=256M mysql.boot.par2.root.size=1G

Notes:

• This command will fail if the template application is running.
• This command will fail if the template application does not have the 'template' attribute set. See 'app config'.
• This operation is similar to 'app copy' with added volume resizing, configuration, and application start.
• A single command can specify size for more than one partition/logical volume, which can also be used with the current size option that changes the size of the volume. If a size is specified for a partition/logical volume and the size of its container (the entity that holds that partition/logical volume) is not specified, the container will be resized to reflect the changes (leaving no free space). If size of the container is specified, it will be honored, which may leave free space on the volume/partition or may cause the operation to fail if the container size is not big enough.
• If more than one partition is being resized, they need to be supported by the same Filer or the operation will fail.
• See 'help app config' for online help on properties and resources. The full and per-property reset are not supported (--reset and -d <prop>).