Installation Guide for FTMS and Node Manager

Transcription

1 Installation Guide for FTMS and Node Manager Table of Contents Windows... 2 Installing FTMS... 2 Launching FTMS... 2 Client... 3 Stopping FTMS Server... 3 Installing Standalone Node Manager... 3 Launching Standalone Node Manager... 4 Linux... 4 Installing FTMS... 4 Launching FTMS... 5 Client... 6 Stopping FTMS Server... 6 Installing Standalone Node Manager... 6 Launching Standalone Node Manager... 7 Solaris... 7 Installing FTMS... 7 Launching FTMS Client Stopping FTMS Server Installing Standalone Node Manager Launching Standalone Node Manager Note on license keys: FTMS requires that you enter a license key on first launch. The license key determines the number of nodes that you have permission to manage. If the license key is not included on the product CD-ROM, download it from the Force10 Networks website, as described on the printed Certificate of Purchase included with the product CD-ROM. Upgrading FTMS: FTMS and above can install over older versions of FTMS. However, as a best practice, Force10 recommends that you remove earlier versions. To do that, double-click the Uninstall FTMS icon on the desktop (or from the Programs menu), and then reboot your system when instructed. Verify that all FTMS program icons and files in the FTMS home directory are removed before installing FTMS 1.4. Check the FTMS Caveats and FTMS FAQ for notes about cleaning up related databases and removing related files. Similarly, you would use the Uninstall FTMS Application Client icon when replacing earlier versions of that application. In any case, after installing, you must reinitialize the FTMS database. Launch the Reinitialize Server option in the Start menu (or double-click the icon in the FTMS Server folder). Alternatively, invoke the appropriate command: Windows: Invoke <FTMSHome>/bin/reinitialize_nms.bat. Linux/Solaris: Invoke <FTMSHome>/bin/reinitialize_nms.sh. Overview of FTMS installation program: The program presents you with a series of dialog boxes that prompt you for information about your installation. Read the information in these dialog boxes Installation Guide (FTMS and Node Manager) 1

2 carefully. You move through the installation by clicking the Next and Previous buttons; the Cancel button terminates the installation. Windows Installing FTMS Note for Microsoft Windows Server 2003: Before installing FTMS, you must set the Compatibility Mode to Windows XP on the FTMS install.exe. Right-click on the file, and select Properties. Select the Compatibility Tab. 1. Execute install.exe to launch the installation program and the installation Introduction dialog box. 2. Choose Install Folder: Select the destination folder for the FTMS installation. By default, FTMS is installed in C:\force10\FTMS. To install FTMS in another directory, click Choose. 3. Choose Shortcut Folder: Select the radio button of the location where you want FTMS program options to appear. 4. Choose the type of installation: Select Full (Client and Server) installation or Client installation, depending on the user requirement. 5. Install As Windows Service: Determine if you want FTMS Server to run as a Windows service, that is, to have FTMS run in the background. The default is No. 6. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Click Install to install FTMS. The installation dialog box provides a status meter as the installation proceeds. 7. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Launching FTMS This version of FTMS requires a default User ID, password, and license key to launch FTMS. All of these elements, except the license key file, are provided in this version. The License key file is provided by Force10 upon request. Launch FTMS from the shortcut icon selected in Step 3 above. Server: 1. Click the Start Server shortcut icon. The License Agreement dialog box appears. (This is only for the first run of FTMS.) 2. Click Accept in the License Agreement dialog box. (This step is only for the first run of FTMS.) 3. Click Browse in the License Key dialog box, navigate to the license key file, and enter the license key supplied by Force10 Networks, Inc. (This step is only for the first run of FTMS.) 4. FTMS launches a Start Server process screen and an Apache process screen. Installation Guide (FTMS and Node Manager) 2

