Gluster ManagementConsole 1.0.0alpha

Release Notes

Red Hat Documentation Team

Release Notes

Gluster Management Console 1.0.0alpha Release NotesAuthor Red Hat Documentation Team docfeedback@gluster.com

Copyright 2011 Red Hat, Inc.

The text of and illustrations in this document are licensed by Red Hat under a Creative CommonsAttribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is availableat http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute thisdocument or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert,Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the InfinityLogo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United Statesand/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and othercountries.

All other trademarks are the property of their respective owners.

1801 Varsity DriveRaleigh, NC27606-2072USAPhone: +1 919 754 3700Phone: 888 733 4281Fax: +1 919 754 3701

The release notes describes the new features in Gluster Management Console and provides basicinformation that you should know before installing the product.

iii

Preface v1. License ......................................................................................................................... v2. Document Conventions ................................................................................................... v

2.1. Typographic Conventions ...................................................................................... v2.2. Pull-quote Conventions ........................................................................................ vi2.3. Notes and Warnings ........................................................................................... vii

3. Feedback ...................................................................................................................... vii

1. Introduction 11.1. Overview ..................................................................................................................... 1

1.1.1. Gluster File System ........................................................................................... 11.1.2. Gluster Management Gateway ........................................................................... 21.1.3. Gluster Management Console ............................................................................ 3

2. What's New in Gluster Management Console? 52.1. Gluster Management Gateway ...................................................................................... 52.2. Gluster Management Console ....................................................................................... 52.3. Volume Management ................................................................................................... 52.4. Cluster Management .................................................................................................... 62.5. Server Management ..................................................................................................... 62.6. Log Management ......................................................................................................... 62.7. Common Internet File System (CIFS) ............................................................................ 72.8. Authentication .............................................................................................................. 72.9. Tools ........................................................................................................................... 7

3. System Requirements 93.1. System Requirements for Gluster Management Gateway ................................................ 93.2. System Requirements for the Client Machine ................................................................. 93.3. Web Browser Requirements ........................................................................................ 10

4. Downloading and Installing Gluster Management Gateway and Backend Packages 114.1. Installing Gluster Management Gateway and Backend from Red Hat Package Manager(RPM) ............................................................................................................................... 114.2. Building and Installing Gluster Management Gateway and Backend from Source ........... 11

5. Product Documentation 13

6. Known Issues 15

iv

v

PrefaceThis document provides important information regarding Gluster Management Console 1.0.0alpha.Please review this entire document before installing Gluster Management Console.

It also provides basic information about what you should know before installing the product, includingsystem requirements, product support, and how to access product documentation

1. LicenseThe License information is available at www.redhat.com/licenses/rhel_rha_eula.html.

2. Document ConventionsThis manual uses several conventions to highlight certain words and phrases and draw attention tospecific pieces of information.

In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts1 set. TheLiberation Fonts set is also used in HTML editions if the set is installed on your system. If not,alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includesthe Liberation Fonts set by default.

2.1. Typographic ConventionsFour typographic conventions are used to call attention to specific words and phrases. Theseconventions, and the circumstances they apply to, are as follows.

Mono-spaced Bold

Used to highlight system input, including shell commands, file names and paths. Also used to highlightkeycaps and key combinations. For example:

To see the contents of the file my_next_bestselling_novel in your currentworking directory, enter the cat my_next_bestselling_novel command at theshell prompt and press Enter to execute the command.

The above includes a file name, a shell command and a keycap, all presented in mono-spaced boldand all distinguishable thanks to context.

Key combinations can be distinguished from keycaps by the hyphen connecting each part of a keycombination. For example:

Press Enter to execute the command.

Press Ctrl+Alt+F2 to switch to the first virtual terminal. Press Ctrl+Alt+F1 toreturn to your X-Windows session.

The first paragraph highlights the particular keycap to press. The second highlights two keycombinations (each a set of three keycaps with each set pressed simultaneously).

If source code is discussed, class names, methods, functions, variable names and returned valuesmentioned within a paragraph will be presented as above, in mono-spaced bold. For example:

1 https://fedorahosted.org/liberation-fonts/

Preface

vi

File-related classes include filesystem for file systems, file for files, and dir fordirectories. Each class has its own associated set of permissions.

Proportional Bold

This denotes words or phrases encountered on a system, including application names; dialog box text;labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:

Choose System → Preferences → Mouse from the main menu bar to launch MousePreferences. In the Buttons tab, click the Left-handed mouse check box and clickClose to switch the primary mouse button from the left to the right (making the mousesuitable for use in the left hand).

To insert a special character into a gedit file, choose Applications → Accessories→ Character Map from the main menu bar. Next, choose Search → Find… fromthe Character Map menu bar, type the name of the character in the Search fieldand click Next. The character you sought will be highlighted in the Character Table.Double-click this highlighted character to place it in the Text to copy field and then

click the Copy button. Now switch back to your document and choose Edit → Pastefrom the gedit menu bar.

The above text includes application names; system-wide menu names and items; application-specificmenu names; and buttons and text found within a GUI interface, all presented in proportional bold andall distinguishable by context.

Mono-spaced Bold Italic or Proportional Bold Italic

Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable orvariable text. Italics denotes text you do not input literally or displayed text that changes depending oncircumstance. For example:

To connect to a remote machine using ssh, type ssh username@domain.name ata shell prompt. If the remote machine is example.com and your username on thatmachine is john, type ssh john@example.com.

The mount -o remount file-system command remounts the named filesystem. For example, to remount the /home file system, the command is mount -oremount /home.

To see the version of a currently installed package, use the rpm -q packagecommand. It will return a result as follows: package-version-release.

Note the words in bold italics above — username, domain.name, file-system, package, version andrelease. Each word is a placeholder, either for text you enter when issuing a command or for textdisplayed by the system.

Aside from standard usage for presenting the title of a work, italics denotes the first use of a new andimportant term. For example:

Publican is a DocBook publishing system.

2.2. Pull-quote ConventionsTerminal output and source code listings are set off visually from the surrounding text.

Output sent to a terminal is set in mono-spaced roman and presented thus:

Notes and Warnings

vii

books Desktop documentation drafts mss photos stuff svnbooks_tests Desktop1 downloads images notes scripts svgs

Source-code listings are also set in mono-spaced roman but add syntax highlighting as follows:

package org.jboss.book.jca.ex1;

import javax.naming.InitialContext;

public class ExClient{ public static void main(String args[]) throws Exception { InitialContext iniCtx = new InitialContext(); Object ref = iniCtx.lookup("EchoBean"); EchoHome home = (EchoHome) ref; Echo echo = home.create();

System.out.println("Created Echo");

System.out.println("Echo.echo('Hello') = " + echo.echo("Hello")); }}

2.3. Notes and WarningsFinally, we use three visual styles to draw attention to information that might otherwise be overlooked.

Note

Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note shouldhave no negative consequences, but you might miss out on a trick that makes your life easier.

Important

Important boxes detail things that are easily missed: configuration changes that only apply tothe current session, or services that need restarting before an update will apply. Ignoring a boxlabeled 'Important' will not cause data loss but may cause irritation and frustration.

Warning

Warnings should not be ignored. Ignoring warnings will most likely cause data loss.

3. Feedback

Preface

viii

Red Hat welcomes your comments and suggestions on the quality and usefulness ofits documentation. If you find any errors or have any other suggestions, write to us atdocfeedback@gluster.com for clarification and provide the chapter, section, and page number, ifavailable.

Red Hat offers a range of resources related to GlusterFS software:

• Discuss technical problems and solutions on the Discussion Forum (http://community.gluster.org)

• Get hands-on step-by-step tutorials (http://www.gluster.org/community/documentation/index.php/Main_Page)

• Reach Support (www.redhat.com/support/)

Chapter 1.

1

IntroductionRed Hat is pleased to announce the availability of Gluster Management Console 1.0.0. This releasenotes contains important information related to v1.0.0 alpha release. Product overview, new features,known problems, and resources are addressed here.

1.1. OverviewThis section provides an overview of Gluster File System, Gluster Management Gateway, and GlusterManagment Console.

1.1.1. Gluster File SystemGlusterFS is an open source, scale-out file system capable of scaling to several petabytes andhandling thousands of clients. GlusterFS assembles storage building blocks, aggregating disk andmemory resources and managing data in a single global namespace. GlusterFS is based on astackable user space design and can deliver exceptional performance for diverse workloads.

The GlusterFS modular architecture allows administrators to stack modules to match userrequirements, as needed. For example, administrators can use GlusterFS to quickly configure astandalone server system and later expand the system as their business needs grow.

Virtualized Cloud Environments

GlusterFS is designed for today's high-performance, virtualized cloud environments. Unlike traditionaldata centers, cloud environments require multi-tenancy along with the ability to grow or shrinkresources on demand. GlusterFS incorporates cloud capabilities into the core architecture.

Every module in GlusterFS is treated as a volume. GlusterFS further adds an elastic volume manager(the glusterd daemon) and a console manager (the gluster command line interface). Using the consolemanager, administrators can dynamically expand, shrink, rebalance, and migrate volumes, amongother operations. The command line interface additionally provides an interactive shell (with auto-completion) along with scripting capabilities suitable for automation.

Chapter 1. Introduction

2

Figure 1.1. GlusterFS Architecture

1.1.2. Gluster Management GatewayGluster Management Gateway provides simple and powerful REST APIs for managing your Glusterstorage cluster. It also hosts the Gluster Management Console binaries, which can be launched froma browser using the Java Webstart. Gluster Management Console uses the REST APIs for performingthe administrative tasks on the Gluster storage cluster.

Figure 1.2. Gluster Management Gateway Architecture

Gluster Management Console

3

1.1.3. Gluster Management ConsoleGluster Management Console is a Java application that provides a single interface to perform theadministrative tasks such as create, manage, and maintain your storage cluster.

You can use the Gluster Management Console to:

• Create a Gluster storage cluster

• Expand your cluster

• Monitor systems in your cluster

• Manage logs

4

Chapter 2.

5

What's New in Gluster ManagementConsole?This section describes the new features available in Gluster Management Console. The following is alist of feature highlights of this new version of the management console:

2.1. Gluster Management GatewayGluster Management Gateway provides simple and powerful REST APIs for managing your GlusterStorage Cluster. It also host’s the Gluster Management Console binaries, which can be launched froma browser using the Java Webstart. Gluster Management Console uses the REST APIs for performingthe administrative tasks on the Gluster Storage Cluster.

2.2. Gluster Management ConsoleGluster Management Console is a Java application that provides a single interface to perform theadministrative tasks such as create, manage, and maintain your storage cluster. For more informationon installation and configuration Gluster Management Console, refer the Gluster ManagementConsole User Guide1.

2.3. Volume ManagementThe highest level of organization in the file system is the volume. A volume is a logical collectionof bricks. Most of the Gluster management operations happen on the volume. Brick is the basicunit of storage, represented by an export directory on a server in the trusted storage pool. GlusterManagement Console provides a GUI to administer volume management functions such as:

• List Volumes

• Create Volume

• Display Volume details

• Properties

• Bricks of volumes

• Volume Options

• Alerts

• Tasks

• Configure Volume

• Access Protocols (Gluster, NFS, CIFS)

• Access Control

• Delete Volume

1 http://download.gluster.com/pub/gluster/glustermc/1.0/Documentation/User_Guide/html/index.html

Chapter 2. What's New in Gluster Management Console?

6

• Brick Management

• Add Brick or Bricks

• Remove Brick or Bricks

• Migrate Brick

• Start Offline Bricks

2.4. Cluster ManagementA cluster is a group of independent computer systems, referred to as nodes, working together as aunified storage resource. Gluster Management Console provides a graphical user interface (GUI) toadminister cluster management functions such as:

• Display Cluster Information

• Summary

• Historic Network and CPU Usage charts

• Alerts

• Tasks

• Auto-Discovery of Servers that are not yet part of a cluster

• List Servers of the Cluster

• Add Server or Servers

• Remove Server or Servers

2.5. Server ManagementGluster Management Console provides a graphical user interface (GUI) to administer servermanagement functions such as:

• Display Server Details

• Resources

• Historic CPU, Memory, and Network usage charts

• Alerts

• Tasks

• Disk Management

• List all disks of the cluster or server

• Initialize or format a disk

2.6. Log ManagementGluster Management Console provides a graphical user interface (GUI) to administer log managementfunctions such as:

Common Internet File System (CIFS)

7

• Volume Logs

• Search logs of a volume based on search criteria

• Download Logs

• Rotate Logs

2.7. Common Internet File System (CIFS)Common Internet File System (CIFS) operates as an application-layer network protocol to provideshared access to files, printers, serial ports, and miscellaneous communications between nodeson a network. It also provides an authenticated inter-process communication mechanism. GlusterManagement Console provides:

• Command line tools to:

• Configure CIFS services on servers

• Create or Delete CIFS users

• Enable or Disable CIFS re-export of a volume from the console

2.8. Authentication• Default single user gluster having all permissions

• Login Window

• Password Management

2.9. Tools• Settings

• Terminal (SSH)

8

Chapter 3.

9

System RequirementsThis chapter describes the basic information that you should know before installing GlusterManagement Console.

3.1. System Requirements for Gluster ManagementGatewayBefore you install the Gluster Management Gateway, verify that your system matches the followingminimum requirements:

• Memory: 2 GB RAM

• Processor: 2 (2.4 GHz each) is recommended; 64 bit

• Disk Space: 10 GB

• Operating System: Red Hat Enterprise Linux 6.1

Gluster Management Gateway may work on other common Linux distributions as well, but has notbeen tested extensively.

• Software Packages:

• java-1.6.0-openjdk 1.6.0.0 or higher

• tomcat6 6.0.24 or higher

You must verify that your Backend storage nodes match the minimum requirements listed below:

• chkconfig

• python v2.4.3

• perl v5.8.8

• rrdtool-perl v1.2.27

• sudo

• crontabs

• samba3

• libxml2 v2.6

• fuse kernel module

3.2. System Requirements for the Client MachineOn the client machine, you must verify the following:

• Processor - 1.4 GHz

• Memory - 2 GB RAM

• Disk - 100 MB

Chapter 3. System Requirements

10

• Operating Systems: Windows XP/Vista/7, Linux, Mac OS X

• Oracle JRE v1.6

3.3. Web Browser RequirementsThe web browser requirements are as follows:

• Use your Java Runtime Environment (JRE) installer to configure your browser for Java Web Start.Also, ensure that you have configured your browser to open .jnlp files using the Java Web Startapplication or javaws exe located in bin folder of your JRE installation

• When you access the Gluster Management Console, Java Web Start downloads all required .jarfiles from the Gateway server and launches the console’s GUI. During this process, web startmay display a certificate warning mentioning that the application is signed by Gluster, Inc. Thiscertificate is authentic, but it requires full permissions as the application contains features thatrequire registering information on the client's hard disk such as exporting the security keys fromgateway. You can accept the warning and select Always Trust Content from this Provider onyour browser to avoid this warning every time you launch the application.

Chapter 4.

11

Downloading and Installing GlusterManagement Gateway and BackendPackagesThis section provides an overview on how you can build and install Gluster Management Gatewayand Backend packages from source as well as install using Red Hat Package Manager (RPM)distributions.

4.1. Installing Gluster Management Gateway and Backendfrom Red Hat Package Manager (RPM)You can download the latest Red Hat Package Manager (RPM) distributions of GlusterManagement Gateway and Backend Packages from: http://download.gluster.com/pub/gluster/glustermc/1.0/1.0.0alpha/RHEL/6.1/.

For more information on how to install Management Gateway and Backend packages from Red HatPackage Manager (RPM) Distributions, refer to section Installing from Red Hat Package Manager(RPM) Distributions1, of the Gluster Management Console User Guide.

4.2. Building and Installing Gluster Management Gatewayand Backend from SourceYou can build and install Gluster Management Gateway and Backend Packages from source. Thebuild can be performed on one machine, which results in the installer tarballs. The application can becan be installed by copying these tarballs to the appropriate machine.

For more information about how to build and install the product from source code, refer to the sectionBuilding and Installing from Source2, of the Gluster Management Console User Guide.

1 http://download.gluster.com/pub/gluster/glustermc/1.0/Documentation/User_Guide/html/ch03s03.html2 http://download.gluster.com/pub/gluster/glustermc/1.0/Documentation/User_Guide/html/ch03s02.html

12

Chapter 5.

13

Product DocumentationIn addition to the Online Help, the document set for Gluster Management Console contains thefollowing guides:

Documentation Title Description

Gluster Management Console User Guide1 Describes how to install, configure GlusterManagement Console. It also describes how touse the Gluster Management Console to build,manage, and maintain your Gluster storagecloud.

Gluster Management Gateway REST API Guide2 This guide describes the REST API for GlusterManagement Gateway.

Gluster Management Console Release Notes3 The release notes describes the new featuresin Gluster Management Console v1.0.0 andprovides basic information that you should knowbefore installing the product.

14

Chapter 6.

15

Known IssuesCIFS related functionality does not work on Fedora 16 operating system.

16