From 7a84412ff29f0c0491d8f01528eedf2774bb1eeb Mon Sep 17 00:00:00 2001 From: Shireesh Anjal Date: Fri, 19 Aug 2011 16:58:07 +0530 Subject: Updated help files --- .../html/gettingstarted/access_gmc_jws.html | 25 ++++++++++++++++ .../html/gettingstarted/alerts.html | 22 ++++++++++++++ .../html/gettingstarted/check_req_client.html | 13 ++++++++- .../html/gettingstarted/check_req_gmg.html | 12 +++++++- .../html/gettingstarted/cifs_service.html | 34 +++++++++++----------- .../html/gettingstarted/install_gmg.html | 27 +++++++++++++++++ .../html/gettingstarted/install_gmg_backend.html | 26 +++++++++++++++++ .../html/gettingstarted/resetting_pwd.html | 18 ++++++++++++ .../html/gettingstarted/subtopic2 (3).html | 4 +-- 9 files changed, 160 insertions(+), 21 deletions(-) create mode 100644 src/com.gluster.storage.management.console.help/html/gettingstarted/access_gmc_jws.html create mode 100644 src/com.gluster.storage.management.console.help/html/gettingstarted/alerts.html create mode 100644 src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg.html create mode 100644 src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg_backend.html create mode 100644 src/com.gluster.storage.management.console.help/html/gettingstarted/resetting_pwd.html (limited to 'src/com.gluster.storage.management.console.help/html/gettingstarted') diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/access_gmc_jws.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/access_gmc_jws.html new file mode 100644 index 00000000..3f1b483f --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/access_gmc_jws.html @@ -0,0 +1,25 @@ + + + + + +Sub Topic + + + +

Accessing the Gluster Management Console Using Java Web Start

+

To start Gluster Management Console using Java web start, perform the following steps. +

    +
  1. Open your web browser. +

    Ensure that your web browser has cookies and Javascript enabled.

    +
  2. Type the following URL in your web browser: +

    http://server-name:8443/glustermg/

    +

    Gluster Management Console login window is displayed

    +

    Login Window +

  3. Type the following default user name and password in the login window: +

    Username: gluster

    +

    Password: syst3m

    +
+

For more information on how you can change the password, refer to Changing Administratorīs Password + + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/alerts.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/alerts.html new file mode 100644 index 00000000..bf825135 --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/alerts.html @@ -0,0 +1,22 @@ + + + + + + Sub Topic 2 + + + +

Alerts

+Alerts page enables you to quickly define alerts for typical alarm conditions found in your cluster environment. For example, low disk space is frequently a problem on managed machines. You can generate alerts for the critical conditions in your cluster by defining threshold conditions. An alert is generated when it reaches the threshold conditions that you set against server resources. These alerts are real-time data collected from your resources and are displayed in the Cluster Summary tab. +
    +
  1. CPU utilization +
  2. Memory utilization +
  3. Disk-space utilization +
  4. Server offline +
  5. Brick offline +
+

To know more on how you can set the thresholds conditions, refer +to Setting Alerts Preferences. + + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_client.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_client.html index 21f98b39..6acb7402 100644 --- a/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_client.html +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_client.html @@ -8,6 +8,17 @@

Checking the Minimum Requirements of Client Machines

-Please enter your text here. + +

Verify the following:

+ +

Web Browser Requirements

+

Using the JRE installer, you can 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 the 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., which 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 this warning and select Always Trust Content from this Provider on your browser to avoid getting this warning every time you launch the application.

\ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_gmg.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_gmg.html index c09c50e5..07c3ab52 100644 --- a/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_gmg.html +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/check_req_gmg.html @@ -8,6 +8,16 @@

Checking Gluster Management Gateway Minimum Requirements

-Please enter your text here. +Gluster Management Gateway is installed on a central server using the Linux package (e.g. rpm for CentOS) published by Gluster. Before you install Gluster Management Gateway, you must verify that your environment matches the minimum requirements described in this section. +

You must verify that your central server matches the minimum requirements listed below:

+ \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/cifs_service.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/cifs_service.html index c32a4805..f057bf15 100644 --- a/src/com.gluster.storage.management.console.help/html/gettingstarted/cifs_service.html +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/cifs_service.html @@ -10,22 +10,22 @@

CIFS Services

The Common Internet File System (CIFS), also known as Server Message Block (SMB), is a network protocol whose most common use is sharing -files on a Local Area Network (LAN). The protocol allows a client to -manipulate files just as if they were on the local computer. Operations -such as read, write, create, delete, and rename are all supported - -the only difference being that the files are not on the local computer -and are actually on a remote server. -