3 5. Bring the Start Server screen forward to view the FTMS Server Modules running process. The message appears when the process is complete: Verifying connection with web server verified FTMS Server modules started successfully Please connect your client to the web server on port: Minimize both the Start Server screen and the Apache screen. Client The two types of clients supported by FTMS are the Application Client and the browser-based HTML Client. Login Note: When you first log in to either of the clients, you are required to enter the default ID and password of root and public. You are then required to change at least the password. Anytime you change the password, the change is for both clients. SNMP Note: You must enable SNMP on any switch that you want FTMS to manage or to display on the device map. For details on enabling SNMP, see the configuration guide for the switch or see the Installation chapter in the Force10 Node Manager Guide. Application Client: 1. Click the Start Application Client shortcut icon. 2. Enter the User ID and password in the FTMS Authentication dialog box and click Connect. 3. FTMS launches another process window and a log window (which you can minimize). Then the main FTMS window launches. Browser-based HTML Client: 1. Start your Web browser and connect to server name/ip address>:9090 An HTML page with HTML UI and Java UI buttons appears in the browser. 2. Enter the username/password and click on HTML UI. Note: If the Web client does not work on Internet Explorer, make sure that the Security Level is set to Medium or lower. You can find the setting in Tools -> Internet Options -> Security tab. Stopping FTMS Server 1. Click the Stop Server icon. 2. When the authentication window is launched, give the user name and password as "root" and "public". Installing Standalone Node Manager 1. Execute install.exe to launch the installation program and the installation introduction dialog box. 2. Choose Install Folder: Select the destination folder for the Node Manager installation. By default, Node Manager is installed in C:\force10\NodeManager. To install Node Manager in another directory, click Choose. Installation Guide (FTMS and Node Manager) 3

4 3. Choose Shortcut Folder: Select the radio buttons where you want the Node Manager shortcut icons to appear. 4. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Click Install to install Node Manager. 5. Installing : The installation dialog box provides a status meter as the installation proceeds. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Launching Standalone Node Manager This version of Node Manager requires an E-Series chassis IP address and SNMP read community string to launch the Node Manager. The Node Manager graphic user interface (GUI) cannot be displayed without connecting an E-Series or S-Series device. Launch Node Manager from the shortcut icon selected above. 1. Click the Start Node Manager shortcut icon. Node Manager launches a Start Node Manager screen and a Java login screen. 2. Enter the E-Series chassis IP address and SNMP read community string in the Node Manager authentication dialog box and click OK. The default is: Chassis IP Address: <E-Series manager port IP address> SNMP Read Community String: public The Node Manager main window launches. Linux Installing FTMS 1. Stop the MySQL daemon if it is running. This can be checked using ps -ax grep -i mysql. 2. Log in as root. Set the executable permissions for install.bin file and execute the command./install.bin to launch the installation program and the installation Introduction dialog box. 3. Choose Install Folder: Select the destination folder for the FTMS installation. By default, FTMS is installed in /FTMS. To install FTMS in another directory, click Choose. 4. Choose Shortcut Folder: Select the radio buttons where you want FTMS shortcut icons to appear. 5. Choose the type of installation: Select Full (Client and Server) installation or Client installation, depending on the user requirement. 6. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Installation Guide (FTMS and Node Manager) 4

5 Click the Install button to install FTMS. Installing : The installation dialog box provides a status meter as the installation proceeds. 7. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Launching FTMS This version of FTMS requires a default User ID, password, and license key to launch FTMS. All of these elements, except the license key file, are provided in this version. The license key file is provided by Force10 upon request. Launch FTMS from the shortcut icon selected above. Server: Configuring FTMS to use MYSQL bundled with FTMS 1. Create a link from /usr/bin/mysqladmin to FTMS mysql as shown below (log in as root): cd /usr/bin rm -f mysqladmin (deleting the previously existing link) ln -s <FTMS_HOME>/mysql/bin/mysqladmin 2. In <FTMS_HOME>/apache/bin, execute ldd httpd to find out the dependencies of the httpd file. If libdb-3.2.so is not found in the output of the ldd command, then follow the procedure, below: Download the file compat-db i386.rpm from Log in as root and install the rpm file using this command: rpm -ivh --nodeps compat-db i386.rpm 3. Make sure that my.cnf file is not present in the following directories. /etc /usr/local/mysql/var /home/<ftms user home> 4. Start the MySQL daemon using the command below: In <FTMS_HOME>/bin, execute the./startmysql.sh file. 5. In <FTMS_HOME>/bin, execute the./startnms file. 6. If the License Agreement dialog box appears (this is only for the first run of FTMS), click Accept. 7. Click Browse in the License Key dialog box, and navigate to the license key file. Enter the license key supplied by Force10 Networks. 8. FTMS launches a Server process. Bring the Server screen forward to view the FTMS Server Modules status. When the process is complete, you are notified by the message: Verifying connection with web server verified FTMS Server modules started successfully Please connect your client to the web server on port: 9090 Configuring FTMS to use MYSQL bundled with Linux: 1. Create a user in mysql database with username/password as ftms/f10ftms. 2. Start the mysql daemon. 3. In <FTMS_HOME>/bin, execute the./startnms file. Installation Guide (FTMS and Node Manager) 5

