Escolar Documentos
Profissional Documentos
Cultura Documentos
User Guide
October 2011
ds
Table of Contents
1. About the Guide ............................................................................................... 4 1.1. Disclaimer ................................................................................................ 4 1.2. Audience for this Guide ................................................................................ 4 1.3. User Prerequisites ....................................................................................... 4 1.4. Documentation Terminology .......................................................................... 4 1.5. Conventions .............................................................................................. 5 1.6. Documentation Feedback .............................................................................. 5 2. 3. 4. Introducing Gluster Virtual Storage Appliance ........................................................... 6 Gluster Virtual Storage Appliance License ................................................................ 8 Preparing to Install Gluster Virtual Storage Appliance ................................................. 9 4.1. Gluster Virtual Storage Appliance Installation Overview ........................................ 9 4.2. Checking Gluster Virtual Storage Appliance Minimum Requirements .......................... 9 4.2.1. 4.2.2. 4.2.3. 5. Checking Gluster Virtual Storage Appliance Minimum Requirements for VMware ................................................................................................ 10 Checking Gluster Virtual Storage Appliance Minimum Requirements for KVM... 11 Checking Gluster Virtual Storage Appliance Minimum Requirements for Xen ... 12
Installing the Gluster Virtual Storage Appliance ........................................................ 13 5.1. Installing the Gluster Virtual Storage Appliance for VMware ................................... 13 5.1.1. 5.1.2. 5.1.3. 5.2.1. 5.2.2. 5.2.3. 5.3.1. 5.3.2. 5.3.3. 5.3.4. Downloading and Installing the Gluster Virtual Storage Appliance for VMware . 13 Configuring Gluster Virtual Storage Appliance for VMware ......................... 15 Starting Gluster Virtual Storage Appliance for VMware ............................. 19 Downloading and Installing the Gluster Virtual Storage Appliance for KVM ..... 20 Configuring Gluster Virtual Storage Appliance for KVM .............................. 23 Starting Gluster Virtual Storage Appliance for KVM .................................. 25 Downloading and Installing Gluster Virtual Storage Appliance for Xen ........... 26 Launching Gluster Virtual Storage Appliance from Template ...................... 29 Configuring Gluster Virtual Storage Appliance for Xen .............................. 30 Starting Gluster Virtual Storage Appliance for Xen ................................... 31
5.2. Installing the Gluster Virtual Storage Appliance for KVM ....................................... 20
5.3. Installing the Gluster Virtual Storage Appliance for Xen ........................................ 26
6. 7. 8. 9.
Verifying Successful Deployment of Gluster Virtual Storage Appliance ............................ 32 Provisioning Storage on Gluster Virtual Storage Appliance ........................................... 33 Licensing Gluster Virtual Storage Appliance............................................................. 34 Upgrading Your Gluster Virtual Storage Appliance ..................................................... 35
User Guide
Pg No. 2
ds
9.1. Upgrading Appliance from 3.1.3 Version to Higher Version .................................... 35 9.2. Swapping between Versions .......................................................................... 35 9.3. Security Patches and Periodic Updates ............................................................ 36 10. 11. Installing Gluster Virtual Storage Appliance Updates .................................................. 37 Managing Your Gluster Virtual Storage Appliance ...................................................... 38
User Guide
Pg No. 3
ds
1.1. Disclaimer
Gluster, Inc. has designated English as the official language for all of its product documentation and other documentation, as well as all our customer communications. All documentation prepared or delivered by Gluster will be written, interpreted and applied in English, and English is the official and controlling language for all our documents, agreements, instruments, notices, disclosures and communications, in any form, electronic or otherwise (collectively, the Gluster Documents). Any customer, vendor, partner or other party who requires a translation of any of the Gluster Documents is responsible for preparing or obtaining such translation, including associated costs. However, regardless of any such translation, the English language version of any of the Gluster Documents prepared or delivered by Gluster shall control for any interpretation, enforcement, application or resolution.
POSIX
Volume
User Guide
Pg No. 4
ds
1.5. Conventions
The following table lists the formatting conventions that are used in this guide to make it easier for you to recognize and use specific types of information. Convention Courier Text Italicized Text Description
Commands formatted as courier indicate shell commands. Within a command, italicized text represents variables, which must be substituted with specific values. Within a command, optional parameters are shown in square brackets. Within a command, alternative parameters are grouped within curly brackets and separated by the vertical OR bar.
Square Brackets
Curly Brackets
User Guide
Pg No. 5
ds
Introducing Gluster Gluster is an open source, scale-out file system capable of scaling to several petabytes and handling thousands of clients. Gluster assembles storage building blocks, aggregating disk and memory resources and managing data in a single global namespace. Gluster is based on a stackable user space design and can deliver exceptional performance for diverse workloads. The Gluster modular architecture allows administrators to stack modules to match user requirements, as needed. For example, administrators can use Gluster to quickly configure a standalone server system and later expand the system as needs grow.
User Guide
Pg No. 6
ds
Virtualized Cloud Environments Gluster is designed for today's high-performance, virtualized cloud environments. Unlike traditional data centers, cloud environments require multi-tenancy along with the ability to grow or shrink resources on demand. Gluster incorporates cloud capabilities into the core architecture. Every module in Gluster is treated as a volume. Gluster further adds an elastic volume manager (the glusterd daemon) and a console manager (the gluster command line interface). Using the console manager, administrators can dynamically expand, shrink, rebalance, and migrate volumes, among other operations. The command line interface additionally provides an interactive shell (with autocompletion) along with scripting capabilities suitable for automation.
User Guide
Pg No. 7
ds
User Guide
Pg No. 8
ds
User Guide
Pg No. 9
ds
4.2.1. Checking Gluster Virtual Storage Appliance Minimum Requirements for VMware
General Verification Verify the following: DNS is properly configured for your environment Centralized time servers are available (required in clustered environments) Verification on Virtual Machines Verify the following: The virtual machine is running HW v7 The virtual machine uses the default configuration settings, as supplied by Gluster (except as noted in this topic) Guests are not set to "sync time with host" The VMware Tools version of the appliance matches the ESX host (VMware Tools needs to be loaded in the guest by default) The VMware Tools version of the appliance matches the ESX host (the appliance comes preinstalled with VMware tools for ESX 4.1) Note: Running non-Gluster virtual machines on the same host or datastore as the Gluster Virtual Storage Appliance may affect Gluster performance if resources are not properly allocated. When Using ESX Hosts Managed by VirtualCenter Verify the following: VMware HCL hardware (Virtual Machine Hardware v7.0) is used, running ESX 4.1 ESX hosts are clustered, and any Distributed Resource Scheduler (DRS) rules are defined against these clusters Remote storage allows vMotion/DRS of the appliances Note: You cannot use a SQLExpress database with Gluster Virtual Storage Appliance. When Using Standalone ESX Hosts Verify the following: All hardware is on the VMware HCL (Hardware Compatibility List)
User Guide
Pg No. 10
ds
2GB RAM is configured for each virtual machine, plus 800MB for COS (up to 8GB or more is recommended for each virtual machine) 2 vCPUs and VMXNET3 network device is recommended ESX hosts are capable of running 64-bit machines, and the ESX host operating system is set to 800MB (RAM) Note: Nehalem procs in the ESX server is recommended to take advantage of appliance performance tuning.
4.2.2. Checking Gluster Virtual Storage Appliance Minimum Requirements for KVM
Before you install Gluster Virtual Storage Appliance for KVM, you must verify that your environment matches the minimum requirements: General Verify the following: DNS is properly configured for your environment Centralized time servers are available (required in clustered environments) Virtual Machines Verify the following: GNU/Linux Operating Systems with Kernel v 2.6.20 or higher The virtual machine uses the default configuration settings, as supplied by Gluster (except as noted in this topic) Note: Running non-Gluster virtual machines on the same host or datastore as the Gluster Virtual Storage Appliance may affect Gluster performance if resources are not properly allocated. When Using GNU/Linux Host Managed by Virtual Machine Manager Verify the following: AMD64 (AKA X86-64) GNU/Linux on Intel-VT or AMD-V supported processors 2GB RAM is configured for each virtual machine, plus 800MB for COS (up to 8GB or more is recommended for each virtual machine) 2 vCPUs and VirtIO network device is recommended VirtIO storage device is recommended The following packages must be installed: Qemu 0.12.5 or higher
User Guide
Pg No. 11
ds
Note: You cannot use a SQLExpress database with Gluster Virtual Storage Appliance.
4.2.3. Checking Gluster Virtual Storage Appliance Minimum Requirements for Xen
Before installing Gluster Virtual Storage Appliance for Xen, verify that your environment matches the minimum requirements: General Verify the following: DNS is properly configured for your environment Centralized time servers are available (required in clustered environments) Virtual Machines Verify the following: The virtual machine uses the default configuration settings, as supplied by Gluster (except as noted in this topic) Note: Running non-Gluster virtual machines on the same host or datastore as the Gluster Virtual Storage Appliance may affect Gluster performance if resources are not properly allocated. When Using XenServer Hosts Managed by Citrix XenCenter Verify the following: XenServer 5.5 or higher Gluster Virtual Storage Appliance may work with lower versions but has not been tested. All hardware is on the Xen HCL(Hardware Compatibility List) 2GB RAM is configured for each virtual machine, plus 800MB for COS (up to 8GB or more is recommended for each virtual machine) 2 vCPUs is recommended XenServer hosts are capable of running 64-bit machines Note: You cannot use a SQLExpress database with Gluster Virtual Storage Appliance.
User Guide
Pg No. 12
ds
5.1.1. Downloading and Installing the Gluster Virtual Storage Appliance for VMware
To install the virtual storage appliance, perform the following steps: 1. Download the VMware Gluster Virtual Storage Appliance from the following location at https://store.gluster.com/788/catalog/category.5837/language.en/currency.USD/?id=v3XNw361 6z The Gluster-Virtual-Storage-Appliance--3-2-0.ova file will be downloaded. 2. Launch the VMware vSphere Client. The logon dialog appears.
User Guide
Pg No. 13
ds
3. Logon to the client. The VMware vSphere Client main screen appears. 4. Connect vSphere Client to an ESX, ESXi, or Virtual Center host, as appropriate. 5. Choose File > Deploy OVF Template. The Deploy OVF Template wizard launches.
User Guide
Pg No. 14
ds
After you complete the wizard, the appliance is downloaded and added to the ESX host virtual machine inventory.
User Guide
Pg No. 15
ds
2. In the Hardware tab, click Add. The Add Hardware dialog appears.
3. Select Hard Disk, and click Next. The Select a Disk screen appears.
User Guide
Pg No. 16
ds
4. Select Create a new virtual disk, and click Next. The Create a Disk screen appears.
5. Specify the disk capacity, select Specify a datastore, and click Browse. The Browse for Datastore dialog appears. 6. Select a datastore, click OK, and click Next.
User Guide
Pg No. 17
ds
Gluster highly recommends separating the OS disk from the brick disks. The Advanced Options screen appears.
User Guide
Pg No. 18
ds
8. Review the summary, and click Finish. The Virtual Machine Properties screen appears with the new virtual disk appearing in the list.
Note: For increased performance, use the vmkfstools command on the ESX host to convert the disk to eagerzeroedthick.
User Guide
Pg No. 19
ds
Note: The default user name and password are root and syst3m, respectively. It is recommended that you change this password after logging on.
5.2.1. Downloading and Installing the Gluster Virtual Storage Appliance for KVM
To download and install the Gluster Virtual Storage Appliance for KVM, perform the following steps. 1. Download the KVM Gluster Virtual Storage Appliance from the following location: https://store.gluster.com/788/catalog/category.5837/language.en/currency.USD/?id=v3XNw361 6z 2. Extract the downloaded files to the server. The following files will be available: Gluster.virt-image.xml Gluster-Virtual-Storage-Appliance--3-2-0.img README.txt 3. You can use virt-image tool or Virtual Machine Manager application for installation. To install KVM Gluster Virtual Storage Appliance using virt-image tool, perform the following steps: 1. Navigate to the directory where the files are extracted by running the following command: # cd Gluster/ 2. Install the virtual machine using the following command: # virt-image -graphics vnc Gluster.virt-image.xml 3. View the status of the virtual machine using the following command: # virsh list all or 4. You can use Virtual Machine Manager application for installation: 1. Launch Virtual Machine Manager application. 2. Click Create a new virtual machine. The New KM dialog appears.
User Guide
Pg No. 20
ds
4. Specify a name for the KVM, select the OS installation type as Import existing disk image, and click Forward.
5. Browse the select the downloaded Gluster-Virtual-Storage-Appliance--3-2-0.img file, choose OS type as Linux, choose version as Red Hat Enterprise Linux 5.4 or later, and click Forward.
User Guide
Pg No. 21
ds
6. Specify the memory as 2048MB and 2 as number of CPUs, and click Forward.
7. The summary screen is displayed. Click Finish to complete the installation and the new VM will be started.
User Guide
Pg No. 22
ds
Note: For remote installation, copy the Gluster-Virtual-Storage-Appliance--3-2-0.img file into /var/lib/libvirt/images/ directory of the remove server.
User Guide
Pg No. 23
ds
5. Specify the disk capacity, select Device type as Virtio Disk. 6. Click Forward. The Finish Adding Virtual Hardware dialog appears.
User Guide
Pg No. 24
ds
7. Review the summary, and click Finish. The Virtual Machine new virtual disk appears in the list.
User Guide
Pg No. 25
ds
5.3.1. Downloading and Installing Gluster Virtual Storage Appliance for Xen
This section describes how to install Gluster Virtual Storage Appliance for Xen. To install the Gluster Virtual Storage Appliance, perform the following steps. 1. Download the Xen Gluster Virtual Storage Appliance from the following location: https://store.gluster.com/788/catalog/category.5837/language.en/currency.USD/?id=v3XNw361 6z 2. Extract the downloaded file to the server. The following file will be available: Gluster-Virtual-Storage-Appliance--3-2-0-Template.xva 3. Launch the Citrix XenCenter. The XenCenter main screen appears.
User Guide
Pg No. 26
ds
4. Select the Xen Server from the list. The Connect to Server dialog may appear, if the Remember Password option is not selected.
5. Provide login credentials and click Connect. The XenCenter main screen appears. 6. Choose File > Import. The Import wizard launches.
User Guide
Pg No. 27
ds
8. Follow the on-screen instructions and in Select a home server for the new VM screen, select the home server and click Next.
9. In Configure virtual network interfaces for the new VM screen, select the network and click Next.
User Guide
Pg No. 28
ds
10. Click Finish in Complete the import screen to complete the wizard.
After you complete the wizard, the appliance is downloaded and added to the XenServer host virtual machine inventory as Gluster-Virtual-Storage-Appliance-3-2-0-Template.
User Guide
Pg No. 29
ds
A new virtual machine is added and started. The new virtual machine will be listed in the XenCenter inventory. Note: You can right-click the Gluster Virtual Storage Appliance Template and select New VM from Template to add a new VM and customize it.
2. In the Storage tab, click Add to add storage devices. The Add Virtual Disk screen appears.
User Guide
Pg No. 30
ds
3. Specify the disk name, size, and select the location, and click Add. The new disks are added and can be viewed in Storage tab.
User Guide
Pg No. 31
ds
User Guide
Pg No. 32
ds
User Guide
Pg No. 33
ds
User Guide
Pg No. 34
ds
User Guide
Pg No. 35
ds
# gluster volume geo-replication stop MASTER SLAVE Now you can downgrade to 3.1.x. Run any parameter changing operations on the volume. For example, operations like # gluster volume set <VOL> read-ahead off and # gluster volume set <VOL> read-ahead on. 2. Restart glusterd using the following command: # service glusterd start Note: This procedure has to be performed on each instance.
User Guide
Pg No. 36
ds
(Older version) Download the base-3.2-repo file from http://bits.gluster.com/pub/gluster/base/ to /etc/yum.repos.d/ directory. Note: Downloading base-3.2-repo file is a one-time effort.
6. Run the following command to retrieve and install the updates: # yum update
User Guide
Pg No. 37
ds
User Guide
Pg No. 38