0.0: Using the InfoCenter to view WebSphere Application Server documentation

The IBM WebSphere Application Server InfoCenter provides central navigation and search of the entire product documentation set.

Though you will probably find it easy enough to learn about the InfoCenter simply by using it, this article describes how to get the most from the WebSphere Application Server part of the WebSphere InfoCenter. See also Using the WebSphere InfoCenter.

Select a goal:

I want to tour the navigation features of a typical article

Here is a description of the navigational features of a typical article (document) in the InfoCenter. Click here to display a typical article in a separate browser window so that you can view its features in the context of this discussion.

The ancestor list at the top of an article provides links to the ancestors of the article that you are viewing.

Ancestor list

The "ancestors" reveal how this article fits into the overall InfoCenter, from the highest level (InfoCenter Home) downward. Typically, you will see a progression of the articles from general (InfoCenter Home) to more specific (the current article in which you are viewing the ancestor list). Use the links on the ancestors to quickly climb to higher, more general levels of the documentation set.

Note, the ancestor list does not show the "peer" or "sub" topics of the current article. Links to articles clustered beside and below the current article (envisioning the arrangement of the InfoCenter articles as a tree with InfoCenter Home as the root) are included in the Related topics area.

The Related topics area of an article contains links to other articles in the InfoCenter, or sometimes to documents outside of the InfoCenter (on the Internet).

Related topics heading

The first link under "Related topics" is the InfoCenter Home, meaning the Getting started page where you can find information for -- well, getting started!

The additional links under "Related topics" are categorized as such:

The links and headings in the "Related topics" area are subject to change, again based on feedback about what users find helpful.

The Back and Forward buttons provide a way to navigate the articles as though you are flipping through the pages of a book.

Back and Forward buttons

The Forward sequence mimics the organization of a book that uses index numbers to indicate its sections and subsections. A sample Forward sequence of article numbers (that does not necessarily reflect the articles currently available in the InfoCenter) is:

1 -> 1.1 -> 1.2 -> 1.3 -> 1.3.1 -> 1.4 -> 2 -> 2.2 ->
2.2.1 -> 2.2.2 -> 2.2.2.1 -> 2.2.2.2 -> 3 -> InfoCenter Home
where -> represents a click of the Forward button. (The last article in the sequence returns to InfoCenter Home). The Back sequence is simply a reversal of the Forward sequence.

Note, article numbering does contain gaps in places, as illustrated above by the gap between 2 and 2.2. Articles are organized according to an "ideal" tree structure established across product releases and editions, meaning articles are omitted from the tree when they do not apply to a particular release or edition. You might click Forward from article 6.6.3 and go to 6.6.5 instead of 6.6.4. Article numbers are provided mainly to help you uniquely identify an article, while providing a rough sense of its context. See the discussion of article numbers for more information.

Also note that the Back and Next buttons are hard-coded, not dynamic. If you use a route other than the sequence of article numbers to arrive at an article, that article's Back button will not lead you through the path that you just took. It will set you on the path of visiting the articles according to their fixed numerical sequence.

The sequence visited by the Back and Forward buttons is not all-inclusive, though all of the numbered articles are included, with the exception of conceptual ("What are concept?") topics numbered 00*. Certain topics are omitted because they do not lend themselves to a sequential, one-by-one viewing, such as the set of HTML articles that are grouped into various case-specific installation documents.

Send your feedback and suggestions for the contents of Related topics and other navigational features!

I want to find all of the available information

Key product Web sites are documented in the README file.

The following table summarizes the location of the product documentation.

What is it? Where can you find it? How current is it?
README and Getting Started book Product CD root, and in InfoCenter Current. Rarely needs an update
"Starter" InfoCenter Installed with the product.

Several topics are omitted, but link to reminders to download the "full" InfoCenter. If you do not see the reminders, then the full InfoCenter is already installed.

Not that current
InfoCenter download ("full InfoCenter")

Includes "Getting started" view

Download it from Application Server InfoCenter page

Install it locally to overwrite and add to your back-level, existing InfoCenter

Very current
"Full" InfoCenter
online version
Browse it from the Application Server InfoCenter page Could be slightly more current than the corresponding InfoCenter download, but typically matches

I want to update the information installed with the product

If you installed the InfoCenter from the product CD (or as part of the product download), or if you have not updated the original version in a while, it is highly recommended that you download the latest InfoCenter to replace your existing files.

The InfoCenter installation instructions are posted on the Web page from which you can download the InfoCenter updates:

Application Server InfoCenter page

I want a summary of what has changed when I update my InfoCenter

For a summary of the changes to each InfoCenter version, see the online revision history, also available in the online InfoCenter on the InfoCenter Web page cited above.

A local copy is installed with your InfoCenter, but could be somewhat back-level, to the extent that your locally installed InfoCenter is back-level.

I want to print the InfoCenter content and take it with me

To print the InfoCenter, use the following options.

I am going to be working offline a lot, but need access to information

As discussed earlier, the latest InfoCenter is available for online viewing from the IBM Web site. But what if your machine is not connected to the Internet, or even an intranet?

If you are going to be offline for a while, or will be using a very slow connection, you can view a locally installed InfoCenter to avoid needing network access. Before you disconnect, download the latest InfoCenter from the WebSphere Application Server Web site and install it.

