Extreme Networks Ridgeline 3.0, Installation Manual

Page 1: ...nc 3585 Monroe Street Santa Clara California 95051 888 257 3000 408 579 2800 http www extremenetworks com Ridgeline Installation and Upgrade Guide Software Version 3 0 Published February 2011 Part Number 100397 00 Rev 01 ...

Page 2: ... Summit SummitStack Triumph 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 sFlow is the property of InMon Co...

Page 3: ...ocal Name Resolution for the Server 14 Required Patches for Solaris 14 Setting the Run Level for Linux 14 Installation Overview 14 Server Installation Steps 15 Adding or Upgrading a License Key 23 Adding a License for an Upgrade Product 24 Starting and Stopping the Ridgeline Server 24 Starting the Server on Windows 24 Starting the Server on Linux or Solaris 24 Stopping the Server on Windows 25 Sto...

Page 4: ...9 Chapter 4 Upgrading the Ridgeline Software 41 Ridgeline Software Upgrade Overview 41 Installing a Service Pack Release 42 Installing a Service Pack on Windows Systems 43 Uninstalling the Service Pack on Windows Systems 44 Installing a Service Pack on Solaris or Linux Systems 44 Uninstalling the Service Pack on Solaris or Linux Systems 45 Upgrading from EPICenter or Ridgeline Service Advisor to R...

Page 5: ...an be installed on systems running Windows Vista XP Windows 2003 server Windows 2008 server or Windows 7 Ridgeline 32 bit version only on SPARC workstations running Solaris 10 or on systems running Red Hat Enterprise Linux version 5 There are several options for installing the Ridgeline 3 0 software depending on whether you already have versions of Ridgeline installed or whether this is a new Ridg...

Page 6: ...ine to a Service Pack Release on page 10 for details NOTE If you have been running a beta version of the Ridgeline 3 0 software you must uninstall the beta version and do a new install of the final version You cannot upgrade a beta version of the Ridgeline 3 0 software to the general availability GA release of the software The Ridgeline Client The Ridgeline client is an application that is launche...

Page 7: ...GB of swap space 1 GHz or greater Pentium compatible processor 2 GHz or greater recommended The Ridgeline server software requires the 1 6 0_10 Java runtime package which is included in the server installation No separate installation is needed 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 t...

Page 8: ...ient The system requirements for the Ridgeline client on Solaris are as follows A monitor that supports at least 1024 x 768 resolution and 16 bit color Your system display settings must be set for at least 65536 colors 512 MB RAM minimum Up to 1 GB recommended 256 MB disk space available Swap space equal to double the amount of memory For example if you have 512 MB of RAM you should have 1 GB of s...

Page 9: ...lay reports and view the Ridgeline online help 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 NOTE The Java plug in version 1 6 0_10 is required for the Ridgeline client If this versio...

Page 10: ...An evaluation license allows you to run the product on a temporary basis If you want to continue using the product beyond the evaluation period you must obtain a permanent license A permanent license has no time limit Permanent licenses are sold based on the number of devices you want Ridgeline to manage Both permanent and evaluation license keys are 14 character keys that start with RS and are fo...

Page 11: ...ermanent Licenses To obtain a permanent license key you must provide your activation key found on the license agreement shipped with your purchased product To request a permanent key go to www extremenetworks com go ridgelinelicense and select the option to obtain a permanent license key Fill in the requested information and enter your activation key The activation key is a 14 character key that s...

Page 12: ...Chapter 1 Installation Overview Ridgeline Installation and Upgrade Guide 12 ...

Page 13: ... for NATed Client Connections on page 25 Installing Ridgeline on a Multi Homed Server on page 26 Installing a Difference Viewer on page 29 Enabling SSH for Secure Communications on page 29 Uninstalling the Ridgeline Server Software on page 31 Installing the Ridgeline Server The Ridgeline server can be installed in the following environments Microsoft Windows Vista Windows XP Professional with SP1 ...

Page 14: ...en it must be able to resolve both system1 and its domain name such as system1 company com You can test for this by attempting to ping the system using both the local name and the domain name If there are problems resolving either of these names make sure the hosts file contains the correct information Required Patches for Solaris The Solaris operating environment may require patches for the Ridge...

