r27 - 07 Aug 2008 - 13:32:29 - BeckyHYou are here: Wiki >  AppLogic23 Web > CliOutput
ALERT! AppLogic 2.3 Beta Documentation The latest production release is AppLogic 2.4.7

AppLogic Shell - Command outputs

Grid Control Command outputs

grid info

The output of this command is the following:
If AppLogic is running, the following information is displayed:
Grid Name           :  val
Grid Description    :  val
AppLogic Version    :  val 
Controller IP         :  val (only displayed if <tt>--verbose</tt> is specified)
Grid ID                :  val (only displayed if <tt>--verbose</tt> is specified)
Current Time        :  val (only displayed if <tt>--verbose</tt> is specified)
System Uptime       :  val (only displayed if <tt>--verbose</tt> is specified)
Grid Public SSH Key :  val (only dipslayed if <tt>--verbose</tt> is specified)
HA State                : val
Total servers       :  val
Servers running     :  val
Servers enabled     :  val
Applications running:  val
Total CPUs          :  val
Reserved CPUs       :  val (only displayed if <tt>--verbose</tt> is specified)
Free CPUs           :  val
CPU Load            :  val
Allocated CPUs      :  val
Total Memory        :  val MB/GB
Reserved Memory     :  val MB/GB (only displayed if <tt>--verbose</tt> is specified)
Free Memory         :  val MB/GB
Allocated Memory    :  val MB/GB
Total Bandwidth     :  val Mbps
Reserved Bandwidth  :  val Mbps (only displayed if <tt>--verbose</tt> is specified)
Free Bandwidth      :  val Mbps
Allocated Bandwidth :  val Mbps
Total Disks         :  val
Total Storage       :  val MB/GB/TB
Reserved Storage    :  val MB (only displayed if <tt>--verbose</tt> is specified)
Free Storage        :  val MB/GB/TB
SSL SHA1 Fingerprint :  <val>  (only displayed if <tt>--verbose</tt> is specified and present)
If --batch option is specified, the output is the following:
grid <name>          
   {          
   description         = "val"
   version             = "val"
   controller_ip      = val (only displayed if <tt>--verbose</tt> is specified)
   grid_id              = val (only displayed if <tt>--verbose</tt> is specified)
   current_time        = n_secs (only displayed if <tt>--verbose</tt> is specified)
   timezone            = "val" (only displayed if <tt>--verbose</tt> is specified)
   system_uptime       = n_secs (only displayed if <tt>--verbose</tt> is specified)
   grid_public_ssh_key = "val"  (only displayed if <tt>--verbose</tt> is specified)
   ha_state             = "val"
   srv_total           = val 
   srv_running         = val 
   srv_enabled         = val 
   app_running         = val 
   cpu_total           = val 
   cpu_reserved        = val
   cpu_free            = val 
   cpu_load            = val 
   cpu_alloc           = val 
   mem_total           = val 
   mem_reserved        = val 
   mem_free            = val 
   mem_alloc           = val 
   bw_total            = val 
   bw_reserved         = val
   bw_free             = val 
   bw_alloc            = val 
   disk_n              = val 
   disk_total          = val 
   disk_reserved       = val 
   disk_free           = val 
   ssl_sha1_fingerprint = "val" (only displayed if <tt>--verbose</tt> is specified and present)
   }

Server Management Command outputs

server list

The output of this command is a table which contains the following columns:
  • name - name of server
  • state - current state of server (up, down, booting, etc.)
  • CPU Alloc/Free - allocated and free CPU in whole CPUs
  • mem(MB)Alloc/Free - allocated and free memory usage
  • bandwidth(Mbps) Alloc/free - allocated and free bandwidth usage

If --map is specified on the command line, the output of this command is the following for each server:
      server name, state state(enabled), val CPU, val MB mem, val Mbps bandwidth

and a list of application components running on the server:
      name : val CPU, val MB, val Mbps

