Document ID: 243150 http://support.veritas.com/docs/243150 E-Mail Colleague IconE-Mail this document to a colleague How to use the VRTSexplorer utility to gather information useful for Symantec Corporation Technical Support Details: VRTSexplorer, also known as Veritas Explorer, vxexplorer, and vxexplore, is a tool provided by Symantec Corporation Technical Support that is executed on a host to gather some of the information that may be needed by a Support Engineer to troubleshoot an issue. The output of this utility is a compressed tar file that must be sent to Support. The information collected may not be sufficient to resolve the issue, but it is likely to give very relevant information about it. This utility will run on Solaris, SUSE Linux, Red Hat Linux, AIX, and HP-UX. Note: No user data is collected by the VRTSexplorer utility. Only the technical information about some server configuration and the installed VERITAS products are collected. For the exact information that is collected by the VRTSexplorer utility, and other additional information refer to the README located in the VRTSexplorer directory after downloading and untarring. The use of VRTSexplorer utility involves three different steps: 1. Obtaining VRTSexplorer 2. Executing the VRTSexplorer binary 3. Sending the output to Symantec Technical Support These steps are detailed below: 1. Obtaining the package that contains the VRTSexplorer utility: Note: The VRTSexplorer utility is now packaged with the Veritas Support Tools, VRTSspt, package which is included on some of the product CDs and available for download. If this package is installed on the host, this step can be skipped unless the latest VRTSexplorer utility is to be run, as the utility is located in the /opt/VRTSspt/VRTSexplorer directory. For more information about the Veritas Support Tools package and the tools that it contains (VRTSexplorer, metasave, vxbench, etc.), please refer to the Related Documents section below. Otherwise, the VRTSexplorer utility must be downloaded from the Symantec FTP site. The package can be downloaded and the binary executed from any directory. However, to remain consistent with installed applications, extract the package in the /opt directory. To download the VRTSexplorer utility, follow the below instructions: Connect to the FTP site: # ftp ftp.veritas.com The below message appears with a prompt for a login name. Log in as the user anonymous. Connected to ftp.veritas.com 220-ftp 220-*********************************************************************** 220- This system is for the use of authorized users only. Individuals 220- using this computer system without authority, or in excess of their 220- authority, are subject to having all of their activities on this 220- system monitored and recorded. 220- In the course of monitoring individuals improperly using this 220- system, or in the course of system maintenance, the activities of 220- authorized users also are monitored. 220- Anyone using this system expressly consents to such monitoring 220- and recording. Please be advised that unauthorized access to this 220- system is a violation of State and Federal law. If monitoring 220- reveals possible evidence of criminal activity, system personnel 220- may provide that evidence to law enforcement officials. 220-*********************************************************************** 220 Name (ftp.veritas.com ): anonymous The below message appears with a prompt for a password. Use a full email address as the password: 331 Guest login ok, send your complete e-mail address as password. Password: customer@email.com While logged into the FTP server as the user anonymous, it is not possible to list any files or directories. It is important that the below steps are followed exactly: Change directories to /pub/support: ftp> cd /pub/support Set FTP mode to binary: ftp> bin Download the file that contains utility: ftp> get vxexplore.tar.Z Close the ftp connection: ftp> bye Untar the download: Untar the downloaded file (only if the VRTSexplorer utility has been downloaded and not installed with the VRTSspt package) : # zcat vxexplore.tar.Z | tar xvf - The above command will create a VRTSexplorer directory containing everything that is needed. Change into this directory: # cd VRTSexplorer 2. Execute the VRTSexplorer utility: Some notes on the execution of VRTSexplorer: · To determine the version of VRTSexplorer that is on the host, along with other options, execute # ./VRTSexplorer -help: # ./VRTSexplorer -help VRTSexplorer: version 5.0f · To run the VRTSexplorer utility for only one particular product, such as Veritas Volume Manager, execute: # ./VRTSexplorer vxvm · To run the VRTSexplorer utility to exclude a particular product, such as Veritas NetBackup, execute: # ./VRTSexplorer -nbu Refer to the README file for additional options that are available with the VRTSexplorer utility. The below messages will appear requesting input for the case number, destination directory, restart of vxconfigd (do not choose to do this if PowerPath is installed or if this is a node in a cluster), etc. The program will output several messages and finish by tarring and compressing the collected information. Please note that this operation can take some time to complete. Below is an example of what might be seen (the messages below are from VRTSexplorer version 5.0f and will be different from earlier versions of the utility) when executing the VRTSexplorer utility to gather information about a host: # ./VRTSexplorer VRTSexplorer: Initializing. VRTSexplorer: Please enter case number, or just hit enter: 150-175-206 VRTSexplorer: Please select a destination directory (default: /tmp): /tmp VRTSexplorer: Using /tmp as destination directory. VRTSexplorer: Collecting system configuration information for SunOS system. VRTSexplorer: Collecting VERITAS package version information. VRTSexplorer: Collecting loadable module information. VRTSexplorer: Collecting SLIM information. VRTSexplorer: Collecting SLIM Agent installer logs. VRTSexplorer: Collecting SLIM Server installer logs. VRTSexplorer: Collecting Cross Product/Platform Installation (CPI) information. VRTSexplorer: Collecting ISIS configuration information. VRTSexplorer: Collecting VERITAS SANPoint Control Console configuration information. ##### All information and files will be placed under /tmp/VRTSexplorer_111-222-333_server1/spc Logfile is /tmp/VRTSexplorer_111-222-333_server1/spc/LOG ##### Capturing SAL/VAIL/VEA information from host server1' ##### Saving VERITAS Package Information.......... ##### Logging VEA Information ##### +Copying vxisis.log files. +Copying /var/vx/isis vxsvc corefiles +Copying /opt/VRTSob/bin vxsvc corefiles ##### Logging VRTSvail Information ##### Checksum /opt/VRTSvail/providers/vx*:............... ##### Saving Detailed information for all VERITAS packages.......................... ##### Saving Host syslogs ##### +Copying syslog files..... VRTSexplorer: Collecting SIG licensing information. VRTSexplorer: Collecting VRW configuration information. VRTSexplorer: Collecting VxFS configuration information. VRTSexplorer: Determining current VxVM operating mode. VRTSexplorer: Collecting VxVM configuration information. VRTSexplorer: Collecting DMP configuration information. NOTICE: This section will stop and restart the VxVM Configuration Daemon, vxconfigd. This may cause your VxVA, VMSA and/or VEA session to exit. This may also cause a momentary stoppage of any VxVM configuration actions. This should not harm any data; however, it may cause some configuration operations (e.g. moving subdisks, plex resynchronization) to abort unexpectedly. Any VxVM configuration changes should be completed before running this section. If you are using EMC PowerPath devices with Veritas Volume Manager, you must run the EMC command(s) 'powervxvm setup' (or 'safevxvm setup') and/or 'powervxvm online' (or 'safevxvm online') if this script terminates abnormally. Restart VxVM Configuration Daemon? [y,n] (default: n) n VRTSexplorer: Collecting VRAS configuration information. VRTSexplorer: Collecting Web GUI Engine information. VRTSexplorer: Script finished. VRTSexplorer: Please ftp /tmp/VRTSexplorer_111-222-333_server1.tar.gz to ftp.veritas.com:/incoming # 3. Send the file created above to Symantec Technical Support: Connect to the FTP site: # ftp ftp.veritas.com The below message appears with a prompt for a login name. Log in as the user anonymous. Connected to ftp.veritas.com 220-ftp 220-*********************************************************************** 220- This system is for the use of authorized users only. Individuals 220- using this computer system without authority, or in excess of their 220- authority, are subject to having all of their activities on this 220- system monitored and recorded. 220- In the course of monitoring individuals improperly using this 220- system, or in the course of system maintenance, the activities of 220- authorized users also are monitored. 220- Anyone using this system expressly consents to such monitoring 220- and recording. Please be advised that unauthorized access to this 220- system is a violation of State and Federal law. If monitoring 220- reveals possible evidence of criminal activity, system personnel 220- may provide that evidence to law enforcement officials. 220-*********************************************************************** 220 Name (ftp.veritas.com ): anonymous The below message appears with a prompt for a password. Use a full email address as the password: 331 Guest login ok, send your complete e-mail address as password. Password: customer@email.com While logged into the FTP server as the user anonymous, it is not possible to list any files or directories. It is important that the below steps are followed exactly: Change into the /incoming directory: ftp> cd /incoming Set FTP mode to binary: ftp> bin Upload the file that was created above: ftp> put VRTSexplorer_150-175-206_server1.tar.Z Close the ftp connection: ftp> bye If this is an existing case, call or email the Technical Support Engineer assigned to the case to let them know the VRTSexplorer data is available along with the name of the file that was uploaded. If a case has not been created for the issue, contact Technical Support via your local support hotline to create a new case, or create a new case on the Web via MySupport at https://mysupport.symantec.com/ and provide the name of the file that was uploaded along with a description of the issue. Related Documents: 261451: How to download the Symantec (formerly VERITAS) Support Tools package http://support.veritas.com/docs/261451 262995: VRTSExplorer hangs or appears to have hung. http://support.veritas.com/docs/262995 Products Applied: Cluster File System 3.4, 3.5 (HP-UX), 3.5 (Solaris) Cluster Server QuickStart 2.0 (Solaris), 3.5 (Solaris) Cluster Server for UNIX 1.0.1 (Solaris), 1.0.2 (Solaris), 1.1 (Solaris), 1.1.1 (HP-UX), 1.1.1 (Solaris), 1.1.2 (Solaris), 1.3.0 (Solaris), 1.3.1 (HP-UX), 2.0 (AIX), 2.0 (Linux), 2.0 (Solaris), 2.1 (Linux), 2.2 (Linux), 3.5 (AIX), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Linux), 4.1 (Solaris), 5.0 (Solaris) Cluster Volume Manager 3.1(Solaris), 3.2 (Solaris), 3.5 (Solaris) File System for UNIX/Linux 2.3 (Solaris), 3.0 (Solaris), 3.2.3 (Solaris), 3.2.4 (Solaris), 3.2.5 (Solaris), 3.2.6 (Solaris), 3.3 (HP-UX), 3.3 (Solaris), 3.3.1(Solaris), 3.3.2 (Solaris), 3.3.3 (Solaris), 3.4 (Linux), 3.4 (Solaris), 3.4.2 (Linux), 3.4.2.0 (AIX), 3.4.2.1 (AIX), 3.4.2.2 (AIX), 3.4.2.3 (AIX), 3.4.3.0 (AIX), 3.4.4.0 (AIX), 3.4.6 (AIX), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (Solaris), 4.1(Linux) FirstWatch for UNIX 2.2.3 (Solaris), 2.2.3.1 (Solaris), 2.2.4 (Solaris), 2.2.5 (Solaris), 2.2.5.1 (Solaris), 2.3 (Solaris) Storage Foundation Basic 4.1 (Linux) Storage Foundation Cluster File System 3.4 (Solaris), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Linux), 4.1 (Solaris) Storage Foundation QuickStart 3.5 (Solaris), 4.0(Linux), 4.0(Solaris), 4.1 (Solaris) Storage Foundation for DB2 4.0 (AIX), 4.0 (Solaris), 4.1 (Linux), 4.1 (Solaris) Storage Foundation for Oracle 1.0, 1.1, 2.0, 2.0.1, 2.0.2, 2.1, 2.1 (HPUX), 2.1.1, 2.1.2, 2.2, 3.0, 3.0 (AIX), 3.0 (Solaris), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Solaris) Storage Foundation for Oracle Real Application Clusters 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Solaris), 4.1(Linux) Storage Foundation for Sybase 4.0 (Solaris), 4.1 (Solaris) Storage Foundation for UNIX/Linux 3.4 (Solaris), 3.4.0 (AIX), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Linux), 4.1 (Solaris), 4.1 MP1 (Solaris) Storage Replicator for Volume Manager 1.0, 1.0.1, 1.0.2, 3.0.2, 3.1 Volume Manager for UNIX/Linux 3.0 (HP-UX), 3.0 (Solaris), 3.1 (HP-UX), 3.1 (Solaris), 3.2 (Linux), 3.2 (Solaris), 3.2.2.0 (AIX), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (Solaris), 4.1(Linux) Volume Replicator 3.0.2 (Solaris), 3.1 (HP-UX), 3.1 (Solaris), 3.2 (AIX), 3.2 (HP-UX), 3.2 (Solaris), 3.5 (HP-UX), 3.5 (Solaris), 4.0 (AIX), 4.0 (Linux), 4.0 (Solaris), 4.1 (HP-UX), 4.1 (Linux), 4.1 (Solaris) Last Updated: June 18 2007 06:39 PM GMT Expires on: 06-17-2008 Subscribe Via E-Mail IconSubscribe to this document Subjects: AIX Application: Informational Cluster File System Application: How To Cluster Server for UNIX Application: How To Cluster Server QuickStart Application: How To Cluster Volume Manager Application: How To File System for UNIX/Linux Application: How To FirstWatch for UNIX Application: How To HP-UX Application: How To Solaris Application: How To Storage Foundation Basic Application: How To Storage Foundation Cluster File System Application: How To Storage Foundation for DB2 Application: How To Storage Foundation for Oracle Application: How To Storage Foundation for Oracle Real Application Clusters Application: How To Storage Foundation for Sybase Application: How To Storage Foundation for UNIX/Linux Application: How To Storage Foundation QuickStart Application: Informational Storage Replicator for Volume Manager Application: How To Volume Manager for UNIX/Linux Application: How To Volume Replicator Application: How To Languages: English (US) Operating Systems: AIX 5.2, 5.3 HP-UX 11.11 Solaris 10, 2.3, 2.4, 2.5, 2.5.1, 2.6, 7.0, 8.0, 9.0 Symantec World Headquarters: 20330 Stevens Creek Blvd. Cupertino, CA 95014 World Wide Web: http://www.symantec.com, Tech Support Web: http://entsupport.symantec.com, E-Mail Support: http://seer.entsupport.symantec.com/email_forms, FTP: ftp://ftp.entsupport.symantec.com or http://ftp.entsupport.symantec.com