Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Managing Superdome Complexes: A Guide for HP-UX System Administrators: HP 9000 Computers > Chapter 4 Configuring and Managing Superdome Partitions

The Partition Manager—A Guided Tour

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Index

The Partition Manager provides a graphical user interface for configuring partitions (and other resources) in your Superdome complex. Patterned after a commonly used PC-based file exploration utility, the Partition Manager (also known as parmgr) is easy to learn and use.

NOTE: The Partition Manager is equipped with an extensive help system that describes the rich set of navigational tools more extensively than what is covered here. This section is intended to help you start-up the Partition Manager, and show you the basic areas that Partition Manager covers.

Advantages of Using The Partition Manager

There are a variety of tools that can be used to configure the partitions in a Superdome complex, each having its own advantages over the others. Which tool is best to use for a given task depends on how comfortable you are with using the tool, and the specific task you are trying to do. The Partition Manager has the following advantages over the other tools:

  • It is a graphical user interface that can be run from any X-Terminal or from a Web browser

  • It has a built-in set of problem detectors to help you quickly figure out the source of a problem in your complex.

  • It has a robust set of error checks to help prevent you from creating illegal configurations or performing steps of a task in the wrong order.

  • It prevents you from having to learn or remember many different HP-UX commands and their options.

  • It is organized around the very objects that you will be configuring:

    • Cells

    • I/O Chassis

    • Partitions

    • Available (not yet configured) Resources

How to Start The Partition Manager

Though it can be used to configure all of the partitions in a Superdome complex (except the Genesis Partition), the Partition Manager must run in (or via) an existing partition in the complex that you are configuring.

NOTE: The Partition Manager will run in a Genesis Partition, so even if the Genesis Partition is the only active partition in the complex, you can still use parmgr to define the other partitions that you need.

You can also run the Partition Manager via a supported Web browser from a Microsoft Windows-based PC that has access to the Superdome complex, but you must be connected to a partition running HP-UX and the Apache web server. Only the graphical interface runs in the Web browser; the Partition Manager itself runs under HP-UX in the Superdome partition.

Starting Partition Manager from the HP-UX Command Line

You can run the Partition Manager directly from an HP-UX command-line prompt. Its path is:

/opt/parmgr/bin/parmgr

IMPORTANT: Partition Manager does not have a text mode interface. You need to set your shell's “DISPLAY” environment variable so that Partition Manager can display its windows on an X-Server based display. Also be sure that the user running Partition Manager has permission to write to the display represented by the value of the DISPLAY environment variable (see xhost(1)).
TIP: If you are running parmgr from the command line, you can specify a task and parameters associated with that task to start parmgr at a specific point and perform only that task. For information on what tasks you can do this with (and the parameters that those tasks require), see parmgr(1M).

Starting Partition Manager from SAM

From SAM: If you are running SAM, the Partition Manager is one of the selections available from the primary level of SAM's interface

Starting Partition Manager From a Web Browser

From an HP-UX environment, the preferred method of running Partition Manager is from the HP-UX command line as described in the previous section. It is also possible to run Partition Manager from a web browser if you are working from a Microsoft Windows-based PC.

Requirements

To use this feature, a web server must be installed and configured on the partition where you will run Partition Manager. The Apache web server will be automatically installed and configured when the ObAM Runtime Environment bundle (required by Partition Manager) is installed. This is currently the only web server supported by the ObAM Runtime Environment. Though already installed, the web server must be activated before it can be used. See “Configuring the Web Server” for more information.

Because of dependencies on the Java runtime Environment and the Java Plug-in, running Partition Manager from a web browser is currently supported only in the following client environments:

Table 4-4 Supported Client-side Environments

Operating System

  • Windows® 95, or

  • Windows® 98, or

  • Windows® NT 4.0 with Service Pack 3 or later

Browser

  • Netscape Navigator® version 4.5 or later, or

  • Internet Explorer version 4.01 or later

Java™ Plug-in

JPI 1.1.3 only

Java™ Runtime Environment

JRE 1.1.8 only

 

Both the Java Plug-in and the Java Runtime Environment are included with the ObAM Runtime Environment bundle. When the web server is first activated, point your browser to the following URL to view instructions on installing and configuring the Java Plug-in and the Java Runtime Environment:

http://hostname:1188/jpi/pc-compatible-only.html

where hostname is the network hostname of the partition that will run Partition Manager.

By default, only systems from the same network domain may access the web server running on a partition. See “Configuring the Web Server” for information on changing this setting.

Launching Partition Manager in the Web Browser

Once the Java Plug-in and Java Runtime Environment are properly installed, Partition Manager can be started by pointing a supported web browser at the URL:

http://hostname:1188/parmgr

where hostname is the network hostname of the partition that will run Partition Manager.

