Configuring nodes > Configuring the Node Management table buttons

5.1 Configuring the Node Management table buttons

The above-table controls perform actions based on items like the currently selected table records. The above-table buttons are configured in the <controls> child element of <node-management>. Supported elements are listed below. Note that some buttons are only valid for a particular record type (node or VM). Buttons disable themselves when their surrounding context is invalid such as if the button requires a selected record but no table record is selected, or if the type of the selected record doesn't apply to the button.

To configure a button's icon, label, or tooltip

  1. Open the nodes.xml file located in your Viewpoint home directory. Locate the <controls> element within <node-management>.
  2. Several above-table buttons have already been configured. The buttons you may configure are:

    Button Description
    <power-off> Powers off selected nodes
    <power-on> Powers on selected nodes
    <refresh> Refreshes the table and any open details panel
    <reprovision> Reprovisions all selected nodes
    <show-pending-actions> Redirects to the pending actions page for the currently-selected node
    <modify-host-reservations> Displays a popup listing all host-based reservations that include the selected node in their host expression. Users can then remove reservations from the node by either shrinking them or by deleting them if they exist only on the selected node.
    <remove-admin-reservations> Removes all host-based user reservations from the selected nodes. If these reservations would then become empty, they are deleted instead.

    You may also insert any other desired buttons that area not already configured.

  3. Customize the buttons by doing the following:
    1. Use the image-url attribute to specify the path to an icon that will be used to display the button.
    2. Use the label attribute to change the button's display text. If an image has been specified, this text will appear to its right side.
    3. Use the tooltip attribute to display a short explanation of what the button does when the cursor hovers over it.
    4. You may set a permission for each button with the <permissions> child element (for details, see Setting permissions).
    5. It might contain a sequence of <permission> elements that specify a Viewpoint permission a user needs in order to see and use the button. For example:
    6. <power-off>
          <permissions>
              <permission name="node.update" />
          </permissions>
      </power-off>

      In this example, a user can use the power-off button only if she/he has the node.update permissions.

Related topics