NetSight Console Installation

	NOTE:	When this topic is opened from the CD-ROM, the links from this topic to other help topics will not work. Links within the topic will work and once you've installed NetSight Console, you can launch the help system and access help for all topics.

This document provides instructions for installing NetSight Console. The most recent version of this file is located on the NetSight Documentation web page: http://www.enterasys.com/support/manuals/netsight.html.

• General Installation Information
  • System Requirements
  • Evaluation Copy
  • Upgrading a Console License
  • NetSight Services
  • NetSight Plugin Integration
  • HP OpenView Network Node Manager Integration
• Windows Installation
  • Configuring the Environment
  • Check For and Stop Other Services
  • Installing NetSight Console (Windows)
• Solaris Installation
  • Preparing for Solaris Installation
  • Installing NetSight Console (Solaris)
• Linux Installation
  • Preparing for Linux Installation
  • Installing NetSight Console (Linux)
• Launching NetSight Console
  • Solaris Launch
  • Linux Launch
  • Windows Launch
• Uninstalling NetSight Console
  • Uninstalling on Windows
  • Uninstalling on Solaris
  • Uninstalling on Linux
• Support
  • Accessing Help
  • Technical Support
  • Documentation
  • Training

• NetSight Console Standalone - provides a NetSight Server and a local Console Client installed on a single workstation and allows sharing the NetSight Database with the suite of NetSight Plugin applications on the same system.
• NetSight Console Client/Server - provides a NetSight Server and a local Console Client installed on a single workstation and allows sharing the NetSight Database with Remote Console Clients and the suite of NetSight Plugin applications.

NetSight Console may be installed on the Windows XP^®, Windows 2003 Server^® 4.0, or Windows^® 2000 platform, or Linux Red Hat version 9, Linux Enterprise WS, ES, SuSE Linux, or the UNIX^® Solaris^® 2.8, 2.9, or 2.10 platform. Before you install Console, it is recommended that you read the NetSight Console Release Notes. You can also access the release notes for Console from the CD with a web browser by opening the relnotes.htm file for NetSight Console. The most recent version of the release notes can be found on the NetSight Documentation web page: http://www.enterasys.com/support/manuals/netsight.html

The following tasks comprise the NetSight Console installation process:

• Installing any required operating system patches (UNIX only).
• Preparing your system for installation.
• Installing NetSight Console.

	NOTE:	When re-installing Console, the installation program saves copies of any FlexViews that you have created/modified in the <install  area>\Enterasys Networks\NetSight Console\backup\FlexViews folder.

	CAUTION:	When re-installing Console, MIBs that you have added to the <install area>\Enterasys Networks\NetSight Console\client\etc\mibs directory will be removed during installation. You should always add MIBs to the <install area>\Enterasys Networks\NetSight Console\client\etc\mibs\MyMIBs directory. The MyMIBs directory is saved and restored during re-installation. Refer to How to Add MIBs for more information.

System Requirements

• Windows 2000, Windows 2003 Server, Windows XP Professional w/Service Pack 2 (qualified on the English version of the operating systems), Linux Red Hat Version 9, Linux Enterprise v3 ES, Linux SuSE
  • Recommended P4-2.4 GHz, 1GB RAM
  • Free Disk Space - 600MB

• Solaris 2.8, 2.9, 2.10 (with latest operating system patches installed.)
  • Recommended Sun® Ultra 30/60 (or equivalent), 900MHz, 1GB RAM
  • Free Disk Space - 600MB

Evaluation Copy

1. In the Console main window, select Tools  > Server Information.
2. In the Server Information window, click the License tab.
3. Select Console from the table and click Change License.
4. Read and accept the License and click OK.
5. Enter the License Key and click Update.

Upgrading Console

Converting a Database

If you are upgrading from Console release 1.5.1, you can convert your Console 1.5.1 database to preserve most of your network information. However, some elements in the earlier version cannot be converted to Console 2.1. Refer to How to Convert a Database for more specific information on converting your Console 1.5.1 database.

