Shell Commands › Application Control › config (Application Control and Management)--Configure Application

config (Application Control and Management)--Configure Application

Show or modify application configuration parameters.

Application configuration parameters specified by <prop> can be one of the following:

• .name: attribute
  • .description - free-form text describing application
  • .doc_url - documentation URL
  • .template - set template attribute for provisioning
  • .destroy_on_stop - destroy application when stopped (useful for temporary applications)
  • .user1, user2 - free-form text used for customer billing information
  • .tag - application tag
  • .pref_virt_mode - name of the preferred virtualization mode for the application
  • .notes - application notes
• name: property
• <resource>.<val> - resource, <resource> can be cpu, mem, bw
  • <val> can be min, max, dflt
  • - cpu.min, cpu.max, cpu.dflt - set cpu resource limits
  • - mem.min, mem.max, mem.dflt - set memory resource limits
  • - bw.min, bw.max, bw.dflt - set bandwidth resource limits
• vol.<name>: volume
• servers.<val> - set servers, <val> can be min, max, set
  • servers.min - set minimum # of servers
  • servers.max - set maximum # of servers
  • servers.set - set list of servers application is to run on (for example "srv1,srv2,...srvN")

Syntax

app config ( <name> | . ) [ --batch ] [ --effective ]
   app config ( <name> | . ) --boundary
   app config ( <name> | . ) [ --reset ] [ <prop>=<val> ]* [ --d <prop> ]*
                             [ --verify  ]
   app config ( <name> | . ) [ <prop>=<val> ]* [ --d <prop> ]* [ --test_only ]
                             [ --verify ]
   app config ( <name> | . ) [--template=<app> [ --skip_rsc } }
                             [ <prop>=<val> ]* [ --test_only ] [ --verify ]
   app config ( <name> | . ) [ --stdin ] [ --verify ] 

Options

--effective

Display the effective configuration for an application - essentially merging the default and the explicitly overridden values.

--boundary

Show application boundary (that is, list of properties that may be configured)

--reset

Reset all properties to default

--template=<app>

Name of application whose configuration is to be used as a base configuration before applying any configuration parameters specified on the command line.

--skip_rsc

Do not propagate any resource settings from the template application.

<prop>=<val>

Change a property setting.

--d <prop>

Reset property to default

--test_only

Test provided configuration parameters, do not set

--batch

Display output in UDL format

--verify

Verify that all mandatory properties are set. If not all mandatory properties are set, the command will fail.

--stdin

Take configuration parameters from standard input - The format is the same as the output of:

'app config <name> --batch'.

Examples

app config app1

Show current configuration for app1

app config app1 --boundary

Show configurable parameters for app1

app config app1 --reset

Reset app configurable parameters for app1 to defaults

app config app1 --template=mytemplate user_ip=192.168.1.2 admin_ip=192.168.1.3

configure application 'app1' using configuration parameters from application 'mytemplate' and set user_ip and admin_ip

Notes

• Using the --template=<app> option is similar to the following:

       'app config mytemplate --batch | app config myapp --stdin'
  

  in that the configuration from 'mytemplate' is configured on 'myapp'.

• The added benefit of using the --template=<app> option is that additional configuration parameters may be specified that override those of the template application.

This section contains the following topics:

application config Command Output Specification