A welcome page containing the following links will be displayed:

  • Run Partition Manager

  • Configure Browser

    This step must be performed before Partition Manager can be started from a web browser.

  • Technical References

    A link into the Partition Manager online help system.

Clicking on the Run Partition Manager link will display the Partition Manager launch page in a new browser window.

IMPORTANT: The launch page must remain open or Partition Manager will immediately terminate. The launch page hides the browser window tool bar and menu bar, so that you cannot accidentally navigate out of Partition Manager in this window. Navigating forward or backward from your original browser window will not affect Partition Manager.

Before Partition Manager is launched, a login dialog will appear, prompting for a user name and password. Only the superuser is allowed to run Partition Manager.

Once the user is authorized, Partition Manager will be launched in a window outside the browser. Additional dialogs for the tasks performed by Partition Manager will be displayed in new windows (just as though you were running the program locally). When you request online help, another browser window (with full browser navigation) will be activated to display the help topic.

When you are finished using Partition Manager, you must close the launch page after exiting Partition Manager.

Configuring the Web Server

The Apache web server will be automatically installed and configured when the ObAM Runtime Environment bundle (required by Partition Manager) is installed. Apache is currently the only web server supported by the ObAM Runtime Environment. This server can be used to host any ObAM-based application.

By default, only systems from the same network domain can access Partition Manager from the web server. For example, if the server is running on a partition whose network address is server.site1.ourco.com, then only systems in the site1.ourco.com domain will be able to launch Partition Manager on this server. This access is controlled by the file /usr/obam/server/conf/httpd.conf.

There are two entries in the file of the form:


Allow from ...
Allow from ...

If Partition Manager was installed during a cold install of HP-UX, these fields will contain the string insert_domain_here, since the network domain was not available at the time that the configuration script was run. In this case, edit this file and replace those strings with the actual domain name (for example: site1.ourco.com). If you do not do this, no one will have permission to access Partition Manager via the web. Additional modifications can be made to these fields to grant other systems and domains access to the server.

The web server must be activated before it can be used. To activate the web server, as the superuser run the following HP-UX command:

/usr/obam/server/bin/apachectl start

If you modify the configuration file after the web server has already been started, you must restart it by executing the following HP-UX command before the new configuration will be recognized:

/usr/obam/server/bin/apachectl restart

TIP: If you want to start the web server automatically every time the partition is booted, the WEBADMIN variable should be set to 1 in the system configuration file /etc/rc.config.d/webadmin (the default value for this variable is 0.

Log files containing startup, authentication and configuration problems are stored in the directory /usr/obam/server/logs.

Troubleshooting Web Browser Access to Partition Manager

Because several components are involved in web browser access to Partition Manager, a number of things could cause problems:

Problem:

When attempting to access the URL (http://hostname:1188/parmgr), the following error message is displayed:

The requested URL could not be retrieved. Connection Failed.

What to do:

Make sure that the web server daemon (httpd) is running. It can be started by executing the following command (as the root user) on the partition where you are attempting to run Partition Manager:

/usr/obam/server/bin/apachectl start

Problem:

A Permission Denied message is displayed when browsing to the welcome page.

What to do:

Check the network domain/access settings in the Apache web server configuration file.

The Apache server maintains an error log in the file /usr/obam/server/logs/error_log. This log can be consulted to help diagnose problems with web access to Partition Manager. If the log consumes too much disk space, delete (or move) it and restart the Apache web server using the command:

/usr/obam/server/bin/apachectl restart

Problem:

On the client side, the Java console is enabled, but is not being displayed when Partition Manager is started.

What to do:

Try shutting down the browser and restarting it.

Problem:

If Partition Manager abnormally terminates after being launched from the browser, the Java Virtual Machine on the PC might be left in a corrupted state. Subsequent attempts to launch Partition Manager from the browser might produce abnormal behavior such as:

  • Partition Manager appears to be stuck in a waiting state indefinitely

  • Additional instances of Partition Manager start up spontaneously

What to do:

Terminate the browser, restart it, and attempt to launch Partition Manager again. If the problem persists, reboot your PC and try again.

Navigating through The Partition Manager

Superdome computers and the Partition Manager are designed around an object hierarchy. The root of the hierarchy is the complex. It contains objects (representing both physical and logical entities) in various levels below the complex: these include partitions, cells, I/O chassis, PCI I/O cards, processors, and memory modules. The hierarchy is shown in Figure 4-3 “Partition Manager Object Hierarchy”.

Figure 4-3 Partition Manager Object Hierarchy

Partition Manager Object Hierarchy

Partition Manager Views

The Partition Manager allows you to view a Superdome complex at various levels of detail. At all levels the primary display window is displayed in two panes:

Object List

The left-hand-side of the display shows the hierarchical list of objects in the complex. Various levels of the list can be expanded or compressed using the + and - icons in the list's display.

Object Summary

The right-hand-side of the display shows basic information about the object currently highlighted in the object list.

In addition to the two display areas there are several other display elements common to all Partition Manager levels:

Menu Bar

Across the top of the display is a menu bar that you can use to customize the display and that provides a pull-down menu of actions that can be performed from the current screen. The specific items on the menu bar and what they represent are described in the Partition Manager's help system.

Tool Bar

Underneath the menu bar is a tool bar that allows you to change view types and levels, and bring up the help system.

Context Menu

The context menu provides a shortcut to all of the items on the menu bar that apply to the current context. To bring up the context menu, press the right mouse button while the mouse pointer is in the Object Summary pane (right-hand-side of the display).

The items available in the context menu depend on which, if any, object is currently selected in the Object Summary pane. If no object is selected, then the context menu will show the actions that are always available for the current screen. If an object is selected, then the context menu will show these actions, as well as actions specific to the selected object.

Viewing Complex-Level Information

When started with no parameters (or from a Web browser), the Partition Manager will initially show the state of a Superdome computer at the complex level. Both the left and right sides of the display will show a list of the partitions currently defined in the complex and a special “partition” called Available Resources. Available Resources is a container used to hold and display the resources in the complex that are not part of any other partition.

Complex Details. In addition to the list of partitions defined in the complex, a lot of detailed information about the resources of the complex is available. To view this information, use the context menu, or the Complex drop-down menu in the menu bar to select Show Complex Details .... This will bring up a new window containing six panels of information about various elements of the complex.

Click on the tab for each panel to familiarize yourself with what information is available in each area. Partition Manager's help system describes in detail what is available under each tab.

Viewing Partition Information

If you want information about the resources of a specific partition, first select the partition by clicking on its name in the object list on the left-hand-side of the display. The right-hand-side of the display will update to show a summary of the resources for the selected partition.

Partition Details. By default Partition Manager will list which cells and I/O chassis are part of the selected partition. In addition to this list, a lot of detailed information about the resources for the selected partition is available. To view this information, use the context menu, or the “Partition” drop-down menu in the menu bar to select “Show Partition Details ...”. This will bring up a new window containing four panels of information about various elements of the complex.

Viewing Cell Information

Partitions are logical collections of cell boards. Cell boards contain (among other things), the processors and memory modules of the complex. The Partition Manager lets you query cell boards to determine how many processors and how much memory they contain, and the status of those items.

Cell Details. Unlike the higher levels of the object hierarchy, there is no summary level for cells. If you click on the name of a partition in the object list on the left portion of Partition Manager's primary display area (to bring up the list of cells and chassis that comprise that partition), then on the right-hand-side of the display double-click on the entry for the cell that you want to know about, the Cell Details window will be displayed.

The Cell Details window has two panels of information:

General

The General panel shows the current status and usage settings of the cell itself, and if an I/O chassis is connected to the cell, you can click on the “Show Details ...” button to get information about that chassis.

CPUs / Memory

The CPUs / Memory panel provides a list of processors, and memory modules along with their type and status.

Viewing I/O Chassis Information

At least one of the cell boards in every partition must have an I/O chassis connected to it (more than one can). The I/O chassis holds the I/O cards that connect devices such as network cards and disk drives to the complex.

At least one of the I/O chassis associated with a partition must contain a core I/O board allowing devices in that chassis to be used to boot the system.

I/O Details. After selecting a partition from the object list on the left-hand-side of the Partition Manager's primary display window, single-click on the entry for the I/O chassis (on the right-hand-side of the display) that you want to query. Then select Show I/O Details... from the I/O menu to bring up the I/O Details window containing information about the selected I/O chassis.

The I/O Details window has three panels of information:

I/O Cards

The I/O Cards panel displays information about the cards in the I/O chassis, the hardware paths to those cards, the drivers used by those cards, and whether or not the slot that the cards are plugged into have power.

Storage

The Storage panel contains a list of mass storage devices attached to the I/O cards associated with the cell, partition, cabinet, or complex you have selected.

Notes

The Notes panel contains a list of errors, warnings, and notes about the information available on the I/O Cards and Storage tabs. For example, if I/O information is not available for a particular cell, a message will be displayed in the notes panel.

The entries in the I/O Details window can be filtered to show a sub-set of all available information. This allows you to focus on specific cards or entries. Details on what each of the above panels show and how to filter the output are available in the Partition Manager help system.

Task Wizards

The Partition Manager is equipped with several task wizards to guide you through tasks that have many steps (for example creating a new partition). These behave in a similar way to many PC software setup routines.

Several of these wizards can be launched directly by specifying the appropriate parameters when starting the Partition Manager from an HP-UX command-line prompt. For details on these parameters, see parmgr(1M).

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2000 Hewlett-Packard Development Company, L.P.