Ridgeline Installation and Upgrade Guide Software Version 3.1 Extreme Networks, Inc. 3585 Monroe Street Santa Clara, California 95051 (888) 257-3000 (408) 579-2800 http://www.extremenetworks.com Published: October 2011 Part Number: 100397-00 Rev. 02...
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.
Installing a Permanent License When an Evaluation License is Already Installed..........12 Chapter 2: Downloading Ridgeline Software..................13 Overview ................................13 Determining Device Serial Numbers ........................14 Providing Serial Numbers to Extreme Networks eSupport..................16 Chapter 3: Installing the Ridgeline 3.1 Server ..................19 Installation Overview ..............................19 Retaining the Database when Reinstalling Ridgeline..................20 User Permissions ............................20...
Page 4
Contents Ridgeline Installation Complete........................38 Windows System Restart ..........................39 Viewing Installation Logs..........................39 Launching the License Manager ........................40 Adding or Upgrading a License Key ........................40 Adding a License for an Upgrade Product ......................41 Starting and Stopping the Ridgeline Server ......................41 Starting the Server on Windows........................42 Stopping the Server on Windows ........................42 Linux and Solaris Command Summary......................42 Starting the Server on Linux or Solaris ......................43...
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.
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.
System Requirements There is no separate installation package for the Ridgeline client. When you connect to the Ridgeline server with a browser and launch the Ridgeline client, all required files are downloaded and installed on your system automatically. No license is needed to run the Ridgeline client; however, the Ridgeline server must have a valid license installed before any client connections are allowed.
Chapter 1: Installation Overview NOTE Additional disk space may be needed to hold alarm logs and other runtime data. The amount of space depends on the number of devices and the number of traps and syslog messages generated by the managed devices.
System Requirements NOTE Additional disk space may be needed to hold alarm logs and other runtime data. The amount of space depends on the number of devices and the number of traps and syslog messages generated by the managed devices. The system requirements for the Ridgeline client on Solaris are as follows: 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.
For more information about the various types of software licenses available for Ridgeline, refer to the Ridgeline Release Notes. You can get two types of licenses from Extreme Networks, an evaluation license and a permanent license at .
Chapter 1: Installation Overview To get an evaluation license: 1 Go to: www.extremenetworks.com/go/ridgelinelicense 2 Select the option to obtain an evaluation license key. 3 Enter your name, company information, and similar information, and an email address to which your license key should be sent. Your evaluation license key will be sent to you by return email.
Using the Ridgeline Firmware Manager, you can download software and BootROM images from Extreme Networks to your Ridgeline server, then upgrade the devices in your network with the new images. To download new images from Extreme, you must have a current support contract and an Extreme Networks eSupport user name and password.
Figure 1: Progress and Results Window Showing Unsuccessful Image Download To obtain the new images, you must determine the serial numbers for the type of device you want to upgrade, then supply those serial numbers to Extreme Networks eSupport. Refer to “Determining Device Serial Numbers”...
Page 15
Determining Device Serial Numbers You can also display the serial numbers of devices in your network by running a Device Details report in Ridgeline. For example: Figure 3: Device Details Report Ridgeline Installation and Upgrade Guide...
Figure 4: All Cards Card Summary Report Providing Serial Numbers to Extreme Networks eSupport To provide serial numbers to Extreme Networks eSupport, complete the following steps: 1 Go to www.extremenetworks.com and log into the eSupport page with your eSupport user ID and password.
Page 17
Providing Serial Numbers to Extreme Networks eSupport Figure 6: Download Software Updates Link on eSupport Page 3 In the Serial # box, enter the serial number of the device or module, and click Software Downloads. NOTE For chassis devices, you must provide the serial number of a Management Module or I/O Module.
Page 18
Chapter 2: Downloading Ridgeline Software A table of the software versions available for the device is displayed. If the device is under a service contract, all software versions are displayed; otherwise, only software versions available for the 90-day warranty period are displayed. For example: Figure 9: List of Available Software Versions for a Device 5 In the Ridgeline Firmware Manager, select one of the software versions listed in the eSupport table.
Installing the Ridgeline 3.1 Server C H A P T E R This chapter describes how to install or upgrade the Ridgeline 3.1 server software in Windows, Solaris, and Linux, and includes the following sections: CAUTION If you are running an evaluation version of the Ridgeline 3.1 software, and you want to retain the information in your Ridgeline database, DO NOT REINSTALL the Ridgeline software to upgrade to a permanent license.
Chapter 3: Installing the Ridgeline 3.1 Server NOTE This release, Ridgeline 3.1 will be the last release that supports Solaris The installation process is very similar under all three operating environments; the few differences are noted in the description of the process when applicable. “System Requirements”...
To install the Ridgeline server, complete the following steps: 1 Download the Ridgeline software from the Extreme Networks eSupport software download page. 2 Extract the contents of the zip or tar file into a temporary directory, if necessary. For information about downloading the software, refer to Chapter 2, “Downloading Ridgeline Software.”...
Page 22
Chapter 3: Installing the Ridgeline 3.1 Server 4 The Ridgeline Software license agreement opens. After you read the agreement, click Accept to consent then click Next to proceed. Figure 12: License Agreement Figure 13: Solaris Non-Support Notice Ridgeline Installation and Upgrade Guide...
Installing the Ridgeline Server When Ridgeline Detects Other Versions of Ridgeline If Ridgeline detects Ridgeline 3.1 is already installed, you are instructed to uninstall it before reinstalling Ridgeline 3.1 again. Figure 14: Ridgeline 3.1 is Already Installed If Ridgeline detects an older version of Ridgeline or EPICenter, the previous versions are listed, along with their installed location.
Page 24
Chapter 3: Installing the Ridgeline 3.1 Server Figure 15: Other Ridgeline or EPICenter Services are Running Click Next to continue the installation. Ridgeline Installation and Upgrade Guide...
Installing the Ridgeline Server If Ridgeline does not Support a Platform If Ridgeline detects a platform it does not support, the Platform not supported dialog opens. See Figure Figure 16: Platform Not Supported Ridgeline Installation and Upgrade Guide...
● proceeds to “Software Installation” on page 31.The default installation directories are: \Program Files\Extreme Networks\Ridgeline 3.1 for Windows, or for Linux or Solaris. /opt/ExtremeNetworks/Ridgeline3.1 If you choose Custom settings, a sequence of dialogs open, starting with the directory path for ●...
Page 27
Installing the Ridgeline Server 1 To set up a custom directory, type the directory path, or browse to find the directory where you want to install Ridgeline. See Figure Figure 18: Installation Destination 2 Click Next to continue. Or, click Restore Default Folder to reset the installation path to the default. Ridgeline Installation and Upgrade Guide...
Chapter 3: Installing the Ridgeline 3.1 Server Starting Windows Services To start services automatically when Windows starts, check the box. This is the default. To start services manually, click the check mark to remove it. Figure 19: Windows Services Startup Ridgeline Installation and Upgrade Guide...
Installing the Ridgeline Server Setting IP Address The Ridgeline server provides several options for IP communications with Ridgeline clients and network devices, as shown in Figure Figure 20: Setting IP Address 1 Choose the desired IP Address option: Use this IP address to launch the clients and to talk to the network devices. ●...
Chapter 3: Installing the Ridgeline 3.1 Server Automatic Updates to Ridgeline Ridgeline automatically searches for updates and installs them on the server. Default Ports Already in Use Ridgeline automatically installs the server software on specified ports: • 3873 • 8009 •...
Installing the Ridgeline Server Software Installation 1 After you have specified all installation options, and optionally migrated the previous database, the Pre-installation Summary opens. Figure 22: Pre-installation Summary For Windows Figure 23: Pre-installation Summary For Linux 2 Click Install. The installation process begins. Ridgeline Installation and Upgrade Guide...
Chapter 3: Installing the Ridgeline 3.1 Server NOTE Ridgeline automatically stops the services for the server and database engine See “Stopping the Server on Linux or Solaris” on page 43 for manual shutdown instructions. The following dialog shows the installation progress. Figure 24: Installation Progress Database Migration If Ridgeline detects an older version installed on the server, gives you a choice to migrate the previous...
Page 33
Installing the Ridgeline Server “Migrating the Database” on page 67. for detailed instructions to migrate a database after the Ridgeline is installed. 1 Choose Yes to migrate the previous database, or No to continue without migrating. If you choose No, the installer skips to “Software Installation Successful”...
Page 34
Chapter 3: Installing the Ridgeline 3.1 Server 3 Choose the Migrate option to have the Wizard migrate the database automatically, or the Import option if you want to use database files previously archived. This procedure demonstrates the Migrate option. Click Next to continue. Figure 26: Database Migration Options 4 Verify the locations of the previous and current Ridgeline installations and click Migrate to continue.
Page 35
Installing the Ridgeline Server Figure 28: Database Migration Assistant Progress 5 When migration is 100% complete, click Close. The successful migration dialog is then displayed. Additional information about the previous installation is displayed, along with any special instructions. Figure 29: Database Migration Success 6 Record any onscreen instructions and click Next to complete the migration.
Chapter 3: Installing the Ridgeline 3.1 Server Figure 30: Database Migration Notice Software Installation Successful When the software installation is complete, the following dialog is displayed. Figure 31: Installation Successful Click Next to continue. Ridgeline Installation and Upgrade Guide...
Installing the Ridgeline Server FTP Server for VM Tracking The following dialog can inform you that VM tracking requires an FTP server to be up and running if you use this feature. Click Next. Figure 32: FTP Server for VM Tracking Reminder 1 Be sure the FTP server is started.
Chapter 3: Installing the Ridgeline 3.1 Server Ridgeline Installation Complete A dialog opens that informs you that the installation is complete and shows the path where Ridgeline is installed. For Windows, it prompts you to restart your system. You must restart your system before a client can connect to the Ridgeline server.
Installing the Ridgeline Server Windows System Restart For Windows installations, choose to restart your system immediately, or to manually restart your system later. The default is to restart your system immediately. Click Done. Figure 34: Restart System Viewing Installation Logs After the installation is complete, details about the installation process are in log files in the following locations: Windows: <installed directory>\Logs...
To install or upgrade a license, complete the following steps: 1 Run the License Manager: In Windows, from the Start menu, select Start > Programs > Extreme Networks > Ridgeline 3.1 ● > License Manager On Linux or Solaris, go to the Ridgeline installation directory and run LicenseManager. By ●...
Starting and Stopping the Ridgeline Server The License Manager window opens: Figure 35: License Key Manager 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...
Chapter 3: Installing the Ridgeline 3.1 Server Starting the Server on Windows To start or restart the Ridgeline services manually, do the following in the specified order: 1 Open the Services window (found under Administrative Tools in the Control Panel). 2 Highlight Ridgeline 3.1 Database Engine, right-click and select Start from the pop-up menu to start the Ridgeline database.
Configuring the Ridgeline Server for NATed Client Connections Starting the Server on Linux or Solaris To start or restart the Ridgeline daemons manually, complete the following steps: Enter the following commands in the order shown: ● /etc/init.d/RidgelineDB31 start /etc/init.d/RidgelineServer31 start /etc/init.d/RidgelineFreeRadius31 start You must have administrative rights to access init.d files.
2 Start the Ridgeline Server Setup Utility: On a Windows system, from the Start menu go to: ● Programs > Extreme Networks > Ridgeline3.1 > Server Setup Utility On Linux, the server setup utility from symbolic link is in /root/ExtremeNetworks/ ●...
Page 45
Installing Ridgeline on a Multi-Homed Server Figure 36: Ridgeline Server Setup Utility 3 Choose one of the setup options: Use this IP address to launch the clients and to talk to the network devices. This selection is not relevant for a multi-homed system, because it only specifies a single interface for all communications.
The Ridgeline SSH enabling key must be installed. Due to export restrictions, you must obtain this ● module from Extreme Networks. It is not included with the Ridgeline software distribution. Your switches must be running versions of ExtremeWare or ExtremeXOS that support SSH, and SSH ●...
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 48
Chapter 3: Installing the Ridgeline 3.1 Server 3 From the Start Menu, go to Programs > Extreme Networks > Ridgeline 3.1 > Uninstall to start the uninstall wizard. This dialog informs you that this process will remove Ridgeline. Figure 37: Uninstall Wizard 4 Click Next.
Page 49
Uninstalling the Ridgeline Server Software Figure 38: Uninstall Options 5 Click Uninstall. The uninstall process begins and the next dialog shows the progress. Ridgeline Installation and Upgrade Guide...
Page 50
Chapter 3: Installing the Ridgeline 3.1 Server Figure 39: Uninstall Progress 6 When the process completes, the dialog informs you that the uninstall was successful. You can choose to restart your system immediately or manually restart the system at a later time. 7 Select your choice, then click Done to close the wizard.
Page 51
Uninstalling the Ridgeline Server Software Figure 40: Ridgeline Uninstall Successful 8 If the uninstall process cannot remove Ridgeline items. The dialog lists these. Choose a restart option. 9 Click Done to close the wizard. Figure 41: Items Were Not Removed Ridgeline Installation and Upgrade Guide...
Uninstall Ridgeline 3.1. On Solaris, the Ridgeline uninstall Wizard is also available under Administrative Tools. Select Administrative Tools > Extreme Networks > Ridgeline > Uninstall Ridgeline 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.
Launching the Ridgeline 3.1 Client C H A P T E R This chapter describes how to connect to the Ridgeline 3.1 server and launch the Ridgeline 3.1 client software, and includes the following sections: About the Client Initialization Process on page 53 ●...
Page 54
Chapter 4: Launching the Ridgeline 3.1 Client Solaris 10 ● NOTE This release, Ridgeline 3.1 will be the last release that supports Solaris. 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.
Page 55
Launching the Client Application 3 The Ridgeline Welcome page appears. Figure 42: 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.
Chapter 4: Launching the Ridgeline 3.1 Client 8 The Ridgeline Log On screen appears, and you are prompted for a username and password. Figure 43: Ridgeline Log On Screen 9 If this is the first time you are logging in to Ridgeline, enter admin in both the Username field and the Password field.
Configuring the Firefox Browser for the Java Plug-In 4 Change the setting to Never allow. Figure 44: 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 58
Chapter 4: Launching the Ridgeline 3.1 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. ●...
Base installation. To upgrade to a new software release install the new version of the software by ● downloading the it from the Extreme Networks web site. As long as you install the software into a different directory, the two versions can co-exist. See “If...
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.
“Stopping the Server on Linux or Solaris” on page 43 for instructions. 3 To start the installation wizard, go to the Start > All Programs > Extreme Networks >Ridgeline 3.1. Ridgeline checks the system for a Ridgeline software version. If it does not detect Ridgeline on your system the Cannot find any Ridgeline Installation dialog opens.
Page 62
Chapter 5: Upgrading the Ridgeline Software Figure 45: Ridgeline SP Introduction 5 Click Next. The dialog opens to inform you that the Ridgeline service will be stopped. Figure 46: Stopping Ridgeline Ridgeline Installation and Upgrade Guide...
Solaris” on page 43 for instructions). 2 Exit all clients. 3 From the Start Menu, select Programs > Extreme Networks > Ridgeline 3.1 > Uninstall SP to start the uninstall wizard. Then uninstall Ridgeline SP wizard opens. Ridgeline Installation and Upgrade Guide...
Page 64
Chapter 5: Upgrading the Ridgeline Software Figure 48: Ridgeline About Uninstall 4 Click Uninstall. When the uninstall process is complete, the dialog confirms that the uninstall was successful. 5 Click Done to close the wizard. Figure 49: Uninstall Complete Ridgeline Installation and Upgrade Guide...
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.
Chapter 5: Upgrading the Ridgeline Software been shut down, you should save it also. (Under most circumstances is removed basecamp.log when the server stops.) You should also save the files , which reside in the basecamp.db epicenter.db /database/data subdirectory under the Ridgeline installation directory, as well as any database transaction log files (for example, ) that reside in this directory.
Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline Upgrading from EPICenter or Ridgeline Service Advisor to Ridgeline To upgrade the EPICenter or Ridgeline Service Advisor software to the Ridgeline software, follow the procedure “Installing the Ridgeline Server” on page 21.
Page 68
Chapter 5: Upgrading the Ridgeline Software a On a Windows system, from the Start menu go to: Programs > Extreme Networks > Ridgeline > Database Migration Assistant b On a Solaris/Linux system, go to: <Ridgeline Installed Directory>/database/bin and launch migrateTool. On Linux, you can also launch this utility from the symbolic link at /root/Database Migration Assistant The Database Migration Assistant dialog box opens.
Migrating the Database Figure 53: Database Migration Progress and Results 6 Reboot the server. Migrating the Database from Another Server or Operating System to a Server with Ridgeline Installed Migrating a database from another server or operating system to a server with Ridgeline installed requires two operations.
Page 70
Chapter 5: Upgrading the Ridgeline Software The Ridgeline Welcome screen for the Exporter opens. Figure 54: Ridgeline Exporter Welcome Screen 5 Click Launch Exporter. The Opening Exporter.jnlp dialog box opens. See Figure Figure 55: Opening Exporter.jnlp 6 Use the default for: What should Firefox do with this file? Then click OK. The Database Exporter dialog opens which identifies the tool.
Page 71
Migrating the Database Figure 56: Database Exporter Initial Dialog Box 7 Click Next. The Database Exporter dialog box opens where you can browse to select the installed path of the old product directory and browse to select the export directory. See Figure Figure 57: Enter Paths in Database Exporter 8 Enter the server IP address or hostname where the new version of Ridgeline is installed.
To import a database to the Ridgeline server, complete the following steps: 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.
Page 73
Migrating the Database Figure 60: Database Migration Assistant Import Database 3 Choose: Import archived database files into Ridgeline. 4 Click Next. The dialog box opens where you enter the import information for the Ridgeline server. Figure Figure 61: Import Archived Database Files 5 Browse to select the import directory, which is the directory where the export folder containing the old product version is located on the exporting server.
Page 74
Chapter 5: Upgrading the Ridgeline Software Figure 62: Import Migration Progress and Results 7 Reboot the server. Ridgeline Installation and Upgrade Guide...