From d314b052f837db9a45a6aac8b8da003ae7d51fca Mon Sep 17 00:00:00 2001 From: Shireesh Anjal Date: Tue, 23 Aug 2011 20:44:44 +0530 Subject: Latest help contents --- .../html/tasks/add_brick.html | 15 ++++---- .../html/tasks/add_servers.html | 3 +- .../html/tasks/create_cluster.html | 17 +++------ .../html/tasks/create_volume.html | 40 +++++++++------------ .../html/tasks/delete_volume.html | 6 ++-- .../html/tasks/display_log.html | 9 +++-- .../html/tasks/download_log.html | 3 +- .../html/tasks/migrate_brick.html | 15 ++++---- .../html/tasks/rebalance_vol.html | 4 +-- .../html/tasks/register_cluster.html | 12 +++---- .../html/tasks/remove_brick.html | 41 ++++++++++++++++++++++ .../html/tasks/remove_server.html | 12 +++---- .../html/tasks/select_cluster.html | 13 +++---- .../html/tasks/start_vol.html | 8 ++--- .../html/tasks/stop_vol.html | 13 ++++--- .../html/tasks/tune_vol_opt.html | 11 +++--- 16 files changed, 118 insertions(+), 104 deletions(-) create mode 100644 src/com.gluster.storage.management.console.help/html/tasks/remove_brick.html (limited to 'src/com.gluster.storage.management.console.help/html/tasks') diff --git a/src/com.gluster.storage.management.console.help/html/tasks/add_brick.html b/src/com.gluster.storage.management.console.help/html/tasks/add_brick.html index 00207885..de0dc6ea 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/add_brick.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/add_brick.html @@ -10,26 +10,23 @@ type="text/css" media="screen" />

Adding Bricks

-You can expand a volume, as required, by adding new bricks to an -existing volume. +You can expand a volume, as required, by adding new bricks to an existing volume. To add a brick to an existing volume, perform the following steps.

Note: You need to add at least one brick to a distributed -volume, two (or multiples of two) bricks to mirrored distributed -volumes, and four (or multiples of four) bricks to striped distributed +volume, two (or multiples of two) bricks to replicated +volumes, and four (or multiples of four) bricks to striped volumes when expanding your storage space.

To add a brick to an existing volume, perform the following steps.

    -
  1. Choose from the menu, toolbar, or right click and select the - Volume and select Add Bricks. +
  2. Select the volume from the left pane, choose from the menu, toolbar, or right click and select Add Bricks.

    The Add Brick window is displayed.

    -

    Add Brick

    +

    Add Brick

  3. Select the bricks that you want to add to the current volume. Click Add to add a specific brick or Click Add All to add all the available bricks.
  4. Click Finish. The Add Brick(s)to Volume window appears indicating that the brick(s) is successfully added. -

    Add Brick to Volume Confirmation

  5. Click OK.
diff --git a/src/com.gluster.storage.management.console.help/html/tasks/add_servers.html b/src/com.gluster.storage.management.console.help/html/tasks/add_servers.html index d71cdfb4..b554a1dc 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/add_servers.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/add_servers.html @@ -9,7 +9,7 @@ type="text/css" media="screen" /> -

Adding Servers

+

Adding Servers to a Cluster