6 4. If the License Agreement dialog box appears (this is only for the first run of FTMS), click Accept. 5. Click Browse in the License Key dialog box, navigate to the license key file, and enter the license key supplied by Force10 Networks. 6. FTMS launches a Server process. Bring the Server screen forward to view the FTMS Server Modules status. When the process is complete, you are notified by the message: Client Verifying connection with web server verified FTMS Server modules started successfully Please connect your client to the web server on port: 9090 The two types of clients supported by FTMS are the Application Client and browser-based HTML Client. Login Note: When you first log in to either of the clients, you are required to enter the default ID and password of root and public. You are then required to change at least the password. Anytime you change the password, the change is for both clients. SNMP Note: You must enable SNMP on any switch that you want FTMS to manage or to display on the device map. For details on enabling SNMP, see the configuration guide for the switch or see the Installation chapter in the Force10 Node Manager Guide. Application Client: 1. In <FTMS_HOME>/bin, execute the./startapplicationclient.sh file. 2. Enter the User ID and Password in the FTMS Authentication dialog box and click Connect. 3. FTMS launches another process window and a log window (which you can minimize), and then the main FTMS window launches. Browser-based HTML Client: 1. Start the browser and connect to server name/ip address>:9090 An HTML page with HTML UI and Java UI buttons appears in the browser. 2. Enter your username/password and click on HTML UI. Stopping FTMS Server 1. In <FTMS_HOME>/bin, execute./stopnms.sh. 2. When the authentication window is launched, give the user name and password as root/public. 3. In <FTMS_HOME>/bin, execute./stopmysql.sh. Installing Standalone Node Manager Before beginning the installation, check for the latest Node Manager software from the Force10 Networks, Inc. website. 1. Set the executable permission for install.bin and execute./install.bin file to launch the installation program and the installation introduction dialog box. 2. Choose the Install Folder: Select the destination folder for the Node Manager installation. By default, Node Manager is installed in /home/<user name>nodemanager. To install Node Manager in another directory, click Choose. Installation Guide (FTMS and Node Manager) 6

7 3. Choose the Shortcut Folder: Select the radio buttons where you want Node Manager shortcut icons to appear. 4. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Click Install to install Node Manager. Installing : The installation dialog box provides a status meter as the installation proceeds. 5. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Launching Standalone Node Manager This version of Node Manager requires an E-Series chassis IP address and SNMP read community string to launch the Node Manager. The Node Manager graphic user interface cannot be displayed without connecting a real E-Series or S-Series device. Launch the Node Manager from the shortcut icon selected above: 1. Click the Start Node Manager shortcut icon. If a shortcut was not chosen during installation, go to <NodeManager_HOME>/bin and execute the./startchassisview.sh file. Node manager launches a Start Node Manager screen and a Java login screen. 2. Enter the E-Series chassis IP address and SNMP read community string in the Node Manager authentication dialog box and click OK. The default is: Chassis IP Address: <E-Series manager port IP address> SNMP Read Community String: public The Node Manager main window launches. Solaris Installing FTMS 1. Stop the MySQL daemon if it is running. This can be checked using ps -ef grep -i mysql. 2. Log in as root user. Set the executable permissions for install.bin file. Execute the command./install.bin to launch the installation program. 3. Choose Install Folder: In the installation Introduction dialog box, select the destination folder for the FTMS installation. By default, FTMS is installed in /home/<username>/ftms. To install FTMS in another directory, click Choose. 4. Choose Shortcut Folder: Select the radio buttons where you want FTMS shortcut icons to appear. 5. Choose the type of installation: Select Full (Client and Server) installation or Client installation depending on the user requirement. Installation Guide (FTMS and Node Manager) 7

