- Sun Storage Virtual Tape Library VTL User Guide

Technical support
96267 • G Appendix A VTL command line reference 225
Technicalsupport
GetX‐Ray
iscon getxray -s <server-name> [-u <username> -p <password>]
[-l <#|all|YYMMDDhhmm-YYMMDDhhmm>] [-r] [-o <filename>] [-f] [-X <rpc-
timeout>]
iscon getxray --server-name=<server-name>
[--server-username=<username> --server-password=<password>]
[--get-log=<#|all|YYMMDDhhmm-YYMMDDhhmm>] [--rescan-for-xray] [--output-
file=<filename>] [--force] [--rpc-timeout=<rpc-timeout>]
Description:
Thiscomma n d allowsyoutoge tX‐rayinformationfromtheVTLServerfor
diagnosticpurposes.EachX‐raycontainstechnicalinforma tion aboutyourserver,
suchasserverme ssagesand a sna pshotofyourserverʹscurrentconfigurationand
environment.YoushouldnotcreateanX‐rayunlessyouarerequested
todosoby
yourTechnicalSupportrepres entative.
‐l(‐‐get‐log)isafiltertogetthespecifie dlogmessages.
■ #=numberoflines
■ all=allthelogmessages
■ YYMMDDhhmm‐YYMMDDhhmm=logmessagesindate/timerange
Thedefaultistogetallthelogmessages.
‐r(‐‐rescan‐for‐xray)isanoption torescanthephysicaldevicesbeforethexrayis
taken.Thedefaultisnottorescanthedevices.
‐o(‐‐output‐file)is thefullpa th
ofthefilenametosavethexrayto.Thedefault
outputfilenameformat is:
xray‐YYYY‐MM‐DD‐hh‐mm‐<servername>.tar.gz
Specifythe‐f(‐‐force)optionifyouwanttooverwritetheexistingfileiftheoutput
filealreadyexist s.Otherwise,anerrorwillbereturned.
‐X(‐‐rpc‐
timeout)isanop tio ntospecifyanumberbetween1and30000inseconds
fortheRPCtimeout.Thesystemwillretrythecommandfortheamountoftime
specifiedif theserverdoesnotrespond.ThedefaultRPCtimeoutis300seconds.