If --batch is specified on the command line, the output of this command is the following:
      server name : state= val , enabled=val, cpu_alloc=val, cpu_free=val, mem_alloc=val, mem_free=val, bw_alloc=val
bw_free=val
            {
            component name : state=val, cpu=val, mem=val, bw=val
            }

If --verbose is specified on the command line, the output of this command is the same as the server info command except that the information is displayed for each server.

server info

The output of this command is the following:
Name                :  val 
State               :  val 
Enabled             :  val 
IP Address 1        : xxx.xxx.xxx
IP Address 2        : xxx.xxx.xxx
-- CPU Information ---
Total CPUs          :  val 
CPU Type            :  val 
CPU Frequency       :  val  Hz
CPU Bogmips         :  val 
CPU Load            :  val 
Reserved CPU        :  val
Free CPU            :  val
Allocated CPU       :  val
--- Memory Information ---
Total Memory        :  val  MB
Reserved Memory     :  val  MB
Free Memory         :  val  MB
Allocated Memory    :  val  MB
--- Network Bandwidth Information
Total Bandwidth     :  val  Mbps
Reserved Bandwidth  :  val  Mbps
Free Bandwidth      :  val  Mbps
Allocated Bandwidth :  val  Mbps
--- Disk Information ---
Total Disks         :  val 
Disk Total          :  val  MB
Disk Reserved       :  val  MB
Disk Free           :  val  MB

If --map is specified, a list of application components running on the server is displayed with the following information specified for each component:

--- Components ---
   (Table with the following headings: Name, CPU, Memory(MB), Bandwidth(Mbps) 

If --batch is specified, the output is as follows:

server name:
   {
   state           =  val 
   enabled         =  val 
   ip1             =  xxx.xxx.xxx
   ip2             =  xxx.xxx.xxx
   hvm_support     =  val
   n_cpus          =  val 
   cpu_type        =  "val"
   cpu_freq        =  val 
   cpu_bogomips    =  val 
   cpu_load        =  val 
   cpu_reserved    =  val 
   cpu_free        =  val
   cpu_alloc       =  val
   mem_total       =  val 
   mem_reserved    =  val 
   mem_free        =  val 
   mem_alloc       =  val 
   bw_total        =  val
   bw_reserved     =  val
   bw_free         =  val
   bw_alloc        =  val
   n_disks         =  val 
   disk_total      =  val 
   disk_reserved   =  val 
   disk_free       =  val 
If --map is specified, the following is displayed for each component
   component <name>: cpu =  val , mem =  val ,  bw =  val 
   }

Application Mangement Command outputs

application list

The output of this command is a table which contains the following columns (ID, Locked, and Description are displayed only if --verbose is specified).
Name, State, ID, Template, Locked, CPU, Memory (MB), Bandwidth (Mbps), Description

IDEA! CPU, Memory, and Bandwidth columns are displayed in Applogic 2.1.1 and later. IDEA! Locked column is displayed in applogic 2.1.1 with hotfix e2106 and later.

If --batch option is specified, the output of this command is the following for each application:

      application name : state=val, id=val, template=val, [locked,] user1=val, user2=val, cpu=val , mem=val , bw=val, incomplete=val, description="val", doc_url="url", destroy_on_stop=val

state may be stopped, standby, starting, maintenance, running, stopping, failed, unknown

IDEA! cpu, mem, bw, and incomplete values are displayed in Applogic 2.1.1 and later. IDEA! locked value is displayed in AppLogic 2.1.1 with hotfix e2106 and later.

application info

The output of this command is the following:
Name                    : val
Description             : val
ID                      : val
Documentation URL       : val
Template                : yes/no
Locked                  : yes/no
User1                   : val
User2                   : val
Destroy on Stop         : yes/no
State                   : state
CPU                     : val
Memory                  : val MB/GB
Bandwidth               : val Mbps
Default Login Appliance : val

The following is also displayed for each component if --verbose is specified:

    name : val CPU, val MB, val Mbps, server val, state val 

If --batch option is specified, the output of this command is the following:

application <name>  
   {
   description     = "val"
   id              = val
   doc_url         = "val"
   template        = val
   locked          = val
   user1           = "val"
   user2           = "val"
   destroy_on_stop = val
   state           = val
   cpu             = val
   mem             = val
   bw              = val
   dflt_appliance  = "val"
   dflt_appliance_opts = "val"
   incomplete      = val
   }
If --verbose option is specified the following is displayed for each component:
   component name : cpu=val, mem=val, bw=val, server=val, state=val 
   }