8 6. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Click the Install button to install FTMS. Installing : The installation dialog box provides a status meter as the installation proceeds. 7. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Requirements 1. Packages The following are the prerequisites for running FTMS Server on Solaris. FTMS uses Apache as the Web server. The Apache binary, which comes bundled with our product, requires certain shared objects. This binary is built for Solaris 8 and 9. For FTMS to work on Solaris 7, build Apache as explained in the 3rd section, Building and Installing Apache The following libraries are not part of the core Solaris package and are required by httpd for Solaris 8 and 9: libdb-4.1.so => /usr/local/lib/libdb-4.1.so libiconv.so.2 => /usr/local/lib/libiconv.so.2 libsendfile.so.1 => /usr/lib/libsendfile.so.1 If these files are missing, install them using the procedure in the Installation of Dependencies section and set the LD_LIBRARY_PATH variable. You can check for the presence of the above libraries using the ldd command, as shown below. cd <FTMS_HOME> Set the Environment using the following command: $../setenv.sh cd <FTMS_HOME>/apache/bin Make sure that LD_LIBRARY_PATH is set if any of these packages is already installed in the system. $ldd httpd libaprutil-0.so.0 => libdb-4.1.so => libexpat.so.0 => libiconv.so.2 => libapr-0.so.0 => libsendfile.so.1 librt.so.1 => libm.so.1 => /FTMS/apache/lib/libaprutil-0.so.0 /usr/local/lib/libdb-4.1.so (If this file does not exist, not found will be displayed here.) /FTMS/apache/lib/libexpat.so.0 /usr/local/lib/libiconv.so.2 (If this file does not exist, not found will be displayed here.) /FTMS/apache/lib/libapr-0.so.0 /usr/lib/libsendfile.so.1 (If this file does not exist, not found will be displayed here.) /usr/lib/librt.so.1 /usr/lib/libm.so.1 Installation Guide (FTMS and Node Manager) 8

9 libsocket.so.1 => libnsl.so.1 => libresolv.so.2 => libdl.so.1 => libpthread.so.1 => libc.so.1 => libaio.so.1 => libmp.so.2 => libthread.so.1 => /usr/lib/libsocket.so.1 /usr/lib/libnsl.so.1 /usr/lib/libresolv.so.2 /usr/lib/libdl.so.1 /usr/lib/libpthread.so.1 /usr/lib/libc.so.1 /usr/lib/libaio.so.1 /usr/lib/libmp.so.2 /usr/lib/libthread.so.1 /usr/platform/sunw,ultra-5_10/lib/libc_psr.so.1 2. Installation of Dependencies: 1. libdb-4.1.so. BerkeleyDB $gunzip db nc.tar.gz $tar -xvf db nc.tar $cd db nc $cd build_unix $../dist/configure -prefix=<berkeley DB HOME> $make $make install 2. libiconv.so.2 libiconv tar.gz $./configure --prefix=/usr/local $ make $ make install 3. libsendfile.so.1 libsendfile.so.1 is part of the core Solaris package from Solaris 9. libsendfile.so.1 is also required by apache2 in Solaris 8. To install this file, patch code from Solaris should be installed: This patch requires installing some additional patches before (see the details in the page). Set the library path, pointing to the required shared objects. For example: $LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<Berkeley DB HOME/lib> $export LD_LIBRARY_PATH $echo $LD_LIBRARY_PATH Execute ldd on httpd after running setenv.sh, as above. If any of the.so resource is still missing, check the Library path. Installation Guide (FTMS and Node Manager) 9

