Gluster Management Console 1.0.0alpha Release Notes. Red Hat Documentation Team

Transcription

1 Gluster Management Console 1.0.0alpha Release Notes Red Hat Documentation Team

2 Release Notes Gluster Management Console 1.0.0alpha Release Notes Author Red Hat Documentation Team Copyright 2011 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document 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 Infinity Logo, 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 States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. All other trademarks are the property of their respective owners Varsity DriveRaleigh, NC USAPhone: Phone: Fax: The release notes describes the new features in Gluster Management Console and provides basic information that you should know before installing the product.

3 Preface v 1. License... v 2. Document Conventions... v 2.1. Typographic Conventions... v 2.2. Pull-quote Conventions... vi 2.3. Notes and Warnings... vii 3. Feedback... vii 1. Introduction Overview Gluster File System Gluster Management Gateway Gluster Management Console What's New in Gluster Management Console? Gluster Management Gateway Gluster Management Console Volume Management Cluster Management Server Management Log Management Common Internet File System (CIFS) Authentication Tools System Requirements System Requirements for Gluster Management Gateway System Requirements for the Client Machine Web Browser Requirements Downloading and Installing Gluster Management Gateway and Backend Packages Installing Gluster Management Gateway and Backend from Red Hat Package Manager (RPM) Building and Installing Gluster Management Gateway and Backend from Source Product Documentation Known Issues 15 iii

4 iv

5 Preface This 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, including system requirements, product support, and how to access product documentation 1. License The License information is available at 2. Document Conventions This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information. In PDF and paper editions, this manual uses typefaces drawn from the Liberation Fonts 1 set. The Liberation 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 includes the Liberation Fonts set by default Typographic Conventions Four typographic conventions are used to call attention to specific words and phrases. These conventions, 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 highlight keycaps and key combinations. For example: To see the contents of the file my_next_bestselling_novel in your current working directory, enter the cat my_next_bestselling_novel command at the shell 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 bold and all distinguishable thanks to context. Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example: Press Enter to execute the command. Press Ctrl+Alt+F2 to switch to the first virtual terminal. Press Ctrl+Alt+F1 to return to your X-Windows session. The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously). If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in mono-spaced bold. For example: 1 v

