Product documentation
Citrix Hypervisor
8.2 CU1 XenServer 8
View PDF

Install

September 26, 2024
Contributed by: 
X X

This section contains procedures to guide you through the installation, configuration, and initial operation of Citrix Hypervisor. It also contains information about troubleshooting problems that might occur during installation and points you to extra resources.

This information is primarily aimed at system administrators who want to set up Citrix Hypervisor servers on physical servers.

Citrix Hypervisor installs directly on bare-metal hardware avoiding the complexity, overhead, and performance bottlenecks of an underlying operating system. It uses the device drivers available from the Linux kernel. As a result, Citrix Hypervisor can run on a wide variety of hardware and storage devices. However, ensure that you use certified device drivers.

For more information, see the Hardware Compatibility List (HCL).

Important:

The Citrix Hypervisor server must be installed on a dedicated 64-bit x86 server. Do not install any other operating system in a dual-boot configuration with the Citrix Hypervisor server. This configuration is not supported.

Before you start

Before installing Citrix Hypervisor 8.2 Cumulative Update 1, consider the following factors:

  • What is the appropriate installation method?

  • What are the system requirements?

Installation methods

Citrix Hypervisor 8.2 Cumulative Update 1 can be installed as a fresh installation.

There is no supported direct upgrade path from out-of-support versions of XenServer to Citrix Hypervisor 8.2 Cumulative Update 1. Instead, perform a fresh installation.

Fresh installation

If you are creating a fresh installation of Citrix Hypervisor 8.2 Cumulative Update 1:

Supplemental packs

You can install any required supplemental pack after installing Citrix Hypervisor. Download the supplemental pack to a known location on your computer and install the supplemental pack in the same way as an update.

Important:

If you want to install the NVIDIA Virtual GPU Manager supplemental pack, we strongly recommend that you do not install this pack during Citrix Hypervisor installation. Instead, install it into your Citrix Hypervisor server by using xe CLI or XenCneter. For more information, see Install the NVIDIA vGPU Manager for Citrix Hypervisor.

For more information, see Supplemental Packs and the DDK Guide.

Install the Citrix Hypervisor server

Tip:

Throughout the installation, quickly advance to the next screen by pressing F12. Use Tab to move between elements and Space or Enter to select. Press F1 for general help.