application config

The output is the following when --batch is not specified:

application : <app>
<name>      : <val>
...

The output is the following when --batch is specified:

appconfig <app>
   {
   <name> = <val>
   ...
   }

can be one of the following:

  • .name - attribute
  • name - property
  • resource.val - resource, resource can be cpu, mem, val can be min, max, dflt
  • vol. name - volume
  • servers. val - set servers, val can be min, max, set.

Show application boundary

The output is the following when --boundary is specified:
boundary main
   {
   property <name> : type=<type>, dflt=<val>
   property <name> : type=<type>, mandatory
   ...

   resource <name> : min=<min>, max=<max>, dflt=<abs>
   ...
   }

Set configuration from stdin

The format of the input is identical to the output for showing application configuration with --batch. It is expected that a user will show the current values for all properties, attributes, etc., redirect the output to a file, modify what needs to be modified and then execute the set command using the modified file as standard input.

Component Control Command outputs

component list

The output of this command is a table which contains the following columns.
Name, Server, State, CPU(%), Mem(MB), Bandwidth(Mbps) If --batch option is specified, the output of this command is the following for each component:
      component name : cpu=val, mem=val, bw=val, server=val, state=val
state may be stopped, standby, starting, maintenance, running, stopping, moving, failed, unknown

component info

The output of this command is the following:
    name              :  val 
    state             :  val  
    default IP address: xxx.xxx.xxx
    time started      :  val 
    server            :  val 
    cpu               :  val 
    mem               :  val 
    bw                :  val 
If --verbose is specified, the following information is also displayed for each interface:
    Interfaces        :
    (table with the following headings: Name and State)
If --batch is specified, the output of this command is the following:
component name 
   {
   state       = val 
   dflt_ip     = xxx.xxx.xxx.xxx
   t_start     = val 
   t_state_chg = val
   server      = val 
   cpu         = val 
   mem         = val 
   bw          = val
If --verbose is specified, the following information is also displayed for each interface:
   interface  name : state = val 
   }

Interface Control Command outputs

interface list

The output of this command is a table which contains the following columns:
Name, Type, and State.
If --verbose is specified, the table also includes the MAC and IP addresses of the interface.
If --batch is specified the output of this command is the following for each interface (MAC address is included if --verbose is specified):
interface name : type=val, state=val, mac=xx:xx:xx:xx:xx:xx, ip=x.x.x.x
Type may be raw, input, output , or bidir
State may be enabled or disabled

interface info

The output of this command is the following:
Name   : val 
Type   : val 
State  : val 
IP     : x.x.x.x
MAC    : xx:xx:xx:xx:xx:xx
Device : val
Connections:
  (Table with the following columns: Local IP, Remote IP, Type, Local Addr, and Remote Addr)
If --verbose option is specified, the output of this command is:
Interface  name 
   {
   type   = val 
   state  = val 
   ip     = x.x.x.x
   mac    = "xx:xx:xx:xx:xx:xx"
   device = val
   connections
      [
      loc_vip = x.x.x.x, rem_vip = x.x.x.x, type =  val , loc_addr = val , rem_addr = val
      ]
   }

Volume Management Command outputs

volume list

The output of this command is a table which contains the following columns:

Scope Name, Volume Name, Size(MB), State, Filesystem, Mirrored and Mount State

