Product Documentation

Changing XenCenter Options

Oct 09, 2015

You can change a number of settings that affect your XenCenter working environment. On the Tools menu, click Options, click on a tab and change the setting, and then click OK to save your changes.

Security settings

Option Description Default
Warn me when a new SSL certificate is found Select this check box to have XenCenter display a warning whenever a new SSL (Secure Sockets Layer) security certificate is found on a managed server. Clear the check box if you do not want to see warnings about new certificates found on your managed servers when connecting to them. Off
Warn me when an SSL certificate changes Clear this check box if you do not want to see warnings about modified certificates found on your managed servers when connecting to them. Select the check box to have XenCenter display a warning whenever a modified certificate is found on a managed server. On

See also: Connecting and disconnecting servers.

Update settings

Option Description Default
Check for new versions of XenServer Select this check box to have XenCenter periodically check and notify you when new versions of XenServer are available. Clear the check box to disable the periodic check. Off
Check for XenServer updates Select this check box to have XenCenter periodically check and notify you when updates are available for XenServer. Clear the check box to disable the periodic check. On
Check for new XenCenter versions Select this check box to have XenCenter periodically check and notify you when a new version of XenCenter is available. Clear the check box to disable the periodic check. On

See also: About software updates, Updating managed servers, Updating XenCenter.

Performance graph settings

Option Description
Area graph Click this radio button if you want to view the performance data shown on the Performance tab as area charts. For example:

Line graph Click this radio button if you want to view the performance data shown on the Performance tab as line charts. For example:

See also: Monitoring system performance.

Console settings

Option Description Default
Share clipboard contents with remote console Select this check box to share your local text clipboard contents with the remote console. Items cut or copied will be placed on the clipboard and made available for pasting on either your local computer or on the remote console. On
Full-screen mode The keyboard shortcut to switch the console to and from full-screen mode. Ctrl+Enter
Dock/Undock The keyboard shortcut to undock the Console tab from the XenCenter window and to redock it. Alt+Shift+U
Release keyboard and mouse When the operating system on a VM captures your keyboard and mouse cursor for use within the guest OS, all keystrokes, mouse moves and button clicks that you make go to the VM. To return ownership of the keyboard and mouse to your host operating system, XenCenter reserves a special key on your keyboard: this is the host key. By default, the host key is the right Ctrl key on your keyboard. You can change this default here. Right Ctrl
Preserve current scale setting when console is undocked Select this check box to use the same console scale setting when the console is docked and when it is undocked. On
Preserve current scale setting when switching back to the default console Select this check box to keep the same console scale setting when switching between console types (for example, VNC/text console). On
Send Windows Key combinations to the Remote Desktop console Select this check box to have XenCenter send any Windows Key combinations entered on your keyboard to the Remote Desktop console. On
Receive sound from the Remote Desktop console Select this check box to have XenCenter play sounds from applications running on the Remote Desktop console on your local computer (the computer on which you are running XenCenter). On
Automatically switch to the Remote Desktop console when it becomes available Select this check box to have XenCenter automatically switch from using the standard graphical console to using the Remote Desktop console whenever it is available. On
Connect directly to the server's console session Select this check box to have XenCenter connect to the existing console session on the remote server instead of creating a new virtual console session when opening a Remote Desktop console session. On
Enable Remote Desktop console scanning Select this check box to have XenCenter automatically scan for an RDP connection. Clear the check box to prevent XenCenter from automatically scanning (polling) the RDP port, for example, if you have a firewall that blocks RDP traffic. Note that when this option is enabled, XenCenter will continue to scan the RDP port even if the Automatically switch to Remote Desktop option is turned off, so that you have the chance to switch to RDP as soon as it becomes available. On

Any changes you make to the Windows Remote Desktop console settings will apply when you restart XenCenter.

See also: Run a remote console session.

Connection settings

Option Description Default
Proxy server XenCenter can be configured to connect directly to your managed servers or to use a proxy server. You can use your Internet Explorer proxy server settings, or you can specify a proxy server.
  • Select Don't use a proxy server to have XenCenter connect directly to managed servers without using a proxy server.
  • Select Use proxy server settings from Internet Explorer to use the same proxy settings as Internet Explorer.
  • Select Use this proxy server if you want XenCenter to connect to the specified proxy server and use HTTP CONNECT to establish a secure SSL tunnel to your servers. Enter the address of the proxy server and the port number to use.

To have connection requests to local resources made directly and not via the proxy server, select the Bypass proxy server for local addresses check box. To have all connection requests made through the proxy server, clear the check box.

A local address is one that is on the LAN or intranet and is identified syntactically by the lack of a period (.) as in the URIs http://webserver/ and http://localhost/.

Don't use a proxy server
Connection timeout You can specify how long to wait when trying to establish a connection with a managed server by adjusting the number of seconds to wait for a connection timeout. You should not set this value too low if you don't want to receive a lot of false alerts due to network-related problems. 20 seconds

See also: Connecting and disconnecting servers.

Save and Restore settings

Use the settings on this tab to specify if you want your login credentials for managed servers to be stored and used to automatically reconnect to all your managed servers at the start of each XenCenter session. You can also set a master password here to protect your stored login credentials.

Option Description Default
Save and restore server connection state on startup Login credentials - your username and password - for all your managed servers can be stored between XenCenter sessions and used to automatically reconnect to them at the start of each new XenCenter session. When this check box is selected, XenCenter will remember the connection state of all your managed servers at the end of each session and attempt to restore them at the start of your next session. Off
Require a master password When Save and restore server connection state on startup is enabled, you can protect your stored login credentials with a master password to ensure they remain secure; at the start of each session, you will be prompted to enter this master password before connections to your managed servers are automatically restored. Off
Change Master Password Click to change the current master password; you will be prompted to enter the current password then to enter and confirm the new master password.  

Plug-ins settings

Plug-ins are optional components that you can add to XenCenter to extend its functionality. You can add custom menu items or even whole tabs to the main window using a XenCenter plug-in. For example, you might do this as an ISV to integrate your own product with XenCenter, or as an end-user to integrate with your company's existing inventory management. A menu item can run a Microsoft PowerShell script or even an arbitrary executable on the client machine. Tabs are populated with a web page, and can call out to other services on your network or to your VMs.

Option Description Default
Plug-in components A XenCenter plug-in consists of the following components:
  • An XML configuration file.
  • A resource DLL for each supported locale.
  • The application and any resources it requires.

Plug-in components should be placed into a plugins subfolder in your XenCenter installation folder. The components will be loaded when XenCenter starts. For example, in a default installation of XenCenter, your plug-ins would be located here:

C:\Program 
Files\Citrix\XenCenter\plugins 
\<your_organization_name>\<your_plugin_name>
Off
View available plug-ins To see a list of plug-ins currently available in XenCenter, and to enable or disable individual plug-ins, on the Tools menu, click Options. The Options dialog box will be displayed. From the list of options on the left pane, click Plugins. On
Creating plug-ins To learn how to create plug-ins for XenCenter, see the XenCenter plugins web page. You can access this web page any time from XenCenter by clicking XenCenter Plugins online on the Help menu.