Previous Topic: Grid ControlNext Topic: Server Management


grid info Output

This topic contains command output specification.

The output of this command is the following:

Grid Name                   : val
Grid Description            : val
Grid Tag                    : val (only displayed  if --verbose is specified)
AppLogic Version            : val
System Uptime               : val
Controller Uptime           : val
Last Server Failure Time    : val (srv)  (srv is only displayed if last server failure time is not 'none')
Last Metadata Backup        : val
Grid Reboot Required        : val (yes/no)
Controller Reboot Required  : val (yes/no)
Controller IP               : val (only displayed if --verbose is specified)
Grid ID                     : val (only displayed if --verbose is specified)
Current Time                : val (only displayed if --verbose is specified)
System Uptime               : val (only displayed if --verbose is specified)
Grid Public SSH Key         : val (only displayed if --verbose is specified)
HA State                    : val
   Application HA State     : val
   Controller HA State      : val
   Backbone Network HA State: val
   External Network HA State: val
Switches                    : (only displayed if --verbose is specified)
   ID       Name   Network  Mode   Detection Method
   -------------------------------------------------------
   <val>    <val>  <val>    <val>  <val>
   ...
(network may be "backbone", "external" or "mixed")
(mode may be "active", "passive", or "mixed")
Default Locale              : val (only displayed if --verbose is specified)
Available Locales           : (only displayed if --verbose is specified)
   ID            Description
   ----------------------------------------
   <val>         <val>

Server Management Mode      : val
Total servers               : val
Servers running             : val
Servers enabled             : val
Applications running        : val
Bandwidth Oversubscription  : val (on, off, or mixed)
Disk NCQ Enabled            : val (on, off, or mixed)
Volume Repair Speed         : val (num KB/sec or mixed)

Resource Information               : (per hypervisor info is only displayed if --verbose is specified and there
are different hypervisors running on the servers of the grid.)
Entity   Resource Count  Total        Alloc     Hypervisor      Free      Physical      Ratio
---------------------------------------------------------------------------------------------
grid     CPU      <val>  <val>        <val>              -     <val>         <val>       <val>
         MEM          -  <val> GB     <val> GB       <val> MB  <val> GB      <val> GB    <val>
         BW           -  <val> Gbps   <val> Gbps         -     <val> Gbps    <val> Gbps  <val>
         DISK     <val>  <val> GB     <val> GB           -     <val> GB          -          -

<hvisor> CPU      <val>   <val>        <val>             -     <val>         <val>       <val>
         MEM          -   <val> GB     <val> GB      <val> MB  <val> GB      <val> GB    <val>
         BW           -   <val> Gbps   <val> Gbps        -     <val> Gbps    <val> Gbps  <val>
         DISK     <val>   <val> GB     <val> GB          -     <val> GB          -           -
(next hypervisor)

SSL SHA1 Fingerprint        : val  (only displayed if --verbose is specified and present)
Application DNS1            : val  (only displayed if --verbose is specified and present)
Application DNS2            : val  (only displayed if --verbose is specified and present)
Application DNS3            : val  (only displayed if --verbose is specified and present)
Application IP Ranges       : (only displayed if --verbose is specified)
   VLAN Name  VLAN #  Lan   Start     End        Netmask/Prefix   Gateway  DNS1    DNS2  DNS3
   val        val     val   val       val        val              val      val     val   val
                            val2      val2       val2             val2     val2    val2  val2
   val3       val3    val3  val3      val3       val3             val3     val3    val3  val3

If --batch option is specified, the output is the following:

grid <name>
   {
   description          = "val"
   tag                  = "val"  (only displayed if --verbose is specified)
   version              = "val"
   controller_ip        = val (only displayed if --verbose is specified)
   grid_id              = val (only displayed if --verbose is specified)
   current_time         = n_secs (only displayed if --verbose is specified)
   timezone             = "val" (only displayed if --verbose is specified)
   system_uptime        = n_secs
   controller_uptime    = n_secs
   last_srv_failure_time= tstamp
   last_failed_srv      = val
   last_metadata_backup_time= tstamp
   grid_reboot_required = val
   ctl_reboot_required  = val
   grid_public_ssh_key  = "val"  (only displayed if --verbose is specified)
   ha_state             = "val"
   ha_state_apps        = "val"
   ha_state_controller  = "val"
   ha_state_backbone    = "val"
   ha_state_network     = "val"
   switches
      [
      id = <val>, name = <val>, network = <val>, mode = <val>, manufacturer = <val>, model = <val>, detection_method = "<val>"
      ...
      ]
   dflt_locale          = "val" (only displayed if --verbose is specified)
   locales (only displayed if --verbose is specified)
      [
      id = <val>, description = "<val>"
      ...
      ]
   srv_mgmt_mode        = "val"
   srv_total            = val
   srv_running          = val
   srv_enabled          = val
   app_running          = val
   vol_repair_speed     = val
   cpu_total              = val
   cpu_reserved           = val
   cpu_free               = val
   cpu_load               = val
   cpu_alloc              = val
   cpu_thread_total       = val
   mem_total              = val
   mem_reserved           = val
   mem_free               = val
   mem_alloc              = val
   mem_hypervisor         = val
   mem_phy_total          = val
   bw_total               = val
   bw_reserved            = val
   bw_free                = val
   bw_alloc               = val
   bw_phy_total           = val
   bw_oversubscription    = val
   disk_n                 = val
   disk_total             = val
   disk_reserved          = val
   disk_free              = val
   disk_ncq_enabled       = val
   resources (pool name is name of hypervisor - per hypervisor information is only displayed if --verbose is specified and not all grids run the same hypervisor)
      {
      pool <name> disk_alloc=<val>, disk_n=<val>, cpu_total=<val>, cpu_alloc=<val>, mem_hypervisor=<val>, mem_alloc=<val>, bw_total=<val>, cpu_reserved=<val>, mem_total=<val>, disk_reserved=<val>, disk_total=<val>, cpu_phy_total=<val>, cpu_free=<val>, mem_reserved=<val>, disk_free=<val>, bw_free=<val>, bw_reserved=<val>, cpu_load=<val>, mem_free=<val>, bw_alloc=<val>, cpu_thread_total=<val>, mem_phy_total=<val>, bw_phy_total=<val>
      ...
      }
   ssl_sha1_fingerprint = "val" (only displayed if --verbose is specified and present)
   nameservers          = val  (only displayed if --verbose is specified)
   apps_network (only displayed if --verbose is specified)
      [
      vlan <name> 
         {
         num         = <val>
         lan         = <val>
         prefix      = <val>
         gateway     = <val> (optional)
         nameservers = <val> (optional)
         ranges
            [
            start = val, end = val, netmask = val, gateway = val, nameservers = val
            ...
            ]
         }
      ]
   }
grid modify_acl

Replace that portion of the grid ACL which relates to the owner or a principal.

Syntax
grid modify_acl [ <principal>=owner ] [ <principal1>=<val1> ... <principalN>=<valN> ] [ --test_only ]  
Parameters
<principal>=owner

Set the owner attribute of the grid ACL to the specified principal.

<principal>=<val>

Add or replace the specified principal in the grid ACL with access level <val>. <principal> is in the following form:

<name>

Local user or group.

/<name>

Global user or group

<scope>:<type>:<name>

A fully qualified principal name where <scope> is 'global' or 'local', <type> is 'group' or 'user', and <name> is the group or user name. Valid access levels are: 'monitor', 'app_operator', 'app_developer', 'grid_operator', and 'grid_administrator'. If the access level is specified as 'none' the principal is removed from the grid ACL if it is present.

--test_only

Do not replace any portion of the grid ACL but rather test if the operation can succeed.

Examples
grid modify_acl local:user:admin=grid_administrator

Replace that portion of the grid ACL which relates to the local user 'admin', providing grid_administrator access level permissions to this user.

grid modify_acl admin=grid_administrator

Replace that portion of the grid ACL which relates to the local user 'admin', providing grid_administrator access level permissions to this user.

Notes
grid net_discover

Initiate network topology discovery for the grid as a whole.

Syntax
grid net_discover   
Example
grid net_discover  

Initiate network topology discovery for the grid as a whole.

Notes:

grid power_cycle

Power cycle CA AppLogic® grid.

Syntax
grid power_cycle [--kill] [--force] [--restartapps] [reason=text] 
Arguments
--kill

Skip trying to stop any applications that have been started.

--force

Do not prompt for user confirmation.

--restartapps

