OneCapture™ Version 4.9 User Manual
Contents
1. NIC related packages information Kernel Runtime Parameters List of all kernel runtime parameters Network Statistics Summary statistics for each protocol Table of all available network interfaces All current TCP connections Routing table Virtual Memory Statistics Various event counters and memory statistics Disk statistics slabinfo Device Interrupts Emulex device interrupts counter in five second intervals iSCSI Specific Information OneCapture User Manual Current multipath topology multipath II P009673 01A Rev A SE EMULEX Table 3 2 Linux information collected Continued 3 Collected Data 14 Linux Systems Type Information iSCSI module information Parameter modinfo be2iscsi Partition tables File system mount Disk UUID Disk space available File system table etc fstab SCSI information Mount information FC Specific Information modinfo SCSI device info SCSI class information FCoE Specific Information Ipcs driver information SCSI class information sys class scsi Ipfcmlp information proc scsi Ipfcmpl Library Information The version number for the following libraries libdfc libmili libHBA libemulexhbaapi Driver Information RPM packages with be2 prefix name Loaded kernel modules with be22. You can run OneCapture on any of the following operating systems e Windows e Linux e Citrix e FreeBSD e Solaris e VMware ESXi OneCapture is installed as a single exe or sh file Download the appropriate OneCapture file to each of the machines from which you want to collect data You can run OneCapture from any directory or folder on your computer e For Windows systems download the OneCapture exe file e For Linux Citris FreeBSD and Solaris systems download the OneCapture sh file e For ESXi systems download the OneCapture_ESX exe file to a Windows remote host See Running OneCapture on VMware ESXi on page 7 for more information e Before OneCapture can run the sh or exe file it must be uncompressed from the tar or zip file Output is generated as HTML Data may vary according to the system type in use Running OneCapture on Windows For Windows systems the OneCommand Manager application must be installed before running OneCapture Refer to the OneCommand Manager Application User Manual available from the Emulex website for instructions To run OneCapture on Windows 1 From Start Menu gt Run navigate to the folder in which OneCapture file was downloaded and run the OneCapture exe or double click the exe file 2 From the popup window select where you want the OneCapture output file stored You can leave the default path or specify a different one 3 From the drop down menu select the level of
3. Run the shell script for example OneCapture sh 3 Change the script to executable mode for example Chmod 777 OneCapture The progress of the script is displayed For example Running Emulex OneCapture Solaris version Emulex Corporation Report Utility Started at Friday February 1 2013 12 50 42 PM CST Initializing report environment for host solaris Collecting System Information 1 uname a After the OneCapture script finishes gathering information it creates a tarball zipped file in its current working directory Open that file to view the information Command Line Interface Parameters The following are the available CLI parameters h help Displays a brief guide on command usage and supported parameters nocrashdump Does not collect the operating system crash dump files under var crash OneCapture User Manual P009673 01A Rev A 2 Running OneCapture 7 25 EMULEX Running OneCapture on VMware ESXi deaddump Collects the dead firmware dump data Note This command will cause system instability if the adapter is the boot device bootfromsan Skips collecting firmware dump files for all adapters Note You must use this command if the adapter is the boot device in a boot from SAN configuration Running OneCapture on VMware ESXi Before obtaining a OneCapture on VMware ESXi 5 0 or 5 1 e The Windows system must have network access to the ESXi system being captured Ensure the firewall rule
4. 01A Rev A Silent Mode Execution gt e EMULEX 2 Running OneCapture 9 For ESXi systems only Usage example OneCapture ESX exe silent type basic dir C Capture BE3 connect ip address username username password password skip cim Available parameters connect ip address Sets the remote VMware host IP address to which to connect username username Sets the remote VMware host username to which to connect password password Sets the remote VMware host password to which to connect Skip cim This option forces OneCapture not to check whether the CIM provider is installed on the remote VMware host OneCapture User Manual P009673 01A Rev A 3 Collected Data Windows Systems SE EMULEX 3 Collected Data The following tables describe by operating system the information that is collected by OneCapture Windows Systems The following information is available for Windows systems Table 3 1 Windows information collected Type Information System Configuration System information System inventory PCI information CPU information CPUEx information Driver Configuration PnPutil information lt HKLM gt Hardware DeviceMap Scsi NIC NIC occfg information becfg4 output becfg6 output registry parameter value driver parameter value adapters registry value CPU topology IP information NIC tcpglo
5. capture type you want to use You can select Basic Safe Full or Custom e Basic The default selection Select Basic if you do not need to use another type of capture e Safe Use Safe if you are capturing data on a Boot from SAN system e Full Includes all available captures but will result in a system and adapter reboot Use only if needed e Custom Automatically selected when you do a custom pick of components to capture in the checkbox list 4 Click Capture OneCapture User Manual P009673 01A Rev A 2 Running OneCapture 6 gt EMULEX Running OneCapture on Linux Citrix FreeBSD and Solaris OneCapture gathers the needed information and outputs the file to the folder specified After OneCapture is finished running click Finish on the popup window to close OneCapture and view the results Running OneCapture on Linux Citrix FreeBSD and Solaris For Linux Cirtix and Solaris systems the OneCommand Manager application must be installed before running OneCapture Refer to the OneCommand Manager Application User Manual available from the Emulex website for instructions FreeBSD systems do not support the OneCommand Manager application therefore OneCapture will not collect the OneCommand Manager application related data including firmware dumps To run OneCapture on Linux Citrix FreeBSD and Solaris 1 Copy the script file onto the system through SSH Secure Shell or use any other method 2
6. circumstances and offers one or more workarounds for each situation Note If no operating system is specified then the issue is applicable to all operating systems Table 4 1 OneCapture troubleshooting Situation Universal Converged Network Adapter UCNA information was not captured Resolution You must install OneCapture on the system where you are collecting data Install the OneCommand Manager application from the Emulex website Additionally install the driver for the devices on the system The drivers must be installed before driver information is available for capture The output HTML file displays a missing Data File error Ensure that the zipped file has been extracted completely from the archive folder before you open the HTML file Cannot connect although the user name and password are correct Access through OneCapture VMware ESXi is denied VMware systems only Due to the nature of command line processing OneCapture cannot handle the parameter when it includes these special characters 4Q9t amp H gt 7 11 1 Make sure that the username and password do not include any of these special characters and try again After connecting the OneCapture VMware script displays an Emulex CIM provider warning VMware systems only Install the Emulex CIM Provider on the VMware ESXi 5 0 or 5 1 system You can download it from the Emulex website By default OneCapture co
7. gt G EMULEX OneCapture Version 4 9 User Manual P009673 01A Rev A Emulex Connects Servers Storage and People SE EMULEX Copyright O 2013 Emulex All rights reserved worldwide No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex Information furnished by Emulex is believed to be accurate and reliable However no responsibility is assumed by Emulex for its use or for any infringements of patents or other rights of third parties which may result from its use No license is granted by implication or otherwise under any patent copyright or related rights of Emulex Emulex the Emulex logo AutoPilot Installer AutoPilot Manager BlockGuard Connectivity Continuum Convergenomics Emulex Connect Emulex Secure EZPilot FibreSpy HBAnyware InSpeed LightPulse MultiPulse OneCommand OneConnect OneCapture One Network One Company SBOD SLI and VEngine are trademarks of Emulex All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitness for a particular purpose Emulex may make improvements and changes to the product described in this manual at any time and without any notice Emulex assumes
8. no responsibility for its use nor for any infringements of patents or other rights of third parties that may result Periodic changes are made to information contained herein although these changes will be incorporated into new editions of this manual Emulex disclaims any undertaking to give notice of such changes Emulex 3333 Susan Street Costa Mesa CA 92626 Note References to OCe11100 series products also apply to OCe11100R series products OneCapture User Manual P009673 01A Rev A DE EMULEX Table of Contents 3 Table of Contents 1 Introductlol 1214422222 anssn nvdGas ndan d O S aaa Da D M aa laa a Dkr 4 Abbrevlati015 52523252253534 52222 530523 TEX va V V A a VT NiD anA TE RATE RSRTEESR SERES 4 2 Running OneCapture 22a222aaaa vanannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnna 5 Running OneCapture on Windows eeeen nennen nnn nn 5 Running OneCapture on Linux Citrix FreeBSD and Solaris se 6 Command Line Interface Parameters iiisiiasaassssisasnakasannanannaaakansarnniin 6 Running OneCapture on VMware ESXi 2 2 2saa2av aanasnnnnnnnnnnnnnnnnnnnnannnnanannnnna naa 7 Silent Mode ExecutiOn ii 2553 52552523 sasasssan sii sas sa saga sas Iri aisis o sagas asgaggsai ga agads 8 3 Collected Data 111170 msn Goa v Gat a S RRRRXERFYEREARERAERERERRKERRZEXRREAKRGARKRRGARNERER 10 Windows SySste mS 2aaaaaaannnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn
9. prefix name NIC kernel module information modinfo be2net Ipfc kernel module information modinfo Ipfc OneCommand Manager Application Information RPM packages with elx prefix name Running status of process hbanywhere OneCapture User Manual Running status of process ocmanager P009673 01A Rev A SE EMULEX Table 3 2 Linux information collected Continued 3 Collected Data 15 Linux Systems Type Information List of executable files with elx prefix name Parameter List of executable files with mili prefix name rm log cnaboardmgnt log utils install log mili2d log Installer log HBACMD listhbas milirpt version hbaattr local HBA only Kernel Log dmesg kernel log Kernel Configuration Compile time kernel configuration proc config gz xinetd configuration network services daemon configuration Module loading configuration proc modprobe conf Core Dump hbacmd dump hbacmd dump down Crashdump dump CrashDump MPIO Info multipath II etc multipath conf Virtualization Logs var log xen xend log OneCapture User Manual var log libvirt libvirtd log P009673 01A Rev A SE EMULEX Solaris Systems 3 Collected Data 16 Solaris Systems The following information is available from Solaris systems Table 3 3 Solaris i
10. able 3 2 Linux information collected Type Information Parameter System Information Kernel version Distributed version Kernel modules currently loaded Ismod Kernel memory allocations numastat Running processes ps Running tasks top Processors statistics mpstat Memory statistics free Installed packages rpm qa Hardware Information System hardware description through dmidecode SMBIOS DMI PCI Information Tree diagram containing all buses bridges devices and connections Verbose and detailed information plus PCI configuration space dump on devices with Emulex vendor ID Kernel Information OneCapture User Manual P009673 01A Rev A SE EMULEX Table 3 2 Linux information collected Continued 3 Collected Data 13 Linux Systems Type Information CPU structures Parameter proc cpuinfo Memory structures proc meminfo Kernel version proc version System uptime proc uptime Kernel boot parameters proc cmdline System memory mapping proc iomem Memory zones and virtual memory proc zoneinfo Devices group proc partitions Kernel caches proc slabinfo Network device status proc net dev SCSI devices proc scsi scsi NIC Information Network interfaces information ifconfig a NIC driver parameters Firewall configurations iptables
11. bal information NIC tcp offload information NIC SEstats parameters NIC tinylog iSCSI iSCSI information iSCSI target information iSCSI diskpark details OneCapture User Manual P009673 01A Rev A 10 SE EMULEX Table 3 1 Windows information collected Continued Type Information iSCSI SEstats information iSCSI registry information ElxTrace Trace messages MILI MILI log MILI service status Hbacmd MILIReport OneCommand Manager Application Information Hbacmd version Hbacmd ListHBAs Hbacmd ListHBAs local Hbacmd HbaAttribute local Hbacmd PortAttribute local Cnaboardmgmt log RM log OneCommand Manager installer log HBA Core Dump Core dump hbacmd dump Core dump down hbacmd dump down Windows Information Emulex services status setupapi log Event logs Autopilot Information AutoPilotReport FC FCoE iSCSI NIC AutoPilot Configuration Data OneCapture User Manual 3 Collected Data 11 Windows Systems P009673 01A Rev A SE EMULEX Table 3 1 Windows information collected Continued 3 Collected Data 12 Linux Systems Type Information FC FCoE iSCSI NIC MPIO Information mpclaim s mpclaim e Linux Systems mpclaim v The following information is available from Linux systems T
12. cription through dmidecode DMI PCI Information PCI devices list with capabilities pciconf I cv supported with vendor device information NIC Information Interfaces info ifconfig ifx OneConnect info sysctl a grep dev oce IP Firewall ipfw list OneConnect package pkg_info grep oce Kernel Runtime Parameters List of all kernel runtime parameters OneCapture User Manual sysctl a P009673 01A Rev A SE EMULEX Table 3 4 FreeBSD information collected Continued 3 Collected Data 19 VMware Systems Type Information TCP send buffer size Parameter sysctl a grep wmem Netstat Information Per protocol statistics netstat s All Interfaces state netstat i All TCP statistics netstat aP tcp Routing tables netstat rn INET family Streams Stats netstat idb f inet Virtual Memory Statistics Various event counters and memory vmstat s statistics slabinfo vmstat m Device Interrupts Emulex device interrupts counter in 5 seconds interval Log Installer Log Kernel Log All var log messages files Kernel Configuration Kernel Compile configuration usr src sys 1386 conf GENERIC Kernel Bootstrap configuration boot defaults loader conf Crash Dump VMware Systems dump CrashDump The following information is available from VMware s
13. eCommand Manager Application Information Running status of process hbanywhere Running status of process ocmanager List of executables with elx prefix name List of executables with mili prefix name rm log cnaboardmgnt log utils install log mili2d log installer log HBACMD listhbas milirpt version hbaattr local only portattr local only Kernel Log dmesg kernel log Kernel Configuration System parameters etc system Kernel symbols nm x dev ksysm grep OBJ Core Dump hbacmd dump OneCapture User Manual hbacmd dump down P009673 01A Rev A SE EMULEX Table 3 3 Solaris information collected Continued 3 Collected Data 18 FreeBSD Systems Type Information Crash Dump Parameter dump FreeBSD Systems CrashDump The following information is available from FreeBSD systems Table 3 4 FreeBSD information collected Type Information Parameter System Information Kernel information uname a Kernel release uname r Network interfaces ifconfig a Hardware model sysctl a egrep I hw model Clockrate sysctl a egrep hw clockrate CPU Count sysctl a egrep hw ncpu Boot time sysctl a grep boottime Running tasks top d5 n2 Running processes ps ef Kernel modules kldstat Hardware Information System hardware des
14. llects firmware dump data which temporarily takes the adapter offline Linux and Solaris systems only Enable the bootfromsan option which prevents OneCapture from collecting dump data By default OneCapture collects firmware dump data which temporarily takes the adapter offline Vmware and Windows systems only OneCapture User Manual From the GUI set Type to safe mode Safe mode does not collect firmware dump data or from custom mode disable hba dump and hba dumpdown From the CLI use the type safe type safe command which does not collect firmware dump data or type custom and component hba dump hba dumpdown For example OneCapture exe silent type custom component hba dump hba dumpdown other necessary options and P009673 01A Rev A
15. nformation collected Type Information Parameter System Information Kernel version uname a Network interface ifconfig a Processors info psrinfo pv Swap info Swap S Last reboot time last reboot Uptime uptime Running tasks top d 5 n2 Running processes ps ef Loaded modules modinfo Service status SVCS Device status cfgadm al Hardware Information BIOS information smbios PCI buses info scanpci System peripherals info prtconf v System peripherals tree prtconf vp Host HBA info fcinfo hba port NIC Specific Information Network interface ifconfig a IP filter rule etc ipf ipf conf Network Statistics Per protocol statistics netstat s ARP tables netstat p All TCP statistics netstat aP tcp Routing tables netstat rn Multicast memberships netstat g INET family streams stats netstat idm f inet System Statistics OneCapture User Manual System events since boot vmsat s P009673 01A Rev A SE EMULEX Table 3 3 Solaris information collected Continued 3 Collected Data 17 Solaris Systems Type Information Parameter Paging Activity in 5 seconds vmstat p 15 Device Interrupts Emulex device interrupts counter 5 seconds Kernel Parameters System definition sysdef D System definition in device tree format sysdef dD Kernel statistics kstat On
16. nning OneCapture 8 2c EMULEX Silent Mode Execution e Full Includes all available captures but will result in a system and adapter reboot Use only if needed e Custom Automatically selected when you do a custom pick of components to capture in the checkbox list 4 Click Capture 5 Onthe next screen specify the ESXi Connection Information Note Both SSH and CIM use the same credential for the ESXi system 6 Click Capture After OneCapture collects the data it generates a zipped file in the default directory or one that you specified Open that file to view the information Silent Mode Execution To run OneCapture with the GUI in Windows and ESXi in silent mode without user input use the following command line parameters For Windows and ESXi systems Usage example OneCapture exe silent type basic dir C Capture BE3 outputfilename output zip Available parameters silent verysilent silent must be used for silent mode verysilent is for not displaying the progress windows dir x dirname Overrides the default directory in the select output path It can be omitted if default path is used outputfilename output zip Specifies the OneCapture output file name type type name Ho u Chooses the capture type which currently includes basic safe and full h To see Help information The Available Types and Available Components are listed OneCapture User Manual P009673
17. nnnnnnnnnan RUM adm 10 Linux SYSECINS iii iiiiiiiia ossa asina saa i39 an 533a E a3 Ya oaa innn d RR EYES XPVIEX YA PPP AF XE S ANEI 12 Solaris SystemS 22 nnaaanvnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn annan annan annan RE 16 FreeBSD SystemS 2asannannnnanas nnnnnnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannna ARE RAE 18 VMware SYSt emS aassasannannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnan nana naa 19 4 Troubleshooting a2aaaaavv nnvannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnan 22 OneCapture User Manual P009673 01A Rev A 1 Introduction 4 gt lt EMULEX Abbreviations 1 Introduction OneCapture is an Emulex device driver utility that gathers system adapter device driver and applications information You can use this information to examine the functionality of the drivers Data collected by OneCapture is compressed into a single file which can be sent to Emulex Technical Support for analysis when debugging systems or for diagnostic purposes OneCapture is fully supported on OCe11000 series adapters For other models OneCapture can collect most data and basic dump data Abbreviations CIM Common Interface Model CLI command line interface HBA host bus adapter HTML hyper text markup language OS operating system SSH Secure Shell OneCapture User Manual P009673 01A Rev A zx EMULEX 2 Running OneCapture 5 Running OneCapture on Windows 2 Running OneCapture
18. s and network configurations are correct e The Windows system can be a guest OS in a virtual machine The OneCommand Manager application must be installed on the Windows system Refer to the OneCommand Manager Application User Manual available from the Emulex website for instructions The Emulex CIM Provider must installed on the ESXi system Refer to the Emulex CIM Installation Guide available on the Emulex website for instructions e You must enable SSH access on the ESXi system To enable SSH on the ESXi system 1 Press F2 on the ESXi main screen 2 Goto Troubleshooting Options 3 Choose Enable SSH Note Ensure that the user name and password do not include these special characters amp _ lt gt These special characters are not supported To run OneCapture 1 From the Windows system run the OneCapture exe file either through the Start Run window or by double clicking the exe icon 2 Onthe popup window specify the directory where you want the OneCapture file to reside By default this path is set to C Users yourname Documents Emulex OneCapture 3 From the drop down menu select the level of capture type you want to use You can select Basic Safe Full or Custom e Basic The default selection Select Basic if you do not need to use another type of capture e Safe Use Safe if you are capturing data on a Boot from SAN system OneCapture User Manual P009673 01A Rev A 2 Ru
19. ystems Table 3 5 VMware information collected Type VMware vm support package as provided by default manifest in ESXi Information Active directory OneCapture User Manual CIM P009673 01A Rev A SE EMULEX Table 3 5 VMware information collected Continued Type Information Configuration Crash Fault File system Hardware Hung VM Installer Integrity checks Logs Network Performance snapshot Storage System Testing Userworld Virtual Host profiles SCSI proc Ipfc820 dump Debug pages from Ipfc device driver HBA Dump Core dump HBACMD HBA list all under management HBA attributes HBA list local Port attributes MILI log RM log mili2d log Log config tmp log tmp ucna txt OneCapture User Manual etc cim emulex log 3 Collected Data 20 VMware Systems P009673 01A Rev A SE EMULEX Table 3 5 VMware information collected Continued Type Information etc cim emulex dmp OneCapture User Manual etc cim emulex conf 3 Collected Data 21 VMware Systems P009673 01A Rev A 4 Troubleshooting 22 VMware Systems SE EMULEX 4 Troubleshooting There are several circumstances in which your system may operate in an unexpected manner The Troubleshooting section explains many of these
Download Pdf Manuals
Related Search