Page 15: ... as the latest Ridgeline patches Start the Ridgeline database and server components manually at system startup in Windows Restart your system to start the Ridgeline database and server After your installation is complete you must run the License Manager to install your Ridgeline license key s Clients will not be able to connect to the Ridgeline server until that is done NOTE Prior to installing Ri...

Page 16: ... on your version of the operating system For Solaris a If you downloaded the installation from the web site change the permissions on the Solaris bin file chmod 755 Ridgeline_3 0_solarisSPARC bin Skip this if you are installing from the CD b Run the executable Ridgeline_3 0_solarisSPARC bin InstallShield will extract the Ridgeline Installation Wizard This may take a few minutes 4 The Ridgeline Ins...

Page 17: ...s if they are running or Select No to exit the installation process Click Next to continue On Solaris Linux systems you must exit the installation process and stop the Ridgeline database and server manually See Stopping the Server on Linux or Solaris on page 25 6 Next the Ridgeline Software license agreement is presented after you read the agreement click the Accept button to accept the agreement ...

Page 18: ...etween the Ridgeline server and the database default is 10553 and between the server and Ridgeline clients via HTTP default is 8080 You can use any port numbers numbers between 1024 and 65535 are recommended except port numbers already in use by another process or ports 514 3873 8083 10550 10554 10555 and 10556 which are used by Ridgeline for internal functions NOTE If you intend to keep multiple ...

Page 19: ...eases and a list of any available Ridgeline patches No information is sent to Extreme Networks except an indication that you are running with an evaluation license if that is the case NOTE If you disable this feature you will not able to obtain software update information through the Software Update feature in the Firmware Manager You can enable this feature at a later time through Ridgeline Admin...

Page 20: ...geline Installation and Upgrade Guide 20 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 ...

Page 21: ...Guide 21 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 ...

Page 22: ...an FTP Server Running Warning 13 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 Click Finish to complete the installation process Figure 10 Reboot 14 Launch the License Manager and install your Ridgeline licenses You can do this at any time after you have installed the Rid...

Page 23: ...ade licenses enable you to manage additional devices 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 opt ExtremeNetworks RidgelineServiceAdvisor3 0 and run instlic bin You must have write permission ...

Page 24: ...u elected not to restart your computer at the end of the installation process then you must start the Ridgeline database and server manually In Windows if you selected the option to start the Ridgeline server components manually then you must start them before running Ridgeline Starting the Server on Windows To start or restart the Ridgeline services manually do the following in the specified orde...

Page 25: ...unning See the previous section for information about how to do this 2 Set the EPICENTER_SERVER_ADDRESS environment variable to the hostname of the Ridgeline server See Setting the EPICENTER_SERVER_ADDRESS Environment Variable on page 26 for information on how to set this variable 3 Open the runserver sp file which resides in Ridgeline_install_dir jboss bin and add the following entry remoting bin...

Page 26: ...st launch the client through a hostname instead of an IP address The EPICENTER_SERVER_ADDRESS environment variable must be set to one of the IP addresses of the server and you must use that IP address to launch the client Setting the EPICENTER_SERVER_ADDRESS Environment Variable When you configure the EPICENTER_SERVER_ADDRESS environment variable the Ridgeline server is available only on this inte...

Page 27: ...e ip_addr_to_bind_to with the IP address to use for communication between the Ridgeline server and the managed devices 7 Start the Ridgeline server to activate the environment variable setting To do this enter the following command etc init d RidgelineServer30 start You must have administrative rights to access init d files Configuring a Multi Homed Server with Separate Management and Client Acces...

Page 28: ... hosts file In Windows the hosts file is c windows system32 drivers etc hosts where c is the drive where Windows is installed In Solaris and Linux the hosts file is etc hosts 8 Start the Ridgeline server as described in Starting and Stopping the Ridgeline Server on page 24 NOTE Configuring the multi homed server in this way is not supported if the server has more than one interface to the manageme...

