When problems occur, support engineers need data points, debug tracing and context information to help determine root causes. Preparation and organization of commonly used tools has always been a time-consuming challenge, especially during outages. The Citrix diagnostics toolkit (CDT) addresses these challenges by rapidly deploying a suite of tools and options in an easy-to-use structured format. Learn how and when to use this toolkit and how it helps Citrix deliver better support.
3. 3
Frank
is
a
Lead
Escala0on
Engineer
on
the
Cri0cal
Situa0on
Team.
He
has
been
with
Citrix
over
9
years
and
is
a
subject
maCer
expert
on
all
things
IMA
and
SQL
related.
Previously,
he
worked
as
an
independent
consultant
for
small
to
medium-‐size
businesses
in
Florida
He
holds
an
Electronic
Engineering
degree
from
I.T.T.
Technical
Ins0tute
of
Florida.
4. Set
the
stage
Present
key
session
takeaways
Time
is
money
One
download
….
Over
20
tools
!
Introduce
data
collec0on
as
primary
talking
point
How
do
Citrix
Engineers
approach
troubleshoo0ng
?
Ques0ons
admins
are
faced
with
during
troubleshoo0ng
sessions
The
Citrix
Diagnos0cs
Toolkit
What
it
is
and
what
its
not
The
install
The
look
and
feel
The
Packager
Integra0ng
3rd
party
tools
The
uninstall
Wrap
up
Comments
from
the
field
CDT
and
TAAS
Applicable
Products
Key
session
takeaways
Resources
Now
that
you’ve
seen
the
concept,
Go
download
and
share
your
thoughts
with
Frank
Marzullo
4
5. The
keys
to
saving
0me
in
most
situa0ons,
not
only
in
technology
but
in
life
and
business
as
well
come
from
efficiency.
Efficiency
comes
from
organiza0on
and
execu0on.
5
6. When
a
tradesman,
like
a
carpenter
or
plumber
arrives
on
a
job
site.
If
he
has
all
the
tools
and
parts
needed
to
complete
the
job
and
they
are
organized
on
his
truck.
There
is
a
good
chance
the
repair
will
go
quickly
and
get
done
correctly.
Conversely,
if
he
is
unprepared
and
unorganized
the
job
will
likely
take
much
longer
and
will
not
get
done
correctly.
6
7. What
do
we
do
with
all
these
tools?
We
collect
data
!
7
8. What
do
we
do
with
all
these
tools?
We
collect
data
!
8
10. When
problems
occur,
data
points,
debug
tracing,
and
context
informa0on
are
things
that
support
engineers
will
collect
to
help
determine
root
cause.
Later
this
same
informa0on
can
be
used
to
affect
product
change
if
applicable.
The
prepara0on
and
organiza0on
of
commonly
used
tools
has
always
been
a
0me
consuming
challenge
especially
during
outages.
We
have
all
experienced
this
at
least
once
in
our
careers
but
one
0me
is
all
it
takes
to
create
that
painful
memory.
Trying
to
coordinate
the
download
and
setup
of
mul0ple
diagnos0c
tools
to
aid
in
troubleshoo0ng
or
some0mes
just
enabling
the
logging
func0onality
of
a
product
can
be
a
cumbersome
and
extremely
0me
consuming
task.
If
my
opening
thoughts
have
hit
home,
let
me
take
you
on
an
exi0ng
journey
into
a
concept
were
“You
and
I”
the
people
responsible
for
suppor0ng
the
environments
our
companies
and
customers
deploy
for
business
agility.
Get
something
that
makes
us
agile
in
those
cri0cal
moments
when
things
go
wrong.
Who’s
interested
?
10
11. When
problems
occur,
data
points,
debug
tracing,
and
context
informa0on
are
things
that
support
engineers
will
collect
to
help
determine
root
cause.
Later
this
same
informa0on
can
be
used
to
affect
product
change
if
applicable.
The
prepara0on
and
organiza0on
of
commonly
used
tools
has
always
been
a
0me
consuming
challenge
especially
during
outages.
We
have
all
experienced
this
at
least
once
in
our
careers
but
one
0me
is
all
it
takes
to
create
that
painful
memory.
Trying
to
coordinate
the
download
and
setup
of
mul0ple
diagnos0c
tools
to
aid
in
troubleshoo0ng
or
some0mes
just
enabling
the
logging
func0onality
of
a
product
can
be
a
cumbersome
and
extremely
0me
consuming
task.
If
my
opening
thoughts
have
hit
home,
let
me
take
you
on
an
exi0ng
journey
into
a
concept
were
“You
and
I”
the
people
responsible
for
suppor0ng
the
environments
our
companies
and
customers
deploy
for
business
agility.
Get
something
that
makes
us
agile
in
those
cri0cal
moments
when
things
go
wrong.
Who’s
interested
?
11
12. The
Citrix
Diagnos0cs
Toolkit
addresses
this
challenge
by
rapidly
deploying
a
suite
of
tools
and
op0ons
in
an
easy
to
use
structured
format.
The
format
closely
resembles
the
look
and
feel
of
any
standard
Windows
applica0on,
even
though
each
tool
is
an
independent
standalone
applica0on
itself.
12
16. It’s
a
suite
of
individual
standalone
applica0ons,
tools
and/or
u0li0es.
It
address
the
pain
of
organizing,
configuring
and
execu0ng
complex
data
collec0on
scenarios
by
automa0ng
and
simplifying
these
steps,
with
the
familiar
look
and
feel
of
a
standard
windows
applica0on
and
installer.
Think
of
it
as
an
agility
plaiorm
for
you
the
sojware
support
specialist,
system
admin
or
IT
professional.
Just
like
the
carpenter
and
plumber
we
discussed
earlier,
this
is
your
toolkit
!
16
17. This
is
done
inten0onally.
DO
NOT
NEST
the
default
install
path.
Nes0ng
will
cause
some
or
all
of
the
task
automa0on
to
not
work
properly.
If
your
system
drive
is
not
detected,
change
the
drive
leCer
only.
For
example,
if
your
system
drive
is
“H”
then
you
may
enter
H:
as
the
install
des0na0on
but
not
H:
mytoolstemp
NOTE:
The
%SystemDrive%
is
were
the
windows
“system32”
directory
lives.
Be
sure
this
is
were
you
install
CDT
to
guarantee
proper
func0onality
of
all
components.
17
18. This
is
done
inten0onally.
DO
NOT
NEST
the
default
install
path.
Nes0ng
will
cause
some
or
all
of
the
task
automa0on
to
not
work
properly.
If
your
system
drive
is
not
detected,
change
the
drive
leCer
only.
For
example,
if
your
system
drive
is
“H”
then
you
may
enter
H:
as
the
install
des0na0on
but
not
H:
mytoolstemp
NOTE:
The
%SystemDrive%
is
were
the
windows
“system32”
directory
lives.
Be
sure
this
is
were
you
install
CDT
to
guarantee
proper
func0onality
of
all
components.
18
19. This
is
done
inten0onally.
DO
NOT
NEST
the
default
install
path.
Nes0ng
will
cause
some
or
all
of
the
task
automa0on
to
not
work
properly.
If
your
system
drive
is
not
detected,
change
the
drive
leCer
only.
For
example,
if
your
system
drive
is
“H”
then
you
may
enter
H:
as
the
install
des0na0on
but
not
H:
mytoolstemp
NOTE:
The
%SystemDrive%
is
were
the
windows
“system32”
directory
lives.
Be
sure
this
is
were
you
install
CDT
to
guarantee
proper
func0onality
of
all
components.
19
20. You
must
s0ll
run
the
install
and
tools
as
Administrator.
If
UAC
or
lockdown
policies
are
applied
to
your
windows
OS
simply
use
the
“Run
as”
op0on
in
windows.
Some
tools
included
or
downloaded
ajer
CDT
is
installed
may
have
sojware
pre-‐
requisites
or
require
reboots.
Reference
each
tool’s
readme
for
more
details
or
ask
your
Citrix
Support
representa0ve
for
guidance.
In
most
cases
you
will
be
working
with
support
and
they
will
be
leveraging
the
toolkit
to
assist
you.
20
22. All
tools
are
categorized
by
func0on
or
use
case.
22
23. Same
concept
applies
to
the
following
products.
You
get
the
tools
specific
to
scenarios
that
match
your
product
selec0on
during
install.
XenApp
Web
Interface
XenDesktop
VDA/Receiver
Provisioning
Server
23
24. The
data
folder
is
a
temporary
repository
were
ac0ve
trace
data
is
stored.
Once
the
“Stop
Trace”
shortcut
is
clicked
the
packager
will
compress
and
move
all
the
data
to
the
upload
folder
were
it
is
staged
and
ready
for
delivery
to
Citrix
or
other
vendor
support
resources.
24
25. This
shortcut
sets
up
22
categories,
350
counters,
sample
intervals,
labels
and
specifies
file
des0na0on
in
less
than
4
seconds.
25
26. This
shortcut
sets
up
22
categories,
350
counters,
sample
intervals,
labels
and
specifies
file
des0na0on
in
less
than
4
seconds.
26
27. Who
remembers
how
to
enable
logging
for
Web
Interface?
Drawing
a
blank?
Now
we
can
setup
logging
on
mul0ple
sites
in
seconds.
Without
having
to
manually
edit
mul0ple
XML
files
manually.
27
28. Who
remembers
how
to
enable
logging
for
Web
Interface?
Drawing
a
blank?
Now
we
can
setup
logging
on
mul0ple
sites
in
seconds.
Without
having
to
manually
edit
mul0ple
XML
files
manually.
28
35. This
is
how
we
used
to
trigger
mul0-‐vector
tracing
before.
Now
with
C.D.T.
one
shortcut
does
it
all
and
there
is
no
file
fishing
because
we
know
all
our
trace
data
will
be
in
the
“data”
directory.
35
36. This
is
how
we
used
to
trigger
mul0-‐vector
tracing
before.
Now
with
C.D.T.
one
shortcut
does
it
all
and
there
is
no
file
fishing
because
we
know
all
our
trace
data
will
be
in
the
“data”
directory.
36
37. In
the
next
release
of
CDT
these
op0ons
will
also
be
available
for
VDA,
XenDesktop
and
PVS.
1st
Image
is
Xenapp
2nd
Image
is
Web
Interface
3rd
Image
is
Receiver
37
38. In
the
next
release
of
CDT
these
op0ons
will
also
be
available
for
VDA,
XenDesktop
and
PVS.
1st
Image
is
Xenapp
2nd
Image
is
Web
Interface
3rd
Image
is
Receiver
38
39. In
the
next
release
of
CDT
these
op0ons
will
also
be
available
for
VDA,
XenDesktop
and
PVS.
1st
Image
is
Xenapp
2nd
Image
is
Web
Interface
3rd
Image
is
Receiver
39
40. In
the
next
release
of
CDT
these
op0ons
will
also
be
available
for
VDA,
XenDesktop
and
PVS.
1st
Image
is
Xenapp
2nd
Image
is
Web
Interface
3rd
Image
is
Receiver
40
42. The
packager,
handles
collec0ng
all
the
context
data
a
Citrix
support
engineer
and
other
vendor
support
representa0ves
would
need
to
compliment,
the
trace
and
debug
data
you
captured.
This
mean
you
will
never
forget
a
context
item
again.
The
data
will
help
Citrix
and
other
vendors
iden0fy
the
point
of
failure
and
then
Citrix
and/or
other
vendors
will
determine
the
next
steps,
including
but
not
limited
to:
impact
mi0ga0on,
temporary
workarounds,
product
code
changes
and
product
enhancements.
42
43. Exports
Windows
Applica0on
&
System
Event
logs
in
CSV
format
Captures
a
Qwinsta
command
output
to
a
.txt
file.
(XenApp
&
Receiver
setups
)
Captures
a
Routeprint
command
output
to
a
.txt
file
Captures
a
SystemInfo
command
output
to
a
.txt
file
Captures
a
Cpatch
command
output
to
a
.txt
file
(XenApp
only
–
Hoiix
list)
Creates
an
.NFO
file
leveraging
MSinfo32.exe
(useful
in
PVS,
XenDesktop
and
Receiver
related
cases,
provides
in-‐depth
system
details
like
NIC
make
model
and
driver,
Video
and
Audio
codec
and
much
more.)
The
packager
then
compresses
the
contents
of
the
Data
folder
and
clears
the
contents
of
the
Data
folder
to
prevent
file
sprawl
and
disk
space
over
usage.
The
“Upload”
folder
and
a
browser
window
poin0ng
to
the
Auto
Support
(TaaS)
site
will
be
launched
for
your
convenience
and
speedy
upload
of
the
data.
Displaying
the
zip
file
with
all
your
data
inside
allows
the
opportunity
to
sani0ze
any
files
or
scrub
the
contents
prior
to
sending
to
Citrix
Support
for
analysis.
This
is
most
43
44. Exports
Windows
Applica0on
&
System
Event
logs
in
CSV
format
Captures
a
Qwinsta
command
output
to
a
.txt
file.
(XenApp
&
Receiver
setups
)
Captures
a
Routeprint
command
output
to
a
.txt
file
Captures
a
SystemInfo
command
output
to
a
.txt
file
Captures
a
Cpatch
command
output
to
a
.txt
file
(XenApp
only
–
Hoiix
list)
Creates
an
.NFO
file
leveraging
MSinfo32.exe
(useful
in
PVS,
XenDesktop
and
Receiver
related
cases,
provides
in-‐depth
system
details
like
NIC
make
model
and
driver,
Video
and
Audio
codec
and
much
more.)
The
packager
then
compresses
the
contents
of
the
Data
folder
and
clears
the
contents
of
the
Data
folder
to
prevent
file
sprawl
and
disk
space
over
usage.
The
“Upload”
folder
and
a
browser
window
poin0ng
to
the
Auto
Support
(TaaS)
site
will
be
launched
for
your
convenience
and
speedy
upload
of
the
data.
Displaying
the
zip
file
with
all
your
data
inside
allows
the
opportunity
to
sani0ze
any
files
or
scrub
the
contents
prior
to
sending
to
Citrix
Support
for
analysis.
This
is
most
44
45. Exports
Windows
Applica0on
&
System
Event
logs
in
CSV
format
Captures
a
Qwinsta
command
output
to
a
.txt
file.
(XenApp
&
Receiver
setups
)
Captures
a
Routeprint
command
output
to
a
.txt
file
Captures
a
SystemInfo
command
output
to
a
.txt
file
Captures
a
Cpatch
command
output
to
a
.txt
file
(XenApp
only
–
Hoiix
list)
Creates
an
.NFO
file
leveraging
MSinfo32.exe
(useful
in
PVS,
XenDesktop
and
Receiver
related
cases,
provides
in-‐depth
system
details
like
NIC
make
model
and
driver,
Video
and
Audio
codec
and
much
more.)
The
packager
then
compresses
the
contents
of
the
Data
folder
and
clears
the
contents
of
the
Data
folder
to
prevent
file
sprawl
and
disk
space
over
usage.
The
“Upload”
folder
and
a
browser
window
poin0ng
to
the
Auto
Support
(TaaS)
site
will
be
launched
for
your
convenience
and
speedy
upload
of
the
data.
Displaying
the
zip
file
with
all
your
data
inside
allows
the
opportunity
to
sani0ze
any
files
or
scrub
the
contents
prior
to
sending
to
Citrix
Support
for
analysis.
This
is
most
45
46. This
func0onality
can
be
toggled
by
typing
the
commands
below
at
the
RUN
line.
taaslaunchoff
taaslaunchon
–
on
by
default.
46
47. This
func0onality
can
be
toggled
by
typing
the
commands
below
at
the
RUN
line.
taaslaunchoff
taaslaunchon
–
on
by
default.
47
48. This
func0onality
can
be
toggled
by
typing
the
commands
below
at
the
RUN
line.
taaslaunchoff
taaslaunchon
–
on
by
default.
48
49. This
func0onality
can
be
toggled
by
typing
the
commands
below
at
the
RUN
line.
taaslaunchoff
taaslaunchon
–
on
by
default.
49
51. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
51
52. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
52
53. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
53
54. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
54
55. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
55
56. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
56
57. More
than
just
downloading
a
tool.
No
wai0ng,
No
searching,
no
browser
and
nothing
to
unzip.
Everything
is
done
programma0cally
for
us.
57
58. Addi0onal
benefits
when
we
use
the
Download
Menu,
are
the
“Ready
to
use”
script
templates
along
with
runnable
executable
that
will
disable
and
enable
the
Windows
Paging
Execu0ve
which
is
a
required
step
for
capturing
stack
walk
profile
using
Xperf.
These
templates
make
it
quick
and
easy
for
any
Citrix
Support
engineer
or
any
IT
professional
to
jump
right
into
a
complex
debugging
scenario
like,
using
Procdump
and
Xperf
combined
for
CPU
spike
issues
or
memory
leak
diagnos0cs.
Or
just
using
procdump
to
capture
mul0ple
sequen0al
dumps
of
a
process
based
on
a
par0cular
trigger
state.
These
templates
have
simple
notes
inside
them
and
pre
populated
parameters
with
“fill
in
the
blank”
type
examples
as
highlighted
above.
This
takes
the
burden
of
figuring
out
how,
when,
what
commands,
how
do
I
automate
this,
from
the
support
professionals
task
list
and
in
doing
so
we
…..
Save
0me
again
!
58
59. Addi0onal
benefits
when
we
use
the
Download
Menu,
are
the
“Ready
to
use”
script
templates
along
with
runnable
executable
that
will
disable
and
enable
the
Windows
Paging
Execu0ve
which
is
a
required
step
for
capturing
stack
walk
profile
using
Xperf.
These
templates
make
it
quick
and
easy
for
any
Citrix
Support
engineer
or
any
IT
professional
to
jump
right
into
a
complex
debugging
scenario
like,
using
Procdump
and
Xperf
combined
for
CPU
spike
issues
or
memory
leak
diagnos0cs.
Or
just
using
procdump
to
capture
mul0ple
sequen0al
dumps
of
a
process
based
on
a
par0cular
trigger
state.
These
templates
have
simple
notes
inside
them
and
pre
populated
parameters
with
“fill
in
the
blank”
type
examples
as
highlighted
above.
This
takes
the
burden
of
figuring
out
how,
when,
what
commands,
how
do
I
automate
this,
from
the
support
professionals
task
list
and
in
doing
so
we
…..
Save
0me
again
!
59
60. Intelligent
shortcuts.
Some
shortcuts
that
represent
third
party
tools
will
check
to
see
if
a
tool
exists
inside
the
C.D.T.
file
structure
first
and
if
the
tool
is
not
found.
You
will
see
the
Download
More
tools
menu.
Once
you’ve
downloaded
the
desired
tool…..the
subsequent
click
of
the
same
shortcut
will
launch
the
desired
tool.
This
is
another
example
of
how
C.D.T.
creates
that
comfortable
“Windows
App”
look
and
feel,
that
makes
it
easy
for
anyone
to
leverage
the
tools
included,
regardless
of
there
previous
experience
with
collec0ng
debug
data
for
vendors.
60
61. Intelligent
shortcuts.
Some
shortcuts
that
represent
third
party
tools
will
check
to
see
if
a
tool
exists
inside
the
C.D.T.
file
structure
first
and
if
the
tool
is
not
found.
You
will
see
the
Download
More
tools
menu.
Once
you’ve
downloaded
the
desired
tool…..the
subsequent
click
of
the
same
shortcut
will
launch
the
desired
tool.
This
is
another
example
of
how
C.D.T.
creates
that
comfortable
“Windows
App”
look
and
feel,
that
makes
it
easy
for
anyone
to
leverage
the
tools
included,
regardless
of
there
previous
experience
with
collec0ng
debug
data
for
vendors.
61
62. Intelligent
shortcuts.
Some
shortcuts
that
represent
third
party
tools
will
check
to
see
if
a
tool
exists
inside
the
C.D.T.
file
structure
first
and
if
the
tool
is
not
found.
You
will
see
the
Download
More
tools
menu.
Once
you’ve
downloaded
the
desired
tool…..the
subsequent
click
of
the
same
shortcut
will
launch
the
desired
tool.
This
is
another
example
of
how
C.D.T.
creates
that
comfortable
“Windows
App”
look
and
feel,
that
makes
it
easy
for
anyone
to
leverage
the
tools
included,
regardless
of
there
previous
experience
with
collec0ng
debug
data
for
vendors.
62
63. Intelligent
shortcuts.
Some
shortcuts
that
represent
third
party
tools
will
check
to
see
if
a
tool
exists
inside
the
C.D.T.
file
structure
first
and
if
the
tool
is
not
found.
You
will
see
the
Download
More
tools
menu.
Once
you’ve
downloaded
the
desired
tool…..the
subsequent
click
of
the
same
shortcut
will
launch
the
desired
tool.
This
is
another
example
of
how
C.D.T.
creates
that
comfortable
“Windows
App”
look
and
feel,
that
makes
it
easy
for
anyone
to
leverage
the
tools
included,
regardless
of
there
previous
experience
with
collec0ng
debug
data
for
vendors.
63
65. Start
Menu
shortcut
or
Control
Panel
Both
op0ons
are
exactly
the
same.
Everything
in
the
CitrixDiagnos9cs
including
the
directory
itself
will
be
removed.
3rd
party
tools
or
applica0ons
“installed”
(wizard
driven)
separately
must
be
removed
separately
using
their
respec0ve
Add
Remove
Program
applet.
65
66. Start
Menu
shortcut
or
Control
Panel
Both
op0ons
are
exactly
the
same.
Everything
in
the
CitrixDiagnos9cs
including
the
directory
itself
will
be
removed.
3rd
party
tools
or
applica0ons
“installed”
(wizard
driven)
separately
must
be
removed
separately
using
their
respec0ve
Add
Remove
Program
applet.
66
67. Start
Menu
shortcut
or
Control
Panel
Both
op0ons
are
exactly
the
same.
Everything
in
the
CitrixDiagnos9cs
including
the
directory
itself
will
be
removed.
3rd
party
tools
or
applica0ons
“installed”
(wizard
driven)
separately
must
be
removed
separately
using
their
respec0ve
Add
Remove
Program
applet.
67
70. We
introduced
Scout
and
TAAS
last
year
in
San
Francisco.
it’s
a
great
proac0ve
tool
that
can
provide
tailored
recommenda0on
for
your
specific
environment
based
on
Data
collected
by
Scout.
C.D.T.
is
not
a
replacement
to
TAAS
or
Scout,
in
fact,
it
is
a
recognized
delivery
source
for
the
Scout
tool.
Ajer
all
it
in
the
name,
Citrix
Diagnos0cs
Toolkit.
So
righiully,
Scout
should
be
included.
As
we
saw
earlier
C.D.T.
can
launch
your
default
browser
directly
to
the
TAAS
site
and
although
the
data
you
upload
will
be
analyzed
by
Support
staff
it
does
provide
confirma0on
of
upload
and
no0fies
your
case
owner
that
data
has
arrived
for
processing.
Again
reducing
cycles
and
saving
0me.
The
combina0on
of
C.D.T.
and
Scout
will
help
you
keep
a
finger
on
the
pulse
of
your
Citrix
environment.
70
74. KB
ar0cles
provide
important
usage
details
and
have
cross
links
to
readme’s
for
all
the
included
citrix
and
3rd
party
downloadable
tools.
Blog
provides
insight
to
the
conceptual
design
behind
CDT
like,
What
was
Frank
thinking?
What
pain
points
is
he
trying
to
address
with
CDT?
74
75. KB
ar0cles
provide
important
usage
details
and
have
cross
links
to
readme’s
for
all
the
included
citrix
and
3rd
party
downloadable
tools.
Blog
provides
insight
to
the
conceptual
design
behind
CDT
like,
What
was
Frank
thinking?
What
pain
points
is
he
trying
to
address
with
CDT?
75