Restart all running applications upon next reboot of the grid. The applications are not stopped prior to power cycle if this option is specified.

reason=text

Free-form text specifying the reason for the grid power cycle.

Examples
grid power_cycle

Stop all applications and power cycle the grid

grid power_cycle --kill

Power cycle the grid without stopping running applications.

Note: If there are applications running on the grid, they should be stopped prior to executing this command or this command should be executed with --kill option due to the possibility that a server may crash under high I/O load when stopping all applications in parallel.

grid put_acl

Replace the entire grid ACL.

Syntax
grid put_acl <principal>=owner [ <principal1>=<val> ... <principalN>=<val> ] [ --test_only | --force ]  
Parameters
<principal>=owner

Set the owner attribute of the grid ACL to the specified principal.

<principal>=<val>

Add the specified principal to the grid ACL with access level <val>. <principal> is in the following form:

<name>

Local user or group.

/<name>

Global user or group.

<scope>:<type>:<name>

A fully qualified principal name where <scope> is 'global' or 'local', <type> is 'group' or 'user', and <name> is the group or user name. Valid access levels are: 'monitor', 'app_operator', 'app_developer', 'grid_operator', and 'grid_administrator'.

--test_only

Do not replace the grid ACL but rather test if the operation can succeed.

--force

Skip prompting the user for verification.

Examples
grid put_acl local:user:admin=owner local:user:admin=grid_administrator

Replace the grid ACL such that the owner is the local user 'admin' and local user 'admin' has grid_administrator access level permissions.

grid put_acl admin=owner admin=grid_administrator

Replace the grid ACL such that the owner is the local user 'admin' and local user 'admin' has grid_administrator access level permissions.

Notes
grid reboot

Reboot grid.

Syntax
grid reboot [--controller] [--force] [--kill]
grid reboot [reason=<text>] [--force] [--restartapps] [--kill]
grid reboot [--controller] [--flag] [--force] 
Arguments
--controller

Reboot the controller VM only. If this option is not specified, the entire grid is rebooted.

reason=text

Free-form text that describes the reason why the grid is being rebooted. The reason is displayed within the dashboard message following the grid reboot.

--kill

Do not try to stop any applications that are started and do not prompt for verification.

--restartapps

Restart all running applications upon the next reboot of the grid.

--force

Skip prompting user for verification.

--flag

Flag the entire grid or grid controller for reboot (do not actually reboot).

Examples
grid reboot

Reboot the entire grid

grid reboot --restartapps

Reboot the entire grid and restart all running applications.

grid reboot --controller

Reboot the grid controller VM

grid reboot --flag

Flag the entire grid for reboot

Notes:

grid set

Set CA AppLogic® grid configuration parameter.

Syntax
grid set <prop>=<val> 
Arguments
<prop>=<val>

Grid parameter to modify. The following parameters may be set:

Examples
grid set recovery_password=-

Set recovery GUI password.

grid set ha_network=1

Enable network HA for the grid on both the backbone and external networks.

grid set ha_external=1

Enable network HA for the grid on the external network.

grid set ha_backbone=1

Enable network HA for the grid on the backbone network.

grid set backbone=01:02:03:04:05:06

Set switch with an ID of 01:02:03:04:05:06 as active, all backbone network traffic on the servers passes through the NIC connected to that switch.

grid set external=07:08:09:0A:0B:0C

Set switch with an ID of 07:08:09:0A:0B:0C as active, all external network traffic on the servers passes through the NIC connected to that switch.

grid set locale=en_US

Set the default locale to U.S. English.

grid set disk_ncq_enabled=0

Disable NCQ on all servers.

grid set bw_oversubscription=1

Enable bandwidth oversubscription.

grid set vol_repair_speed=1024

Set the volume repair speed to 1024 KB/sec on all servers.

grid set vol_repair_speed=10M

Set the volume repair speed to 10 MB/sec on all servers.

Notes:

grid shutdown

Shutdown grid.

Syntax
grid shutdown [--kill] [--force] 
Arguments
--kill

Skip trying to stop any applications that have been started.

--force

Do not prompt for user confirmation.

reason=text

Free-form text specifying the reason for the grid shutdown.

Examples
grid shutdown  

Shutdown all started applications and shutdown the grid

grid shutdown --kill  

Shutdown the grid without stopping any running applications.

Notes: