Installing NMS SS

Transcription

1 Installing NMS SS Crossing Boulevard Framingham, MA USA

2 Installing NMS SS7 4.3 No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of NMS Communications Corporation NMS Communications Corporation. All Rights Reserved. Alliance Generation is a registered trademark of NMS Communications Corporation or its subsidiaries. NMS Communications, Natural MicroSystems, AG, CG, CX, QX, Convergence Generation, Natural Access, Natural Access MX, CT Access, Natural Call Control, Natural Media, NaturalFax, NaturalRecognition, NaturalText, Fusion, Open Telecommunications, Natural Platforms, NMS HearSay, AccessGate, MyCaller, and HMIC are trademarks or service marks of NMS Communications Corporation or its subsidiaries. Multi- Vendor Integration Protocol (MVIP) is a registered trademark of GO-MVIP, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. Windows NT, MS-DOS, MS Word, Windows 2000, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Clarent and Clarent ThroughPacket are trademarks of Clarent Corporation. Sun, Sun Microsystems, Solaris, Netra, and the Sun logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and/or other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the United States and/or other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. Linux is a registered trademark of Linus Torvalds. Red Hat is a registered trademark of Red Hat, Inc. All other marks referenced herein are trademarks or service marks of the respective owner(s) of such marks. All other products used as components within this product are the trademarks, service marks, registered trademarks, or registered service marks of their respective owners. Every effort has been made to ensure the accuracy of this manual. However, due to the ongoing improvements and revisions to our products, NMS Communications cannot guarantee the accuracy of the printed material after the date of publication or accept responsibility for errors or omissions. Revised manuals and update sheets may be published when deemed necessary by NMS Communications. P/N Revision history Revision Release date Notes 1.0 September 2004 SSR, SS April 2005 LBG, SS7 4.2 GA 1.2 September 2006 LBZ, SS7 4.3 GA 1.3 January 2007 SRG, SS7 4.3 Linux GA Last modified: January 29, 2007 Refer to for product updates and for information about support policies, warranty information, and service offerings. 2 NMS Communications

3 Table Of Contents Chapter 1: Introduction...5 Chapter 2: Installing the software under Windows...7 Activating the TX PCI device drivers... 8 Windows Windows Verifying the TX PCI device driver status... 9 Chapter 3: Installing the software under Solaris...11 Environment variable settings...11 Chapter 4: Installing the software under Red Hat Linux...13 Environment variable settings...13 Chapter 5: Using NMS SS7 documentation...15 Installing and configuring NMS hardware...15 Configuring and managing the system...15 Developing layer applications...15 Configuring and controlling protocol engines...16 Chapter 6: Removing the software...17 Windows...17 Removing TX PCI drivers under Windows...17 Solaris and Linux...18 NMS Communications 3

4

5 1 Introduction SS7 4.3 software includes the following products: TX Base 6.5 MTP MTP SCCP 7.4 TCAP 5.4 ISUP 7.4 TUP 7.4 SS7 4.3 software products support the following operating systems: Windows 2000 Server and Windows 2000 Professional Windows Server 2003, Standard edition Intel Solaris 8 SPARC Solaris 9 (32-bit mode) Run in either of these operating environments: 32-bit applications, 32-bit libraries, 32-bit kernel, 32-bit drivers 32-bit applications, 32-bit libraries, 64-bit kernel, 64-bit drivers SPARC Solaris 9 (64-bit mode) SPARC Solaris 10 (32-bit mode) Run in either of these operating environments: 32-bit applications, 32-bit libraries, 32-bit kernel, 32-bit drivers 32-bit applications, 32-bit libraries, 64-bit kernel, 64-bit drivers SPARC Solaris 10 (64-bit mode) Red Hat Enterprise Linux, ES, version 4.0 The SS7 installation program installs the following components: SS7 development and runtime software Device drivers TX board software Host applications Libraries Sample applications NMS Communications 5

6 Introduction Installing NMS SS7 4.3 Refer to for product updates and for information about NMS support policies, warranty information, and service offerings. From the NMS web site, you can download the SS7: Software Documentation 6 NMS Communications

7 2 Installing the software under Windows Complete the following steps to install the software under Windows: Step Action 1 Uninstall any prior versions of SS7 software. 2 Log on as a member of the Administrators group. 3 Download the SS7 software from the NMS Communications web site. 4 Launch Windows Explorer, and double-click on the downloaded file. 5 Click OK to unzip the files. 6 Specify a location for the unzipped product files, and click Unzip. 7 Double-click on setup.exe in the product files directory. 8 The Welcome screen appears followed by the NMS license agreement. 9 Follow the prompts as the Installation Wizard guides you through the installation process. 10 Reboot Windows before configuring and using the SS7 software. For additional installation information, refer to the readme_ss7.txt file. NMS Communications 7

8 Installing the software under Windows Installing NMS SS7 4.3 Activating the TX PCI device drivers After you reboot the system when installing the SS7 software, activate the applicable devices drivers. The following procedures describe how to activate device drivers under Windows 2000 or Windows Windows 2000 Complete the following steps to activate a device driver for a Windows 2000 installation: Step Action 1 Log on as a member of the Administrators group. The Found New Hardware Wizard appears. 2 Click Search for suitable driver for my device, and click Next. 3 Click Specify a location, deselect any other options, and click Next. 4 Click Browse, select the SS7 root directory, click Open, and then click OK. The wizard locates the nmstxpci.inf file, renames it oem#.inf (where # is a random number that Windows assigns), and displays its full pathname. This file is located at the root of the directory in which you unzipped the SS7 software. The wizard uses this file to install the new device driver. Note: If the displayed pathname is C:\WINNT\inf\oem#.inf, refer to the readme_ss7.txt file for procedures to clean up the old files, and repeat steps 2 through 4. 5 Click Finish. The New Hardware Wizard repeats file requests for each new TX device it detects. When it is complete, it exits. 6 Reboot Windows NMS Communications

9 Installing NMS SS7 4.3 Installing the software under Windows Windows 2003 Complete the following steps to activate a device driver for a Windows 2003 installation: Step Action 1 Log on as a member of the Administrators group. The Found New Hardware Wizard appears. 2 Click Install from a list or specific location (Advanced), and click Next. 3 At the Choose your search and installation options prompt, click Browse, select the SS7 root directory, click Open, and then click OK. The wizard locates the nmstxpci.inf file, renames it oem#.inf (where # is a random number that Windows assigns), and displays its full pathname. This file is located at the root of the directory in which you unzipped the SS7 software. The wizard uses this file to install the new device driver. Note: If the displayed pathname is C:\WINDOWS\inf\oem#.inf, refer to the readme_ss7.txt file for procedures to clean up the old files, and repeat steps 2 and 3. 4 When Security Alert - Driver Installation appears, click Yes. The wizard installs the device driver. 5 When Complete the New Hardware Wizard appears, click Finish. The New Hardware Wizard repeats file requests for each new TX device it detects. When it is complete, it exits. 6 Reboot Windows Verifying the TX PCI device driver status Complete the following steps to verify the TX PCI device driver status: Step Action 1 Click Start > Settings > Control Panel. 2 In the Control Panel, double-click System. 3 Click the Hardware tab, and then click Device Manager. 4 Expand the NMS Communications Devices entry. TX PCI device drivers appear as NMS TX PCI Driver entries. NMS Communications 9

10

11 3 Installing the software under Solaris Complete the following steps to install the software under Solaris: Step Action 1 Uninstall any prior versions of SS7 software. 2 Log on as root. 3 Download SS7 software from the NMS Communications web site. 4 Extract the SS7 software image from the file that you downloaded by entering the following commands: uncompress filename.tar.z tar -xvf filename.tar where filename is the name of the file that you downloaded. 5 Run the ss7_install script located in the directory in which you opened the tar file, and follow the prompts from the script. For additional installation information, refer to the readme_ss7.txt file. When the installation process is complete, proceed with any additional configuration as needed. For more information, refer to the product documentation. Environment variable settings To set up the system environment correctly, you must: Add /opt/nmstx/bin to the system PATH variable. Add /opt/nmstx/lib to the system LD_LIBRARY_PATH variable. To set these environment variables, enter the following changes at the command line and reboot your system: PATH=/opt/nmstx/bin:$PATH export PATH LD_LIBRARY_PATH=/opt/nmstx/lib:$LD_LIBRARY_PATH export LD_LIBRARY_PATH Note: NMS recommends that you also make these variable changes in the system login.profile file. NMS Communications 11

12

