Asset ID:	1-71-1146464.1
Update Date:	2011-05-06
Keywords:

---

Solution Type  Technical Instruction Sure

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

Instructions for locally creating an Oracle-Sun VTL Xray from command line

In this Document
  Goal
  Solution
     Background
     Expectation
     Step by Step

---

Applies to:

Sun StorageTek VTL Storage Appliance - Version: 4.0 - Build 1221 to 4.0 - Build 1221 - Release: 4.0 to 4.0
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 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]
Information in this document applies to any platform.
***Checked for relevance on 06-05-2011*** (dd-mm-yyyy)

Goal

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

Solution

Background

Although Xray can easily be pulled with the VTL Console, 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

1. 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.
2. Once logged in, verify that you are on the right server with a uname -a command.
3. Verify that the VTL server has adequate space to hold a new Xray with a df -h command.
4. Create the Xray from command line with following command:
   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 get the grab quotes.
5. Terminal should show progress in building the requested Xray.
6. 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 vtl01_010810_123510.tar.gz)

Attachments

This solution has no attachment