10 If the ldd command still shows that any files are missing, build the Apache sources using the procedure in the following section. 3. Building and Installing Apache : Apache (httpd tar.gz) Run the following commands over the file (httpd tar.gz): $ gunzip httpd tar.gz $ tar -xvf httpd tar.gz You will get the "httpd " directory. Go to "httpd " and run the following commands to install Apache $./configure --prefix=<apache HOME> $ make $ make install where <APACHE HOME> = directory where Apache is to be installed (provide the absolute path) (e.g. APACHE HOME=/FTMS/apache/). The above commands install Apache. Launching FTMS This version of FTMS requires a default User ID, Password and Key License to launch FTMS. All of these elements, except the license key file, are provided in this version. The license key file is provided by Force10 upon request. Launch FTMS from the shortcut icon selected above. Server: 1. In <FTMS_HOME>/bin, execute the./startnms.sh file. 2. If the License Agreement dialog box appears (this is only for the first run of FTMS), click Accept. 3. Click Browse in the License Key dialog box, navigate to the license key file, and enter the license key supplied by Force10 Networks. 4. FTMS launches a Server process. Bring the Server screen forward to view the FTMS Server Modules status. When the process is complete, you are notified by the message: Client Verifying connection with web server verified FTMS Server modules started successfully Please connect your client to the web server on port: 9090 The two types of clients supported by FTMS are the Application Client and browser-based HTML Client. Login Note: When you first log in to either of the clients, you are required to enter the default ID and password of root and public. You are then required to change at least the password. Anytime you change the password, the change is for both clients. SNMP Note: You must enable SNMP on any switch that you want FTMS to manage or to display on the device map. For details on enabling SNMP, see the configuration guide for the switch or see the Installation chapter in the Force10 Node Manager Guide. Application Client: 1. In <FTMS_HOME>/bin, execute the./startapplicationclient.sh file. Installation Guide (FTMS and Node Manager) 10

11 2. Enter the user ID and password in the FTMS Authentication dialog box and click Connect. FTMS launches another process window and a log window (which you can minimize), and then the main FTMS window launches. Browser-based HTML Client: 1. Start the browser and connect to server name/ip address>:9090 An HTML page with HTML UI and Java UI buttons appears in the browser. 2. Enter the default username/password and click on HTML UI. Stopping FTMS Server 1. In <FTMS_HOME>/bin, execute./stopnms.sh. 2. When the authentication window is launched, give the user name and password as root/public. 3. In <FTMS_HOME>/bin, execute./stopmysql.sh. Installing Standalone Node Manager Before beginning the installation, check for the latest Node Manager software on the Force10 Networks website. 1. Set the executable permission for install.bin and execute the./install.bin file to launch the installation program and the installation introduction dialog box. 2. Choose Install Folder: Select the destination folder for the Node Manager installation. By default, Node Manager is installed in /home/<user name>nodemanager. To install Node Manager in another directory, click Choose. 3. Choose Shortcut Folder: Select the radio buttons where you want Node Manager shortcut icons to appear. 4. Pre-Installation Summary: Review the pre-installation summary. This allows you to view the selections you have made so far in the installation process. If you need to change any of your selections, click Previous and make the necessary changes. Click Install to install Node Manager. Installing : The installation dialog box provides a status meter as the installation proceeds. 5. Install Complete: When the installation is complete, a confirmation dialog box is displayed. Click Done to exit the installation program. Launching Standalone Node Manager This version of Node Manager requires an E-Series chassis IP address and SNMP read community string to launch the Node Manager. The Node Manager GUI cannot be displayed without connecting a real E-Series. Launch the Node Manager from the shortcut icon selected above. 1. Click the Start Node Manager shortcut icon. If a shortcut was not chosen during installation then, in <NodeManager_HOME>/bin, execute the./startchassisview.sh file. Node manager launches a Start Node Manager screen and a Java login screen. 2. Enter the E-Series chassis IP address and SNMP read community string in the Node Manager authentication dialog box and click OK. The default is: Chassis IP Address: <E-Series manager port IP address> SNMP Read Community String: public The Node Manager main window launches. Installation Guide (FTMS and Node Manager) 11