For application, catalog, and cache scopes, the Scope Name column is not included in the output.

If the --verbose option is specified, Link and Comment columns are included in the output.
The states for a volume are:

  • "ok" - all mirrors are available and synchronized
  • "degraded" - volume is accessible, but at least one mirror is down
  • "repairing" - volume is being repaired
  • "migrating" - volume is being migrated
  • "error" - all mirrors are invalid
The mount states for a volume are:
  • "available" - volume is available
  • "in-use" - volume is in use by a running application
  • "mounted" - volume is mounted on the controller

If the --batch option is specified, the output of this command is the following:
volume name : scope_type=val, scope_name=val, size=val, \
              state=val, filesystem=val, n_mirrors=val, \
              mount_state=val,[link,] comment=val

The output specifies a single volume per line.

volume info

The output of this command is the following:
Name             : val
Link              : val (display only if volume is a symbolic link)
Comment          : val
Size             : val
State            : val
Progress         : val% (displayed only if in transitional state)
Filesystem       : val
Mount State      : val
Mounted Device   : val
Current Users    : val
Attributes       : val
Time Created     : val
Time Written     : val
Time Accessed    : val
Number Mirrors   : val
Mirrors          :
   (Table containing the following columns: Server, State)

If the --batch option is specified, the output of this command is the following:

volume name      
   {
   link           = val
   comment       = "val"
   size          = val
   state         = val
   progress      = val (displayed only if in transitional state)
   filesystem    = val
   mount_state   = val
   mount_path    = val
   n_users       = val
   attributes    = val
   time_created  = val
   time_written  = val
   time_accessed = val
   n_mirrors     = val
   mirror <name> : server = val, state = val
   ...
   }

volume create

The output of this command is the following: volume name created [ with filesystem fstype ].

If the --batch option is specified, the output of this command is the following:

volume name
   {
   size     = val
   comment  = "val"
   fs_type  = "val"
   }

volume check

The output of the check command is the following when invoked without any options:
---System Volumes ---
Table with the following columns: Name, Scope, Type, State, Size(MB), Mirrored, Linked
(type can be: repair, migrate, broken, sync, error)

---Orphan Volumes ---
Table with the following headings: Name, State, Size(MB)

The output of the check command is the following when invoked with --batch option:
volume name : scope_name=scope, state=state, type=type, size=size, mirrored=(yes|no|?), [link,] sysvol=logical-vol-name

* type can be: repair, migrate, sync, error, broken or orphan
* name is either the volume name or vrid if orphan volume
* scope_name and sysvol values are omitted when listing orphan volumes

Catalog Management Command outputs

catalog list

The output of this command when listing global catalogs if a table with the following columns:
  • name � name of catalog
  • description � catalog description
If --batch option is specified, the output is the following:
catalog <name> : description="<val>"
...

catalog info

The output of this command is the following (protocols are displayed if -verbose option is provided.
Name                : val
Description         : val
Total classes       : val
Total diskspace     : val GB
Protocols           :
   (table containing the following columns: Name, Filter)
If --batch option is specified, the output is the following:
catalog <name>          
   {          
   description      =  "val"    
   total_classes    =  val  
   total_diskspace  =  val  
   protocol <name>  : filter="<val>"
   }

Class Management Command outputs

class list

The output of this command when listing the contents of a catalog is a table with the following headings:
  • class - name of class
  • category - class category
  • volume size(MB) - size of class volume(s) (if --verbose specified)
  • locked - class is locked (if --verbose is specified)
  • description - class description
If --batch option is specified, the output is the following (volume size as well as protocols are listed if --verbose is specified):
catalog <name>
   {
   class <name> : category="<val>", vol_sz=<val>, [locked,] description="<val>"
   ...

   protocol <name> : filter="<val>"
   ...
   }

-- BeckyH - 23 May 2006

 
Copyright © 2005-2008 3tera, Inc. All Rights Reserved.
%