Gluster Management Console discovers servers across the environment. You can add servers manually or from the discovered list of servers to your cloud environment to expand the amount of available storage. @@ -18,6 +18,7 @@ steps:

  1. Choose from the menu, toolbar, or right click on the Discovered Server node and select Add Server. +

    You can also choose multiple discovered servers or select All from the Discovered Servers tab and select Add Sever.

    Add Servers

  2. The console displays the Add Server(s) to Cluster window to indicate that the server was successfully added to the diff --git a/src/com.gluster.storage.management.console.help/html/tasks/create_cluster.html b/src/com.gluster.storage.management.console.help/html/tasks/create_cluster.html index b0325372..a2e0dff8 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/create_cluster.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/create_cluster.html @@ -9,24 +9,17 @@ type="text/css" media="screen" /> -

    Create Cluster

    -You can use Gluster Management Console to create and manage virtual -machines and resources on GlusterFS. To create a cluster, perform the +

    Creating a Cluster

    + To create a cluster, perform the following steps.
      -
    1. Open your web browser. -
    2. Type the following URL in your web browser:
    3. -

      http://server-name:webserver-port/glustermg/gluster-management-console.jnlp

      -

      Gluster Management Console login window is displayed.

      -

      Login Window -

    4. Type the user name and password in the login window and click - Login. -

      Select Cluster window is displayed.

      +
    5. Launch the application and log in with a valid password. +

      Select Cluster window is displayed

      Create Cluster

    6. Select Create. Type the name of the new cluster in the Cluster Name field. -
    7. Click OK. The Gluster Management Console window is displayed with the newly created cluster +
    8. Click OK. The Gluster Management Console window is displayed with the newly created cluster.
    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/create_volume.html b/src/com.gluster.storage.management.console.help/html/tasks/create_volume.html index 398be2e4..814835ec 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/create_volume.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/create_volume.html @@ -10,44 +10,38 @@ type="text/css" media="screen" />

    Creating a Volume

    -You can use the Management Console to create and start new volumes -featuring a single global namespace. When creating a new volume, you can -select the servers that will comprise the volume and, optionally, -specify whether the volume is to be distributed, distributed mirrored, -or distributed stripedPlease enter your text here. +You can create new volumes in your storage environment, as needed. When creating a new volume, you must specify the bricks that comprise the volume and specify whether the volume is to be distributed, replicated, or striped.

    To create a volume, perform the following steps:

    1. Choose from the menu, toolbar, or right click and select the - Volume and select Create Volume. + Volume and select Create Volume. -

      The Create Volume window is displayed. +

      The Create Volume window is displayed.

      Create Volume

      -
    2. Enter the name of the volume in the Name field. -
    3. Select the type of the volume from the Type drop-down list. - You can choose the type as either Plain Distribute, Distributed Mirror, - or Distributed Stripe. +
    4. Type the name of the volume in the Name field. +
    5. Select the type of the volume from the Type drop-down list. + You can choose the type as either Distribute, Replicate, + or Stripe.
    6. Bricks will be created on all the disks of the cluster when - you create a volume, by default. Click Customize, to select and add + you create a volume, by default. Click Customize, to select and add specific bricks to your volume. -
    7. Select the Access Protocol for the new volume. You can select - GlusterFS, NFS, or CIFS checkbox. -
    8. If you choose CIFS, specify the user name and password to use +
    9. Select the Access Protocol for the new volume by selecting GlusterFS, NFS, or CIFS checkbox. +
    10. If you choose CIFS, specify the user name and password to use from Windows clients to connect to the volume.

      You need to use user-based authentication for CIFS exports, hence you must specify the user’s who can access the volume as a comma-separated list in the Users field. -

    11. Specify the volume access control as a comma-separated list of - IP addresses or hostnames in the Access Control field. -

      You can use wildcard to specify ranges of addresses. Typing an - asterisk (*) specifies all IP addresses. You need to use IP-based - authentication for Gluster Filesystem and NFS exports.

      -
    12. Select the Start Volume check box to automatically start the + +

      For more information about configuring CIFS, refer CIFS + Services.

    13. In the Allow Access From field, specify the volume access control as a comma-separated list of IP addresses or hostnames. +

      You can use wildcards to specify ranges of addresses. Typing an asterisk (*) specifies all IP addresses or hostnames. You need to use IP-based authentication for Gluster Filesystem and NFS exports.

      +
    14. Select the Start Volume check box to automatically start the volume once created. -
    15. Click Create Volume. The console displays Create Volume window +
    16. Click Create Volume. The console displays Create Volume window to indicate that the volume was successfully created.

      Volume Created Successfuly

      -
    17. Click OK. +
    18. Click OK.
    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/delete_volume.html b/src/com.gluster.storage.management.console.help/html/tasks/delete_volume.html index 17a313e8..aaefc783 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/delete_volume.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/delete_volume.html @@ -14,18 +14,18 @@ You can delete a volume or multiple volumes from your storage environment, as re

    To delete a volume, perform the following steps.

    1. Choose from the menu, toolbar, or right click and select the Volume and select Delete Volume. -

      The Delete Volume window appears. If the volume is - currently running, you are asked to confirm before proceeding with the +

      The Delete Volume window appears. You are asked to confirm before proceeding with the volume deletion

      Delete Volume

      In case of multiple volumes, the Delete Volume window is displayed as shown below.

      Delete Multiple Volumes

    2. If you wish to delete the volume permanently, click Delete Volume and Data.
    3. If you wish to keep the data but delete the volume, click Delete Volume, Keep Data. +

      The bricks directories of the volume will be renamed to <olddirectory>_<timestamp>.

      The Delete Volume window is displayed indicating that the volume was deleted successfully.

      Delete Volume

      -

      In case of multiple volumes, the Delete Volume window is displayed as follows.

      +

      In case of multiple volumes, the Delete Volume window is displayed as follows.

      Delete Multiple Volumes

    4. Click OK.
    diff --git a/src/com.gluster.storage.management.console.help/html/tasks/display_log.html b/src/com.gluster.storage.management.console.help/html/tasks/display_log.html index 3bf88f41..4575fd18 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/display_log.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/display_log.html @@ -13,14 +13,13 @@ type="text/css" media="screen" /> You can download the log file of your resource based on search criteria such as warning,error, alerts, and so on.

    To display log based on a search criteria, perform the following steps.

      -
    1. Choose Volumes and click the Volume Logs tab. -
    2. Select the volume for which you want to display the logs. +
    3. Select the volume for which you want to display the log and click the Volume Logs tab.
    4. In the Scan Last field, type the number of messages to scan.
    5. Select All or select bricks from Filter on Bricks drop down list. -
    6. Select the From date, Time, and To date and click Go. -
    7. Select the search criteria by typing the criteria in the Filter String field. -

      For example, in the window below the search criteria chosen is Warning. Hence, all the warning messages are displayed.

      +

    8. Select the From date, Time, and To date and click Fetch Logs. +

      The volume log messages for the selected criteria is displayed

      Volume Logs with Warning Search Criteria

      +

      The logs fetched from the servers can be filtered further by typing a value in the Filter String field.

    diff --git a/src/com.gluster.storage.management.console.help/html/tasks/download_log.html b/src/com.gluster.storage.management.console.help/html/tasks/download_log.html index d647cfd8..4d36b0c4 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/download_log.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/download_log.html @@ -13,10 +13,11 @@ type="text/css" media="screen" />

    You can download the server logs to your local machine to analyze and archive, as required.

    To download logs, perform the following steps.

      +
    1. Select the volume for which you want to download the logs
    2. From the Gluster menu or toolbar, select Download Logs.
    3. A window is displayed allowing you to choose the download location on your machine.
    4. Choose the location, and click Save. -

      The logs for the selected volume are downloaded to the location you specified in a .tar.gz file format.

      +

      The logs for the selected volume are downloaded to the location you specified in a .tar.gz file format.

    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/migrate_brick.html b/src/com.gluster.storage.management.console.help/html/tasks/migrate_brick.html index c705e783..b5202f25 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/migrate_brick.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/migrate_brick.html @@ -10,19 +10,20 @@ type="text/css" media="screen" />

    Migrating Bricks

    -

    You can migrate the data from one brick to another, as needed, while the volume is online and available.You can migrate disks, that is, move data from one disk to another within your cluster. You might want to do this, for example, when upgrading a disk to another with a larger capacity.

    -

    When migrating a disk, the Gluster Management Console allows you to select both the source and destination bricks. After initiating a disk migration, the Task tab displays the status of the migration, and allows you to cancel the migration, if necessary.

    +

    You can migrate the data from one brick to another, as needed, while the cluster is online and available. +You can migrate bricks, that is, move data from one brick to another within your cluster. You might want to do this, for example, when upgrading a disk to another with a larger capacity. +

    +

    When migrating a disk, the Gluster Management Console allows you to select both the source and destination bricks. After initiating a disk migration, the Task tab displays the status of the migration. You can stop, pause, resume, or commit the migration by selecting the appropriate icon from the toolbar.

    To migrate volume data from one brick to another, perform the following steps.

      -
    1. Select Migrate Bricks by choosing from the menu, toolbar, or right click and select the volume. +
    2. Select Migrate Bricks by choosing from the menu, toolbar, or right click when you select the volume.

      The Migrate Brick window is displayed.

      Migrate Brick -

    3. Type the source volume in the From Disk field. -
    4. Type the destination volume in the To Disk field. +
    5. Select the source brick from the From Brick table. +
    6. Select the destination brick from the To Brick table.
    7. Click Finish. The Brick Migration window appears indicating that the brick was successfully migrated.

      Migrate Brick Success -

    8. The Volumes tab displays the migration status of the volume (updated automatically every few minutes). -
    9. In the Task tab, click Cancel to cancel the volume migration or click Pause to pause the process, if required. +
    10. The Tasks tab displays the migration status (updated periodically).
    diff --git a/src/com.gluster.storage.management.console.help/html/tasks/rebalance_vol.html b/src/com.gluster.storage.management.console.help/html/tasks/rebalance_vol.html index 57d85404..63bf3050 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/rebalance_vol.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/rebalance_vol.html @@ -14,11 +14,11 @@ You can rebalance a volume, as required. After adding bricks, you need to rebala

    To rebalance a volume, perform the following steps:

    1. Choose from the menu, toolbar, or right click to select the volume. Select Rebalance Volume. -

      The Rebalance Volume window appears indicating that the volume rebalance was successfully started.

      +

      The Rebalance Volume window is displayed indicating that the volume rebalance is successfully started.

      Rebalance Volume

    2. Click OK.
    3. Select the cluster from the left pane and choose the Task tab to check the volume rebalance status. -
    4. If you wish to temporarily stop the rebalance process, click Pause from the menu bar. Click Resume, to continue and complete the process. +
    5. If you wish to stop rebalance of a volume, click Stop from the menu bar.
    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/register_cluster.html b/src/com.gluster.storage.management.console.help/html/tasks/register_cluster.html index 2265a961..eac9f4a8 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/register_cluster.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/register_cluster.html @@ -9,19 +9,15 @@ type="text/css" media="screen" /> -

    Register Cluster

    +

    Registering a Cluster

    To register a cluster, perform the following steps.
      -
    1. Open your web browser. -
    2. Type the following URL in your web browser:
    3. -

      http://server-name:webserver-port/glustermg/gluster-management-console.jnlp

      -

      Gluster Management Console login window is displayed.

      -

      Login Window -

    4. Type the user name and password in the login window and clickLogin. +
    5. Launch the application and log in with a valid password.

      Select Cluster window is displayed.

      Register Cluster

    6. Select Register. Type the name of the cluster and server name in the respective fields. -
    7. Click OK. The Gluster Management Console window is displayed with the newly registered cluster +

      Note: Ensure that you type an online server name in the Server Name field.

      +
    8. Click OK. The Gluster Management Console will register the cluster with the gateway, fetch all the management information such as servers and volume resources and display them in the console.
    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/remove_brick.html b/src/com.gluster.storage.management.console.help/html/tasks/remove_brick.html new file mode 100644 index 00000000..a05c83ec --- /dev/null +++ b/src/com.gluster.storage.management.console.help/html/tasks/remove_brick.html @@ -0,0 +1,41 @@ + + + + + + +Sub Topic + + + +

    Removing Bricks

    +You can shrink volumes, as needed, while the cluster is online and +available. For example, you might need to remove a brick that has become +inaccessible in a distributed volume due to hardware or network failure. +

    Note: Data residing on the brick that you are removing +will no longer be accessible; only the configuration information is +removed - you can continue to access the data directly from the brick, +as necessary. +

    To remove bricks from an existing volume, perform the following +steps.

    +
      +
    1. Choose from the menu, toolbar, or right click and select the + Volume and select Remove Bricks. +
    2. If the volume is currently running, you are asked to confirm + before deleting a brick. +

      Remove Brick

      +
    3. If you wish to remove the brick permanently, click Remove + Bricks, Delete Data. +
    4. If you wish to keep the data but remove the brick, click Remove + Bricks, Keep Data. +

      The selected bricks directories will be renamed to <olddirectory>_<timestamp>. +

    5. The Remove Brick from Volume window is displayed indicating that the + volume was deleted successfully. +

      Remove Brick

      +
    6. Click OK. +
    + + + + \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/remove_server.html b/src/com.gluster.storage.management.console.help/html/tasks/remove_server.html index cf5d87a0..a2edd86a 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/remove_server.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/remove_server.html @@ -9,22 +9,22 @@ type="text/css" media="screen" /> -

    Removing Servers

    +

    Removing Servers from a Cluster

    You can remove the server, as required.

    To remove a server, perform the following steps:

    1. Choose from the menu, toolbar, or right click on the selected - Server and select Remove Server. -
    2. If the server is currently running, you are asked to confirm - before removing a server. + server and select Remove Server. +

      You can also choose multiple servers or select All from the Servers tab and select Remove Sever

      +

      You are asked to confirm before removing a server.

      Remove Server Confirmation

    3. Click Yes. The console displays the following window to indicate that the server was successfully removed.

      Remove Server -

    4. Click OK. The removed server is listed under Discovered - Server node +
    5. Click OK. The removed server is listed under Discovered + Server node
    . diff --git a/src/com.gluster.storage.management.console.help/html/tasks/select_cluster.html b/src/com.gluster.storage.management.console.help/html/tasks/select_cluster.html index d8aea996..1dbd96a4 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/select_cluster.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/select_cluster.html @@ -9,21 +9,16 @@ type="text/css" media="screen" /> -

    Select Cluster

    +

    Selecting a Cluster

    +

    The select cluster option is enabled after you create or register a cluster.

    To select a cluster, perform the following steps.
      -
    1. Open your web browser. -
    2. Type the following URL in your web browser:
    3. -

      http://server-name:webserver-port/glustermg/gluster-management-console.jnlp

      -

      Gluster Management Console login window is displayed.

      -

      Login Window -

    4. Type the user name and password in the login window and click - Login. +
    5. Launch the application and log in with a valid password.

      Select Cluster window is displayed.

      Select Cluster

    6. Select the cluster name from the Cluster Name drop down list. -
    7. Click OK.The Progress Information window is displayed. +
    8. Click OK.The Progress Information window is displayed is displayed while the console fetches the management information for the selected cluster.

      Select Cluster Progress Information

    9. The Gluster Management Console window displays the selected cluster.
    diff --git a/src/com.gluster.storage.management.console.help/html/tasks/start_vol.html b/src/com.gluster.storage.management.console.help/html/tasks/start_vol.html index 97f6789e..4b3e76d6 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/start_vol.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/start_vol.html @@ -15,13 +15,11 @@ You can start a volume or multiple volumes that are currently stopped.
    1. Choose from the menu, toolbar, or right click and select the volume and select Start Volume. -

      Alternatively, you can select the Volume node and from the right - pane select the volumes that you need to start or click All to select - all volumes. -

    2. The Create Volume window appears indicating that the volume +

      Alternatively, from the left pane you can choose the Volumes node and select the volumes that you need to start in Volumes tab or click All to select all volumes and select Start Volume. +

    3. The Start Volume window appears indicating that the volume (or volumes) were successfully started.

      Volume started Successfuly

      -

      If you have selected multiple volumes, the Start Volume window appears indicating the volumes were started successfully.

      +

      If you have selected multiple volumes, the Start Volume window appears indicating the volumes were started successfully.

      Multiple Volumes Started Successfuly

    4. Click OK.
    diff --git a/src/com.gluster.storage.management.console.help/html/tasks/stop_vol.html b/src/com.gluster.storage.management.console.help/html/tasks/stop_vol.html index 091b73e7..c97d1d91 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/stop_vol.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/stop_vol.html @@ -10,18 +10,17 @@ type="text/css" media="screen" />

    Stopping Volumes

    -You can stop volumes, as needed, while the server is online and available. For example, you might need to remove a brick that has become inaccessible in a distributed volume due to hardware or network failure.

    To stop a volume, perform the following steps:

      -
    1. Choose from the menu, toolbar, or right click to select the volume. Select Stop Volume. -

      If the volume is currently running, you are asked to confirm before stopping a volume.

      +
    2. Choose from the menu, toolbar, or right click to select the volume. Select Stop Volume. +

      You are asked to confirm before stopping a volume.

      Stop Volume

      -
    3. Select Yes to stop the Volume. -

      The Stop Volume window appears indicating that the volume was successfully stopped.

      +
    4. Click Yes to stop the Volume. +

      The Stop Volume window appears indicating that the volume was successfully stopped.

      Stop Volume

      -

      If you have selected multiple volumes, the Stop Volume window appears indicating the volumes were stopped successfully.

      +

      If you have selected multiple volumes, the Stop Volume window appears indicating the volumes were stopped successfully.

      Stop Multiple Volumes

      -
    5. Click OK. +
    6. Click OK.
    \ No newline at end of file diff --git a/src/com.gluster.storage.management.console.help/html/tasks/tune_vol_opt.html b/src/com.gluster.storage.management.console.help/html/tasks/tune_vol_opt.html index a659017d..9a48b86e 100644 --- a/src/com.gluster.storage.management.console.help/html/tasks/tune_vol_opt.html +++ b/src/com.gluster.storage.management.console.help/html/tasks/tune_vol_opt.html @@ -10,15 +10,14 @@ type="text/css" media="screen" />

    Tuning Volume Options

    -You can set volume options, as needed, while the cluster is online and -available.

    To tune volume options, perform the following steps.

      -
    1. Select the volume that you need to add Volume Options. -
    2. Click the Volume Options tab. +
    3. Select the volume for which you need to tune volume options. +
    4. Click the Volume Options tab.

      Volume Options

      -
    5. Click Add. Choose the volume options from the drop down list - and enter the Options value. +
    6. Click Add. Choose the volume option from Option Key drop down list + and type the value in the Option Value field. +

      You can edit the value of an existing option by selecting the Option Value field

    To read more about the volume options, refer to the Gluster Filesystem Administration Guide, Section 8.1 Tuning Volume Options. -- cgit