Reference Information › Command Line Shell Reference Guide › Shell Commands › Component Control

Component Control

This section describes commands that manage the components of the application.

This section contains the following topics:

component continue

component info

component list

component login

component restart

component ssh

component start

component stop

component continue

Continue starting of a component.

Syntax

component continue name 

Arguments

name

Name of component to continue starting. name should be of the form application name:component name

Example

component continue sugarcrm:main.config

Continue starting component 'main.config' in application 'sugarcrm'

Note: This command is useful following the failed start of a component started with --debug option.

component info

Retrieve detailed information for a specific component.

Syntax

component info name [ --batch [--extended]][ --verbose ]  

Arguments

name

Name of component for which to retrieve information. name should be of the form application name:component name

--batch

Display output in UDL format

--extended

Display extended component information

--verbose

Include list of interfaces for the component

Examples

component info sugarcrm:main.config - Display information for component 'main.config' in application 'sugarcrm'

Notes: A specification of the output of this command can be found here.

Typical Output

   name                   : main.WEB5
   state                   : running
   default IP address : 10.96.32.1
   console options    : web:80,ssh
   time started         : Tue Sep 16 13:49:29 2008
   server                 : srv1
   cpu                    : 0.30
   mem                  : 512.00 MB
   bw                    : 250.00 Mbps
   OS type            : Linux
   OS name           : CentOS
   OS version         : 5
   OS kernel          : Linux 2.6.18.8-xenU #1 SMP Mon Aug 18 15:15:18 PDT 2008
   PV driver           : unknown
   class                : .WEB5

component info Output

This topic contains command output specification.

Non-batch Output

name               : <val>
state              : <val>
default IP address : <val>
console options    : <val>
time started       : <val>
server             : <val>
cpu                : <val>
mem                : <val>
service mem        : <val>
bw                 : <val>
OS type            : <val>
OS name            : <val>
OS version         : <val>
OS kernel          : <val>
PV driver          : <val>
class              : <val>
Metered RX Packets : val (if --verbose is specified)
Metered TX Packets : val (if --verbose is specified)
Metered RX Bytes   : val (if --verbose is specified)
Metered TX Bytes   : val (if --verbose is specified)

Interfaces         : (if --verbose is specified)
   Name            State
   default         active

Batch Output

component <name>
   {
   state            = <val>
   dflt_ip          = <val>
   console_options  = <val>
   t_start          = <val>
   t_state_chg      = <val>
   server           = "<val>"
   cpu              = <val>
   mem              = <val>
   mem_hypervisor   = <val>
   bw               = <val>
   os_guess         = "<val>"
   os_type          = "<val>"
   os_name          = "<val>"
   os_version       = "<val>"
   os_kernel        = "<val>"
   pv_driver        = "<val>"
   class            = "<val>"
   metered_rx_pkts  = <val>
   metered_tx_pkts  = <val>
   metered_rx_bytes = <val>
   metered_tx_bytes = <val>
   interface <name> : state = <val>
   ...
   }

component list

List all components for the specified running application.

Syntax

component list name [ --batch [--extended] ]  

Arguments

name

Name of application for which to retrieve list of components

--batch

Display output in UDL format

--extended

Display all component information in the list

Examples

component list lamp 

List components for application 'lamp'

Notes: A specification of the output of this command can be found here.

Typical Output

Name         Server  State     CPU  Mem(MB)  Bandwidth(Mbps)
main.usr     srv1    running  0.10   128.00            10.00
main.content srv1    running  0.05    96.00            10.00
main.dbase   srv1    running  0.10   160.00            10.00
main.srv     srv1    running  0.10   160.00            10.00
main.net     srv1    running  0.05    96.00            10.00

component list Output

This topic contains command output specification.

Non-batch Output

Name  Server  State  CPU  Mem(MB) Bandwidth(Mbps)
val   val     val    val      val              val
…

Batch Output

component name : cpu = val, mem = val, bw = val, server = val, state = val
…

Batch Output Extended

component name: cpu=val, mem=val, mem_hypervisor=val, bw=val, server=val, state=val,
n_int_ifc=val, n_ext_ifc=val, n_vols=val, pinned=val, is_hvm=val, failover_grp="val",
os_name="val", os_version="val", os_extra="val", virt_mode=<val>,
supported_virt_modes=<val>, metered_rx_pkts = val, metered_tx_pkts = val,
metered_rx_bytes = val, metered_tx_bytes = val
…

component login

Login to component's virtual machine.

Syntax

component login <name> [--ssh] [console=text|graphic] [--force] [--abort] [command] 

Parameters

<name>

Name of component to login to

--ssh

SSH into component (default)

console=text

Access text console

console=graphic

Access graphical console

--force

Take control of console (kill existing console)

--abort

Kill existing console (if any)

command