Page 29: ...as described in Starting and Stopping the Ridgeline Server on page 24 Installing a Difference Viewer Ridgeline provides a Diff feature that allows you to compare configuration files using a Difference Viewer This feature requires that a Difference Viewer be installed on the client system A Difference Viewer can automatically compare and highlight the differences between two files The Diff feature ...

Page 30: ...ces to which you want to communicate using SSH NOTE If the SSH enabling key is not installed in the Ridgeline directory you will not be able to configure SSH in Ridgeline The relevant fields will be grayed out 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 t...

Page 31: ... software see Uninstalling the Service Pack on Windows Systems on page 44 or Uninstalling the Service Pack on Solaris or Linux Systems on page 45 Uninstalling the Server on Windows An Uninstall utility is provided in the Windows Start menu This utility removes all the currently installed components of the Ridgeline server It also removes some of the supporting files and asks about removing certain...

Page 32: ...g See Stopping the Server on Linux or Solaris on page 25 2 Exit all clients 3 Start the uninstall Wizard a Go to the following Ridgeline directory cd install_dir _uninst install_dir is the directory path where you installed the Ridgeline components If you installed in the default directory the path is opt ExtremeNetworks RidgelineServiceAdvisor3 0 b Execute uninstaller bin In Linux the uninstall W...

Page 33: ...stallation and Upgrade Guide 33 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 ...

Page 34: ...Chapter 2 Installing the Ridgeline 3 0 Server Ridgeline Installation and Upgrade Guide 34 ...

Page 35: ...eline server and clicking on a hyperlink The download and installation of the Ridgeline software on the client system takes place automatically Each time you launch the client Ridgeline checks whether you have the most current software version If you do not Ridgeline automatically updates the client files on your system Client initialization using Java Web Start requires that the client system hav...

Page 36: ...he name or IP address of the Ridgeline server to which the client should connect The HTTP port that the client uses to communicate with the server the default is 8080 This is the HTTP port you entered when you installed the Ridgeline server To launch the Ridgeline client do the following 1 Launch your web browser 2 Enter the URL for your Ridgeline server in the form http host port Replace host wit...

Page 37: ... 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 If you are running the correct version of the Java plug in the Ridgeline client software is downloaded from the Ridgeline server and installed on the local system 6 After the software is downloaded you are prompted whether you want to run the app...

Page 38: ...or the online help Disabling Installation of Desktop Shortcuts As part of the Ridgeline client initialization process a shortcut may be installed on your desktop The desktop shortcut allows you to start the client without having to point a browser to the server and clicking the Log on to Ridgeline link Installation of the desktop shortcut assumes that the Java setting for Shortcut Creation is set ...

Page 39: ...erver you must download and install the Java Runtime Environment JRE plug in and then link it to the Firefox browser These are two separate steps Until you do this you will not be able to log into Ridgeline using Firefox To download and install the JRE plug in go to the Sun web site at http www java com en download manual jsp For Windows you can download either the Online or Offline versions For S...

Page 40: ...ge click the Enable and Configure link near the top of the page You can also go directly to these instructions at the following URLs For Windows http www java com en download help 5000010400 xml enable For Linux http www java com en download help 5000010500 xml enable For Solaris http www java com en download help 5000010600 xml enable Follow the instructions to create a symbolic link to the JRE l...

Page 41: ...minor releases that may add new features to Ridgeline as well as provide fixes for known problems from previous releases A Service Pack release is made available as a patch that can be installed over an existing Ridgeline installation If you already have the Ridgeline software installed on your system when a Service Pack is released you can upgrade the software by installing the patch bundle for t...

Page 42: ...already installed 2 Install the Ridgeline Service Pack NOTE It is strongly recommended that you backup your Ridgeline database before installing a Service Pack If you need to uninstall the Service Pack and revert to the previous release for any reason you will need to restore the database as it was prior to the upgrade Table 2 Ridgeline Installation and Upgrade Options Release Type Contents Availa...

Page 43: ...hould save it also Under most circumstances basecamp log is removed when the server stops You should also save the files basecamp db and epicenter db which reside in the Ridgeline_install_dir database data subdirectory as well as any database transaction log files for example basecamp log or epicenter log that reside in this directory NOTE While upgrading to a Service Pack release you may encounte...

