Install_everRun_6.2
Install_everRun_6.2
Install_everRun_6.2
Guide
Release 6.2
Rev B
March 2014
NOTICE
The information contained in this document is subject to change without notice.
UNLESS EXPRESSLY SET FORTH IN A WRITTEN AGREEMENT SIGNED BY AN
AUTHORIZED REPRESENTATIVE OF STRATUS TECHNOLOGIES, STRATUS
MAKES NO WARRANTY OR REPRESENTATION OF ANY KIND WITH RESPECT
TO THE INFORMATION CONTAINED HEREIN, INCLUDING WARRANTY OF
MERCHANTABILITY AND FITNESS FOR A PURPOSE. Stratus Technologies
assumes no responsibility or obligation of any kind for any errors contained herein or in
connection with the furnishing, performance, or use of this document.
Software described in Stratus documents (a) is the property of Stratus Technologies
Bermuda, Ltd. or the third party, (b) is furnished only under license, and (c) may be
copied or used only as expressly permitted under the terms of the license. The software
described in this document is covered by the following copyright: © Stratus Technologies
Bermuda, Ltd. 2008, 2009-2013.
Stratus documentation describes all supported features of the user interfaces and the
application programming interfaces (API) developed by Stratus. Any undocumented
features of these interfaces are intended solely for use by Stratus personnel and are
subject to change without warning.
This document is protected by copyright. All rights are reserved. Stratus Technologies
grants you limited permission to download and print a reasonable number of copies of
this document (or any portions thereof), without change, for your internal use only,
provided you retain all copyright notices and other restrictive legends and/or notices
appearing in the copied document.
Stratus, the Stratus logo, ftServer, and the ftServer logo are registered trademarks of
Stratus Technologies Bermuda, Ltd.
The Stratus Technologies logo, the Stratus 24 x 7 logo, ActiveService, ftScalable,
Automated Uptime, and Active Upgrade are trademarks of Stratus Technologies
Bermuda, Ltd.
The Application Availability Experts, ComputeThru, everRun, and SplitSite, are
registered trademarks or trademarks of Stratus Technologies Bermuda, Ltd.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation in the
United States and/or other countries; Xen® and Citrix® are registered trademarks and
XenServer™, XenCenter™, and XenConvert™ are trademarks of Citrix Systems, Inc.;
Java® is a registered trademark of Sun Microsystems; Linux® is a registered
trademark of Linus Torvalds. Intel® is a registered trademark of Intel Corporation. All
other trademarks are the property of their respective owners.
Stratus everRun products are protected by one or more of the following patents: U.S.
Patent Numbers: 5,600,784; 5,615,403; 5,787,485; 5,790,397; 5,896,523; 5,956,474;
5,983,371; 6,038,685; 6,205,565; 6,279,119; 6,473,869; 6,728,898; 7,373,545; 7,877,552.
European Patent Numbers: EP0731945; EP0974912; EP0986784; EP0993633;
EP1000397; EP1000404; EP1029267; EP1496434; GB2392536; Japanese Patent
Numbers: 3679412; 4166939; 4264136. Other patents pending.
The product makes use of software covered under the GNU Public License (GPL) and
the Lesser GNU Public License (LGPL). For a written copy of these licenses, see /var/
everRun/ current_everRun/licenses on any XenServer host on which everRun software
is installed. Stratus will make source components available upon request, as required
under the terms of the GPL. Contact everRun MX Support (US Toll-Free) 866-763-1813
or (International) 602-852-3094.
© 2014 Stratus Technologies Bermuda, Ltd. All rights reserved.
Contents
Contents vi
vii Setup and Installation Guide
Installation Overview
1
This chapter describes the main tasks required for a complete everRun installation and
lists the source of information for each task. As you install, you can return to this
chapter to find an information source.
NOTE: Throughout this guide, key terms are displayed in a blue bold font. The first
instance of a key term links to a brief definition in the glossary at the end of
the book. After you check a term, you can return to the text by clicking the
section bookmark in the navigation panel at left.
In addition to the process described in this guide, you must install specific software to
support certain everRun features, such as SNMP notification or the everRun snapshot
feature. For further information, see “Additional Installation Options” on page 4.
Installation Sequence
The everRun® software must be installed onto an existing Citrix® XenServer™
virtualization environment. Before you begin, please review the tasks you’ll perform.
1. Plan your configuration, obtain system components, and set up hardware.
2. Obtain the required Citrix and everRun software, documentation, and licenses.
3. Install and configure your XenServer hosts and the XenCenter management
GUI, then add the XenServer license to each host in the pool.
4. Create a XenServer resource pool from the configured hosts and verify the
network connection.
6. Now or at any later time you can install the Windows application(s) you want to
protect — email server, database, and so forth — onto the VMs in the pool.
Installation Overview 1
7. Install the everRun software onto each XenServer host in the pool.
9. Using the URL provided during the install process, open the everRun
Availability Center (eAC) management GUI.
10. Use the eAC for the post-install configuration tasks: applying the everRun license,
checking the pool isolation IP address, configuring the availability-link (A-link)
networks, and enabling/configuring quorum service if it is required in your
configuration.
Information Sources
Table 1 explains where to find the information needed for each of these tasks.
.(
Installation Overview 3
Table 1: Information Sources
Installation Overview 5
6 Setup and Installation Guide
System Requirements
2
This chapter describes everRun configuration basics, as well as the hardware, software,
disk space, and network requirements for the system.
Figure 2-1 A basic everRun configuration is a pool of two XenServer hosts that
can support virtual machines, as well as a general-purpose PC that
can run both the XenCenter management application and the
browser-based everRun Availability Center management client.
System Requirements 7
The XenServer software must be installed on two x64 (64-bit) servers, which are known
as the XenServer hosts. The XenServer hosts are dedicated to the task of hosting
virtual machines (VMs). All hosts must be members of the same XenServer
resource pool.
The management computer that runs the XenCenter management application and
the browser-based everRun Availability Center (eAC) management client can
run on any general-purpose Windows machine that satisfies the hardware
requirements. This computer can also be used to run other Windows applications.
If the resource pool contains more than two XenServer hosts (using point-to-point cable
links), or if the hosts in the pool are geographically separated (as in a SplitSite®
deployment), two quorum service computers must be connected to the network, as
described in the everRun Configuration Planning Guide.
Hardware Requirements
The hardware requirements are based on those given in the XenServer Installation
Guide. A list of hardware and software components that have been reported to work
with XenServer, as tested by Citrix, by the individual vendors, or by the Xen
community, is available at http://hcl.xensource.com/.
For the most reliable operation, choose components tested by Citrix or by the individual
vendors.
XenServer Hosts
Each XenServer host is an x64 server-class machine devoted to hosting multiple VMs.
This machine runs a customized distribution of the Linux operating system, with a
XenServer-enabled kernel that controls the interaction between the virtualized devices
accessible by VMs and the physical hardware.
Table 3 lists the requirements for each system host. The processors in each host must
support hardware virtualization, as shown in the CPUs row of the table.
Category Requirements
CPUs One or more x64 CPUs, 1.5 GHz minimum, 2 GHz or faster multicore
CPU recommended. For VMs running Windows, the processors must be
virtualization-capable Intel models with one or more (up to 8) CPUs.
A second computer with identical processors is required for use as a
redundant server for Protected Virtual Machines (PVMs—virtual
machines that are protected by Stratus everRun software). The CPUs
for every XenServer host computer must have hardware support for
virtualization enabled in the BIOS.
CPUs For a list of processors supported by Stratus products (required for
(cont.) Level 2 and Level 3 protection, for example), refer to the everRun 6.2
Hardware Guide at:
https://everrun-support.stratus.com/portallogin.asp
If you are not certain whether your hardware supports everRun
operation, download the everRun_CompatibilityCheck utility,
available in the Tools and Utilities section of the everRun customer
web portal. Download the Compatibility Check Readme document, also
at the web site, for instructions.
Supported Guests that are candidates for everRun protection must be running
guest OS Windows Server 2003 Standard or Enterprise (32- or 64-bit, SP2),
Windows Server 2003 R2 Standard or Enterprise (32- or 64-bit),
Windows Server 2008 Standard or Enterprise (64-bit, SP1 or SP2),
Windows Small Business Server (SBS) 2003 or 2008, or Windows
Server 2008 Release 2.
RAM 2 GB minimum, 4 GB or more recommended.
Disk space Locally attached storage (PATA, SATA, SCSI, or FC-SAN) with a
for storage minimum of 72 GB of total disk space recommended. Shared storage
repositories (NFS share, iSCSI, and FC-SAN as described in the
XenServer Installation Guide) are also supported.
Disk space • 4 GB for XenServer in the host control domain, Domain 0 (Dom 0),
required and 4 GB for everRun in a supported storage repository (SR).
• Allow 10 GB minimum (Windows boot disk) for each Windows VM.
This may be located in local attached storage or shared storage, as
described under “Disk space for storage” above.
• Additional storage as required for applications and data on each VM.
System Requirements 9
Table 3: Requirements for XenServer Host Computers
Category Requirements
The browser-based eAC everRun management GUI can be loaded and run by a Flash-
enabled web browser on any computer, including the management computer. Table 4
shows the system requirements for the management computer.
Category Requirements
Category Requirements
As noted in the everRun Configuration Planning Guide, quorum service computers are
not required for a two-host local deployment with point-to-point private LANs.
System Requirements 11
Software Requirements and Sources
The software requirements for everRun MX are listed below.
Product Source
This document describes a basic, local two-host XenServer pool. For details on other
deployment options, refer to the everRun Configuration Planning Guide.
The two interconnected XenServer hosts shown in Figure 3-1 are members of the same
XenServer resource pool. In the recommended configuration, Host 1 is designated
the master host and Host 2 is the member host. A separate, general-purpose
management computer with access to the management LAN contains the
XenCenter management console and provides browser access to the everRun
Availability Center (eAC) client.
NOTE: In Figure 3-1, the configuration shows four networks that use five NICs. The
fifth NIC is used to create a bonded management LAN, as recommended when
you plan to enable XenServer High Availability (HA). This bonded NIC is not
required for the everRun evaluation deployment, or for any configuration that
does not include XenServer HA.
Additional ISO images will be needed to provide support for hardware devices that are
not included on the Citrix XenServer installation CD-ROM. The everRun web
download portal also contains the Supplemental Driver Disk required for a new
installation of everRun.
See the Hardware Guide or more information on the most up to date list of supported
platforms, devices, and drivers.
2. Download the Citrix and everRun ISO images to the shared directory on the
XenServer management computer using your favorite web browser.
NOTE: Refer to the everRun MX 6.2 Hardware Guide for the required BIOS settings.
Without multipathing, guest VMs with a virtual disk image (VDI) configured on the
associated FC SAN will not recover storage access properly following repair of a FC
SAN until you restart the XenServer host. When multipathing is properly configured,
you will avoid this problem. For more information, search the Citrix website for articles
on multipathing, or contact everRun Technical Support.
If you plan to enable multipathing you should do it right after you install the XenServer
software and the XenServer management network on your servers, but before you
perform additional configuration.
You can enable and disable storage multipathing using the xe command-line interface
(as described in the Citrix XenServer Administrator's Guide (search the document for
"multipathing" ), or in XenCenter (search for "Multipathing" in the Online Help).
NOTE: Do not use DHCP to set up the XenServer hosts. Instead, use the static IP
addresses you obtained from your local IT administrator. Also configure a
suitable NTP server as part of each XenServer installation.
Set up the basic configuration shown in Figure 3-1; it contains four LANs that use five
physical network interface cards (NICs) on each server. (The management LAN uses
two NICs to create the bonded NIC.) This section describes the recommended network
configuration for the basic deployment supported in this release.
NOTE: Remember, if you do not plan to use XenServer HA, you do not need to create
a bonded NIC for the management network.
Stratus recommends the following network assignments for a local, two-host pool:
• eth0 — XenServer management LAN
The system management LAN provides connectivity to the XenServer hosts for
clients running the XenCenter management application and the everRun
Availability Center (eAC) management software. Choose eth0, as recommended in
the XenServer Installation Guide. For maximum reliability, it is highly
recommended that you bond this network card with eth4, as described below.
• eth1 — availability link 1
In a local, two-host pool, availability link 1 (A-link 1) is a direct-cabled, or an active,
switched network connection from eth1 on one host to eth1 on a second host.
• eth2 — availability link 2
In a local, two-host pool, availability link 2 (A-link 2) is a second direct-cabled, or
an active, switched network connection from eth2 on one host to eth2 on the second
host.
• eth3 — production LAN
This is the network used to provide connectivity from application clients to
applications operating on virtual machines resident on the XenServer hosts.
• eth4 — bond with eth0, XenServer management LAN
XenServer automatically creates a virtual bridge called a Xen bridge (xenbr), which
is named to correspond to each Ethernet adapter during XenServer installation. The
XenServer convention names xenbr0 to provide a virtual bridge to eth0, xenbr1 to
provide a virtual bridge to eth1 and so forth. When you configure networks for use by
the virtual machines or everRun software, you can refer to the corresponding virtual
bridge name to understand the physical path connectivity. For more information, see
the XenServer documentation.
NOTE: See the everRun Configuration Planning Guide for configuration details
recommended for multihost pools, SplitSite pools, or a Level 3 SMP setting.
NOTE: For a basic discussion of how physical storage hardware is mapped to VMs in
XenServer, see the XenServer Administrator’s Guide.
Instructions for each of these tasks are given in the following sections.
1. Load the XenServer installation CD you created into the CD-ROM drive of
XenServer Host 1 (the master host). Boot the server from the CD-ROM and select
the appropriate language keymap as requested.
2. The next screen will display the Welcome to XenServer Setup dialogue.
Press F9 at this time in order to load the device drivers. You will be presented with
a subsequent dialogue box to select the Driver Source.
3. Remove the XenServer Installation Disk and place the Supplemental Driver Disk
into the CD-ROM. Select "Local Media" and press OK.
4. The name of the Supplemental Driver Disk title will appear in the next dialogue
box. Press the Right Arrow keyboard key while holding down the Alt key. This will
present a new Linux shell window.
5. Mount the CD-ROM and prepare for driver installation using the following
commands:
mount -r /dev/cdrom /home
sh /home/prepare_drivers
6. Once the script is completed, return to the installer by pressing the Left Arrow
keyboard key while holding down the Alt key.
7. Select the "Use" option and press Enter, one or more drivers will be presented.
Press OK.
a. Press the Right Arrow keyboard key again, while holding down the Alt key, to go back
to the Linux shell window.
b. Run the below command to fix the reordering of the Network Adapters:
/tmp/reorder-nics -r
c. Then, run the below command to display the Network Adapters and MAC addresses:
/tmp/reorder-nics -l
d. Find the Network Adapter’s MAC Address that you want to use for your management
link in the list displayed by the above command, and note the name of that Network
Adapter (for example, eth0).
e. Return to the installer by pressing the Left Arrow keyboard key while holding
down the Alt key.
a. When XenServer installer displays the list of the Network Adapters to select the
Management Link, find the Network Adapter name that you noted in above (step d. of
step 7.) and select that for the management Link (even if the XenServer installer
displays an incorrect MAC address for that adapter).
10. At the dialogue entitled "New Media", you will be requested to reload the
Supplemental Driver Disk again. Remove the XenServer Installation Disk and
insert the Supplemental Driver Disk, selecting OK.
11. Select the "Use" option and press Enter on the subsequent dialogue to load the
drivers.
12. Install the XenServer software on the second or any additional host(s) using the
same procedure on each host.
1. Put the XenServer CD you created from the Citrix ISO file into the CD drive of your
management computer.
If Auto-play is enabled for the CD drive, the XenCenter installer launches
automatically after a few moments.
If Auto-play is not enabled for the CD drive, browse to the \client_install
directory on the CD and find the file named XenCenter.msi. Double-click on the
file icon to launch the XenCenter installer.
2. Follow the instructions displayed in the installer window. When prompted for the
installation directory, either click Browse to change the installation location, or
click Next to accept the default path C:\Program Files\Citrix\XenCenter.
Use two commands for this task. First use xe pif-list to get the UUID (user ID) of
the PIF you want to verify. Then use xe pif-param-list and the PIF UUID to
identify which connector controls each network. You can run these commands from the
console command line in XenCenter or from any remote console that can access the
XenServer hosts.
As you verify each network cable, you may want to label the associated port with the
network name, or create a simple table that lists the network connectivity for each port.
1. With all cables connected to your system, select a XenServer host in the XenCenter
resource pane, then issue the following command in XenCenter to obtain network
UUIDs:
# xe pif-list
2. Use this display to cut and paste each UUID you want to verify, as shown in the
following sequence.
1. With the cables still attached, look at the parameters for the network identified as
eth0 by issuing the following command using the UUID for eth0:
# xe pif-param-list uuid=5b430bc0-d4fd-098f-5d33-4f9cbf84c4a4
params=all
XenServer returns a long list of parameters associated with that UUID.
uuid ( RO) : 5b430bc0-d4fd-098f-5d33-4f9cbf84c4a4
device ( RO): eth0
MAC ( RO): 00:1e:4f:f5:7f:7e
physical ( RO): true
etc...
3. Now remove the cable from eth0 and issue the command again:
# xe pif-param-list uuid=5b430bc0-d4fd-098f-5d33-4f9cbf84c4a4
params=all
XenServer should return the following parameter set:
: 5b430bc0-d4fd-098f-5d33-4f9cbf84c4a4
device ( RO): eth0
MAC ( RO): 00:1e:4f:f5:7f:7e
physical ( RO): true
etc...
carrier ( RO): false
The value of false indicates the network is not connected.
Repeat the sequence for each of the network PIFs (eth1, eth2, eth3...) to verify
that the physical cable corresponds to the network
IP addresses are not available for all networks at this time. When the information
becomes available, you may want to add it to your table. The information will be useful
if you need to modify or troubleshoot the networks later on.
4. Assuming eth4 is chosen for use as a Management LAN as recommended, from the
list of available NICs, choose NIC 4.
5. Click Create.
When you create a NIC bond on the pool master host, the bond should replicate to the
pool member host(s). However, you should check to make sure the bonded network on
the member host is connected, as described in the following process.
2. Click the Networks or NICs tabs to see if the bonded NIC displays as Connected.
1. Open the VM menu at the top of the XenCenter interface and choose the New
command to display the Create VM wizard. See the XenCenter Online Help topic
“Create a new VM” for instructions on installing and configuring a guest VM.
2. Use appropriate Windows installation media to install the operating system on the
new VM.
3. See the XenCenter Online Help topics under “Configuring VM networks” for
instructions on adding a network to your VM.
NOTE: This installation procedure describes default installation options. If you would
like to change any installer options, please refer to Appendix A, “everRun
Installer Online Help”.
3. If the files were extracted from the product ISO and a remote folder is shared from
a Windows computer, issue a command similar to the following:
mount -t cifs //<yourcomputername>/<sharedfoldername> /mnt
-o user=<yourusername>
2. Highlight OK and press Enter, then Press the Tab key so the scroll bar at right
changes to red, scroll down and review the Stratus License Agreement. Press the
Tab key to highlight Accept and press Enter.
3. The next screen displays the Sun Java Runtime Environment license. Review the
agreement, highlight Accept, and press Enter.
4. Next select the XenServer storage repository (SR) where everRun software should
be installed. Installation requires at least 3.9GB of available disk space. The
installer displays all of the SRs you have configured for XenServer host access. SRs
are listed in order of priority as recommended by Stratus; local storage at the top
followed by shared storage SRs. Select the storage repository where you wish to
install everRun software. Once selected, tab to OK and press the space bar to enter
your choice.
5. If Citrix Hotfix 9, 10, 21, and 23 must be applied to the pool, a popup will be
displayed indicating that it is required. Highlight Continue and press Enter to
allow the everRun installation to continue.
6. A confirmation popup will be displayed indicating that all verification steps have
been completed. Highlight Continue and press Enter to complete the installation.
No further interaction is required. If Citrix Hotfix 9, 10, 21, and 23 must be applied,
it will be uploaded and applied automatically by the installer.
8. If you used a CD-ROM to install everRun type eject cdrom at the # prompt and
press Enter to eject the media from the drive. If you used a mount point to install
type umount /mnt at the # prompt to remove the mount point.
NOTE: If this host is the master host, XenCenter will be disconnected and unavailable
until the master has finished rebooting. Restore the connection with the
master host when reboot completes.
Quorum service — and the need for two quorum service computers — is described in
the everRun Configuration Planning Guide.
NOTE: Always install the quorum service software included with the current everRun
release.
1. Copy the file from the downloaded everRun ISO onto the quorum servers.
3. After you open the eAC, you can configure the quorum servers as part of the pool
configuration process. Install Quorum Servers on networks that are most
convenient for your configuration.
TIP: To determine whether the XenServer tools have been installed, highlight a VM
in the XenCenter resource pane and open the General tab. If the tools are
required for that VM, a red Tools not installed message displays.
NOTE: If you are creating a new VM, you must install the Windows operating system
and the XenServer tools on the VM. A VM imported from a template may
already have Windows and the XenServer tools installed on it however, it is
always a good idea to install XenTools again, at the correct version for the new
pool.
1. Type the URL provided at the end of the installation program — for example,
http://10.40.196.10:8080 — into any Flash-enabled browser that has access to the
XenServer management network.
By default, the URL directs your browser to TCP port 8080 of your pool master
host. If you specified another port when you installed everRun, that port number
will be part of the URL.
When the browser connects to the specified URL, a screen opens where you can log
in to the eAC GUI for your XenServer pool.
NOTE: Because you’ll use the same URL each time you open the eAC, it’s a good idea
to bookmark the address of the master host in your browser.
2. Enter the username and password created during the XenServer installation, then
click the Login button.
Before you can start to protect applications with everRun, you need to use the eAC to
perform several pool-wide configuration tasks, which are described under Step 9.
NOTE: In the Getting Started column of the eAC Welcome screen, click Pool-Wide
Configuration Tasks for links to more information about any of these steps.
1. When the eAC workspace opens for the first time, it displays a message that lets
you choose the (single-host) default evaluation license or install a different everRun
license. Choose Install License to display the license pop-up window.
2. Locate the license key you obtained from everRun Order Support.
3. Copy the license key from the text file, paste it into the License Key field of the
everRun License dialog box, and click Install.
A message informs you that the license was accepted and applied.
If you require additional details, see the Online Help topics under Configuring an
everRun Pool > License Management.
For information on setting the IP address for maximum reliability, start with the
following topics in Online Help: Configuring an everRun Pool > Pool Isolation IP
Address.
NOTE: When planning your IPv4 pool network design, consult your network
administrator if you need help in planning IP address ranges, netmasks, and
other network details that are consistent with your existing infrastructure.
For information on using the eAC GUI controls to configure quorum service, see the
following topics in Online Help: Configuring an everRun Pool > Quorum Service
Management.
1 The task bar area contains the File and Help menus, as well as the shortcut
buttons for the Protect ( ) and Unprotect ( ) functions.
2 The Protected VM Summary area provides a quick way to view the status, by
category, of all VMs and protected PVMs on the XenServer hosts.
3 The resource pane shows all system resources in a Windows tree view. This pane
contains two tabs: Virtual Machines and Hosts. When you select a resource on
one of these tabs, an orange bar highlights it, and the same resource is highlighted
in the Virtual Machine Status table (circle 4). At the same time, the Detail tab at
the lower right of the workspace (circle 5) displays detailed information for that
resource.
4 The Virtual Machine Status table contains key information about each of the
hosts, VMs, and protected VMs in the system. Check this table to learn if a VM is
a candidate for protection and to identify the level(s) of protection it qualifies for.
In the eAC, most tabs display in dark green, but the selected tab displays in light green.
1. Open the Help menu in the task bar, click Search, and type everRun Protection
Overview into the search field.
However, you may want to change some options because of your local network
constraints. This appendix contains examples describing the use of the installer help
options.
To see all the options available in installer Online Help, along with a brief description
of each option, issue the install command with --help while the CD-ROM is still in the
CD drive:
35
--help or -h Displays this text and additional information about
ports, and the SR and VG options
To see Online Help that contains more descriptive text about each option,
enter one of the following commands while the CD-ROM is still in the CD
drive:
• # bash /mnt/everRun-6.2<version_id>-installer.bin -h
• # bash /mnt/everRun-6.2<version_id>-installer.bin
1. When you issue the install command, include the specific port(s) to use:
bash /mnt/everRun-6.2<version_id>-installer.bin – install --
port=6900
This example sets ports 6900 and 6901 as the communication ports.
In this example, the installer reported an error in the installation process, which
involved the logical volume required for everRun storage. Instead of successfully
completing the installation, the installer sent the following message.
Could not mount logical volume storage for product installation.
Examine the logfile for additional details.
The location of the logfile is included in the final lines of the installer script.
logfiles saved to tmp/everRun...[directory path].
1. To see a list of local storage of type LVM in the pool (let’s say you are root@test1-
master ~), type the following at the console command line:
[root@test1-master ~] # xe sr-list type=lvm
When the list displays, you can select the local storage located on the test1-master
host.
uuid ( RO) : c4571f60-cee4-f929-f19a-e7e816a8d545
name-label ( RW): Local storage
name-description ( RW):
host ( RO): test1-master
type ( RO): lvm
content-type ( RO): user
37
host ( RO): test1-slave
type ( RO): lvm
content-type ( RO): user
In this case, the first example shows the local storage on test1-master, so the UUID
you want is c4571f60-cee4-f929-f19a-e7e816a8d545.
2. Alternatively, to guarantee seeing local storage on test1-master, you can add the
hostname to the command:
[root@test1-master ~]# xe sr-list type=lvm host=$(hostname)
This command shows the UUID for local storage on that host.
uuid ( RO) : c4571f60-cee4-f929-f19a-e7e816a8d545
name-label ( RW): Local storage
name-description ( RW):
host ( RO): test1-master
type ( RO): lvm
content-type ( RO): user
3. Now you can specify the UUID for the local storage repository when you rerun the
everRun install command:
bash /mnt/everRun-6.2<version_id>-installer.bin --install --
sr=c4571f60-cee4-f929-f19a-e7e816a8d545
If you are experiencing trouble installing Flash Player, verify that your Internet
Explorer security level is not set to High or to a custom level that does not permit
viewing of ActiveX controls. Before attempting to launch eAC, you or your system
administrator should verify that the following settings are in effect on your browser.
The Medium Default Level Security permits you to view Flash content. Should you
need to implement any Custom Level, ensure that both the Download Signed ActiveX
controls and Run ActiveX controls and plug-ins options are set to Prompt.
39
5. Locate the section ActiveX controls and plugins.
http://kb.adobe.com/selfservice/viewContent.do?externalId=tn_19166&sliceId=1
Overview
This appendix describes how to enable the multipath option for shared storage in an
everRun-enabled XenServer pool.
Any time you select the multipath option for a protected VM (in XenCenter) the error
message "Storage repository not available" displays. The workaround is to stop the
everRun services, enable multipathing, and then re-enable the everRun services.
You can enable and disable storage multipathing using the xe command-line interface
(as described in the Citrix XenServer Administrator's Guide (search the document for
"multipathing"), or in XenCenter (search for "multipathing" in the Online Help).
41
Re-enabling everRun Services
To re-enable everRun services after the multipath option is enabled, issue the following
commands in a Console window on each host in the pool:
# service everrun-prep start
# service everrund start
# service mtcamlogd start
# service xenfiled start
# service pdmonitord start
# service mtclinkwatchd start
Overview
The following everRun components use the User Datagram Port (UDP) numbers listed
below, with default values defined in private header files.
In the unlikely event of a site conflict involving one of these port numbers, everRun
provides a capability to override the default values. This is done by defining the new
port assignment in the marathon.properties file, then issuing a command to activate
the new assignment.
43
However, when making changes that affect running PVMs, it is always a good idea to
recheck the configuration after changes are made—to make certain that a quorum
server can be reached from all PVMs after assigning a new IP address, for example.
Use the following procedure to reconfigure everRun Port assignments. Before you begin
make sure that all PVMs are up and running.
1. With all PVMs running, use eAC to disable the everRun pool-wide Quorum Service.
From eAC right-click on the pool icon from the navigation pane and select
Configure from the properties menu to open the Configure Pool Properties dialog.
Then click the Quorum Settings button and check the Disable Quorum check
box. Click Save to save your settings. A confirm operation popup will appear. Click
YES.
2. Perform a clean shutdown of all PVMs in the pool using the eAC or from a
XenServer host command window by issuing the following command:
ev pvm-shutdown uuid=<UUID number>
NOTE: Changes in quorum port numbers on the server are not preserved when
upgrading or rolling back the system. If you override default quorum port
numbers on the server and then the system is upgraded or rolled back, you
must override the default numbers again.
• To override the default for the quorum server port number, add the following
line to the properties file on each host in the pool:
mtc.default.pvm.quorum.server.port=<port-no>
• To override the default for the quorum manager (client) port number, add
the following line to the properties file on each host in the pool:
mtc.default.pvm.quorum.client.port=<port-no>
• To override the default for the Linux kernel mode socket driver port
number, add the following line to the properties file on each host in the pool:
mtc.default.pvm.lksd.port=<port-no>
5. After making the desired modification(s) to the site.properties file on all hosts in
the pool, restart the everRun Management Services daemon on each host:
service everrund restart
6. If you changed the quorum server port, activate the new assignment using the
following procedure otherwise you may skip to item 7.
• Stop the Quorum Service on the quorum service computers. Issue the following
command from a command window on each quorum service computer:
net stop mtcqserver
• Restart the Quorum Service on each Quorum Service computer by issuing the
following command from a command window on each Quorum Service
computer:
net start mtcqserver
7. Next, re-enable the pool-wide Quorum Service. From eAC right-click on the pool
icon from the navigation pane and select Configure from the properties menu to
open the Configure Pool Properties dialog. Then click the Quorum Settings
button and check the Enable Quorum check box. Click Save to save your setting.
8. Restart PVMs using the eAC interface or from a command window that has access
to the XenServer hosts:
ev pvm-start uuid=<UUID number>
See the previous note for related information.
45
46 Setup and Installation Guide
Brief Glossary
Brief Glossary 47
connection. The results of the ping help split brain
isolate master/member failures and An undesirable condition in which the
determine corrective action. By default two availability managers (AMs)
the isolation IP address is that of the servicing the two halves of an everRun
network’s gateway device, which is the protected VM are partitioned and
first usable IP address on the subnet. operating independently.
protected VMs (PVMs)
Virtual machines (VMs) that have XenServer™ and Industry
everRun availability software applied. Terminology
For optimum availability, a PVM should
domain
run on two physical XenServer hosts.
In XenServer terminology, refers to the
quorum service execution context that contains a running
An everRun communication service, virtual machine (VM). The relationship
installed on one or more Windows clients between VMs and domains in XenServer
on the LANs, that prevents host servers is similar to that between programs and
from operating independently in a non- processes in an operating system: like a
communicating, partitioned mode of program, a VM is a persistent entity that
operation (commonly known as split resides on disk. When it is loaded for
brain). Also enables unattended restarts execution, a VM runs in a domain with a
in failure modes that impact all networks distinct domain ID. See Domain0,
(such as loss of connectivity between the DomainU.
two AMs in a PVM).
Domain 0 (Dom 0)
quorum service computer A privileged virtual machine (VM) that
The network-accessible PC that runs the provides the platform management and
everRun quorum service. The eAC drives the physical I/O devices and
provides a dialog box where you can platform resources. Dom0 (rhymes with
specify an IP address for the preferred (or Mom) is the first domain started by the
primary) quorum computer, as well as an XenServer hypervisor at boot, running a
alternate quorum server. All PVMs in a Linux OS. Dom0 is sometimes referred to
resource pool use the same quorum as the “control domain.”
service computers.
DomainU (DomU)
snapshot An unprivileged domain on a XenServer,
A read-only image that represents the running a guest operating system that
disk image and configuration of a PVM at has been ported to XenServer; for
a certain point in time. example, each Windows guest VM runs in
a DomU. The U stands for “user.”
SNMP
Simple Network Management Protocol, a FC-SAN
notification services that enables you to In storage virtualization, fibre-channel
monitor the health of each everRun (FC) storage area networks (SAN) allow
protected virtual machine (PVM) and to you to aggregate disks and logical units
receive notice of state changes within the (LUNs) from disparate systems into
PVM. shared storage pools.
Brief Glossary 49
storage repository
In XenServer, any storage target that
contains physical disks.
virtual disk image (VDI)
A disk abstraction that contains the
contents of a virtual disk.
virtual machines (VMs)
File-based abstractions of dedicated
machines, which provide the
environment in which a hosted operating
system (OS) runs. A VM is also known as
a guest domain or "DomU" in XenServer
terminology.
Xen bridge (xenbr)
In XenServer network configuration, the
bridge parameter defines a method of
connecting objects. For example, if a
physical interface (PIF) object connects a
network object (n) to a host object (h), the
network corresponding to n is bridged
onto a physical interface specified by the
fields of the PIF object. Thus, if a NIC is
named eth0, the associated bridge is
xenbr0.
XenCenter
A Windows client (GUI) application that
enables you to manage XenServer hosts,
resource pools, and shared storage. It also
lets you deploy, manage, and monitor
VMs.
XenServer API (xapi)
The Citrix XenServer management API,
the application programming interface
that supports both XenCenter GUI and
the xe command line interface (CLI).
XenServer hosts
As defined by Citrix, a host is a
homogeneous system — aggregated into a
single management entity — that can
contain virtual machines. For detailed
information, see the XenServer
documentation.