Optional command line to execute. If there is more than one argument, the command must be enclosed in quotes (for example, "ls /tmp"). This argument is only valid if --ssh is specified.

Examples

component login sugarcrm:main.config

SSH into component 'main.config' in application 'sugarcrm'

component login sugarcrm:main.config "ls /tmp"

SSH into component 'main.config' in application 'sugarcrm' and execute ls /tmp

component login sugarcrm:main.config console=text

Access text boot console of appliance instance.

Notes:

• This command will fail if the component is not started.
• When no command line options are specified, login to the component using the default console that is specified for the component.
• The ssh login is performed using a special appliances ssh key installed on your grid. This key does not need a passphrase -- it is assumed that if you are logged in on the controller, you are authorized to log in on the appliances. Contact Technical Support if you cannot log in on an appliance or if you believe your appliance key has been compromised and want to have it replaced.

  Graphical console should be accessed through the GUI.

  Whenever a user logs into an appliance, CA AppLogic creates an environment variable named _APPLOGIC_USERID which contains the name of the user that logged into the appliance. This is only valid if the appliance uses the DHCP configuration mode (APK).

component restart

Restart a component.

Syntax

component restart <name> (prop=val)* [ --debug ] [ --kill ] [ --force] 

Parameters

<name>

Name of component to restart. <Name> should be of the form: <application name>:<component name >

prop=val

Parameters for scheduling of component. The following parameters may be specified:

• cpu - (optional) CPU allocation (val[%])
• mem - (optional) Memory allocation (val[M[B]|G[B]]). If units are not specified, memory is in MB.
• bw - (optional) Bandwidth allocation (val[M[b]|G[b]]). If units are not specified, bandwidth is in Mbps.

--debug

Start component in debug mode.

--kill

Force the stopping of the component (that is, abort) prior to restart. .

--force

Skip user verification.

Examples

component restart sugarcrm:main.config

Restart component 'main.config' in 'application sugarcrm'

component restart my-app:comp1 --debug

Restart component in debug mode

component restart my-app:comp1 mem=64M bw=10M

Restart component with scheduling parameters

Note: This command will fail if the application is not running. This command combines component stop and start commands.

component ssh

Ssh into the virtual machine of a component.

Syntax

[component] ssh <name> [command] 

Parameters

<name>

Name of component to log into

command

Optional command to execute on the appliance.

Examples

component ssh sugarcrm:main.config

SSH into component 'main.config' in application 'sugarcrm'

component ssh sugarcrm:main.config --ssh "ls /tmp"

SSH into component 'main.config' in application 'sugarcrm' and execute ls /tmp

Notes:

• This command will fail if the component is not running.
• This command is identical to executing comp login name

  The ssh login is performed using a special appliances ssh key installed on your grid. This key does not need a passphrase -- it is assumed that if you are logged in on the controller, you are authorized to log in on the appliances. Contact Technical Support if you cannot log in on an appliance or if you believe your appliance key has been compromised and want to have it replaced.

• Whenever a user logs into an appliance, CA AppLogic creates an environment variable named _APPLOGIC_USERID which contains the name of the user that logged into the appliance. This is only valid if the appliance uses the dhcp configuration mode (APK).

component start

Start a component.

Syntax

component start <name> (prop=val)* [ --debug ] 

Parameters

<name>

Name of component to start. <Name> should be of the form: <application name>:<component name>

prop=val

Parameters for initial scheduling of component. The following parameters may be specified:

• cpu - (optional) CPU allocation (val[%])
• mem - (optional) Memory allocation (val[M[B]|G[B]]). If units are not specified, memory is in MB.
• bw - (optional) Bandwidth allocation (val[M[b]|G[b]]). If units are not specified, bandwidth is in Mbps.

--debug

Start component in debug mode.

Examples

component start sugarcrm:main.config

Start component 'main.config' in 'application sugarcrm'

component start my-app:comp1 --debug

Start component in debug mode

component start my-app:comp1 mem=64 bw=10

Start component with scheduling parameters

Notes:

• This command will fail if the application is not running.
• Starting a component resets the component's flapping counter that is maintained by CA AppLogic. A component's flapping counter is the number of times that component has failed within the last 24 hours. Each component has its own flapping counter. Once a component fails 3 times in 24 hours, the component is not restarted by CA AppLogic. comp restart or app start/restart may also be used to reset a component's flapping counter.

component stop

Stop a component.

Syntax

component stop <name> [ --kill ] [ --force ] 

Parameters

<name >

Name of component to stop. <Name> should be of the form:<application name>:<component name>

--kill

Force the component to stop (that is,, non-graceful shutdown). This option is supported only in CA AppLogic 2.8.x+. Forcing a component to stop may cause data corruption.

--force

Skip user verification. Prior to CA AppLogic 2.8.x this option has the same functionality as the --kill option.

Example

component stop sugarcrm:main.config

Stop component 'main.config' in application 'sugarcrm'