Page 44: ...en a command window and run the script uninstall bat as follows prompt cd Ridgeline_install_dir backup service_pack_id uninstaller prompt uninstall bat The service_pack_id identifies the Ridgeline service pack and software build number you are uninstalling for example sp1_32 or sp2_69 This batch file calls a script that will restore backed up files from Ridgeline_install_dir backup service_pack_id...

Page 45: ...ecify the directory name in quotes For example install sh Directory With Spaces Ridgeline3 0 This script file calls a script that will back up Ridgeline files to Ridgeline_install_dir backup 7 Restart the Ridgeline server and the database engine if applicable see Starting the Server on Linux or Solaris on page 24 for instructions Uninstalling the Service Pack on Solaris or Linux Systems NOTE Pleas...

Page 46: ...m will be included 2 Start the installation wizard as follows For Windows run Ridgeline_3 0_win32 exe or Ridgeline_3 0_win64 exe depending on your version of the operating system 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 or chmod 755 Ridgeline_3 0_linux64 bin Skip this if you are inst...

Page 47: ...idgeline Installation and Upgrade Guide 47 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 ...

Page 48: ...ng the Ridgeline Software Ridgeline Installation and Upgrade Guide 48 5 Accept the default installation directory or click Browse to select a different location Click Next to continue Figure 19 Installation Destination ...

Page 49: ...recommended except port numbers already in use by another process or ports 514 3873 8083 10550 10554 10555 and 10556 which are used by Ridgeline for internal functions Click Next to continue NOTE If you intend to keep multiple versions of the Ridgeline server on the same computer to avoid a port conflict each Ridgeline server must be configured to use a unique port number to communicate with the d...

Page 50: ...of any available Ridgeline patches No information is sent to Extreme Networks except an indication that you are running with an evaluation license if that is the case NOTE If you disable this feature you will not able to obtain software update information through the Software Update feature in the Firmware Manager You can enable this feature at a later time through Ridgeline Administration Server ...

Page 51: ...ice Advisor to Ridgeline Ridgeline Installation and Upgrade Guide 51 8 Verify the components and installation directory and click Install to continue Figure 22 Installation Summary The installation process begins Figure 23 Installation Progress ...

Page 52: ...it version of EPICenter to the 64 bit version of Ridgeline 3 0 are not allowed If you have one of the supported versions of software installed you can migrate your database and other persistent data to the new installation of Ridgeline as part of the upgrade process Migrating the database does not affect your previous installation the old database is left intact and functional On Windows systems t...

Page 53: ...s 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 Refer to the Managing Virtual Machines chapter in the Ridgeline Reference Guide for more information Figure 26 VM Tracking Requires an FTP Server Running Warning ...

Page 54: ...n be running while you do this but this is not required See Adding or Upgrading a License Key on page 23 for more detailed instructions Migrating the Database You can migrate the database as part of the standard software installation procedure as shown in Figure 24 on page 52 or manually using the procedure described in this section NOTE You must reconfigure multi homed configurations manually aft...

Page 55: ... you use Ridgeline 1 Stop the Ridgeline and database services after it is installed on your server 2 Start the Database Migration Assistant 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 migratetool bin c The Database Migration Assistant dialog box opens Se...

Page 56: ...uires two operations First you must export the data from the server where the previous version of the application is installed then import the data on to the server where the latest version of Ridgeline is installed Exporting Database Information To export data for migration to Ridgeline on a different server or to Ridgeline on a different operating system do the following 1 Start Ridgeline servic...

Page 57: ...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 32 Figure 32 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 See Figure 33 ...

Page 58: ...t The old product version is shown 9 Enter the directory path where you are migrating the database to 10 Enter the server IP address or hostname where the new version of Ridgeline is installed 11 Enter the database port The default database port is 10553 12 Click Export The status screen opens showing the export progress See Figure 35 When the process completes a folder named export is created tha...

Page 59: ...the latest version of Ridgeline We recommend that you perform this pro cu du re before you use Ridgeline 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 op...

Page 60: ...7 Figure 37 Import Archived Database Files 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 Figure 38 Figure 38 Import Migration Progress and Results 7 Reboot the server ...