r27 - 21 Dec 2009 - 12:03:59 - BeckyHYou are here: Wiki >  AppLogic27 Web > CliGrid
ALERT! AppLogic 2.7/2.8 Documentation The latest production release is AppLogic 3.0.30

Grid Control Commands

The following commands are supported to control the AppLogic grid:

      Command       Description
  info   Retrieve current grid information
  get   Retrieve grid configuration parameter Supported in AppLogic 2.7.5+
  set   Set grid configuration parameter Supported in AppLogic 2.7.5+
  reboot   Reboot the AppLogic grid
  power_cycle   Power cycle the AppLogic grid
  shutdown   Shutdown the AppLogic grid

info

Description: Retrieve AppLogic grid status and information
Syntax: grid info [ --batch ] [ --verbose ]
Arguments: --batch Display output in UDL format
--verbose Display additional information
Examples: grid info Retrieve AppLogic grid status and information
Notes: A specification of the output of this command is listed here.
Typical Output
Grid Name               : mygrid
Grid Description        :
AppLogic Version        : 2.7.4 Beta hf3213
System Uptime           : 2 days, 1 hour, 28 minutes
Controller Uptime       : 1 day, 57 minutes
Last Server Failure Time: Thu Aug 27 13:06:33 2009 (srv1)
HA State                : ok
Total Servers           : 2
Servers Running         : 2
Servers Enabled         : 2
Applications Running    : 1
Total CPUs              : 16.00
Free CPUs               : 15.76
CPU Load                : 0.03
Allocated CPUs          : 0.14
Total Memory            : 64.00 GB
Reserved Memory         : 2.38 GB
Free Memory             : 61.17 GB
Allocated Memory        : 448.00 MB
Service Memory          : 0.00 MB
Total Bandwidth         : 4.00 Gbps
Free Bandwidth          : 3.99 Gbps
Allocated Bandwidth     : 14.00 Mbps
Total Disks             : 2
Total Storage           : 3.40 TB
Free Storage            : 3.22 TB

get

Description: Retrieve AppLogic grid configuration parameter
Syntax: grid get/tt> param | --all [--batch]
Arguments: param Name of grid configuration parameter to get. The following parameters may be retrieved:
- recovery_password: Recovery GUI password
--all Retrieve all configurable grid parameters
--batch Display output in UDL format
Examples: grid get recovery_password Retrieve recovery GUI password
Notes: Supported in AppLogic 2.7.5+
A specification of the output of this command is listed here.

set

Description: Set AppLogic grid configuration parameter
Syntax: grid set param=val
Arguments: param=val Grid configuration parameter to set. The following parameters may be set:
recovery_password=- - Prompt for user's password. If the standard input is not a terminal device, it will not print a prompt and expect only one copy of the password on 'stdin' (this can be used for batch operations, to set the password from a file).
IDEA! If not empty, the password must be between 8 and 24 characters in length.
Examples: grid set recovery_password=- Set recovery GUI password
Notes: The grid controller must be rebooted in order for the password change to take effect.
Supported in AppLogic 2.7.5+

reboot

Description: Reboot AppLogic grid
Syntax: grid reboot --controller [--force]
grid reboot [--kill] [--force] [--restartapps] [reason=text]
Arguments: --controller Reboot the controller VM only. If this option is not specified, the entire grid is rebooted. Supported in AppLogic 2.7.5+.
--kill Skip trying to stop any applications that have been started when rebooting the grid. This option is supported in AppLogic 2.8.x+.
--force Do not prompt for user confirmation. Prior to AppLogic 2.8.x, this option had the same functionality as the --kill option.
--restartapps Restart all running applications upon next reboot of the grid. The applications are not stopped prior to reboot if this option is specified.
reason=text Free-form text specifying the reason for the grid reboot.
Examples: grid reboot Stop all applications and reboot the AppLogic grid
grid reboot --kill reboot the AppLogic grid without stopping running applications.
grid reboot --controller reboot the AppLogic grid controller VM.
Notes: IDEA! When rebooting the AppLogic controller VM, ensure that all applications have been saved in the AppLogic Editor and all running operations have completed.
IDEA! 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. SCR 1323

power_cycle

Description: Power cycle AppLogic grid
Syntax: grid power_cycle [--kill] [--force] [--restartapps] [reason=text]
Arguments: --kill Skip trying to stop any applications that have been started. This option is supported in AppLogic 2.8.x+.
--force Do not prompt for user confirmation. Prior to AppLogic 2.8.x, this option had the same functionality as the --kill option.
--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 AppLogic grid
grid power_cycle --kill Power cycle the AppLogic grid without stopping running applications.
Notes: IDEA! 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. SCR 1323

shutdown

Description: Shutdown AppLogic grid
Syntax: grid shutdown [--kill] [--force]
Arguments: --kill Skip trying to stop any applications that have been started. This option is supported in AppLogic 2.8.x+.
--force Do not prompt for user confirmation. Prior to AppLogic 2.8.x, this option had the same functionality as the --kill option.
Examples: grid shutdown Shutdown all started applications and shutdown the AppLogic grid
grid shutdown --kill Shutdown the AppLogic grid without stopping any running applications.
Notes: IDEA! 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 SCR 1323
When this command is executed, the grid servers are powered off and the grid will not come back online without user intervention.

-- BeckyH - 23 May 2006

 
Copyright © CA 2005-2011. All Rights Reserved.
%