If you are upgrading from Console release 2.0.x to Console 2.1, your data will be automatically migrated.

Upgrading a Console License

It is possible to update Console to change from a Standalone to a Client/Server configuration. However, on Windows systems, this requires re-installing Console 2.1 using the Client/Server license key. This update can be done on Solaris and Linux systems without re-installing.

	NOTE:	It is not possible to upgrade from a Client-Only configuration to either a Standalone or Client/Server configuration without re-installing with the upgraded license key.

Upgrading your Console license on a Linux or Solaris system:

1. Navigate to the /var/Enterasys_Networks
2. Edit the run_conf.sh file using your favorite text editor.
3. To change from a Standalone to a Client/Server configuration, modify the hostname line to read:

       JBOSS_HOSTNAME=

4. In Console, select Tools > Server Information from the menu bar. The Server Information window opens.
5. Select the License tab.
6. Select the license that you want to change and click Change License. The Change License window opens.
7. Read and accept the terms of the license agreement and click OK.
8. Enter the License Key and click Update. The license file will be updated with the new license number.
9. Restart the server:
   1. Navigate to the <installdir>/server
   2. Start the server using the command: stopserver.sh
   3. Start the server using the command: startserver.sh

	NOTE:	You can set a Console licensed for a Client/Server configuration to allow only a local host to connect to the server by editing the hostname line to read: JBOSS_HOSTNAME="127.0.0.1". Restart the server after editing the run_conf.sh file.

Co-existing Versions of Console

• Prior to installing Console 2.1 on a system with Console 1.5, preserve a copy of the .nsaservrc file in the <Console 1.5 install area>\Enterasys Networks\NetSight Atlas Shared\Users\AllUsers directory.

• If you have selections that were added to the device-level right-click menu, you should preserve a copy of the ThirdPartyDeviceMenu.txt file from Console 1.5 (in the <Console 1.5 install area>\Enterasys Networks\NetSight Console\backupshared) prior to installing Console 2.1. You will need to restore the 1.5 version of this file or copy portions of the prior version into the one created by the Console 2.1 installation.

• If you uninstall Console 2.1  while retaining Console 1.5, you must restore your saved copy of the .nsaservrc file to the <Console 1.5 install area>\Enterasys Networks\NetSight Atlas Shared\Users\AllUsers directory.

• If you later uninstall Console 1.5 while retaining Console 2.1, you will need to re-install Console 2.1.

	CAUTION:	If NetSight Console 2.x (licensed version or evaluation copy) is installed on a system with a 1.x version of Console that is integrated with HP OpenView, the 1.x version of Console will no longer be accessible from the HPOV menus.

NetSight Services

• SNMPTrap Service (Windows, Solaris, and Linux) - Enables SNMP trap messages to be received and logged when problems or irregularities are detected on network devices. Only one trap service may be running at a time on a machine. If you are also running a network management system on the Console machine, you may wish to use the network management trap service.
  When properly configured, NetSight Console supports SNMP Informs (trap messages that require an acknowledgement of receipt). Refer to Configuring SNMPtrap Service for SNMPv3 Inform Support to learn how to perform this configuration. Windows Users: Windows users should check for and stop any other SNMP trap service before enabling the NetSight version (see Check For and Stop Other Services).
  
• TFTP (Windows, Solaris, and Linux) - Enables you to upload and download configuration files, and download firmware to devices. Only one TFTP service may be running at a time on a machine.
  Windows Users: Windows users should check for and stop any other TFTP service before enabling the NetSight version (see Check For and Stop Other Services).
  Solaris Users: You may use the TFTP service that exists in UNIX; however, the NetSight version of TFTP provides additional features for Console, so you may wish to enable the NetSight version. If you elect to enable the NetSight version on the Solaris platform, you must stop the UNIX TFTP service and perform some configuration steps in order for it to work properly, as follows:
  1. Edit your /etc/inetd.conf file. Comment out any existing TFTP entries.
  2. Execute the command:/etc/rc2.d/S72inetsvc stop
  3. Execute the command: /etc/rc2.d/S72inetsvc start
  4. Execute the command:/etc/rc2.d/S99NsTftp start
  
  Linux Users: Typically, the TFTP service that exists in Linux is disabled; however, if it is enabled, you may wish to disable it and enable the NetSight version of TFTP which provides additional features for Console. If you elect to enable the NetSight version on the Linux platform, you must first disable the Linux TFTP service and perform some configuration as follows:
  1. Using a text editor, edit the file /etc/xinetd.d/tftp
  2. Set disable = yes

     Sample file:

     service tftp
     { flags = REUSE
     socket_type = stream
     wait = no
     user = root
     server = /usr/sbin/in.tftp
     disable = yes
     }

  3. Then run : /etc/rc3.d/S56xinetd restart

• BOOTP (Windows only) - Enables the Console workstation to also be a BOOTP server. This allows the workstation to supply devices with firmware images (or other basic identity information) in the event the device's current firmware image becomes corrupt. Only one BOOTP service can be running at a time on a machine. If you elect to enable this service, you will need to create a Bootptab file for the BOOTP service to read.
  Solaris Users: Use the UNIX BOOTP service if you wish to take advantage of BOOTP. Refer to the UNIX BOOTP "man pages" for more information.
  
• Syslog (Windows only) - Console maintains a record of syslog messages in the Syslog tab of the Alarm & Events panel. A Syslog Pattern Configuration window lets you define a pattern to specify how the information from a non-standard syslog file is presented in a tab in the Alarm and Events view.

NetSight Plugin Integration

	TIP:	You can also configure this menu to launch your own applications. You can edit the NetSight.properties file to customize this menu to allow you to launch your own applications from the Console Applications menu. Refer to How to Add Applications to the Applications Menu for more information.

HP OpenView Network Node Manager Integration