13 4 Installing the software under Red Hat Linux Complete the following steps to install the software under Red Hat Linux: Step Action 1 Uninstall any prior versions of SS7 software. 2 Log on as root. 3 Download the SS7 Monitor software from the NMS Communications web site. 4 Unzip and untar the download file by entering the following commands: gzip -d filename.tar.gz tar -xvf filename.tar where filename is the name of the file that you downloaded. 5 Run the ss7_install script located in the directory in which you opened the tar file, and follow the prompts from the script. For additional installation information and for information about using the Red Hat Package Manager (RPM) to install individual packages, refer to the readme_ss7.txt file. Note: Hot Swap is not supported with the SS7 4.3 Red Hat Enterprise Linux, ES, 4.0 release. Environment variable settings To set up the system environment correctly, you must: Add /opt/nmstx/bin to the system PATH variable. Add /opt/nmstx/lib to the system LD_LIBRARY_PATH variable. To set these environment variables, enter the following changes at the command line and reboot your system: PATH=/opt/nmstx/bin:$PATH export PATH LD_LIBRARY_PATH=/opt/nmstx/lib:$LD_LIBRARY_PATH export LD_LIBRARY_PATH Note: NMS recommends that you also make these variable changes in the system login.bashrc file. NMS Communications 13

14

15 5 Using NMS SS7 documentation NMS SS7 documentation is available on the NMS Communications web site, You can: Download all NMS SS7 manuals in HTML format. To access a master list, view Start_here_SS7.htm in the \doc\ directory. Download or view individual manuals in HTML format. Print individual manuals using the Adobe Acrobat Reader available from The following table summarizes the NMS SS7 documents according to subject. Installing and configuring NMS hardware For information about... Configuring and installing a TX board and verifying its installation Refer to the... TX 3220 Installation Manual TX 3220C Installation Manual TX 4000 Installation Manual TX 4000C Installation Manual Configuring and managing the system For information about... Configuring and operating the SS7 software Developing applications to monitor and control redundant and standalone configurations Using TX utilities to load and configure a TX board, and to diagnose hardware and software issues Refer to the... NMS SS7 Configuration Manual SS7 Health Management Developer's Reference Manual TX Utilities Manual Developing layer applications For information about... SS7 layers and a reference of functions, parameters, events, and errors Refer to the... NMS MTP 2 Developer's Reference Manual NMS MTP 3 Developer's Reference Manual NMS SCCP Developer's Reference Manual NMS TCAP Developer's Reference Manual NMS ISUP Developer's Reference Manual NMS TUP Developer's Reference Manual NMS Communications 15

16 Using NMS SS7 documentation Installing NMS SS7 4.3 Configuring and controlling protocol engines For information about... Establishing communication channels between host applications and TX boards Developing applications that perform task loading Developing applications that control the H.100/H.110 switch fabric and the T1/E1 interfaces Refer to the... CPI Library Developer's Reference Manual Loader Library Developer's Reference Manual TDM for SS7 Developer's Reference Manual 16 NMS Communications

17 6 Removing the software Under Windows, you can remove all of the SS7 software at once or remove individual software components. The Solaris removal script removes all of the SS7 components. Windows To remove SS7 software under Windows: Step Action 1 Make sure that no applications are using SS7 components or libraries. 2 Click Start > Settings > Control Panel. 3 In the Control Panel, double-click Add/Remove Programs. 4 Select NMS Communications SS7, and click Change/Remove. 5 Follow the prompts as appropriate for your system. Use the Remove option to remove the entire SS7 package. Other options enable you to remove individual components. Removing TX PCI drivers under Windows To remove the TX PCI device drivers under Windows: Step Action 1 Click Start > Settings > Control Panel. 2 In the Control Panel, double-click System. 3 Click the Hardware tab, and then click Device Manager. 4 Expand the NMS Communications Devices entry. 5 Right-click an NMS TX PCI Driver entry, and select Uninstall. 6 Click OK. 7 Repeat steps 5 and 6 for each NMS TX PCI driver listed. For information about cleaning up residual system files, refer to the readme_ss7.txt file. After you complete the software removal process, reboot the system before reinstalling or upgrading SS7 software. NMS Communications 17

18 Removing the software Installing NMS SS7 4.3 Solaris and Linux Complete the following steps to remove SS7 software under SPARC Solaris, Intel Solaris, and Red Hat Linux: Step Action 1 Log on as root. 2 Make sure that no applications are using SS7 components or libraries. 3 Run the ss7_remove script, located in the /opt/nmstx/bin directory. The removal script removes all SS7 packages. For information about using the Red Hat Package Manager (RPM) to uninstall individual packages, refer to the readme_ss7.txt file. 18 NMS Communications