To install or upgrade the Citrix Hypervisor server:

  1. Back up data you want to preserve. Installing Citrix Hypervisor overwrites data on any hard drives that you select to use for the installation.

  2. Boot the computer from the installation media or by using network boot:

    • To install Citrix Hypervisor server from a bootable USB:

      1. Create a bootable USB from the XenServer installation ISO. Ensure that the tool does not alter the contents of the ISO file.
        • On Linux, you can use the dd command to write the ISO to a USB. For example, dd if=<path_to_source_iso> of=<path_to_destination_usb>.
        • On Windows, you can use Rufus. Ensure that you select Write in DD Image mode. If this is not selected, Rufus can alter the contents of the ISO file and cause it not to boot.
      2. Insert the bootable USB drive into the target system.
      3. Restart the system.

      4. In the BIOS, change the settings to boot the system from the USB.

        (If necessary, see your hardware vendor documentation for information on changing the boot order)

    • To install Citrix Hypervisor server from a CD:

      1. Burn the Citrix Hypervisor installation ISO file to a CD.
      2. Insert the bootable CD into the CD/DVD drive on the target system.
      3. Restart the system.

      4. In the BIOS, change the settings to boot the system from the CD.

        (If necessary, see your hardware vendor documentation for information on changing the boot order)

    • To install Citrix Hypervisor server from virtual media:

      1. Go to the virtual console of your system.
      2. Insert the Citrix Hypervisor installation ISO file as virtual media.
      3. Restart the system.

      4. In the BIOS, change the settings to boot the system from the virtual media.

        (If necessary, see your hardware vendor documentation for information on changing the boot order)

    • To set up a network-accessible TFTP server to boot:

      For details about setting up a TFTP server to boot the installer using network, see Network Boot Installation.

    • To install Citrix Hypervisor to a remote disk on a SAN to enable boot from SAN:

      For details, see Boot From SAN.

  3. Following the initial boot messages and the Welcome to Citrix Hypervisor screen, select your key map (keyboard layout) for the installation.

    Note:

    If a System Hardware warning screen is displayed and hardware virtualization assist support is available on your system, see your hardware manufacturer for BIOS upgrades.

  4. The Welcome to Citrix Hypervisor Setup screen is displayed.

    Citrix Hypervisor ships with a broad driver set that supports most modern server hardware configurations. However, you might need to apply driver disks (a type of supplemental pack) in order to be able to perform the Citrix Hypervisor installation. If you have been provided with any additional essential device drivers, press F9. The installer steps you through loading the necessary drivers.

    Warning:

    You cannot install other types of supplemental packs at this point in the installation process. You can install them along with additional driver disks near the end of the installation process.

    After you have loaded all of the required drivers, select OK to proceed.

    Citrix Hypervisor enables customers to configure the Citrix Hypervisor installation to boot from FCoE. Press F10 and follow the instructions displayed on the screen to set up FCoE.

    Notes:

    Before enabling your Citrix Hypervisor server to boot from FCoE, manually complete the configuration required to expose a LUN to the host. This manual configuration includes configuring the storage fabric and allocating LUNs to the public world wide name (PWWN) of your SAN. After you complete this configuration, the available LUN is mounted to the CNA of the host as a SCSI device. The SCSI device can then be used to access the LUN as if it were a locally attached SCSI device. For information about configuring the physical switch and the array to support FCoE, see the documentation provided by the vendor.

    When you configure the FCoE fabric, do not use VLAN 0. The Citrix Hypervisor server cannot find traffic that is on VLAN 0.

    Occasionally, booting a Citrix Hypervisor server from FCoE SAN using software FCoE stack can cause the host to stop responding. This issue is caused by a temporary link disruption in the host initialization phase. If the host fails to respond for a long time, you can restart the host to work around this issue.

  5. The Citrix Hypervisor EULA is displayed. Use the Page Up and Page Down keys to scroll through and read the agreement. Select Accept EULA to proceed.

  6. Select the appropriate action. You might see any of the following options:

    • Perform clean installation

    • Upgrade: If the installer detects a previously installed version of Citrix Hypervisor or XenServer, it offers the option to upgrade. For information about upgrading your Citrix Hypervisor server, see Upgrading from an existing version.

    • Restore: If the installer detects a previously created backup installation, it offers the option to restore Citrix Hypervisor from the backup.

    Make your selection, and choose OK to proceed.

  7. If you have multiple local hard disks, choose a Primary Disk for the installation. Select OK.

  8. Choose which disks you want to use for virtual machine storage. Information about a specific disk can be viewed by pressing F5.

    If you want to use thin provisioning to optimize the use of available storage, select Enable thin provisioning. This option selects the local SR of the host to be the one to be used for the local caching of VM VDIs. Citrix Virtual Desktops and DaaS users are recommended to select this option for local caching to work properly. For more information, see Storage.

    Choose OK.

  9. Select your installation media source.

    • To install from a USB or CD, choose Local media.

    • To install by using network, select HTTP or FTP or NFS.

      Note:

      If you are using IIS to host the installation media, ensure that double escaping is enabled on IIS before extracting the installation ISO on it.

    Choose OK to proceed.

    If you select HTTP or FTP or NFS, set up networking so that the installer can connect to the Citrix Hypervisor installation media files:

    1. If the computer has multiple NICs, select one of them to be used to access the Citrix Hypervisor installation media files. Choose OK to proceed.

    2. Choose Automatic configuration (DHCP) to configure the NIC using DHCP, or Static configuration to configure the NIC manually. If you choose Static configuration, enter details as appropriate.

    3. Provide VLAN ID if you have your installation media present in a VLAN network.

    4. If you choose HTTP or FTP, provide the URL for your HTTP or FTP repository, and a user name and password, if appropriate.

      If you choose NFS, provide the server and path of your NFS share.

      Select OK to proceed.

  10. Indicate if you want to verify the integrity of the installation media. If you select Verify installation source, the SHA256 checksum of the packages is calculated and checked against the known value. Verification can take some time. Make your selection and choose OK to proceed.

  11. Set and confirm a root password, which XenCenter uses to connect to the Citrix Hypervisor server. You also use this password (with user name “root”) to log into xsconsole, the system configuration console.

    Note:

    Citrix Hypervisor root passwords must contain only printable ASCII characters.

  12. Set up the primary management interface that is used to connect to XenCenter.

    If your computer has multiple NICs, select the NIC which you want to use for management. Choose OK to proceed.

  13. Configure the Management NIC IP address by choosing Automatic configuration (DHCP) to configure the NIC using DHCP, or Static configuration to configure the NIC manually. To have the management interface on a VLAN network, provide the VLAN ID.

    Note:

    To be part of a pool, Citrix Hypervisor servers must have static IP addresses or be DNS addressable. When using DHCP, ensure that a static DHCP reservation policy is in place.

  14. Specify the hostname and the DNS configuration, manually or automatically via DHCP.

    In the Hostname Configuration section, select Automatically set via DHCP to have the DHCP server provide the hostname along with the IP address. If you select Manually specify, enter the hostname for the server in the field provided.

    Note:

    If you manually specify the hostname, enter a short hostname and not the fully qualified domain name (FQDN). Entering an FQDN can cause external authentication to fail, or the Citrix Hypervisor server might be added to AD with a different name.

    In the DNS Configuration section, choose Automatically set via DHCP to get name service configuration using DHCP. If you select Manually specify, enter the IP addresses of your primary (required), secondary (optional), and tertiary (optional) DNS servers in the fields provided.

    Select OK to proceed.

  15. Select your time zone by geographical area and city. You can type the first letter of the desired locale to jump to the first entry that begins with this letter. Choose OK to proceed.

  16. Specify how you want the server to determine local time: using NTP or manual time entry. Make your selection, and choose OK to proceed.

    • If using NTP, select NTP is configured by my DHCP server or enter at least one NTP server name or IP address in the fields below. Choose OK to proceed.
    • If you elected to set the date and time manually, you are prompted to do so. Choose OK to proceed.

    Note:

    Citrix Hypervisor assumes that the time setting in the BIOS of the server is the current time in UTC.

  17. Select Install Citrix Hypervisor.

    The installation process starts. This might take some minutes.

  18. The next screen asks if you want to install any supplemental packs (including driver disks). If you plan to install any supplemental packs or driver disks provided by your hardware supplier, choose Yes.

    Note:

    If you have already loaded a driver disk during initial installation, you might be prompted to reinsert the driver disk so that the driver can be installed onto disk. At this point, reinsert the driver disk to ensure that your Citrix Hypervisor instance contains the new driver.

    If you choose to install supplemental packs, you are prompted to insert them. Eject the Citrix Hypervisor installation media, and insert the supplemental pack media. Choose OK.

    Important:

    If you want to install the NVIDIA Virtual GPU Manager supplemental pack, we strongly recommend that you do not install this pack during Citrix Hypervisor installation. Instead, install it into your Citrix Hypervisor server by using xe CLI or XenCneter. For more information, see Install the NVIDIA vGPU Manager for Citrix Hypervisor.

    Select Use media to proceed with the installation.

    Repeat for each pack to be installed.

  19. From the Installation Complete screen, eject the installation media (if installing from USB or CD) and select OK to reboot the server.

    After the server reboots, Citrix Hypervisor displays xsconsole, a system configuration console. To access a local shell from xsconsole, press Alt+F3; to return to xsconsole, press Alt+F1.

    Note:

    Make note of the IP address displayed. Use this IP address when you connect XenCenter to the Citrix Hypervisor server.

