VTL - How to generate an Xray from a VTL server command line

Asset ID:	1-71-1146464.1
Update Date:	2011-11-28
Keywords:

Solution Type Technical Instruction Sure

Solution 1146464.1 : VTL - How to generate an Xray from a VTL server command line

Applies to:

Sun StorageTek VTL Plus Storage Appliance - Version: 1.0 - Build 1323 to 2.0 - Build 1656 - Release: 1.0 to 2.0
Sun StorageTek VTL Storage Appliance - Version: 4.0 - Build 1221 to 4.0 - Build 1221   [Release: 4.0 to 4.0]
Sun StorageTek VTL Prime System - Version: 1.0 - Build 1813 to 1.1 - Build 2076   [Release: 1.0 to 1.0]
Sun StorageTek VTL Value System - Version: 1.0 - Build 1323 to 1.0 - Build 1323   [Release: 1.0 to 1.0]
Linux x86
Oracle Solaris on x86 (32-bit)
***Checked for relevance on 06-05-2011*** (dd-mm-yyyy)

Goal

This article is expected to assist the customer and/or field support engineer in locally pulling an Xray file from VTL server command line for remote VTL troubleshooting and problem analysis.

Solution

Background

Although Xray can easily be pulled with the VTL Console (see KM doc id 1185517.1), there are times Xray must be pulled through command line locally on the VTL server. This is a step by step procedure for completing the task from command line.

Expectation

This step by step instructions are expected to be used by the customer and/or field support engineer, when an Xray is needed to diagnose problems on Oracle-Sun VTL appliances. Skills needed to complete these steps include Unix command line and ssh.

Note: This procedure requires root access to the VTL server.

Step by Step

Log into VTL server using the virtual or heartbeat IP address.
Note: Heartbeat IP is required if VTL is in a failover state, as virtual IP form failed server will be redirected to surviving server.
Once logged in, verify that you are on the right server with a uname -a command.
Verify that the VTL server has adequate space to hold a new Xray with a df -h command.
Create the Xray from command line with following command, using default values:
Note: this will copy entire messages file which may be large. See section below on using date range to limit size.
ipstorxray `hostname`_`date +%m%d%y_%H%M%S`
This command should build a Xray file with the hostname and the date and time as the file name. You should be able to cut and paste this command, make sure you include the quotes.

A. Running Xray with date range (requires root user):
# ipstorxray -l <startdate@time-enddate@time> <outputfilename>
Where:
* 'startdate@time' is the date and time Xray is to start from. Format = YY/MM/DD@hh:mm:ss
* 'enddate@time' is the ending date and time. Format = YY/MM/DD@hh:mm:ss.
* 'outputfilename' is the file name of the Xray file generated.

Example:
# ipstorxray -l 11/08/20@00:01:00-11/08/21@23:59:00 VTL-node1_08202011

B. Running Xray with date range (with root or vtl user):
NOTE: To use iscon commands with "vtl" user, "enablevtladm" script must be implemented. Contact VTL support or with Oracle internal access, download script from USR.

# iscon getxray -s <server-name> -u <username> -p <password> -l <YYMMDDhhmm-YYMMDDhhmm>

Example:
# iscon getxray -s VTL-node1 -u vtl -p password -l 1108200001-1108212359
(this will collect messages file entries from Aug 21, 2011 at 00:01 (midnight) to Aug 28, 2011 at 23:59)
When the prompt returns from the command, a new Xray file will be created in the /usr/local/vtl/var/xray directory with a file name <hostname>_<date>_<time>.tar.gz on the vtl server (example VTL-node1_010810_123510.tar.gz)

Attachments

This solution has no attachment