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).
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: | When rebooting the AppLogic controller VM, ensure that all applications have been saved in the AppLogic Editor and all running operations have completed. |
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: | 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: | 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.