Install XenCenter

XenCenter must be installed on a Windows machine that can connect to the Citrix Hypervisor server through your network. Ensure that .NET framework version 4.6 or above is installed on this system.

To install XenCenter:

  1. Download the installer for the latest version of XenCenter from the Citrix Hypervisor downloads page.

  2. Launch the installer .msi file.

  3. Follow the Setup wizard, which allows you to modify the default destination folder and then to install XenCenter.

For more information about using XenCenter, see XenCenter documentation.

Connect XenCenter to the Citrix Hypervisor server

To connect XenCenter to the Citrix Hypervisor server:

  1. Launch XenCenter. The program opens to the Home tab.

  2. Click the Add New Server icon.

  3. Enter the IP address of the Citrix Hypervisor server in the Server field. Type the root user name and password that you set during Citrix Hypervisor installation. Click Add.

  4. The first time you add a host, the Save and Restore Connection State dialog box appears. This dialog enables you to set your preferences for storing your host connection information and automatically restoring host connections.

    If you later want to change your preferences, you can do so using XenCenter or the Windows Registry Editor.

    To do so in XenCenter: from the main menu, select Tools and then Options. The Options dialog box opens. Select the Save and Restore tab and set your preferences. Click OK to save your changes.

    To do so using the Windows Registry Editor, navigate to the key HKEY_LOCAL_MACHINE\Software\Citrix\XenCenter and add a key named AllowCredentialSave with the string value true or false.

Install
September 26, 2024
Contributed by: 
X X
September 26, 2024
Contributed by: 
X X

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.