Using CA AppLogic® › Grid Administration Guide › Support Utility

Support Utility

CA AppLogic® includes a utility to help CA Support resolve your issues. The 3tcollect utility is a command-line tool that you can execute on the Backbone Fabric Controller (BFC) or the grid controller to collect log and configuration data.

This section contains the following topics:

Run 3tcollect against a Grid

Collect Log and Configuration Data using 3tcollect

Run 3tcollect against a Grid

3tcollect collects all log and configuration data from the BFC, grid controller, and the servers that form the grid. The output is packaged in a single .zip file that can be transmitted to customer support and CA AppLogic® development for troubleshooting purposes.

Note: Only grid maintainers have access to the 3tcollect utility. Maintainers must also set up the ssh key correctly throughout the grid and enable key forwarding on the ssh client.

Execute the following command to collect grid controller logs and configuration data, and store this data in a .zip archive.

[root@GC test]# ./3tcollect

Note: You can execute this command only from the /usr/local/applogic/bin directory of the grid controller. The .zip file is stored in the /tmp directory.

Execute the following command to collect data of BFC grid controller and servers of that particular grid, and store this data in a .zip archive.

[root@BFC5 bin]# ./3tcollect -g grid_name

Note: You can execute 3tcollect only from the /opt/bfc/bin directory of BFC.

For a list of available grids on BFC, run the following command:

[root@BFC5 bin]# ./3tcollect -l 

The following commands are supported:

3tcollect [--silent] [--timeout] [file] [upload]

3tcollect [--list]

silent

Stops displaying print processing and status information on the screen while running the utility.

timeout

Specific to commands executed on remote systems, which must complete within the allocated timeout span.

file

Uses the specified file name for the resulting .zip file.

[root@BFC5 bin]# ./3tcollect file xengrid3tcollect.zip

Default: 3tcollect_<grid name>.zip

upload

Uploads the resulting file to the specified host using FTP transfer. The format of the upload string is: host: port, user, password, folder. The 'folder' value is optional and must be an existing folder on the FTP server.

list

Lists the grid name, grid controller backbone IP address, and state.

Collect Log and Configuration Data using 3tcollect

The 3tcollect utility works through the back-end network of the BFC or grid controller and collects the following information from the servers and the grid controllers:

• all logs under /var/log
• contents of grub
• all information under /etc/applogic.d (servers only)
• /etc/applogic/applogic.config (grid controller only)
• /etc/applogic.conf (servers only)
• /var/local/applogic (servers only)
• /etc/ha.d/ha.cf (servers only)
• /var/lib/heartbeat/crm/cib.xml (servers only)
• Output from the following utilities:
  • uname –a
  • vmstat
  • ps
  • df
  • mount
  • cat/proc/mdstat
  • cat/proc/cpuinfo
  • rpm list
  • lsmod (server only)
  • lspci (server only)
  • dmidecode (server only)
  • firewall rules (iptables)
  • ifconfig
  • netstat
  • route
  • ip
  • xm list (server only)
  • xm info (server only)
  • history
  • grid controller console output (xm console) (server only)
  • grid controller: grid info
  • grid controller: srv info (for each server)
  • only the following outputs from ESX:
    • info: esxcfg-info -r
    • firewall rules: esxcfg-firewall -q
    • scsi devices: esxcfg-scsidevs -l
    • NAS list: esxcfg-nas -l
    • vmknic list: esxcfg-vmknic -l
    • vswitch list: esxcfg-vswitch -l
    • kernel modules: esxcfg-modules -l
    • Nic list: esxcfg-nics -l
    • Bond list: 3tbond list
    • Vswitch info: vmware-vim-cmd-hostsvc/net/vswitch_info vSwitch0, vmware-vim-cmd-hostsvc/net/vswitch_info vSwitch1
    • list of registered VM: vmware-cmd -l
    • for each VM returned in the preceding command get state: vmware-cmd getstate
    • IOVM status: /usr/local/apl-srv/bin/iovmctl status
    • VSW status: /usr/local/apl-srv/bin/virtswctl status

3tcollect files are located at::

Grid Controller

• executable: /usr/local/applogic/bin/
• config file: /etc/applogic/

BFC Server

• executable: /opt/bfc/bin
• config file: /etc/bfc/

Notes:

The information is stored in a .zip file under the /tmp folder.

zip rpm is mandatory to use this feature on the BFC Server.