PreviousNextIndex

Chapter 2: Administering a Cluster Using WebSMIT


HACMP includes a Web-enabled user interface (WebSMIT) that provides consolidated access to:

  • HACMP SMIT configuration and management functions
  • Interactive cluster status display
  • HACMP online documentation
  • Graphical displays of cluster topology and resource group dependencies.
  • User Authentication settings (optional)—administrators can specify a group of users that have read-only access. Those users have permissions to view configuration and status, and navigate through SMIT panels, but cannot execute commands or make changes.
  • Support for Mozilla-based browsers (Mozilla 1.7.3 for AIX and FireFox 1.0.6) in addition to Internet Explorer versions 6.0 and higher.
  • The WebSMIT interface includes an interface similar to the ASCII SMIT interface in addition to other information. Because WebSMIT runs in a Web browser, you can access it from any platform.

    To use the WebSMIT interface, you must configure and run a Web server process on the cluster node(s) to be administered. See the /usr/es/sbin/cluster/wsm/README file for information on setting up WebSMIT to work with your web server, the default security mechanisms in place when installing HACMP 5.2 and up, and the configuration files available for customization. For more information about configuring WebSMIT, see the section Installing and Configuring WebSMIT in the Installation Guide.

    The following sections describe WebSMIT’s functionality:

  • Working with WebSMIT
  • Configuring HACMP Using WebSMIT
  • Viewing the Cluster Components
  • Viewing Cluster Configuration Information in WebSMIT
  • Viewing HACMP Documentation in WebSMIT.
  • Working with WebSMIT

    Here is the WebSMIT main display page:

    WebSMIT Display 
    

    .

    The WebSMIT display is divided into the following frames, which are described in detail in the following sections:

  • Header Frame
  • Navigation Frame
  • Activity Frame
  • Header Frame

    The top frame displays the name of the cluster and provides a logout link.

    Navigation Frame

    The left frame displays three tabbed views from which you can navigate your cluster, as well as configuration menus. These navigation tabs display items in an expandable, hierarchical view. Selecting an item updates the content displayed in the Activity frame to reflect the current selection. Open and contract the tree as needed to show or hide the sub-components by clicking on the + or - symbol or by using the Expand/Collapse All button. In the previous figure, the WebSMIT Display shows the Navigation frame with the Nodes and Networks tab selected.

    You may select the following tabs from the Navigation frame:

  • SMIT tab. Provides hierarchical navigation of the SMIT menus to configure and manage your cluster. Clicking on a menu item from the SMIT tab, displays the corresponding SMIT panel in the Activity frame on the Configuration tab.
  • N&N (Nodes and Networks) tab. Contains an expandable hierarchical view based on the cluster topology (either site- or node-centric depending on the cluster definition).
  • The icons to the left of the hierarchical menu items indicates the state of the site, node, or network.
    Clicking on the N&N tab updates the tabs available in the Activity frame.
  • RGs (Resource Groups) tab. Provides an expandable hierarchical view, based on the cluster resources. The icons to the left of the hierarchical menu items indicate the state of the corresponding cluster resource.
  • If a branch of a cluster hierarchy has a flashing status indicator, one of its nested objects has a problem. For example, if a node is in the error state, the site that contains it has a flashing status indicator, and the cluster that contains it likewise has a flashing indicator. By expanding the flashing branches of the cluster hierarchy, you can find where the problem is.

    Activity Frame

    The pane on the right side displays information corresponding to the items selected in the Navigation frame. You may select the following tabs from the Activity frame:

  • Configuration tab. Displays items selected in the SMIT tab of the Navigation frame.
  • Details tab. Displays cluster components selected in the N&N tab or the RGs tab. To view updated configuration information, click the Refresh button, located on the upper left of the page, after making changes to the cluster.
  • Associations tab. View a graphical display of objects related to the item selected from the N&N tab or the RGs tab in the Navigation frame.
  • Docs tab. View the HACMP for AIX 5L documentation bookshelf page for access to the HACMP documentation installed on your system. This tab also provides a link to the online HACMP for AIX 5L documentation.
  • Tooltip Help is available where indicated by a light gray question mark, slightly smaller than the surrounding text: move your mouse over the tooltip indicator to view the help text about possible actions you may take.

    Holding your mouse over the help status indicator changes the cursor to the help cursor. To display help on the possible action(s) you may take, right-click on the item

    Configuring HACMP Using WebSMIT

    Clicking on the SMIT tab from the Navigation frame displays the expandable SMIT menus used to configure and manage your cluster. Clicking on a SMIT menu item, displays the corresponding SMIT panel in the Activity frame on the Configuration tab.

    A fastpath text box is located at the bottom of the display area. You may enter another SMIT panel fastpath in this text box to display that SMIT panel.

    WebSMIT: SMIT Tab and HACMP Configuration Tab 
    

    Common WebSMIT Panel Options

    The common WebSMIT panel options are mapped as follows:

    Key or Command
    Action
    F1 help
    Displays context help for the current screen. For menus, a popup menu (Tell me more) displays the help text in a separate window.
    F3 cancel
    This is mapped to the browser Back function.
    F4 list
    Pressing F4 or selecting the List button next to an item creates a popup selection list.
    F5 reset
    This is a built-in function of the browser.
    F6 show command
    Displays the command that was created from the input provided.
    F7 edit
    This function key is not mapped.
    F8 image
    This function key is not mapped. There are several built-in functions of the browser that provide these functions.
    F9 shell
    This function key is not mapped.
    F10 exit
    This function key is not mapped.
    Enter = do
    Runs the command by pressing ENTER.
    / = Find
    n = Find Next>
    These keys are not mapped. The browser has built-in search capability.
    Fast Paths>
    At the bottom of each panel is a text entry where you can enter an HACMP SMIT fast path. The current panel ID is displayed.

    Browser Controls

    Pressing the browser stop button stops the current page from loading; it does not stop any commands that are being run on the server.

    Pressing the browser reload button reloads the current page.

    Functional Limitations

    SMIT panels that use interactive input, such as entering a password or “Mount volume 2 on cd0 and press ENTER to continue,” are not supported. WebSMIT displays a default page when you attempt to access these pages directly.

    WebSMIT Logs

    All operations of the WebSMIT interface are logged to the wsm_smit.log file and are equivalent to the logging done with smitty -v. Script commands are also captured in the wsm_smit.script log file. All logs go to /usr/es/sbin/cluster/wsm/logs. The WebSMIT logs are not subject to manipulation (redirect, backup) by HACMP logs. Just like smit.log and smit.script, the files grow indefinitely.

    The snap -e utility captures the WebSMIT log files only in the default location (/usr/es/sbin/cluster/wsm/logs).

    Configuring and Managing Nodes and Networks in WebSMIT

    The N&N (Nodes and Networks) tab contains an expandable hierarchical view based on the cluster topology, and the status of the cluster sites, nodes, and resource groups. The cluster object displays first, followed by the next item in the hierarchy: Sites if one or more sites exist, or Nodes otherwise. WebSMIT displays the N&N tab by default upon login and updates the contents automatically.

    Note: The tree is not a representation of “configuration” but of state. Therefore, if the cluster is down, the hierarchy will not be shown

    To view configuration information of an item selected in the N&N tab, select the Details tab from the Activity frame on the right.

    To view a site or node-centric graphical display of the cluster components, select the Associations tab from the Activity frame.

    The following figure shows the N&N tab displayed in the Navigation frame and the Details Tab displayed in the Activity frame.

    WebSMIT: Nodes and Networks View tab and Details tab 
    

    WebSMIT Nodes and Networks Status Indicators

    Status icons adjacent to the items in the hierarchy on the N&N tab indicate the status of each item, according to the icon’s color and shape. A flashing icon indicates that a sub-item is in an ERROR state.

    Note: You must have cluster services running on at least one node for the hierarchy to display.

    The table below shows the status indicator description for each N&N tab object.

    Object
    Circle - Green
    Square - Red
    Caution Sign- Yellow
    Diamond- Blue
    Cluster
    All cluster
    resources are up.
    • All cluster resources are down.
    • Cluster Manager has stopped.
    Error
    N/A
    Site
    All nodes in the site are up.
    All nodes in the site are down.
    Error
    N/A
    Nodes
    All nodes in the cluster or site |are up.
    All nodes in the cluster or site are down.
    Error
    All composite’s children do not have the same state.
    Node
    All networks and resource groups are up.
    All networks and resource groups are down.
    Error
    Node is in an intermediate state, like JOINING or LEAVING.
    Network
    All interfaces
    are up.
    All interfaces
    are down.
    Error
    N/A
    Resource Group online on home node only or first available
    Resource group is online and on home node.
    Resource group
    is down.
    Error if the resource group is in the ERROR state
    Resource group is in an intermediate state, such as, ACQUIRING.
    Resource Group online on all available nodes
    Resource group is online on all nodes in the resource group.
    Resource group is offline on all nodes in the resource group.
    Resource group is in the ERROR state on all nodes.
     

    WebSMIT N&N Tab Right-Click SMIT Options

    Right-click on a menu item to display a list of SMIT entries. Selecting a SMIT menu displays the appropriate SMIT panel in the Activity frame on the Configuration tab as shown below:

    Menu Item
    SMIT Entries
    Cluster
    Add/Change/Show an HACMP Cluster
    Remove an HACMP Cluster
    Add a Site
    Add Nodes to an HACMP Cluster
    Manage HACMP Services
    Discover HACMP-related Information from Configured Nodes
    Verify and Synchronize HACMP Configuration
    Site
    Add a Site
    Change/Show a Site
    Remove a Site
    Nodes
    Add a Node to the HACMP Cluster
    Remove a Node in the HACMP Cluster
    Node
    Add a Node to the HACMP Cluster
    Change/Show a Node in the HACMP Cluster
    Remove a Node in the HACMP Cluster
    Network
    Add a Network to the HACMP Cluster
    Change/Show a Network in the HACMP Cluster
    Remove a Network from the HACMP Cluster
    Add Communication Interfaces/Devices
    Resource Group
    Add a Resource Group
    Change/Show a Resource Group
    Change/Show Resources and Attributes for a Resource Group
    Remove a Resource Group
    Bring on/off-line

    Configuring and Managing Resources in WebSMIT

    The RGs (Resource Groups) tab contains an expandable hierarchical menu based on the cluster resource groups, and the status of the cluster resource components. The content of this tab updates automatically as changes occur in the cluster.

    Selecting a menu item from the RGs tab displays its configuration information under the Details tab in the Activity frame.

    To view a resource group-centric graphical display of the cluster components hierarchy, select the Associations tab from the right pane.

    The following figure shows the RGs tab displayed in the Navigation frame and the Details Tab displayed in the Activity frame.

    WebSMIT: RGs View tab and Details tab 
    

    WebSMIT RGs Tab Status Indicators

    The status icons displayed on the RGs View tab indicate the state of the top-level cluster object. The status icons also display adjacent to the items in the tree to indicate the status of the each item. These status indicators give you the state of the cluster object.

    Note: You must have cluster services running on at least one node for status icons to display.

    The color and shape icon to the left of the text of each item indicates its status. The following table shows the status indicator description for each RGs tab objects.

    Object
    Circle - Green
    Square - Red
    Caution Sign- Yellow
    Diamond- Blue
    Cluster
    All cluster are resources up.
    • All cluster resources are down.
    or
    • Cluster Manager is stopped.
    Error
    N/A
    Node Location
    Resource group is ONLINE
    on node.
    Resource group is in ERROR state on node.
    Error
    N/A
    Non-concurrent Resource Group
    ONLINE on a participating node.
    Resource group is DOWN.
    Resource group is in the ERROR state.
    Resource group is in an intermediate state, like ACQUIRING.
    Concurrent Resource Group
    ONLINE on all nodes in the resource group.
    DOWN state on all participating nodes.
    ERROR on all participating nodes
    Resource group is not in the same state on all participating nodes (for example, UP on some, DOWN or ERROR on others).
    Service IP Label
    Service IP label is up on
    boot interface.
    Service IP label is down.
    N/A
    N/A
    Application Server
    Started
    Stopped
    N/A
    N/A

    Note: In WebSMIT, you cannot run the cluster verification process in an interactive mode.

    WebSMIT RGs Tab Right-Click SMIT Options

    Right-click on a menu item to display a list of SMIT entries that, when selected, will display the appropriate SMIT panel in the Activity frame on the Configuration tab as shown below:

    Menu Item
    SMIT Entries
    Cluster
    Add/Change/Show an HACMP Cluster
    Remove an HACMP Cluster
    Add a Site
    Add Nodes to an HACMP Cluster
    Manage HACMP Services
    Discover HACMP-related Information from Configured Nodes
    Verify and Synchronize HACMP Configuration
    Site
    Add a Site
    Change/Show a Site
    Remove a Site
    Nodes
    Add a Node to the HACMP Cluster
    Remove a Node in the HACMP Cluster
    Node
    Add a Node to the HACMP Cluster
    Change/Show a Node in the HACMP Cluster
    Remove a Node in the HACMP Cluster
    Network
    Add a Network to the HACMP Cluster
    Change/Show a Network in the HACMP Cluster
    Remove a Network from the HACMP Cluster
    Add Communication Interfaces/Devices
    Resource Group
    Add a Resource Group
    Change/Show a Resource Group
    Change/Show Resources and Attributes for a Resource Group
    Remove a Resource Group
    Bring on/off-line

    Note: In WebSMIT, you cannot run the cluster verification process in an interactive mode.

    Viewing the Cluster Components

    From the Activity frame, click the Associations tab to view a graphical display of the cluster components hierarchy corresponding to the item selected in the Navigation frame: the N&N tab or the RGs tab. WebSMIT continuously updates the Navigation frame status icons to indicate state of the current cluster components.

    Both the N&N view and the RGs view show the cluster components in a hierarchical manner. The difference between the two views is:

  • The N&N view displays site- or node-centric associations related to the item selected in the navigation frame.
  • The RGs view displays a resource-group-centric summary of where each resource group is online and any resource group dependencies.
  • When reviewing the N&N associations, if the graph becomes too complicated, you can remove the Application Servers, Storage, and the Networks from this view by de-selecting the check boxes at the bottom of the page. Similarly, when reviewing the RGs associations, if the graph becomes too complicated you can remove the Parent/Child, Online on Different Nodes, Online on Same Nodes, and Online on Same Site from the view by de-selecting the check boxes.

    The following figures show examples of the associations displays:

    WebSMIT: Resource Group Summary, Associations View  
     



    WebSMIT: Sites, Nodes and Networks Details, Associations View

    Viewing Cluster Configuration Information in WebSMIT

    The Details tab provides configuration information about the item selected in the Navigation frame. The following table shows the command used to retrieve the information, and the information displayed under the Details tab for each cluster component.

    Component
    Command
    Details
    Cluster
    cltopinfo
    Lists the cluster topology information.
    Nodes
    cltopinfo
    Lists all node topology information.
    Node
    cltopinfo -n
    Shows the configuration for the specified node and displays the status of the HACMP subsystems.
    Network
    cltopinfo -w
    Shows all the networks configured in the cluster.
    Resource Groups
    clshowres
    Shows the resources defined for all groups.
    Resource Group
    clshowres -g
    Shows the resources defined to the selected group.
    Volume Group
    lsvg <volume group name>
    Shows the status of the volume group.
    Service IP
    cl_harvestIP_scripts -u <name>
    Lists the Service IP information.
    Boot IP
    cltopinfo –i <name>
    Shows all interfaces configured in the cluster.
    Application Server
    cllsserv -n <name>
    Lists application servers by name.

    For more information on these commands, see the man page or the description in Appendix C: HACMP for AIX Commands.

    The Details tab contains static information about the component selected in the left pane. This information is not automatically updated as changes are made to the cluster. To view updated information, click the item again.

    The following example shows the detail information shown for a specific resource group:

    WebSMIT Resource Group Details Page 
    

    Viewing HACMP Documentation in WebSMIT

    Through WebSMIT, you can access the HACMP documentation installed on your system. To view the WebSMIT bookshelf page, click the Docs tab in the Activity frame. The bookshelf page contains links to installed documentation only; WebSMIT notifies you of any documentation that is not installed.

    WebSMIT Bookshelf Page 
    


    PreviousNextIndex