The locally installed InfoCenter is quite self-contained, providing access to documentation, help files, and the product Javadoc without requiring network connectivity. You need only a Web browser and an optional Adobe Acrobat Viewer for accessing PDF files.

Nearly everything is available in one place, although you will need a connection to view the online prerequisites information and some Web sites referenced in the documentation, usually as supplemental information.

An additional option is to print the needed information and take it with you, as described in the previous section.

I want to find my way around quickly

To find information quickly, use the following features.

Use the Getting started page to find information to jump-start your use of the product
The getting started page introduces you to the product, providing links to the information you need to install, start, and try out the product
Consult the Getting Started book for a customized path
The Getting Started book suggests optimal paths through the InfoCenter for users with various roles, such as evaluator, administrator, and developer.

The book suggests a combination of reading and product use for each role, directing users to the most relevant activities for their purposes.

Perform a search
(For details, click "Perform a search.")
Use the master table of contents to find any topic in one click of your mouse
You can reach nearly any HTML file in the documentation set by clicking its entry in the master table of contents.

The master table of contents lists the available HTML files in the product documentation, with the exception of the installation documents, which are combined into handy PDF versions. Only a couple of documents are available in PDF only (see next entry).

A key use of the master table of contents is to ensure that you have performed an exhaustive search for information. If you cannot find a topic on the master table of contents, it is highly probable that the information is not in the InfoCenter, unless it is described with different terminology than you are using.

Consider right-clicking the browser frame containing the master table of contents, then using your browser Find or Search option to locate keywords or article numbers that you jotted down earlier.

PDF view
The PDF view shows the available PDF files. Nearly all of the PDF files are also available in HTML. The exceptions are noted. Each PDF file consolidates the HTML version of the information for easy printing.

The PDF files vary in quality from no-frills "print solutions" for printing many related HTML files easily, to complete IBM softcopy books.

I want to keep track of what I am reading, and have already read

Most InfoCenter articles have a unique identifying number (ID). Here is some information for understanding and utilizing the numbering scheme:

I need operating system and prerequisites information

View article 1.3 for a link to the prerequisites Web site.

The Web site is the ultimate source of accurate supporting software information for current product releases. Because the site provides centralized access to detailed prerequisite information, the InfoCenter documentation is written in a more general way with respect to citing specific prerequisite brands and versions.

Troubleshooting the InfoCenter and GUI help systems

The following problems and workarounds apply to the InfoCenter and the related help systems for the product interfaces.

Problem Op System Workaround
The readme.html file incorrectly states that the WebSphere Application Server Standard Edition installation guides are included in the product installation. All Obtain the Standard Edition installation guides as part of the full InfoCenter download available from the product Web site. Details for this download are in the readme.html file. The installation guides are also available from the online InfoCenter.
When opening the InfoCenter or its files using a Netscape browser, you might receive this message:
file not found

This message refers to the name and path of the file you are attempting to open, for example:

'c:\WebSphere\AppServer\web\doc\
begin_here\filename.html' not found
Windows NT/2000 Do the following:
  1. Start Windows Explorer.
  2. Click View, then select Options.
  3. Click the File Types tab.
  4. Scroll the Registered File Types list to Netscape Hypertext Document and double click.
  5. Under Actions, double click Open.
  6. Uncheck the Use DDE option.
  7. Click OK, then close.

With the Use DDE (Dynamic Data Exchange) option off, the window errors that complain that a local file (like the Readme) is not found should not appear.

Using the Netscape browser, the InfoCenter and Help display blank pages or give Java/Javascript errors when opening InfoCenter or Help topics. Solaris Set up the Netscape browser environment to allow use of the InfoCenter and Help system (setup consists of putting all Netscape .jar files in the CLASSPATH, followed by the required WebSphere JDK):
  1. Configure Netscape:
    1. Set your CLASSPATH to include (in this order) each Jar file in the MOZILLA_HOME/Java/classes directory; the Java classes.zip file found in /usr/java1.1/lib.
    2. In Netscape, select Preferences, then Appearance, then Fonts and change the font settings. The recommended setting for variable width font is New Century Schoolbook; and for fixed width font, it is Courier. Note that many of the font choices included with the Netscape Navigator product will work. Choose a set you like.
If Netscape Navigator (or Communicator) is the system default browser and a browser is already open for a purpose other than displaying WebSphere Application Server help or documentation, the open browser might ignore a request to display the WebSphere Application Server help or documentation. The help or documentation is not displayed in the open browser, and no new browser instance is launched for displaying the requested file. Windows NT/2000 If instances of the default browser are already open for other purposes, close these browser instances, if possible, before requesting help or documentation from WebSphere Application Server using the Help menu on the WebSphere Administrative Console or the Start menu on Windows NT.
The online help for the Administrative Console accessible from the Help menu choices sometimes does not work. Solaris, HP-UX Fixes and workarounds are being investigated so that you can access context-sensitive help reliably from the product interfaces.

Note, as a workaround the help files are available from the InfoCenter, with an administrative tasks, tools, and resources quick reference providing easy access. See also the administrative topology quick reference.