6 Preface File-related classes include filesystem for file systems, file for files, and dir for directories. 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 Mouse Preferences. In the Buttons tab, click the Left-handed mouse check box and click Close to switch the primary mouse button from the left to the right (making the mouse suitable 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 from the Character Map menu bar, type the name of the character in the Search field and 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 Paste from the gedit menu bar. The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all presented in proportional bold and all distinguishable by context. Mono-spaced Bold Italic or Proportional Bold Italic Whether mono-spaced bold or proportional bold, the addition of italics indicates replaceable or variable text. Italics denotes text you do not input literally or displayed text that changes depending on circumstance. For example: To connect to a remote machine using ssh, type ssh username@domain.name at a shell prompt. If the remote machine is example.com and your username on that machine is john, type ssh john@example.com. The mount -o remount file-system command remounts the named file system. For example, to remount the /home file system, the command is mount -o remount /home. To see the version of a currently installed package, use the rpm -q package command. It will return a result as follows: package-version-release. Note the words in bold italics above username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system. Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example: Publican is a DocBook publishing system Pull-quote Conventions Terminal 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: vi

7 Notes and Warnings books Desktop documentation drafts mss photos stuff svn books_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 Warnings Finally, 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 should have 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 to the current session, or services that need restarting before an update will apply. Ignoring a box labeled '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 vii

8 Preface Red Hat welcomes your comments and suggestions on the quality and usefulness of its documentation. If you find any errors or have any other suggestions, write to us at for clarification and provide the chapter, section, and page number, if available. Red Hat offers a range of resources related to GlusterFS software: Discuss technical problems and solutions on the Discussion Forum ( Get hands-on step-by-step tutorials ( Main_Page) Reach Support ( viii

9 Chapter 1. Introduction Red Hat is pleased to announce the availability of Gluster Management Console This release notes contains important information related to v1.0.0 alpha release. Product overview, new features, known problems, and resources are addressed here Overview This section provides an overview of Gluster File System, Gluster Management Gateway, and Gluster Managment Console Gluster File System GlusterFS is an open source, scale-out file system capable of scaling to several petabytes and handling thousands of clients. GlusterFS assembles storage building blocks, aggregating disk and memory resources and managing data in a single global namespace. GlusterFS is based on a stackable user space design and can deliver exceptional performance for diverse workloads. The GlusterFS modular architecture allows administrators to stack modules to match user requirements, as needed. For example, administrators can use GlusterFS to quickly configure a standalone 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 traditional data centers, cloud environments require multi-tenancy along with the ability to grow or shrink resources 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 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. 1

10 Chapter 1. Introduction Figure 1.1. GlusterFS Architecture Gluster Management Gateway Gluster Management Gateway provides simple and powerful REST APIs for managing your Gluster storage cluster. It also hosts the Gluster Management Console binaries, which can be launched from a browser using the Java Webstart. Gluster Management Console uses the REST APIs for performing the administrative tasks on the Gluster storage cluster. Figure 1.2. Gluster Management Gateway Architecture 2

11 Gluster Management Console Gluster Management Console Gluster Management Console is a Java application that provides a single interface to perform the administrative 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 3

12 4

13 Chapter 2. What's New in Gluster Management Console? This section describes the new features available in Gluster Management Console. The following is a list of feature highlights of this new version of the management console: 2.1. Gluster Management Gateway Gluster Management Gateway provides simple and powerful REST APIs for managing your Gluster Storage Cluster. It also host s the Gluster Management Console binaries, which can be launched from a browser using the Java Webstart. Gluster Management Console uses the REST APIs for performing the administrative tasks on the Gluster Storage Cluster Gluster Management Console Gluster Management Console is a Java application that provides a single interface to perform the administrative tasks such as create, manage, and maintain your storage cluster. For more information on installation and configuration Gluster Management Console, refer the Gluster Management Console User Guide Volume Management The highest level of organization in the file system is the volume. A volume is a logical collection of bricks. Most of the Gluster management operations happen on the volume. Brick is the basic unit of storage, represented by an export directory on a server in the trusted storage pool. Gluster Management 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 5

14 Chapter 2. What's New in Gluster Management Console? Brick Management Add Brick or Bricks Remove Brick or Bricks Migrate Brick Start Offline Bricks 2.4. Cluster Management A cluster is a group of independent computer systems, referred to as nodes, working together as a unified storage resource. Gluster Management Console provides a graphical user interface (GUI) to administer 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 Management Gluster Management Console provides a graphical user interface (GUI) to administer server management 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 Management Gluster Management Console provides a graphical user interface (GUI) to administer log management functions such as: 6

15 Common Internet File System (CIFS) 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 provide shared access to files, printers, serial ports, and miscellaneous communications between nodes on a network. It also provides an authenticated inter-process communication mechanism. Gluster Management 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) 7

16 8

17 Chapter 3. System Requirements This chapter describes the basic information that you should know before installing Gluster Management Console System Requirements for Gluster Management Gateway Before you install the Gluster Management Gateway, verify that your system matches the following minimum 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 not been tested extensively. Software Packages: java openjdk or higher tomcat 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 v sudo crontabs samba3 libxml2 v2.6 fuse kernel module 3.2. System Requirements for the Client Machine On the client machine, you must verify the following: Processor GHz Memory - 2 GB RAM Disk MB 9

18 Chapter 3. System Requirements Operating Systems: Windows XP/Vista/7, Linux, Mac OS X Oracle JRE v Web Browser Requirements The 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 Start application or javaws exe located in bin folder of your JRE installation When you access the Gluster Management Console, Java Web Start downloads all required.jar files from the Gateway server and launches the console s GUI. During this process, web start may display a certificate warning mentioning that the application is signed by Gluster, Inc. This certificate is authentic, but it requires full permissions as the application contains features that require registering information on the client's hard disk such as exporting the security keys from gateway. You can accept the warning and select Always Trust Content from this Provider on your browser to avoid this warning every time you launch the application. 10

19 Chapter 4. Downloading and Installing Gluster Management Gateway and Backend Packages This section provides an overview on how you can build and install Gluster Management Gateway and Backend packages from source as well as install using Red Hat Package Manager (RPM) distributions Installing Gluster Management Gateway and Backend from Red Hat Package Manager (RPM) You can download the latest Red Hat Package Manager (RPM) distributions of Gluster Management Gateway and Backend Packages from: glustermc/1.0/1.0.0alpha/rhel/6.1/. For more information on how to install Management Gateway and Backend packages from Red Hat Package Manager (RPM) Distributions, refer to section Installing from Red Hat Package Manager (RPM) Distributions 1, of the Gluster Management Console User Guide Building and Installing Gluster Management Gateway and Backend from Source You can build and install Gluster Management Gateway and Backend Packages from source. The build can be performed on one machine, which results in the installer tarballs. The application can be can 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 section Building and Installing from Source 2, of the Gluster Management Console User Guide

20 12

21 Chapter 5. Product Documentation In addition to the Online Help, the document set for Gluster Management Console contains the following guides: Documentation Title Gluster Management Console User Guide 1 Gluster Management Gateway REST API Guide 2 Gluster Management Console Release Notes 3 Description Describes how to install, configure Gluster Management Console. It also describes how to use the Gluster Management Console to build, manage, and maintain your Gluster storage cloud. This guide describes the REST API for Gluster Management Gateway. The release notes describes the new features in Gluster Management Console v1.0.0 and provides basic information that you should know before installing the product. 13

22 14

23 Known Issues Chapter 6. CIFS related functionality does not work on Fedora 16 operating system. 15

24 16