Extreme Networks Ridgeline Installation Manual

Version 3.0
Hide thumbs Also See for Ridgeline:
Table of Contents

Advertisement

Ridgeline Installation and Upgrade Guide

Software Version 3.0

Extreme Networks, Inc.
3585 Monroe Street
Santa Clara, California 95051
(888) 257-3000
(408) 579-2800
http://www.extremenetworks.com
Published: February 2011
Part Number: 100397-00 Rev. 01

Advertisement

Table of Contents
loading

Summary of Contents for Extreme Networks Ridgeline

  • Page 1: Software Version

    Ridgeline Installation and Upgrade Guide Software Version 3.0 Extreme Networks, Inc. 3585 Monroe Street Santa Clara, California 95051 (888) 257-3000 (408) 579-2800 http://www.extremenetworks.com Published: February 2011 Part Number: 100397-00 Rev. 01...
  • Page 2 Unified Access Architecture, Unified Access RF Manager, UniStack, XNV, the Extreme Networks logo, the Alpine logo, the BlackDiamond logo, the Extreme Turbodrive logo, the Summit logos, and the Powered by ExtremeXOS logo are trademarks or registered trademarks of Extreme Networks, Inc. or its subsidiaries in the United States and/or other countries.
  • Page 3: Table Of Contents

    Contents Chapter 1: Installation Overview....................... 5 Installation Overview ..............................5 The Ridgeline Server ............................5 Upgrading the Ridgeline Server .........................6 The Ridgeline Client ............................6 System Requirements ..............................7 Windows Vista/XP/2003 Server/2008 Server/Windows 7 .................7 The Ridgeline Server ..........................7 The Ridgeline Client ...........................7 Sun Microsystems Solaris 10 ..........................8 The Ridgeline Server ..........................8 The Ridgeline Client ...........................8 Red Hat Enterprise Linux 5 ..........................8...
  • Page 4 Contents Uninstalling the Ridgeline Server Software ......................31 Uninstalling the Server on Windows........................31 Uninstalling the Server on Linux or Solaris .....................32 Chapter 3: Launching the Ridgeline 3.0 Client ..................35 About the Client Initialization Process ........................35 Launching the Client Application ..........................35 Disabling Installation of Desktop Shortcuts ......................38 Configuring the Firefox Browser for the Java Plug-In.....................39 Chapter 4: Upgrading the Ridgeline Software ..................
  • Page 5: Chapter 1: Installation Overview

    Ridgeline is a powerful, yet easy to use, client-server application for the centralized management of a network of Extreme Networks switches and selected third-party devices. Ridgeline offers a comprehensive set of network management tools that are easy to use from a client workstation with a web browser and the appropriate Java plug-in.
  • Page 6: Upgrading The Ridgeline Server

    SSH. Upgrading the Ridgeline Server From time to time Extreme Networks may choose to release updates to Ridgeline as a Service Pack release. On systems with a previously installed base release of the Ridgeline server, you can upgrade to a service pack release by installing a Ridgeline service pack patch.
  • Page 7: System Requirements

    System Requirements System Requirements The following sections specify the system requirements for installing and running Ridgeline 3.0. Please check the most current version of the Ridgeline Release Notes for any additional or changed requirements for the Ridgeline release you are installing. Windows Vista/XP/2003 Server/2008 Server/Windows 7 The Ridgeline Server.
  • Page 8: Sun Microsystems Solaris 10

    Chapter 1: Installation Overview Sun Microsystems Solaris 10 The Ridgeline Server. The Ridgeline server software, version 3.0, is supported on the Sun Solaris operating environment on SPARC workstations. The system requirements for the server and client are as follows: 2 GB RAM minimum, 4 GB recommended. ●...
  • Page 9: The Ridgeline Client

    Browser Requirements for Launching the Ridgeline Client The Ridgeline client is launched from a browser window. Ridgeline uses signed applets. You will be prompted to accept the security certificate from Extreme Networks the first time you try to launch the applet.
  • Page 10: Upgrading Ridgeline To A Service Pack Release

    Chapter 1: Installation Overview Upgrading Ridgeline to a Service Pack Release From time to time Extreme Networks may elect to release updates to the current Ridgeline release as Service Packs. Service Packs are minor releases that provide fixes for known problems from previous releases.
  • Page 11: Permanent Licenses

    Obtaining a License Key for the Ridgeline Server Your evaluation license key will be sent to you by return email. If your evaluation license expires before you have finished evaluating the product, you can request another evaluation key—up to three evaluation keys for a total of 90 days of evaluation use. Permanent Licenses To obtain a permanent license key, you must provide your activation key, found on the license agreement shipped with your purchased product.
  • Page 12 Chapter 1: Installation Overview Ridgeline Installation and Upgrade Guide...
  • Page 13: Chapter 2: Installing The Ridgeline 3.0 Server

    Installing the Ridgeline 3.0 Server C H A P T E R This chapter describes how to install or upgrade the Ridgeline 3.0 server software in Windows, Solaris, and Linux, and includes the following sections: Installing the Ridgeline Server on page 13 ●...
  • Page 14: User Permissions

    Make certain these patches have been installed before you install the Ridgeline server software. For the most current information on required patches, see the Ridgeline Release Notes that accompanies your Ridgeline software, or go to the Extreme Networks web site at www.extremenetworks.com...
  • Page 15: Server Installation Steps

    To install the Ridgeline server do the following: 1 Download the Ridgeline 3.0 server software for your chosen platform (Windows, Linux or Solaris) from the Extreme Networks software download page, and extract the contents of the zip or tar file into a temporary directory.
  • Page 16 Chapter 2: Installing the Ridgeline 3.0 Server For Linux: a If you downloaded the installation from the web site, change the permissions on the Linux bin file as follows: chmod 755 Ridgeline_3-0_linux32.bin chmod 755 Ridgeline_3-0_linux64.bin (Skip this if you are installing from the CD). b Run the executable , depending Ridgeline_3-0_linux32.bin...
  • Page 17 Installing the Ridgeline Server On Windows systems, if the Ridgeline components were installed as services, select one of the following options: Select Yes to have the installer shut down the Ridgeline services (if they are running), or ● Select No to exit the installation process. ●...
  • Page 18 Chapter 2: Installing the Ridgeline 3.0 Server 7 Verify or enter a location for the Ridgeline installation. By default this is the directory for Windows, or C:\Program Files\Extreme Networks\Ridgeline Service Advisor 3.0 for Linux or Solaris. /opt/ExtremeNetworks/RidgelineServiceAdvisor3.0 You can type a different directory path, or browse to find the directory in which you want to install.
  • Page 19 Networks web site each time you connect the client to the Ridgeline server. If you enable this feature, Ridgeline will connect to the Extreme Networks web site at server start-up and once every 24 hours to obtain a list of the current software releases, and a list of any available Ridgeline patches.
  • Page 20 Chapter 2: Installing the Ridgeline 3.0 Server Figure 5: Settings 10 The next panel asks you to verify the components and installation directory. Click Install to proceed with the installation, and follow the onscreen instructions. Figure 6: Installation Summary Ridgeline Installation and Upgrade Guide...
  • Page 21 Installing the Ridgeline Server The installation process begins. Figure 7: Installation Progress 11 If the installation was successful, the final dialog box displays a summary message. If there were any problems, they will be noted here. Click Finish to continue. Figure 8: Post Installation Summary Ridgeline Installation and Upgrade Guide...
  • Page 22 Chapter 2: Installing the Ridgeline 3.0 Server 12 Click OK to accept the warning messages that displays. The VM tracking feature requires an FTP server running prior to starting Ridgeline. Refer to the “Managing Virtual Machines” chapter in the Ridgeline Reference Guide for more information. Figure 9: VM Tracking Requires an FTP Server Running Warning 13 Ridgeline prompts you to restart your system.
  • Page 23: Adding Or Upgrading A License Key

    To install or upgrade a license, do the following: 1 Run the License Manager: In Windows, from the Start menu, select Start > Programs > Extreme Networks > Ridgeline 3.0 ● > License Manager In Linux or Solaris, go to the Ridgeline installation directory (by default ●...
  • Page 24: Adding A License For An Upgrade Product

    Chapter 2: Installing the Ridgeline 3.0 Server 2 Enter the 14-character license key(s) in the appropriate fields, and click Install License. A pop-up window tells you whether the installation was successful or not. Adding a License for an Upgrade Product When you purchase a product upgrade option such as a 50-node license or an Advanced Services licenses, you receive a separate key to enable Ridgeline to manage additional devices or unlock additional features.
  • Page 25: Stopping The Server On Windows

    Configuring the Ridgeline Server for NATed Client Connections Stopping the Server on Windows To stop the Ridgeline server: 1 Open the Services window (found in Administrative Tools in the Control Panel). 2 Highlight Ridgeline 3.0 Server, right-click and select Stop to stop the Ridgeline server. This should be done while the database is still running.
  • Page 26: Installing Ridgeline On A Multi-Homed Server

    Chapter 2: Installing the Ridgeline 3.0 Server jboss ports 3873, 8080 (default), and 8083, which allow the Ridgeline server to talk to the client ● HTTP port 8334, which allows switches to talk to the Ridgeline server in HTTPs mode ●...
  • Page 27: Configuring A Multi-Homed Server With Separate Management And Client Access Networks

    Installing Ridgeline on a Multi-Homed Server Figure 12: System Variable 7 Restart Windows to activate the new settings. NOTE You can also open a command window and use the SET command from the command prompt to set the EPICENTER_SERVER_ADDRESS environment variable. In Solaris or Linux: 1 Open the file.
  • Page 28: Configuring The Multi-Homed Server With Nat

    Chapter 2: Installing the Ridgeline 3.0 Server 2 Stop the Ridgeline server if it is currently running. See “Starting and Stopping the Ridgeline Server” on page 24 for information about how to do this. 3 Open the file, which resides in , and add the runserver.sp <Ridgeline_install_dir>/jboss/bin...
  • Page 29: Configuring The Multi-Homed Server For Client Access From Both Networks

    Installing a Difference Viewer jboss ports 3873, 8080 (default), and 8083, which allow the Ridgeline server to talk to the client ● HTTP port 8334, which allows switches to talk to the Ridgeline server in HTTPs mode ● FreeRADIUS port 10559 (default) ●...
  • Page 30: The Ridgeline Ssh Enabling Key

    The Ridgeline SSH Enabling Key Ridgeline’s SSH2 capability can be enabled by installing the Ridgeline SSH enabling key. This module must be downloaded from Extreme Networks, as it is subject to export restrictions. It is not provided with the Ridgeline software distribution.
  • Page 31: Uninstalling The Ridgeline Server Software

    1 Shut down the Ridgeline server components if they are still running (see “Stopping the Server on Windows” on page 25 for instructions). 2 Exit all clients. 3 From the Start Menu, select Programs > Extreme Networks > Ridgeline 3.0 > Uninstall to start the uninstall wizard. Ridgeline Installation and Upgrade Guide...
  • Page 32: Uninstalling The Server On Linux Or Solaris

    In Linux, the uninstall Wizard is also available in the Startup menu. Select Others > Uninstall Ridgeline. In Solaris, the Ridgeline uninstall Wizard is also available under Administrative Tools. Select Administrative Tools > Extreme Networks > Ridgeline > Uninstall Ridgeline Ridgeline Installation and Upgrade Guide...
  • Page 33 Uninstalling the Ridgeline Server Software 4 Follow the onscreen instructions to uninstall the software. If you plan to re-install the Ridgeline server, you should restart your system before you attempt to re-install. The Ridgeline software is now completely uninstalled. Ridgeline Installation and Upgrade Guide...
  • Page 34 Chapter 2: Installing the Ridgeline 3.0 Server Ridgeline Installation and Upgrade Guide...
  • Page 35: Chapter 3: Launching The Ridgeline 3.0 Client

    Launching the Ridgeline 3.0 Client C H A P T E R This chapter describes how to connect to the Ridgeline 3.0 server and launch the Ridgeline 3.0 client software, and includes the following sections: About the Client Initialization Process on page 35 ●...
  • Page 36 Chapter 3: Launching the Ridgeline 3.0 Client Solaris 10 ● Red Hat Enterprise Linux Version 5 ● A Ridgeline client requires a monitor that supports 1024 x 768 resolution, and at least 16-bit color. Your system display settings must be set for at least 65536 colors. “System Requirements”...
  • Page 37 Launching the Client Application 3 The Ridgeline Welcome page appears. Figure 14: Ridgeline Welcome Page 4 Click the Log on to Ridgeline link. 5 Ridgeline checks if your system is running the correct version of the Java plug-in. If you are not running the correct version, you are directed to a page where you can download the correct version.
  • Page 38: Disabling Installation Of Desktop Shortcuts

    Chapter 3: Launching the Ridgeline 3.0 Client 7 The Ridgeline Log On screen appears, and you are prompted for a username and password. Figure 15: Ridgeline Log On Screen 8 If this is the first time you are logging in to Ridgeline, enter admin in both the Username field and the Password field.
  • Page 39: Configuring The Firefox Browser For The Java Plug-In

    Configuring the Firefox Browser for the Java Plug-In 4 Change the setting to Never allow. Figure 16: Modifying the Java Shortcut Creation Setting 5 Click OK to apply the setting and close the Java Plug-In control panel. Configuring the Firefox Browser for the Java Plug-In If you plan to use the Mozilla Firefox browser to connect to the Ridgeline server, you must download and install the Java Runtime Environment (JRE) plug-in, and then link it to the Firefox browser.
  • Page 40 Chapter 3: Launching the Ridgeline 3.0 Client After the plug-in is installed, you must configure and enable the JRE to run applets in your browser. You can find the instructions in one of two ways: On the Installation Instructions page, click the “Enable and Configure” link near the top of the page. ●...
  • Page 41: Chapter 4: Upgrading The Ridgeline Software

    Upgrading the Ridgeline Software C H A P T E R This chapter describes how to upgrade the Ridgeline software, and includes the following sections: Ridgeline Software Upgrade Overview on page 41 ● Installing a Service Pack Release on page 42 ●...
  • Page 42: Installing A Service Pack Release

    Installing a Service Pack Release From time to time, Extreme Networks releases updates to the current Ridgeline software as Service Packs. Service Packs are minor releases that provide fixes for known problems from previous releases. A Service Pack is released as a software patch that integrates the Service Pack fixes into an existing Ridgeline installation.
  • Page 43: Installing A Service Pack On Windows Systems

    To install a Ridgeline Service Pack release on a Windows system, follow these steps: 1 Download the Ridgeline Service Pack software from the Extreme Networks software downloads page and extract the contents of the zip file into a temporary directory.
  • Page 44: Uninstalling The Service Pack On Windows Systems

    To install a Ridgeline Service Pack release on a Solaris or Linux system, follow these steps: 1 Download the Ridgeline Service Pack software from the Extreme Networks software downloads page and extract the contents of the file into a temporary directory.
  • Page 45: Uninstalling The Service Pack On Solaris Or Linux Systems

    Installing a Service Pack Release 4 It is recommended that you back up your database. In addition, if the database transaction log, , remains in the top-level Ridgeline installation directory after the Ridgeline server has basecamp.log been shut down, you should save it also. (Under most circumstances is removed basecamp.log when the server stops.)
  • Page 46: Upgrading From Epicenter Or Ridgeline Service Advisor To Ridgeline

    Chapter 4: Upgrading the Ridgeline Software 4 Restart the Ridgeline server and the database engine, if applicable. See “Starting the Server on Linux or Solaris” on page 24 for instructions. Ensure that you clear your browser cache before reconnecting to the Ridgeline server. Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline To upgrade the EPICenter or Ridgeline Service Advisor software to the Ridgeline software do the...
  • Page 47 Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline 3 The Ridgeline InstallShield wizard welcome screen appears. Click Next to continue. Figure 17: InstallShield Wizard Welcome Screen 4 Accept the terms of the license Agreement and click Next to continue. Figure 18: License Agreement Ridgeline Installation and Upgrade Guide...
  • Page 48 Chapter 4: Upgrading the Ridgeline Software 5 Accept the default installation directory or click Browse to select a different location. Click Next to continue. Figure 19: Installation Destination Ridgeline Installation and Upgrade Guide...
  • Page 49 Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline 6 Specify (verify or change) the ports to use for communication between the Ridgeline server and the database (default is 10553), between the server and Ridgeline clients via HTTP (default is 8080), and between the switches and FreeRADIUS server (default is 10559).
  • Page 50 Networks website each time you connect the client to the Ridgeline server. If you enable this feature, Ridgeline will connect to the Extreme Networks web site at server start-up and once every 24 hours to obtain a list of the current software releases, and a list of any available Ridgeline patches.
  • Page 51 Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline 8 Verify the components and installation directory, and click Install to continue. Figure 22: Installation Summary The installation process begins. Figure 23: Installation Progress Ridgeline Installation and Upgrade Guide...
  • Page 52 Chapter 4: Upgrading the Ridgeline Software 9 Select Yes to migrate the database or No to continue without doing so. Click Next to continue. When you install the Ridgeline 3.0 software, the installer automatically detects all supported prior versions of the network management software and prompts you to perform the migration. The supported versions include: EPICenter 6.0 Service Pack 1 and later releases and Ridgeline Service Advisor 2.0 and later releases.
  • Page 53 Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline The InstallShield wizard displays a message when the installation is complete. Click Finish to exit the wizard. Figure 25: Post Installation Summary 10 Click OK to accept the warning messages that displays. The VM tracking feature requires an FTP server running prior to starting Ridgeline.
  • Page 54: Migrating The Database

    Chapter 4: Upgrading the Ridgeline Software 11 Ridgeline prompts you to restart your system. You must either restart your system or start the Ridgeline services manually before a client can connect to the Ridgeline server. Select one and then click Finish to complete the installation process. Figure 27: Reboot 12 Launch the License Manager and install your Ridgeline licenses.
  • Page 55: When Ridgeline And A Previous Version Are Installed On The Same System

    Migrating the Database When Ridgeline and a Previous Version are Installed on the Same System To migrate data from an earlier version of EPICenter or Ridgeline to the latest version of Ridgeline when an older version is installed on the same system as the latest version of Ridgeline, do the following: WARNING! This procedure overwrites any database information that is on the latest version of Ridgeline.
  • Page 56: Exporting Then Importing Data

    Chapter 4: Upgrading the Ridgeline Software Figure 29: Enter Directory Paths of Previous Version and Latest Version 5 Click Migrate. The status screen opens showing the migration progress. See Figure Figure 30: Database Migration Progress 6 Reboot the server. Exporting then Importing Data Migrating data from another server or operating system to a server with Ridgeline installed requires two operations.
  • Page 57 Exporting then Importing Data 4 Enter the URL for the server where the latest version of Ridgeline is installed, for example: http://10.255.25.25:8080/exporter.html The Ridgeline Welcome screen for the Exporter opens. Figure 31: Ridgeline Exporter Welcome Screen 5 Click Launch Exporter. The Opening Exporter.jnlp dialog box opens. See Figure Figure 32: Opening Exporter.jnlp 6 Use the default for: What should Firefox do with this file? Then click OK.
  • Page 58 Chapter 4: Upgrading the Ridgeline Software You are reminded: Please make sure you are running this tool on the server which has the old database. Figure 33: Database Exporter Initial Dialog Box 7 Click Next. The Export database to archive files dialog box opens. See Figure Figure 34: Enter Paths in Database Exporter 8 Enter the directory path of the older version of the product.
  • Page 59: Importing Database Information

    To import database information to the Ridgeline server, do the following: 1 Make sure all Ridgeline servers are stopped. 2 On the Start menu go to Programs>Extreme Networks>Ridgeline>Database Migration Assistant. The Database Migration Assistant dialog box opens. The Database Migration dialog box opens. See Figure 36.
  • Page 60 5 Enter the required information: Import from directory. The directory where the Export folder is located on the exporting server. ● The Ridgeline directory at Program Files>Extreme Networks>Ridgeline directory ● 6 Click Next. The status screen opens showing the migration progress. See...

This manual is also suitable for:

Ridgeline 3.0

Table of Contents