Installing the Integration Piece
If you want to install the integration piece, it is suggested that you shut down NNM when you install Console. (It is all right to leave NNM processes running.) During the HP OpenView portion of the Console installation, you will be asked to provide the location in which to install the integration components, and an HP OpenView integration script will run. (Note: The installer looks for the path \bin\ovw.exe directory in your HPOV installation area. If it doesn't find the expected path, you will see a message informing you that the path is incorrect.) Lastly, you will receive a reminder that you can also run a manual script to load Enterasys Networks MIBs and trap definitions into NNM.

Running the MIBs Script
Once NetSight Console is installed, you can go to the top level of your NetSight Console installation area and run the loadmibs file to load the Enterasys Networks MIBs and trap definitions into your NNM database. This takes approximately 45 minutes to an hour, which is why it is not an automated part of the NetSight Console installation process.

Accessing NetSight Applications from NNM

• To access NetSight Console from NNM, select My Apps > NetSight Console from the menu.
• To access NetSight Device Manager from a device in NNM, right-click the device and select NetSight Device Manager from the menu. This menu option is only available on Enterasys Networks devices .

Windows Installation

• Configure the Environment
• Check For and Stop Other Services

Once your system is properly configured, you can proceed with:

• Installing NetSight Console (Windows)
• Launching NetSight Console (Windows)

Configuring the Environment

	NOTE:	Some of the operations in the following instructions may generate a message prompting you to reboot your system. It is not necessary to reboot your system until you have completed the configuration process.

Windows 2000

1. Open your system's Control Panel (Start > Settings > Control Panel) and double-click the System icon. The System Properties window opens.
2. Select the Advanced tab and click the Performance options button. The Performance Options window opens.
3. Verify that the "Application response" section has Optimize performance for: Applications selected.
4. Click the Change button in the "Virtual Memory" section of the Performance Options window. The Virtual Memory window opens.
5. Enter the following settings in the "Paging file size for selected drive" section:
   Initial size (MB) -- set to a minimum of 128 MB or equivalent to your system RAM.
   Maximum size (MB) -- typically set to twice the Initial size. For example, if your Initial size is set to 128 MB, your maximum size would be set to 256 MB.
6. Click Set and OK to close the window.
7. Click OK to close the Performance Options window.
8. Click OK to close the System Properties window.
9. With the cursor in an open area of the desktop, right click and select Properties from the drop-down menu. The Display Properties window opens.
10. Select the Settings tab, and set Colors to High Color (16 bit) and Screen area to 1024 by 768 pixels (recommended minimum). The Color setting affects the appearance of Console windows. Certain window features, such as table rows that appear with a color gradient can only be enabled with color settings of 24 bit (16777216 colors) and above. Setting the palette lower than 24 bit (16 bit - 65,536 colors) does not support gradients.
11. Click OK to close the Display Properties window.
12. Reboot your system.

Windows XP and Windows 2003 Server

1. Open your system's Control Panel (Start > Settings > Control Panel) and double-click the System icon. The System Properties window opens.
2. Select the Advanced tab and click the Settings button in the "Performance" section. The Performance Options window opens.
3. Select the Advanced tab and verify that the "Processor scheduling" and "Memory usage" sections have Adjust for best performance of: programs selected.
4. Click the Change button in the "Virtual Memory" section of the Performance Options window. The Virtual Memory window opens.
5. In the "Paging file size for selected drive" section, select the Custom size option and enter the following settings:
   Initial size (MB) -- set to a minimum of 128 MB or equivalent to your system RAM.
   Maximum size (MB) -- typically set to twice the Initial size. For example, if your Initial size is set to 128 MB, your maximum size would be set to 256 MB.
6. Click Set and OK to close the window.
7. Click OK to close the Performance Options window.
8. Click OK to close the System Properties window.
9. With the cursor in an open area of the desktop, right click and select Properties from the drop-down menu. The Display Properties window opens.
10. Select the Settings tab, and set the Screen resolution to 1024 by 768 pixels (recommended minimum), and the Color quality to Medium (16 bit). The Color setting affects the appearance of Console windows. Certain window features, such as table rows that appear with a color gradient can only be enabled with color settings of 24 bit (16777216 colors) and above. Setting the palette lower than 24 bit (16 bit - 65,536 colors) does not support gradients.
11. Click OK to close the Display Properties window.
12. Reboot your system.

Check For and Stop Other Services

1. Open the Services window on your system (on Windows 2000 systems - Control Panel > Services -- on Windows XP and Windows 2003 Server - Control Panel > Administrative Tools > Services).
2. Scroll down to find the service in the list.
3. Right click on the service and select Stop from the popup menu.
4. Right click on the service again and select Properties from the popup menu.
5. In the Properties window, set the Startup Type for the service to Manual.
6. Repeat for any other services, if necessary.
7. Close the Services windows and Control Panel.
8. Open the Task Manager and check to be sure that the process is not running.
9. Close the Task Manager.

Installing NetSight Console (Windows)

1. Log onto your system as Administrator.
2. Insert the NetSight Console CD into your system's CD drive.
3. In Windows Explorer, navigate to the CD drive and open the Windows folder where the install.exe application resides.
4. Double-click the install.exe application.
5. The NetSight Console Installer leads you through a series of windows that ask you for all the information required in order to install Console. You will need the following information to complete the Installer Program:
   • License -- This is a unique number assigned to your copy of NetSight Console and are located on a label on your CD holder. Or you may choose to install the NetSight Console Evaluation Copy.
   • Destination Directory -- This is the path to your NetSight Console Installation Directory. In the Destination Directory window, click Choose to navigate to the directory, or type the path in manually.
   When you have finished with this series of windows, NetSight Console will be installed according to your specifications.

Solaris Installation

Before installing NetSight Console on a Solaris platform, you need to:

• Prepare for Installation on Solaris

Once your system is properly configured, you can proceed with:

• Installing NetSight Console (Solaris)
• Launching NetSight Console (Solaris)

Preparing for Solaris Installation

1. Insert the NetSight Console CD into the CD drive.
2. Use an xterm where you are logged in as root using the su - command.

   	NOTE:	You may encounter a Java exception during the install when becoming the root user with the su - command. Be sure that your system's root environment has a proper DISPLAY variable setting. The Installation program will report a Java exception (InvocationTargetException) if the DISPLAY variable is undefined. If this occurs: Before using the su - command, set the system display variable to accept a remote display with the command:        /usr/openwin/bin/xhost + After using the su - command,  set the display variable in the environment where the su - was done.   For C shell:       setenv DISPLAY :0.0   For Korn shell:       export DISPLAY=:0.0

3. Using the cd command, cd to the /cdrom/cdrom0 (where 0 is zero) directory. If it does not exist, make the directory using the mkdir -p command, then cd to the newly created directory.
4. Using the ls command, check to see if the CD drive is mounted. If no files are listed, issue the following commands:
   cd /
mount -r -F hsfs /dev/sr0 /cdrom/cdrom0
   (where 0 is zero).
5. You can now launch the NetSight Console Installer (see Installing NetSight Console (Solaris)).

Installing NetSight Console (Solaris)

1. Use an xterm where you are logged in as root. (Be sure that your system's root environment has a proper DISPLAY variable setting. For more information see the above note.)
2. Start the Installer by issuing the appropriate command:
   /cdrom/cdrom0/Solaris/install.bin
3. The NetSight Console Installer leads you through a series of windows that ask you for all the information required in order to install Console. You will need the following information to complete the Installer Program:
   • License -- This is a unique number assigned to your copy of NetSight Console. It is located on a label on your CD holder. Or you may choose to install the NetSight Console Evaluation Copy.
   • Destination Directory -- This is the path to your NetSight Console Installation Directory. In the Destination Directory window, click Choose to navigate to the directory, or type the path in manually.
   When you have finished with this series of windows, Console will be installed according to your specifications.

Linux Installation

	NOTE:	Prior to beginning installation, verify that your /etc/hosts file has the local host name specified. It should have an entry that looks like:   127.0.0.1  localhost

Before installing NetSight Console on a Linux platform, you need to:

• Prepare for Installation on Linux

Once your system is properly configured, you can proceed with:

• Installing NetSight Console (Linux)
• Launching NetSight Console (Linux)

The following procedures assume that the CD drive from which you are installing is physically attached to the system where NetSight Console is being installed.

Preparing for Linux Installation

1. Insert the NetSight Console CD into the CD drive.
2. Use an xterm where you are logged in as root.

   	NOTE:	If you do not have a DISPLAY variable defined for your root user environment, you will encounter a Java exception during the install upon becoming the root user. Be sure that your system's root environment has a proper DISPLAY variable setting.

3. Using the cd command, cd to the /mnt/cdrom directory.
4. Using the ls command, check to see if the CD drive is mounted. If no files are listed, issue the following commands:

   mount /mnt/cdrom

5. You can now launch the NetSight Console Installer (see Installing NetSight Console (Linux)).

Installing NetSight Console (Linux)

1. Use an xterm where you are logged in as root. (Be sure that your system's root environment has a proper DISPLAY variable setting.)
2. Start the Installer by issuing the appropriate command:

   /mnt/cdrom/linux/install.bin

3. The NetSight Console Installer leads you through a series of windows that ask you for all the information required in order to install Console. You will need the following information to complete the Installer Program:
   • License -- This is a unique number assigned to your copy of NetSight Console. It is located on a label on your CD holder. Or you may choose to install the NetSight Console Evaluation Copy.
   • Destination Directory -- This is the path to your NetSight Console Installation Directory. In the Destination Directory window, click Choose to navigate to the directory, or type the path in manually.
   When you have finished with this series of windows, Console will be installed according to your specifications.

Launching NetSight Console

After you've launched Console for the first time, it is highly recommended that you select Help > Help Topics from the menu and read the Welcome topic to review the Help system features and learn more about how to use NetSight Console.

Solaris Launch

Start the server with the command:

     <installdir>/server/startserver.sh

This starts the database, then starts the NetSight Server.

Then, you can launch the Console client:

1. Use the cd command to navigate to the NetSight Console Installation Directory.
2. Issue the NetSight Console startup command:
   ./console

Linux Launch

Start the server with the command:

     <installdir>/server/startserver.sh

This starts the database, then starts the NetSight Server.

Then, you can launch the Console client:

1. Use the cd command to navigate to the NetSight Console Installation Directory.
2. Issue the NetSight Console startup command:
   ./console

Windows Launch

Uninstalling NetSight Console

Use the procedures below to uninstall Console. When you uninstall, only the files which were distributed with NetSight Console will be uninstalled. Files you generate (such as logs, FlexViews, device lists, and data files) will not be automatically uninstalled. Click here for a complete list of directories removed by uninstall. If you have multiple versions of Console installed and are uninstalling, refer to the Co-existing Versions of Console section in the Release Notes for information and cautions.

Uninstalling on Windows

1. Go to the Taskbar Notification Area of your desktop (on the lower right of your screen, unless you've relocated your Taskbar).
2. Right-click the Services Manager icon ( ) and select Stop running services to stop all NetSight Services that are currently running.
3. Right-click again on the Services Manager icon and select Exit to shut down the Services Manager.

You can now uninstall Console:

From the Start menu, select Programs > Enterasys Networks > NetSight Console > Uninstall NetSight Console.

Uninstalling on Solaris

1. Stop the NetSight Server and database:
   1. On the server system, navigate to the <installdir>/server
   2. Stop the server and database using the command: stopserver.sh
2. Stop the NetSight Services:
   1. Navigate to the etc/rc2.d directory.
   2. Stop the SNMP trap service using the command:

          S99NsSnmptrapd stop

   3. Stop the TFTP service using the command:

          S99NsTftp stop

3. Uninstall Console.
   1. Navigate to the NetSight Console Installation Directory (top level).
   2. Start the Uninstaller by issuing the command:

          ./uninstallconsole

Uninstalling on Linux

When installed as a service on Red Hat Linux, the NetSight Server and database can be controlled using tools such as the Red Hat Service Configuration Tool. Otherwise, use the following steps to stop the NetSight Services, Server and Database:

1. Stop the NetSight Server and database:
   1. On the server system, navigate to the <installdir>/server
   2. Stop the server and database using the command: stopserver.sh
2. Stop Services on all Linux systems except SuSE:
   1. Navigate to the etc/rc2.d directory.
   2. Stop the SNMP trap service using the command:

          S99NsSnmptrapd stop

   3. Stop the TFTP service using the command:

          S99NsTftp stop

3. Stop Services on SuSE Linux:
   1. Navigate to the etc/init.d directory.
   2. Stop the SNMP trap service using the command:

          NsSnmptrapd stop

   3. Stop the TFTP service using the command:

          NsTftp stop

4. Uninstall Console.
   1. Navigate to the NetSight Console Installation Directory (top level).
   2. Start the Uninstaller by issuing the command:

          ./uninstallconsole

Support

To locate product specific information, refer to the Enterasys website:

http://www.enterasys.com

Accessing Help

Technical Support

Phone: (800) 872-8440 (24 hours a day, 365 days a year)
Email: support@enterasys.com

Mail:
Enterasys Networks, Inc.
Technical Support
50 Minuteman Rd.
Andover, MA 01810

FTP: ftp.enterasys.com
Login: anonymous
Password: [your email address]

BBS: 603-335-3358
Modem Setting: 8N1: 8 data bits, 1 stop bit, No parity

Documentation

Training

Related Information

• NetSight Console Release Notes