Citrix provides two forms of support: free, self-help support on the Citrix Support website and paid-for Support Services, which you can purchase from the Support site. With Citrix Technical Support, you can open a Support Case online or contact the support center by phone if you experience technical difficulties.
The Citrix Knowledge Center hosts several resources that might be helpful to you in the event of odd behavior, crashes, or other problems. Resources include: Forums, Knowledge Base articles, White Papers, product documentation, hotfixes, and other updates.
If you experience technical difficulties with the XenServer host, this section is meant to help you solve the problem if possible. If it isn’t possible, use the information in this section to gather the application logs and other data that can help your Citrix Solution Provider and Citrix track and resolve the issue.
Citrix recommends that you follow the troubleshooting information in this section solely under the guidance of your Citrix Solution Provider or Citrix Support.
In some support cases, serial console access is required for debug purposes. Therefore, when setting up your XenServer configuration, it is recommended that serial console access is configured. For hosts that do not have physical serial port (such as a Blade server) or where suitable physical infrastructure is not available, investigate whether an embedded management device, such as Dell DRAC or HP iLO can be configured.
For information on setting up serial console access, see CTX121442.
Use the Health Check feature to generate and upload the server status report to Citrix Insight Services (CIS) and to receive CIS analysis reports in XenCenter.
When you connect any eligible pool to XenCenter, you are prompted to enable Health Check for the pool. During the enrollment process, you can take the following actions:
- Specify the schedule to use for uploading the server status report automatically to CIS
- Enter XenServer credentials that are used to establish a connection with the pool
- Authenticate your uploads with CIS
After the pool is successfully enrolled to Health Check, you receive notifications in XenCenter regarding the health of the pool. This feature enables you to monitor proactively the health of the XenServer systems based on the report that CIS generates.
To use the Health Check feature:
All hosts in the pool must be running XenServer 7.6
Connect to the XenServer pool using XenCenter shipped with XenServer 7.6
XenCenter must have access to the internet
The Health Check Service must be installed and running on the XenCenter machine.
If using Active Directory (AD), you must have a Pool Operator or a higher role
For detailed information about Health Check and for step-by-step instructions on enrolling a pool to Health Check, see the XenCenter Help.
XenServer host logs
XenCenter can be used to gather XenServer host information.
Click Server Status Report in the Tools menu to open the Server Status Report task. You can select from a list of different types of information (various logs, crash dumps, and so on). The information is compiled and downloaded to the machine that XenCenter is running on. For details, see the XenCenter Help.
Additionally, the XenServer host has several CLI commands that collate the output of logs and various other bits of system information using the utility
xen-bugtool. Use the xe command
host-bugreport-upload to collect the appropriate log files and system information and upload them to the Citrix Support FTP site. For a full description of this command and its optional parameters, see
host-bugreport-upload . If you are requested to send a crashdump to Citrix Support, use the xe command
host-crashdump-upload. For a full description of this command and its optional parameters, see
XenServer host logs may contain sensitive information.
Sending host log messages to a central server
Rather than have logs written to the control domain filesystem, you can configure your XenServer host to write them to a remote server. The remote server must have the
syslogd daemon running on it to receive the logs and aggregate them correctly. The
syslogd daemon is a standard part of all flavors of Linux and Unix, and third-party versions are available for Windows and other operating systems.
Set the syslog_destination parameter to the hostname or IP address of the remote server where you want the logs to be written:
xe host-param-set uuid=BRAND_SERVER_host_uuid logging:syslog_destination=hostname
Run the command:
xe host-syslog-reconfigure uuid= BRAND_SERVER_host_uuid
To enforce the change. (You can also execute this command remotely by specifying the
XenCenter also has client-side log. This file includes a complete description of all operations and errors that occur when using XenCenter. It also contains informational logging of events that provide you with an audit trail of various actions that have occurred. The XenCenter log file is stored in your profile folder. If XenCenter is installed on Windows 2008, the path is
If XenCenter is installed on Windows 8.1, the path is
To locate the XenCenter log files - for example, when you want to open or email the log file - click View Application Log Files in the XenCenter Help menu.
Troubleshooting connections between XenCenter and the XenServer host
If you have trouble connecting to the XenServer host with XenCenter, check the following:
Is your XenCenter an older version than the XenServer host you are attempting to connect to?
The XenCenter application is backward-compatible and can communicate properly with older XenServer hosts, but an older XenCenter cannot communicate properly with newer XenServer hosts.
To correct this issue, install the XenCenter version that is the same, or newer, than the XenServer host version.
Is your license current?
You can see the expiration date for your license access code in the XenServer host General tab under the License Details section in XenCenter.
For more information on licensing a host, see Licensing.
The XenServer host talks to XenCenter using HTTPS over the following ports:
- Port 443 (a two-way connection for commands and responses using the management API)
- Port 5900 for graphical VNC connections with paravirtualized Linux VMs.
If you have a firewall enabled between the XenServer host and the machine running the client software, ensure that it allows traffic from these ports.