The CIFS protocol works by sending packets from the client to the -server. Each packet is typically a basic request of some kind, such as -open file, close file, or read file. The server then receives the -packet, checks to see if the request is legal, verifies the client has -the appropriate file permissions, and finally executes the request and -returns a response packet to the client. The client then parses the -response packet and can determine whether or not the initial request was -successful.

-

The CIFS protocol is most commonly used with Microsoft operating -systems. Windows For Workgroups was the first Microsoft operating system -to use CIFS, and each Microsoft operating system since then has been -able to function as both a CIFS server and client.

+files on a Local Area Network (LAN). It 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. Most usage of SMB involves computers running Microsoft Windows operating system. + +

CIFS can be used as an access protocol by Microsoft Windows users to access files in a GlusterFS volume. Users will be able to perform regular file system operations such as creating files, read/write data to files, deletion of data through CIFS.

+ +

Configuring the CIFS Service

+

To configure CIFS, you must create a text file consisting of a list of servers (hostnames or IP addresses).

+

Note: You can configure CIFS on a fresh install or on an existing installation on the server which you have installed Gluster Management Gateway after adding the server to the cluster.

+

Run the following command on the gateway server to configure CIFS:

+

$ grun.py <server list>.txt setup_cifs_config.py

+

Creating CIFS Users

+

You must create users and their password to enable them to use the CIFS access protocol.

+

To create CIFS users, run the following on the gateway server:

+

$ add_user_cifs_all.py <server list> <user list> <password>

+

Removing CIFS Users

+

You can delete users and their password.

+

To delete CIFS users, run the following on the gateway server:

+

$ delete_user_cifs_all.py <server list> <user list>

\ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg.html new file mode 100644 index 00000000..74ae05b6 --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg.html @@ -0,0 +1,27 @@ + + + + + +Sub Topic + + + +

Installing the Gluster Management Gateway

+

Note: For checking the GlusterFS minimum requirements, refer to the Gluster 3.2 Filesystem Installation Guide, Checking Minimum Requirements.

+

You can install the Gluster Management Gateway through the following command:

+
    +
  1. Open a terminal and type the following command +

    # rpm -ivh glustermg-1.0.0-1.x86_64.rpm +

  2. Start the Gluster Management Gateway by executing the following service +

    # service tomcat5 start +

+

Note: +

+

Gateway generates SSH keys during installation. These keys are stored in the following location /opt/glustermg/keys. These keys are used for communication with the storage servers. However, in AWS environment, SSH communication is done using the private key provided by Amazon. Hence, the AWS genegrated private key (.pem file) must be stored in /opt/glustermg/keys and the file must be named as gluster.pem

+ + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg_backend.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg_backend.html new file mode 100644 index 00000000..60240dd9 --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/install_gmg_backend.html @@ -0,0 +1,26 @@ + + + + + +Sub Topic + + + +

Installing Gluster Management Gateway Backend Packages

+Gluster Management Gateway communicates with every node of your cluster using the backend package. This package must be installed on each and every node of your cluster using the Linux package (e.g. rpm for CentOS) published by Gluster. +

The minimum requirements for installing the backend package:

+ +

To install the backend packages on each and every node of your cluster run the following command: +

# rpm -ivh cluster glustermg-backend-1.0.0-1.x86_64.rpm

+

Note: In case CIFS only, the Samba services must be configured to run on port 445 which needs to be enabled and open on all the storage servers in your cluster.

+ + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/resetting_pwd.html b/src/com.gluster.storage.management.console.help/html/gettingstarted/resetting_pwd.html new file mode 100644 index 00000000..c86fb4dd --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/resetting_pwd.html @@ -0,0 +1,18 @@ + + + + + +Sub Topic 2 + + + +

Resetting the Password

+If you have managed to get locked out of your Gluster Management Console, you will be able to reset the password if you are the administrator of the Tomcat server. +

Note: Ensure to stop the tomcat5 service before running this script.

+

You can reset the password by running the following tool on your tomcat server:

+

/opt/glustermg/1.0.0/scripts/gmg-reset-password.sh

+

The tool resets the password to the default system password “syst3m”.

+ + + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/gettingstarted/subtopic2 (3).html b/src/com.gluster.storage.management.console.help/html/gettingstarted/subtopic2 (3).html index 5ece5749..d443ce80 100644 --- a/src/com.gluster.storage.management.console.help/html/gettingstarted/subtopic2 (3).html +++ b/src/com.gluster.storage.management.console.help/html/gettingstarted/subtopic2 (3).html @@ -2,8 +2,8 @@ - - Sub Topic 2 + +Sub Topic 2 -- cgit