Installation

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

This document provides instructions for installing NetSight Atlas Router Services Manager. 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

You can install Router Services Manager on the following platforms: Before you install Router Services Manager, it is highly recommended that you read the NetSight Atlas Router Services Manager Release Notes. 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. You can also access the release notes from the CD by opening the relnotes.htm file with a web browser.

The following tasks comprise the Router Services Manager installation process:

System Requirements

The system requirements for operating Router Services Manager are listed here.

  NOTE: Router Services Manager requires a minimum monitor logging setting of high on XSR devices that are managed by Router Services Manager. Do not set the monitor logging level to no logging Monitor. Router Services Manager will not be able to communicate with a device.

User Authorization

Router Services Manager's Authorization feature lets you manage user access privileges in Router Services Manager, offering a greater level of security than user authentication. If you have Administrative privileges on your Windows system or root privileges on your UNIX workstation, you can set Router Services Manager to run with Authorization enabled. Authorization lets you define three levels of Router Services Manager users:

Administrator
No Restrictions - Administrator access is required to launch the User Authorization window and add remove or edit user profiles.

Read Write
Cannot launch the User Authorization window, view or change user profiles. All other operations and functions are permitted.

Read Only
The following restrictions apply:

With Authorization disabled, users are required to provide authentication (User ID, Password, etc.) to launch Router Services Manager, but then all users are granted Read Write access once they are logged on to Router Services Manager.

If you plan to run Router Services Manager with Authorization enabled, you must configure Administrator privileges for your user ID. Refer to the user documentation for your system for more information about Administrative privileges.

Evaluation Copy

When you install Router Services Manager, you can select to install a 30-day Evaluation Copy.

To convert from an evaluation copy of Router Services Manager to a purchased copy, contact your Enterasys Networks Representative to purchase the software and receive a License Key. You do not need to reinstall the software to perform the conversion. If your evaluation copy has not expired, do this:

  1. In the Router Services Manager main window, select Help  > About NetSight Atlas Router Services Manager.
  2. In the About NetSight Atlas Router Services Manager window, click License.
  3. Enter the License Key and click Update.
If you have let your Evaluation Copy expire, when you launch Router Services Manager a window opens where you can enter the License key.

Top

Upgrading from a prior ACL Manager or Router Services Manager Release

When upgrading to the current Router Services Manager release from ACL Manager 1.2 or a prior Router Services Manager release, the installation automatically copies (and renames) several resource and configuration files from your prior installation into the new Router Services Manager directory or into the common NetSight Atlas area. However, any User-defined Well Known protocols are not automatically ported into the Router Services Manager. If you defined any well-known protocols in the prior release of ACL Manager, Router Services Manager, or one of the other NetSight Atlas applications, you must define your unique protocols again after installing Router Services Manager.

Also, if you have modeled XSR devices in ACL Manager, you must Refresh Device Data following installation to update the existing device information for devices that support Firewall.

When upgrading from ACL Manager 1.1 or earlier, you must handle several files manually as follows:

  1. Copy the .templates folder
        From:
    <install area>\Enterasys Networks\NetSight Atlas ACL Manager
        To:
    <install area>\Enterasys Networks\NetSight Atlas Router Services Manager.

  2. Copy the aclmgr.packetdefs file (if one exists)
        From:
    <install area>\Enterasys Networks\NetSight Atlas ACL Manager
        To:
    <install area>\Enterasys Networks\NetSight Atlas Router Services Manager.

  3. Copy the <user(s)> folder(s)
        From:
    <install area>\Enterasys Networks\NetSight Atlas ACL Manager\Users
        To:
    <install area>\Enterasys Networks\NetSight Atlas Shared\Users.

  4. Open the .amgrrc file in the \Enterasys Networks\NetSight Atlas Shared\Users\<username> folder with a text editor and Save As .rsmrc.

  5. After launching the application, open the database (filename.amd) used with the earlier version of ACL Manager, located in <install area>\Enterasys Networks\NetSight Atlas ACL Manager and Save the database as filename.rsd.

Recommended Reading Sequence

It is highly recommended that you read the following information before you use Router Services Manager:

Before installation:

After installation:

Top

Installation on Windows

  NOTE: On Windows 2000 or Windows XP systems, you must be logged on as an Administrative user, or as a user that is a member of the Administrators Group or the Power Users Group.

Use the following instructions to install Router Services Manager on a Windows NT, Windows 2000, or Windows XP system.

Before installing Router Services Manager on a Windows platform system, you need to:

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

Top

Configuring the Environment

Following are instructions for configuring the environment on Windows NT, Windows 2000, and Windows XP platforms.

  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 NT

  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 Performance tab and verify that Application Performance Boost is set to Maximum.
  3. Click the Change button in the "Virtual Memory" section of the System Properties window. The Virtual Memory window opens.
  4. 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.
  5. Click Set and OK to close the window.
  6. Click OK to close the System Properties window.
  7. 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.
  8. Select the Settings tab, and set the Color Palette to a minimum of 65,536 colors and Desktop Area to 1024 by 768 pixels (recommended minimum).
  9. Click OK to close the Display Properties window.
  10. Reboot your system.

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).
  11. Click OK to close the Display Properties window.
  12. Reboot your system.

Windows XP

  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).
  11. Click OK to close the Display Properties window.
  12. Reboot your system.

Top

Launching the Installer (Windows)

Now that you have configured your system, you are ready to launch the Router Services Manager installer.
  1. Log onto your system as the user who will be using Router Services Manager.
  2. Insert the Router Services Manager 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. Go on to the Installer.

Installation on UNIX

On the UNIX platform, Router Services Manager supports the Sun Solaris 2.7 and Solaris 2.8 operating systems. Before installing Router Services Manager, be sure to install the latest patches for your operating system. You can download these from http://sunsolve.sun.com.

Before installing Router Services Manager on a UNIX platform, you need to:

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

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

Top

Preparing for Installation on UNIX

The user performing the installation must have privileges to create, read, write, and execute within the installation directory.
  1. Insert the Router Services Manager CD into the CD drive.
  2. Use an xterm where you are logged in as root using the su - command.
  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 Router Services Manager Installer (see Launching the Installer (UNIX)).

Top

Launching the Installer (UNIX)

Now that you have accessed your CD, you are ready to install Router Services Manager.

  NOTE: Before the Installer Program launches, it checks to see if the Solaris patches required for installation are installed on your system. For more information, see Installation on UNIX, above.

  1. Use an xterm where you are logged in as the user who will be running Router Services Manager.
  2. Start the Installer by issuing the command: /cdrom/cdrom0/Solaris/install.bin
  3. The Installer checks your system for required installation patches. If required patches are not present, the Installer will stop and list the patches that are needed. If required patches are installed, the Installer program launches.
  4. Go on to the Installer.

Top

Installer

The Router Services Manager Installer leads you through a series of windows that ask you for all the information required in order to install NetSight Atlas Router Services Manager. You will need the following information to complete the installation: When you click Done on the final window in the Installer, Router Services Manager has been installed according to your specifications.

Top

Launching Router Services Manager

Now that you've installed Router Services Manager, you can launch it.

Router Services Manager's Authorization feature lets you manage user access privileges in Router Services Manager. Authorization is disabled when Router Services Manager is first installed and all users are granted Read Write access once they are logged on (authenticated) to Router Services Manager.

That means that:

  NOTE: UNIX users with a local account must launch Router Services Manager from an xterm window as root.

To enable Authorization, you must you must log on to Router Services Manager as a user with Administrative access on your Windows system or launch Router Services Manager from an xterm window as root on your UNIX workstation, then log on to Router Services Manager as root.

When you launch Router Services Manager as an Administrative user and Authorization is disabled, you will be asked, "Do you want to enable Authorization?" If you click Yes, the User Authorization window opens where you can add yourself as a user with Administrator privileges. Refer to How to Configure User Authorization for more information.

If you click No, Authorization is disabled and all users are granted Read Write access once they are logged on (authenticated) to Router Services Manager.

Launching on Windows

  1. From the Start menu, select Programs > Enterasys Networks > NetSight Atlas Router Services Manager > Router Services Manager.
  2. Evaluation Copy users will see a message indicating that this is an evaluation copy, and informing you of the expiration date (30 days from date of installation). Click OK to continue. If you are launching a licensed copy of Router Services Manager, the User Authentication window opens.

    User Authentication Window - Windows

  3. Log onto Router Services Manager

    As an Administrative user:

    1. Log on as the user with Administrative privileges on the system where you are launching Router Services Manager. Enter your User ID, Domain Password, and select a Domain from the drop-down list into the Authentication window. The Domain list contains only the domains that are configured for your system.
    2. Click OK. The Router Services Manager Main window opens along with a message asking if you want to enable Authorization.
    3. Click Yes to open the User Authorization window where you can add yourself as an Administrative user. Refer to How to Configure User Authorization for more information. Click No to disable Authorization and return to the Router Services Manager Main window where you can begin using Router Services Manager.

    As a non-Administrative user:

    1. Enter your User ID, Domain Password, and select a Domain from the drop-down list into the Authentication window. The Domain list contains only the domains that are configured for your system.
    2. Click OK. The Router Services Manager Main window opens and you are ready to begin using Router Services Manager.

  TIP: You can drag the Router Services Manager shortcut from the Installation Directory to the desktop.

After you've launched Router Services Manager for the first time and added yourself as a user, it is highly recommended that you select Help > Contents from the menu and read the following links before proceeding to use Router Services Manager:

Top


Launching on UNIX

  NOTE: If you are going to run Router Services Manager with Authorization enabled, it must be launched from an xterm window by a user who is logged on as root.
  1. Use the cd command to navigate to the Router Services Manager Installation Directory.
  2. Issue the Router Services Manager startup command:
    ./ACLManager
  3. Evaluation Copy users will see a message indicating that this is an evaluation copy, and informing you of the expiration date (30 days from date of installation). Click OK to continue.

    If you are launching a licensed copy of Router Services Manager, the User Authentication window opens.

    User Authentication - UNIX

  4. Log onto Router Services Manager

    As an Administrative user (root):

    1. Log on as the root on the system where you are launching Router Services Manager. Enter root as the User ID, and root Password into the Authentication window.
    2. Click OK. The Router Services Manager Main window opens along with a message asking if you want to enable Authorization.
    3. Click Yes to open the User Authorization window where you can add yourself as an Administrative user. Refer to How to Configure User Authorization for more information. Click No to disable Authorization and return to the Router Services Manager Main window where you can begin using Router Services Manager.

    As a non-Administrative user:

    If your user account is configured locally, you must launch Router Services Manager as root from an xterm window. You can then authenticate to Router Services Manager as a local user (other than root). Router Services Manager will verify your access and either allow or deny access based on its Authorization settings. With Authorization disabled, you will be granted Read Write access.

    If your user account is configured in NIS (YP) you can authenticate using your network credentials, without the need for an xterm window launched by root. Router Services Manager will verify your access and either allow or deny access based on its Authorization settings. With Authorization disabled, you will be granted Read Write access.

    1. Enter your User ID and Password into the Authentication window.
    2. Click OK. The Router Services Manager Main window opens and you are ready to begin using Router Services Manager.

Top

After you've launched Router Services Manager for the first time and added yourself as a user, it is highly recommended that you select Help > Contents from the menu and read the following links before proceeding to use Router Services Manager:

Uninstalling Router Services Manager

Use the procedures below to uninstall Router Services Manager. When you uninstall, only the files which were distributed with Router Services Manager will be uninstalled. Files you generate will not be automatically uninstalled.

Uninstalling on Windows

From the Start menu, select Programs > Enterasys Networks > NetSight Atlas Router Services Manager > Uninstall Router Services Manager. You must be logged in as the user who installed Router Services Manager in order to see this selection on the Start menu.

If a different user is uninstalling Router Services Manager, go to the UninstallerData directory located in the Router Services Manager Installation Directory and double-click on Uninstall ACLManager.exe. In such a case the Uninstaller may not be able to remove certain files due to permission conflicts.

Uninstalling on UNIX

Router Services Manager should be uninstalled from an xterm window by a user who is logged on with the same ID as that of the user who installed the application.

Use the cd command to navigate to the Router Services Manager Installation Directory (top level). Start the Uninstaller by issuing the command:

./UninstallACLManager.sh

Top

Support

To locate product specific information, refer to the Enterasys website:
http://www.enterasys.com

Accessing Help

After you have installed Router Services Manager on your system, the full Help system is available from the Help menu option on Router Services Manager windows, and from any window that has a Help button on it. The online Help system is available as a PDF file in the docs directory located in your Router Services Manager installation directory.

On Windows systems, you can also access the Release Notes and Router Services Manager Help from the Start menu (Start > Programs > Enterasys Networks > NetSight Atlas Router Services Manager > NetSight Atlas Router Services Manager Help)

Technical Support

If you need technical support related to Router Services Manager, contact the Enterasys Global Call Center:

Phone: 603-332-9400 (24 hours a day, 365 days a year)
Fax: 603-337-3075 (24 hours a day, 365 days a year)
Email: support@enterasys.com

Mail:
Enterasys Networks, Inc.
Technical Support
P.O. Box 5005
Rochester, NH 03866-5005

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

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

Documentation

For the latest Enterasys documentation on the web, see http://www.enterasys.com/support/manuals.

Send your questions, comments, and suggestions regarding NetSight documentation to NetSight Technical Communications via the following e-mail address:

Netsight_docs@enterasys.com

Training

For training on this and other Enterasys products, see http://www.enterasys.com/training.

Top