Installing/Uninstalling the Tivoli NMC Topology Console on Linux
Installing the Tivoli NMC Topology Console on Linux
To install the NMC Topology Console on Linux, follow these steps:

1. To install the NMC Topology Console by HTTP download:
   1. Point your web browser to the NetView tools web page.
   2. Download the Windows version of the NMC Topology Console into a temporary directory as duinmccl.tar.gz
2. Change to the root directory, regardless of the directory to which the tar file was downloaded.
3. Use tar to unpack the files in duinmccl.tar.gz which will unpack and distribute the files in the appropriate directories. You should run this from the root directory since the product installation path begins with /usr. The form of the command is: "tar -zxvf <download path>duinmccl.tar.gz"

1. Change directory to the generic_unix directory by issuing this command: "cd /usr/local/Tivoli/bin/generic_unix"
2. Delete the files from the "TDS" directory and below by entering "rm -r TDS"
3. Select the "Add/Remove Programs" icon in the Control Panel.
4. Change directory to the linux-ix86 directory by issuing this command: "cd /usr/local/Tivoli/bin/linux-ix86"
5. Delete the files from the "TDS" directory and below by entering "rm -r TDS"

Starting the NMC Topology Console for Linux
To start the NMC Topology Console for Linux you will need to first change to subdirectory /usr/local/Tivoli/bin/generic_unix/TDS/client/bin by entering the following command: "cd /usr/local/Tivoli/bin/generic_unix/TDS/client/bin".

In this subdirectory, you can now start the NMC Console by entering the command: "tconsole.sh .. -key nmc"

Hints and Tips for the NMC Topology Console
The most common problem encountered with the Tivoli NMC Topology Console in past releases was not having Java set up correctly. By shipping Java as part of the NMC Topology Console binaries, the majority of Java related problems have been eliminated.

Partial download of the Topology Console from the Topology Server: This is caused when communications drop as NMC is being downloaded from the server it connected to. The problem will usually manifest itself as a hang once NMC is started. This is because only part of the .jar file that contains most of the NMC function was downloaded. This is easy to detect by comparing the size of the ihseuc.jar file in the ...\TDS\client\lib directory of the console with that of the ihseuc.jar file in the ...\TDS\server\db\current\lib directory on the server. They should be the same size and if the ihseuc.jar file in the ...\TDS\client\lib directory is smaller then this is the problem. To resolve this you must uninstall NMC and also delete all the directories and files starting from \TDS. Then you need to reinstall NMC and then connect to the server again and it will progress normally.

Late-Breaking News
New enhancements
A new on-line help engine has replaced the old on-line help engine.

Known defects

1. Empty view displayed when quickly opening a view while one is opening

   When quickly opening a view while another view is currently being built and displayed, an empty view displayed and no further actions can be taken until the empty view is closed.

   The work-around for this problem is to avoid quickly opening another view (or the same view again) while a previous request is being processed. If an empty view is displayed and prevents further actions, close the view.

2. Online help and waiting for large HTML files to load

   When displaying large HTML files such as "Help -> Help Index" or the "Help -> How Do I?", if you click on a hotlink before the page is fully loaded, the Topology Console sometimes will throw a Java exception. The work-around is to wait until a page is fully loaded before clicking on a hotlink.

3. Displaying external URL

   When displaying HTML from an external URL (not NMC product HTML help) sometimes the Topology Console will throw a Java exception. An example is clicking on the Tivoli icon in the view bar. The on-line help window is not a fully functional browser. There is no work-around for this problem.

4. Color palette and mouse clicks on the Solaris platform

   When changing colors for views either from the "Console Properties" window ("View" tab) or the "View Properties" window; the selection of a color from the palette after selecting the ColorPopUp button does not work.

   The color changes are for the following items:

   • Label foreground
   • Expanded label foreground
   • Expanded label background
   • Free text foreground
   • Background
   The documentation states that you must press the left mouse button to select a color. On the Solaris platform, you must use the middle or right button.

5. Mouse-overs can overwrite the icon images on the icon toolbar

   When moving the mouse across the icons on the icon toolbar, the icon images can be corrupted when running NMC on specific hardware configurations:

   • Microsoft Windows 2000 Server in combination with the Matrox Millennium G400 Dual Head Max graphics card.
   The work-around for hardware configurations with the problem is to either:
   1. Sweep the mouse the opposite direction to repaint the icons; or,
   2. Change the number of usable colors to 256.

Service History
This corresponds to the NMC 1.4.0.0 GA level.

Documentation Changes
None

Trademarks
The following terms are trademarks of their respective companies in the United States or other countries or both: