&virt.manager;&xvm.sysadmin;<chapter id="gefzh"><title>Troubleshooting Miscellaneous
Sun xVM Problems</title><highlights><para>This chapter contains troubleshooting information for Sun xVM.</para>
</highlights><sect1 id="ggdzr"><title>Verifying System Elements</title><task id="gfzgz"><title>How to Verify Devices in <literal>/dev/xen</literal></title><procedure remap="single-step"><step><para>Change directories to <literal>/dev/xen</literal> and list the
contents:</para><screen># <userinput>cd /dev/xen</userinput>
# <userinput>ls</userinput>
balloon  domcaps  evtchn  privcmd  xenbus</screen>
</step>
</procedure>
</task><task id="ggczi"><title>How to Verify That the Required Packages Are Installed</title><tasksummary><para>The following packages must be installed to use the hypervisor and install
and manage domains on your system.</para>
</tasksummary><procedure><step><para>Verify that the following <literal>xvm</literal> software packages
are installed on the system:</para><screen># <userinput>pkginfo | grep xvm</userinput>
system      SUNWxvmdomr       Hypervisor Domain Tools (Root)
system      SUNWxvmdomu       Hypervisor Domain Tools (Usr)
system      SUNWxvmh          Hypervisor Header Files
system      SUNWxvmhvm        Hypervisor HVM
system      SUNWxvmr          Hypervisor (Root)
system      SUNWxvmu          Hypervisor (Usr)</screen>
</step><step><para>Verify that the <literal>virtinst</literal> software package is
installed on the system:</para><screen># <userinput>pkginfo | grep virtinst</userinput>
system      SUNWvirtinst       virt-install</screen>
</step><step><para>Verify that the <literal>libvert</literal> software package is
installed on the system:</para><screen># <userinput>pkginfo | grep virtinst</userinput>
system      SUNWlibvirt        libvirt</screen>
</step><step><para>Verify that the <literal>urlgrabber</literal> software package
is installed on the system:</para><screen># <userinput>pkginfo | grep SUNWurlgrabber</userinput>
system      SUNWurlgrabber     urlgrabber</screen>
</step>
</procedure>
</task><task id="geypo"><title>How to Verify That the <literal>xvm</literal> Hypervisor
Services Are Started</title><procedure><step><para>Become superuser, or assume the Primary Administrator role.</para>
</step><step><para>Verify that the <literal>xvm</literal> services are running.</para><screen># <userinput>svcs -a | grep xvm</userinput></screen><para>If the system displays the following, the services are not running:</para><screen>disabled         Dec_07   svc:/system/xvm/store:default
disabled         Dec_07   svc:/system/xvm/xend:default
disabled         Dec_07   svc:/system/xvm/console:default

disabled         Dec_07   svc:/system/xvm/domains:default</screen>
</step><step><para>If the services are not running, verify that you booted an <literal>i86xpv</literal> kernel.</para><screen># <userinput>uname -i</userinput>
i86xpv</screen><para>Reboot if necessary.</para>
</step><step><para>If the correct kernel is running, enable the services.</para><screen># <userinput>svcadm enable xvm/store</userinput>
# <userinput>svcadm enable xvm/xend</userinput>
# <userinput>svcadm enable xvm/console</userinput>
# <userinput>svcadm enable xvm/domains</userinput></screen><para>You are now ready to create guest domains (domUs).</para>
</step>
</procedure>
</task>
</sect1><sect1 id="gfwvp"><title>Developers: Using DTrace With the Hypervisor</title><para>Due to the isolation of the hypervisor from dom0, there is currently
no way to apply DTrace directly to the hypervisor. There is an <literal>xpv</literal> DTrace
provider that allows you to trace the interaction between dom0 and the hypervisor.</para><para>To list the available DTrace probes, use the following command line:</para><screen># <userinput>dtrace -l -i 'xpv:::'</userinput></screen><para>To enable all probes, use the following command line</para><screen># <userinput>dtrace -n 'xpv::: {}'</userinput></screen>
</sect1>
</chapter>