Avaya CVLAN Server 9.0 for Linux Installation and Basic Administration Guide

Transcription

1 Avaya CVLAN Server 9.0 for Linux Installation and Basic Administration Guide Issue 1 March 2004

2 2004 Avaya Inc. All Rights Reserved. Notice While reasonable efforts were made to ensure that the information in this document was complete and accurate at the time of printing, Avaya Inc. can assume no liability for any errors. Changes and corrections to the information in this document may be incorporated in future releases. Preventing toll fraud Toll fraud is the unauthorized use of your telecommunications system by an unauthorized party (for example, anyone who is not a corporate employee, agent, subcontractor, or person working on your company's behalf). Be aware that there may be a risk of toll fraud associated with your system and that, if toll fraud occurs, it can result in substantial additional charges for your telecommunications services. Avaya fraud intervention If you suspect that you are being victimized by toll fraud and you need technical assistance or support, call Technical Service Center Toll Fraud Intervention Hotline at for the United States and Canada. For additional support telephone numbers, see the Avaya Web site: Select Support, then select Escalation Lists. This Web site includes telephone numbers for escalation within the United States. For escalation telephone numbers outside the United States, select Global Escalation List. Providing telecommunications security Telecommunications security (of voice, data, and video communications) is the prevention of any type of intrusion to (that is, either unauthorized or malicious access to or use of) your company's telecommunications equipment by some party. Your company's telecommunications equipment includes both this Avaya product and any other voice/data/video equipment that could be accessed via this Avaya product (that is, networked equipment ). An outside party is anyone who is not a corporate employee, agent, subcontractor, or person working on your company's behalf. Whereas, a malicious party is anyone (including someone who may be otherwise authorized) who accesses your telecommunications equipment with either malicious or mischievous intent. Such intrusions may be either to/through synchronous (time-multiplexed and/or circuit-based) or asynchronous (character-, message-, or packet-based) equipment or interfaces for reasons of: Use (of capabilities special to the accessed equipment) Theft (such as, of intellectual property, financial assets, or toll-facility access) Eavesdropping (privacy invasions to humans) Mischief (troubling, but apparently innocuous, tampering) Harm (such as harmful tampering, data loss or alteration, regardless of motive or intent) Be aware that there may be a risk of unauthorized intrusions associated with your system and/or its networked equipment. Also realize that, if such an intrusion should occur, it could result in a variety of losses to your company (including, but not limited to, human and data privacy, intellectual property, material assets, financial resources, labor costs, and legal costs). Your responsibility for your company's telecommunications security The final responsibility for securing both this system and its networked equipment rests with you, an Avaya customer's system administrator, your telecommunications peers, and your managers. Base the fulfillment of your responsibility on acquired knowledge and resources from a variety of sources, including, but not limited to: Installation documents System administration documents Security documents Hardware-/software-based security tools Shared information between you and your peers Telecommunications security experts To prevent intrusions to your telecommunications equipment, you and your peers should carefully program and configure: Your Avaya-provided telecommunications systems and their interfaces Your Avaya-provided software applications, as well as their underlying hardware/software platforms and interfaces Any other equipment networked to your Avaya products. Warranty Avaya Inc. provides a limited warranty on this product. Refer to your sales agreement to establish the terms of the limited warranty. In addition, Avaya s standard warranty language, as well as information regarding support for this product, while under warranty, is available through the following Web site: Link disclaimer Avaya Inc. is not responsible for the contents or reliability of any linked Web sites and does not necessarily endorse the products, services, or information described or offered within them. We cannot guarantee that these links will work all of the time and we have no control over the availability of the linked pages. Trademarks Avaya is a trademark of Avaya Inc. All trademarks identified by the or are registered trademarks or trademarks, respectively, of Avaya Inc. All other trademarks are the property of their respective owners. License Information for Third Party Software Apache STRUTS and Tomcat All software produced by The Apache Software Foundation or any of its projects or subjects is licensed according to the terms of the documents listed below. Individual packages may use slightly different wording due to varying requirements for attribution or mark identification, but the binding terms are the same for all, and are as described here. Apache Software License, version 1.1 (current) Based upon the 1.0 version of the ASL, the 1.1 version was approved by the ASF in The primary change from the 1.0 license is in the advertising clause (section 3 of the 1.0 license); derived products are no longer required to include attribution in their advertising materials, but only in their documentation. All new packages produced by the ASF are implicitly licensed by this document rather than the 1.0 license, unless otherwise explicitly stated. PostgreSQL PostgreSQL is released under the BSD license PostgreSQL Database Management System (formerly known as Postgres, then as Postgres95). Portions Copyright ( ) , The PostgreSQL Global Development Group. IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN AS IS BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. The ADAPTIVE Communication Environment (ACE(TM)) Copyright and Licensing Information for ACE, TAO, and CIAO ACE, TAO, and CIAO are copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine, and Vanderbilt University Copyright ( ) , all rights reserved. Redhat Red Hat, the Red Hat "Shadow Man" logo, RPM, Maximum RPM, the RPM logo, Linux Library, PowerTools, Linux Undercover, RHmember, RHmember More, Rough Cuts, Rawhide and all Red Hat-based trademarks and logos are trademarks or registered trademarks of Red Hat, Inc. in the United States and other countries. SUN, Java 2 Platform, Standard Edition (J2SE) Java 2, Standard Edition (J2SE ) Specification ( Specification ) Version: Status: FCS Release: June 25, Copyright 2003 Sun Microsystems, Inc Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

3 Avaya support Avaya provides a telephone number for you to use to report problems or to ask questions about your contact center. The support telephone number is in the United States. For additional support telephone numbers, see the Avaya Web site: Select Support, then select Escalation Lists. This Web site includes telephone numbers for escalation within the United States. For escalation telephone numbers outside the United States, select Global Escalation List. Comments To comment on this document, send to crminfodev@avaya.com. Acknowledgment This document was written by the CRM Information Development group.

4

5 Avaya CVLAN Server 9.0 for Linux Installation and Basic Administration Guide Contents About this document Purpose Intended audience How to use this document Organization of this document Conventions used in this document Security Administrative security System protection Restart capability Backup and restoration of data Security logs Security Patches Related documents Avaya product assistance and service Web sites Chapter 1: Overview of Avaya CVLAN Server 9.0 for Linux What is CVLAN? The CVLAN Server The CVLAN Client Getting the CVLAN Client software The Avaya CVLAN Server 9.0 for Linux operating environment Chapter 2: Installing and setting up Avaya CVLAN Server 9.0 for Linux Prerequisites for Avaya CVLAN Server 9.0 for Linux Hardware Requirements Software requirements Planning Your Installation Planning guidelines for remote installation of CVLAN Server Planning guidelines local installation of CVLAN server Logging in as root To originally log in as root To become root or the superuser Before you begin Determining what components you need to install Issue 1 March

6 Contents Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software Installing the CVLAN Server license file Troubleshooting the CVLAN license installation If you receive error messages from WebLM If you do not have a license Identifying the MAC address CTI links Link administration Link types Administering a CTI link on Avaya Communication Manager Administering a CTI Link on configurations with Processor Ethernet connectivity Procedure to administer a CTI Link -- Processor Ethernet Connectivity Administering a CTI Link on configurations with C-LAN connectivity Procedure for administering a CTI link -- C-LAN connectivity Chapter 3: Administering Avaya CVLAN Server 9.0 for Linux Logging on to CVLAN OAM Commands and Web pages you will be using Basic CVLAN administration procedure Configuring Avaya CVLAN Server 9.0 for Linux Using the default CVLAN configuration Guidelines for configuring TCP/IP General information about TCP/IP Ports used by Avaya CVLAN Server 9.0 for Linux Changing the TCP/IP port for Tomcat Changing the TCP/IP port for PostgreSQL Network latency requirements Recommended NIC configurations Removing Avaya CVLAN Server 9.0 for Linux What happens to logs and the database Upgrading CVLAN Operating system updates Appendix A: Avaya CVLAN Server 9.0 for Linux installed files Avaya CVLAN Server 9.0 for Linux files Appendix B: Setting the Linux PC for remote access Setting up the Linux PC for remote access Prerequisites Before You Begin Determining if the software is installed Installing the additional software components Configuring the Linux PC Editing the inittab file Editing the login.config file Editing the pap-secrets file Checking the PPP options file CVLAN Installation and Basic Administration Guide

7 Contents Editing the options.tty file Setting up the client to dial-in to the server Windows clients Linux clients Connection Requirements Appendix C: Installing Avaya CVLAN Server 9.0 for Linux -- a general reference.. 65 How to use this appendix Installing the Korn shell Installing the SQL Database Installing the Development Tools Installing the Java SDK Installing Tomcat Appendix D: Administering the Co-resident DLG Administering the Co-resident DLG service over Processor Ethernet Procedure to administer the Co-resident DLG service over Processor Ethernet Administering the Co-resident DLG service over C-LAN Procedure to administer the Co-resident DLG service over C-LAN Glossary Index Issue 1 March

8 Contents 8 CVLAN Installation and Basic Administration Guide

9 Purpose About this document CVLAN is an application programming interface (API) that enables applications to communicate with Avaya Communication Manager. Avaya CVLAN Server 9.0 for Linux is specific to the Linux operating system. Purpose The purpose of this document is to describe the basic set of administrative tasks required for CTI enabling CVLAN client applications. Intended audience This document is intended for system administrators or service technicians who are familiar with administering Avaya Communication Manager and Linux. How to use this document Use this document to carry out the following tasks. Determine if your PC is ready for installing Avaya CVLAN Server 9.0 for Linux (also referred to as the CVLAN Server or CVLAN). Administer Avaya Communication Manager to communicate with the CVLAN server Install Avaya CVLAN Server 9.0 for Linux Administer the CVLAN Server to communicate with Avaya Communication Manager and CVLAN clients (ultimately enabling CVLAN clients to communicate with Avaya Communication Manager) Issue 1 March

10 About this document Organization of this document This document is organized as follows: Chapter 1: Overview of Avaya CVLAN Server 9.0 for Linux describes the hardware and software requirements for installing Avaya CVLAN Server 9.0 for Linux. Chapter 2: Installing and setting up Avaya CVLAN Server 9.0 for Linux describes how to install the Avaya CVLAN Server 9.0 for Linux and how to administer a link on Avaya Communication Manager. Chapter 3: Administering Avaya CVLAN Server 9.0 for Linux describes the basic, initial tasks for administering CVLAN using the Web-based CVLAN Operations, Administration, and Maintenance interface. Glossary provides definitions of technical terms used in this document Conventions used in this document The following conventions are used in this document. Convention Example Usage bold monospace add station Bold monospace indicates a literal entry. Type exactly as depicted bold italic monospaced term in angle brackets <username> Angle brackets enclosing Italics denote a term that you replace. Angle brackets are used as visual cues, you do not type them. Keep in mind that the number of terms in angle brackets does not have any significance. Descriptive terms are often used as an aid to comprehension. For example, you would replace the term <link number> by typing 1. plain monospace Password: Plain monospace denotes the command line interface (as opposed to the Graphical User Interface). bold sans-serif Start Bold sans serif indicates a mouse selection. 10 CVLAN Installation and Basic Administration Guide

11 Security Security At a general level, security means ensuring the confidentiality, integrity, and availability of data. The CVLAN security implementation provides administrative security. Administrative security Administrative security is an encompassing term that includes system protection, (including passwords and authentication), the ability to stop and restart the system, and the ability to backup and restore the system. System protection Any user administered on a Linux system (except root) is allowed administer CVLAN using the CVLAN OAM Web based interface. CVLAN provides a cvlan account (user name cvlan) that is locked, and the only way to access the account is by using su cvlan from root. User accounts are authenticated at log on. If an account is root, it is prohibited from performing CVLAN web administration. In other words, the root user can not use the CVLAN OAM Web based interface. Restart capability CVLAN provides the ability to stop the CVLAN Server and to restart it. For more information see Restart CVLAN in CVLAN OAM Help. Backup and restoration of data CVLAN provides a feature to backup the CVLAN database and a feature to restore the backed up database. See Backup CVLAN Database and Restore CVLAN Configuration in CVLAN OAM Help for more information. Note: Note: CVLAN does not encrypt backup (.bck) files. Issue 1 March

12 About this document Security logs CVLAN provides the following log files, which are not encrypted, for recording system events and activities: client access log system reset log Security Patches command log You can download these logs, which are located in the $LOGS directory, from the OAM interface. Security vulnerabilities that affect Avaya products or underlying platforms will be posted on the Security Advisories page on the Avaya Support Web site. To access this page, navigate to the following URL in your browser CVLAN Installation and Basic Administration Guide

13 Related documents Related documents Use this section to locate additional information about implementing CVLAN. Avaya Communication Manager documents Administrator s Guide for Avaya Communication Manager, Use this document as a general reference for Avaya Communication Manager. In most cases you will not need to consult this document to administer Avaya Communication Manager because the Avaya CVLAN Server 9.0 for Linux Installation and Basic Administration Guide includes this information. API-related documents for information about developing your application. These documents are included on the Avaya CVLAN Server 9.0 for Linux CD-ROM. - Avaya Computer Telephony CVLAN Programmer s Reference (CALLVISR.PDF) This document is intended for application designers and programmers who will be using the CVLAN API to develop and maintain CVLAN Client applications. - Avaya Communication Manager, Release 2.0, ASAI Technical Reference (ASAITECH.PDF) This document describes the messages that can be sent and received. - Avaya Communication Manager, Release 2.0, ASAI Protocol Reference (ASAIPROT.PDF) This document describes the format of messages. Avaya product assistance and service Web sites For help with CVLAN, call the Avaya National Customer Care Center at: For information about Avaya products and service, go to For product documentation for all Avaya products and related documentation, go to Issue 1 March

14 About this document 14 CVLAN Installation and Basic Administration Guide

15 What is CVLAN? Chapter 1: Overview of Avaya CVLAN Server 9.0 for Linux Use Chapter 1 to familiarize yourself with Avaya CVLAN Server 9.0 for Linux (also referred to as the CVLAN Server or CVLAN) and the context of operations for the CVLAN Server. Chapter 1 includes the following topics. What is CVLAN? The CVLAN Server The CVLAN Client The Avaya CVLAN Server 9.0 for Linux operating environment What is CVLAN? CVLAN is an application programming interface (API) that enables applications to communicate with Avaya Communication Manager -- that is, to send and receive ASAI Messages over shared ASAI links on TCP/IP. An application can use ASAI Messages to monitor and control resources on the Avaya Communication Manager server. Avaya CVLAN Server 9.0 for Linux is specific to the Linux operating system. CVLAN consists of two components, a client and a server. The CVLAN Server provides LAN connectivity to remote workstations that require access to the CVLAN API. Important:! Important: Avaya CVLAN Server 9.0 for Linux, is designed exclusively for a Linux based PC. Although this server is functionally equivalent to the CVLAN Server that runs on the Multi-Application for DEFINITY (MAPD) platform, the two products are packaged differently and installed differently. For more information about the MAPD based DLG, see DEFINITY Enterprise Communications Server ASAI Applications Over MAPD, The CVLAN Client can be installed on a server or on a client workstation. It provides clients with access to Avaya Communication Manager via the CVLAN Server. Issue 1 March

16 Overview of Avaya CVLAN Server 9.0 for Linux Important:! Important: The Avaya CVLAN Server 9.0 for Linux CD-ROM does not include the CVLAN Client. The CVLAN Client software is available on the Web. For more information about the CVLAN Client software see The CVLAN Client on page 16. The CVLAN Server The CVLAN Server is software that manages ASAI message traffic between CVLAN Clients and Avaya Communication Manager. Avaya CVLAN Server 9.0 for Linux supports the following versions of the CVLAN Client. CVLAN Client Version CVLAN Client Version The CVLAN Client The CVLAN Client enables your applications to send and receive computer based telephony requests. The CVLAN Client provides the API (a set of function calls to send ASAI messages) that enables telephony based applications to use the resources provided by Avaya Communication Manager. In addition to the API library, the CVLAN Client provides a protocol exerciser called the Integration Test Tool (ITT). ITT is designed to help test the ASAI library by exercising its function calls and, optionally, by comparing the expected results to the actual results for received messages. Important:! Important: The Avaya CVLAN Server 9.0 for Linux CD-ROM does not include the CVLAN Client software. See Getting the CVLAN Client software on page CVLAN Installation and Basic Administration Guide

17 The CVLAN Client Getting the CVLAN Client software Follow this procedure to get CVLAN Client software from the Avaya Web site. 1. Go to 2. From the top navigation bar, Select Support > Software & Firmware Downloads. 3. From the Software & Firmware downloads page scroll down to Computer Telephony Integration (CTI), and select CVLAN client. 4. From the CVLAN Client page, click Software Downloads. 5. From the Software Downloads table select either of the following links CVLAN client Version CVLAN client Version Issue 1 March

18 Overview of Avaya CVLAN Server 9.0 for Linux The Avaya CVLAN Server 9.0 for Linux operating environment The CVLAN operating environment includes the following A media server running Avaya Communication Manager, such as - Avaya Media Server S8100, Avaya Media Server S8300, Avaya Media Server S8500 or Avaya Media Server S8700). Avaya Communication Manager is the telephony component of Avaya MultiVantage. A Red Hat 9.0 Linux based computer (where the CVLAN Server is installed) A computer for running the CVLAN Client software. The CVLAN Client is supported on the following operating systems. - Windows Windows NT (4.0 or higher) Windows 2000 Windows XP Windows 2003) -Unix UnixWare Solaris x86 Solaris Sparc IBM Advanced Interactive Executive (AIX) Note: Note: The CVLAN Client does not currently run on the Linux operating system. 18 CVLAN Installation and Basic Administration Guide

19 Chapter 2: Installing and setting up Avaya CVLAN Server 9.0 for Linux The chapter describes how to install Avaya CVLAN Server 9.0 for Linux (also referred to as the CVLAN Server or CVLAN) and how to carry out the basic set of necessary administrative tasks to enable communications between the CVLAN Server and the server running Avaya Communication Manager. It includes the following topics. Prerequisites for Avaya CVLAN Server 9.0 for Linux Logging in as root Before you begin Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software Installing the CVLAN Server license file CTI links Administering a CTI link on Avaya Communication Manager Issue 1 March

20 Installing and setting up Avaya CVLAN Server 9.0 for Linux Prerequisites for Avaya CVLAN Server 9.0 for Linux Before you install the Avaya CVLAN Server 9.0 for Linux, make sure that you have the required hardware and software. Hardware Requirements The following table lists the minimum basic hardware requirements. Table 2-1: Avaya CVLAN Server 9.0 for Linux -- hardware requirements Component Description CPU RAM Network Connections Drives Disk Space 1 Pentium III 800 MHZ or higher 256 MB or higher For a standard installation, 2 network interface card(s) are recommended CD-ROM drive 10 GB Hard Drive Modem Must be compatible with Red Hat Linux The disk space requirement is an approximation. The amount of disk space required also depends on other factors such as the number of users, types of activity performed, and number and/or size of the trace files. Additionally, this requirement includes space for the operating system, CVLAN dependencies, and Avaya CVLAN Server 9.0 for Linux. 20 CVLAN Installation and Basic Administration Guide

21 Prerequisites for Avaya CVLAN Server 9.0 for Linux Software requirements The following table lists the components required for remote access to the Linux server and the components required for installing Avaya CVLAN Server 9.0 for Linux. Although GNOME (the graphical desktop included with Red Hat Linux) is not required, this document assumes that it is installed.. Table 2-2: Avaya CVLAN Server 9.0 for Linux -- software requirements Component Version Description Red Hat Linux 9 Desktop, Server 9.0 Operating system In addition to installing the default packages, you must also install: pdksh PostgreSQL pam-devel pam Command line interpreter Open source database Software development tools. gdb gcc ltrace mgetty ppp Software required for remote access. See Appendix B: Setting the Linux PC for remote access on page 57. j2sdk Java software development kit (not on Red Hat Linux 9 or CVLAN Server product distribution). See Installing the Java SDK on page 69 Tomcat 3.3.1a Java servlet container (not Red Hat Linux 9 or CVLAN Server product distribution). See Installing Tomcat on page 70 Important:! Important: Be sure to read Planning Your Installation on page 22 and Determining what components you need to install on page 26 before you attempt to install the Avaya CVLAN Server 9.0 for Linux software. Issue 1 March

22 Installing and setting up Avaya CVLAN Server 9.0 for Linux Planning Your Installation Refer to Table 2-2: Avaya CVLAN Server 9.0 for Linux -- software requirements on page 21, as you read this section. This planning section provides guidelines for two ways of setting up the Linux PC. Setting up the Linux PC for remote installation of Avaya CVLAN Server 9.0 for Linux. See Planning guidelines for remote installation of CVLAN Server. Setting up the Linux PC as the CVLAN Server. See Planning guidelines local installation of CVLAN server on page 23. Planning guidelines for remote installation of CVLAN Server If you are planning to remotely install Avaya CVLAN Server 9.0 for Linux, follow these guidelines. Important:! Important: Make sure you have the Red Hat 9 installation CD-ROM Disk 2 and the Avaya CVLAN Server 9.0 for Linux CD-ROM on hand. 1. Follow the instructions in Determining what components you need to install on page Set up the Linux PC for remote access. Follow the instructions in Appendix B: Setting the Linux PC for remote access on page Install Avaya CVLAN Server 9.0 for Linux. See Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software on page Administer the CVLAN Server license. See Installing the CVLAN Server license file on page 28, 5. Administer the CVLAN Server. See Administering a CTI link on Avaya Communication Manager on page CVLAN Installation and Basic Administration Guide

23 Planning Your Installation Planning guidelines local installation of CVLAN server If you are planning a local installation of CVLAN R9 Server for Linux, follow these guidelines. Important:! Important: Make sure you have the Red Hat 9 installation CD-ROM Disk 2 and the Avaya CVLAN Server 9.0 for Linux CD-ROM on hand. 1. Follow the instructions in Determining what components you need to install on page 26, 2. Install Avaya CVLAN Server 9.0 for Linux. See Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software on page Administer the CVLAN Server license. See Installing the CVLAN Server license file on page 28, 4. Administer the CVLAN Server. See Administering a CTI link on Avaya Communication Manager on page 33. Issue 1 March

24 Installing and setting up Avaya CVLAN Server 9.0 for Linux Logging in as root To carry out the administrative procedures described in this chapter, you must be the root user (or superuser) of the system. To originally log in as root If you are initially starting the Linux server running CVLAN you can login as root, as follows. 1. At the login: prompt type, root. The system issues the Password: prompt 2. Type the root password. The system issues the root prompt (#:) To become root or the superuser If you have already logged in with your user name, and you have the authority to become the superuser or root, follow this procedure. 1. Click the Red Hat icon (Main Menu) > System Tools >Terminal to get the command prompt. 2. At the command prompt, type su - To become root and work in the root shell you must type su followed by a space and the dash symbol). The system issues the Password: prompt 3. Type the root password. 24 CVLAN Installation and Basic Administration Guide

25 Before you begin Before you begin Make sure you are logged into Linux, and you are running the X Window graphical environment (also called the X Window System). If you are logged in at the console and you are not running the X Window graphical environment, type startx to run the X Window System. You need to have the X Window system running to be able to accomplish the tasks described in: Determining what components you need to install on page 26 Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software on page 27 Issue 1 March

26 Installing and setting up Avaya CVLAN Server 9.0 for Linux Determining what components you need to install Use Table 2-3: RPM Installation Checklist to see if you need to install any software components. Bear in mind that you must be logged in as root to use this checklist. For more information see Logging in as root on page 24. Table 2-3: RPM Installation Checklist Type the following Verify the results rpm -q mgetty rpm -q ppp If the modem software is installed, the system displays the file name and version information. If the modem software is not already installed, see Appendix B: Setting the Linux PC for remote access on page 57 If the Point-to-Point Protocol software is installed, the system displays the file name and version information. If the Point-to-Point Protocol software is not already installed, see Appendix B: Setting the Linux PC for remote access on page 57 rpm -q pdksh If the Korn shell is already installed, the system displays the file name and version information. If the Korn shell is not already installed, see Installing the Korn shell on page 67 rpm -q postgresql If the SQL Database is already installed, the system displays the file name and version information. If SQL Database is not already installed, see Installing the SQL Database on page 67. rpm -q glibc-devel rpm -q pam-devel rpm -q pam rpm -q gdb rpm -q gcc rpm -q ltrace If any of these Development Tools are installed, the system displays the file name and version information. If any of these Development tools are not already installed, see Installing the Development Tools on page 68 rpm -q j2sdk If the Java SDK is already installed, the system displays the file name and version information. If the Java SDK is not already installed, see Installing the Java SDK on page 69 rpm -q tomcat3. If Tomcat is already installed, the system displays the file name and version information. If Tomcat is not already installed, see Installing Tomcat on page 70 Once you have completed this checklist and have verified that you have the required components already installed, continue with Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software on page CVLAN Installation and Basic Administration Guide

27 Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software Installing Avaya CVLAN Server 9.0 for Linux on a PC that has the required software If you are installing the CVLAN Server on a PC that has all the required components listed in Software requirements on page 21) follow these steps to install the CVLAN Server software from the Avaya CVLAN Server 9.0 for Linux CD-ROM. Important:! Important: If you are not sure if the PC already has the required software, see Determining what components you need to install on page Click the Red Hat icon (Main Menu) > System Tools >Terminal to get the command prompt. 2. Log in to the system as root. For more information see Logging in as root on page Insert the Avaya CVLAN Server 9.0 for Linux CD-ROM in the PC s CD-ROM drive and type mount /mnt/cdrom/ 4. Type cd /mnt/cdrom/rpms to change to the directory containing CVLAN R9 Server for Linux. 5. Type rpm -i cvlan* to install CVLAN R9 Server for Linux. Wait for the package manager to install the software. The package installation is complete when the system displays this message: reboot the system to start CVLAN. 6. Type cd to get out of the cdrom directory. 7. Type umount /mnt/cdrom to eject the CD ROM from the drive. 8. Type reboot to reboot the system. You have completed the procedure for installing CVLAN R9 Server for Linux. Now you are ready for the next procedure, Installing the CVLAN Server license file. Issue 1 March

28 Installing and setting up Avaya CVLAN Server 9.0 for Linux Installing the CVLAN Server license file The CVLAN Server license file is not included on the CVLAN Server for Linux CD-ROM. It is distributed separately in an from Avaya. If you have not received a license file from Avaya, see If you do not have a license on page 31. Follow these steps to install the license file Important:! Important: You must install the CVLAN Server software (which includes WebLM) before you can install the license file. Also, you can install the license file only once. 1. Locate the containing the CVLAN Server license file. Detach the license file from the , and store it locally on a PC. The PC that the license file is stored on does not have to be same PC that the CVLAN Server is installed on. 2. Start your browser and type the appropriate URL based on this example: Substitute <cvlanhostname> and <port> with your CVLAN Server s host name (or IP address) and port number (the default port number is 8080), for example: or Your browser displays the Avaya WebLM page, which contains a License Administration link and a Host ID, which is the MAC address of the NIC (in a dual NIC installation the Host ID is the MAC address of the first NIC WebLM reads). 00A12B345C6D 28 CVLAN Installation and Basic Administration Guide

29 Installing the CVLAN Server license file Note: 3. Click License Administration. Your browser displays the WebLM Administrator Login page. 4. Accept the default User name (admin) and leave the Password blank, then click Continue. Your browser displays the Change Administrator Password page Note: WebLM issues the Change Administrator Password page the first time you log in to WebLM. If you get a new license, you do not have to change your password the next time you log in to WebLM. 5. Complete the Change Administrator Password page (leave the Old Password field blank the first time you set up your password), and click Change Password. Your browser displays the License Administration page, 6. Under Install License File, click Browse and locate the CVLAN Server license file. Once you have located the license file, click Install. WebLM uploads the license file from your PC to the WebLM server, and displays the following message License File is installed successfully. If you do not receive this message see Troubleshooting the CVLAN license installation This completes the CVLAN license installation, and you are ready to continue with the activity described in Administering a CTI link on Avaya Communication Manager. Issue 1 March

30 Installing and setting up Avaya CVLAN Server 9.0 for Linux Troubleshooting the CVLAN license installation Use the information in this section to help you troubleshoot problems you might encounter during installation of the license. It covers the following topics. If you receive error messages from WebLM If you do not have a license If you receive error messages from WebLM If your browser displays the following messages contact your Avaya representative. Message License file is invalid or not created for this server. License file was NOT installed. Attemting to install a license file that is currently installed. License file was NOT installed Explanation The file is corrupt or the MAC address in the license file does not match the MAC address in the server. The license has already been activated. 30 CVLAN Installation and Basic Administration Guide

31 Troubleshooting the CVLAN license installation If you do not have a license If you discover that you have not received the CVLAN Server license file in an from Avaya, contact your Avaya representative or Avaya Partner representative. To ensure that your request is processed as quickly as possible, be ready to provide the information listed in Required information for requesting a license file. Note: Note: You must send a separate request for each license file. Required information for requesting a license file Required information Return address MAC Address of the NIC Description Avaya s this license file to you. You must provide a secure address where you want to receive the license file. For more information, see Identifying the MAC address. Identifying the MAC address If you have already installed CVLAN, use WebLM to identify the MAC address of the NIC. Follow Step 2 of Installing the CVLAN Server license file on page 28. As an alternate method (if you have not installed CVLAN), you can use the Linux ifconfig command to identify the MAC address of the Network Interface Card (NIC) on your PC. 1. Click the Red Hat icon (Main Menu) > System Tools >Terminal to get the command prompt. 2. At the prompt enter ifconfig 3. Linux displays each MAC address on a separate line, for example AB4567 Important:! Important: If ifconfig displays more than one MAC address, use the first MAC address in the list for requesting the license file. Issue 1 March

32 Installing and setting up Avaya CVLAN Server 9.0 for Linux CTI links In simplest terms, a link is a communications path (for example a LAN connection) between the CVLAN Server and Avaya Communication Manager. In terms of Avaya Communication Manager, the generic term for a link is a CTI Link. Communication Manager supports four link types, but only two are used by the CVLAN Server. For more information, see Link types. Link administration For communications to take place between Avaya Communication Manager and CVLAN, two basic administrative tasks must be carried out. Avaya Communication Manager must be set up to communicate with CVLAN (see Administering a CTI link on Avaya Communication Manager on page 33). The CVLAN Server must be set up to communicate with Avaya Communication Manager (see Chapter 3: Administering Avaya CVLAN Server 9.0 for Linux on page 37). Link types The CVLAN Server supports two link types, CVLAN and Proprietary. In terms of Avaya Communication Manager, CVLAN links correspond to ASAI-IP links and Proprietary Links correspond to ADJ-IP links. Table 2-4: Link Types restates this in table format for easy reference. For more information about Link Types, see Chapter 14 of the Avaya Communication Manager, Release 2.0, ASAI Technical Reference. Table 2-4: Link Types CVLAN Server (Edit Link Web page in OAM) CVLAN Proprietary Avaya Communication Manager (System Parameters Customer Options Screen) ASAI-IP ADJ-IP 32 CVLAN Installation and Basic Administration Guide

33 Administering a CTI link on Avaya Communication Manager Administering a CTI link on Avaya Communication Manager This section provides you with two representative scenarios for administering a CTI link on an Avaya Media Server that relies on a Co-resident DLG for communicating with the CVLAN Server. Administering a CTI Link on configurations with Processor Ethernet connectivity on page 34 Administering a CTI Link on configurations with C-LAN connectivity on page 35 Issue 1 March

34 Installing and setting up Avaya CVLAN Server 9.0 for Linux Administering a CTI Link on configurations with Processor Ethernet connectivity This section provides the procedure for administering a CTI link for Avaya Communication Manager on the following media servers: Avaya S8100 Media Server Avaya S8300 Media Server Note: Note: The following procedure assumes that the DLG has been administered. For more information, see Administering the Co-resident DLG service over Processor Ethernet on page 74. Procedure to administer a CTI Link -- Processor Ethernet Connectivity Follow these steps from a Communication Manager system access terminal (SAT) to administer a CTI link (Link Type: ASAI-IP) for configurations that use the Processor Ethernet for IP connectivity. This procedure assumes you are running the appropriate level of software. 1. Type change node-names ip and follow Steps a and b on the IP Node Names screen. a. In the Name field, type <name of CVLAN Server> b. In the IP Address field, type <IP address of CVLAN Server> 2. Type add cti-link <link number> and follow Steps a through c on the CTI Link screen. a. In the Extension field, type <station extension> b. In the Type field, type ASAI-IP c. In the Name field, type <name of CVLAN Server> 3. Type change ip-services, and follow Steps a through e. a. Go to the DLG Administration page of the IP Services screen. b. In the CTI Link field, type <link number> c. In the Enabled field, type y d. In the Client Name field, type <name of CVLAN Server> e. In the Client Link field, type <link number of CVLAN Server> 4. Type status dlg cti-link, and on the DLG CTI Link Status screen, verify that the Service State field displays established. This completes the procedure for administering a CTI link. 34 CVLAN Installation and Basic Administration Guide

35 Administering a CTI link on Avaya Communication Manager Administering a CTI Link on configurations with C-LAN connectivity This section provides the procedure for administering a CTI link for Avaya Communications Manager on the following servers: Avaya S8100 Media Server Avaya S8500 Media Server Avaya S8700 Media Server Avaya DEFIFINTY Server G3si Avaya DEFIFINTY Server G3csi Note: Note: The following procedure assumes that a C-LAN board has been installed and that the Co-resident DLG has been administered. For more information, see Administering the Co-resident DLG service over C-LAN on page 75. Procedure for administering a CTI link -- C-LAN connectivity Follow these steps from a Communication Manager system access terminal (SAT) to administer a CTI Link (Link Type: ASAI-IP) for configurations that use the C-LAN board for IP connectivity. This procedure assumes you are running the appropriate level of software. 1. Type change node-names ip and follow Steps a and b on the IP Node Names screen. a. In the Name field, type <name of CVLAN Server> b. In the IP Address field, type <IP address of CVLAN Server> 2. Type add cti-link <link number> and follow Steps a through c on the CTI Link screen. a. In the Extension field, type <station extension> b. In the Type field, type ASAI-IP c. In the Name field, type <name of CVLAN Server> 3. Type change IP services and follow Steps a through e. a. Go to the DLG Administration page of the IP Services screen b. In the CTI Link field, type <link number> c. In the Enabled field, type y d. In the Client Name field, type <name of CVLAN Server> e. In the Client Link field, type <link number of CVLAN Server> Issue 1 March

36 Installing and setting up Avaya CVLAN Server 9.0 for Linux 4. Type status dlg cti-link, and on the DLG CTI Link Status screen, verify that the Service State field displays established. This completes the procedure for administering a CTI link. 36 CVLAN Installation and Basic Administration Guide

37 Chapter 3: Administering Avaya CVLAN Server 9.0 for Linux This chapter is primarily a quick reference for administering Avaya CVLAN Server 9.0 for Linux (also referred to as the CVLAN Server or CVLAN) using the Web-based Operations Administration and Maintenance (OAM) interface. It includes the following topics: Logging on to CVLAN OAM on page 38 Commands and Web pages you will be using on page 40 Basic CVLAN administration procedure on page 41 In addition to OAM based CVLAN administration, this chapter also includes the following server-based administrative tasks. Configuring Avaya CVLAN Server 9.0 for Linux on page 48 Guidelines for configuring TCP/IP on page 49 Removing Avaya CVLAN Server 9.0 for Linux on page 51 Upgrading CVLAN on page 52 Issue 1 March

38 Administering Avaya CVLAN Server 9.0 for Linux Logging on to CVLAN OAM Follow this procedure to log on to the CVLAN Web based OAM. 1. Start your Web browser and type the following URL to start the CVLAN OAM interface: Substitute hostname with the host name of the Linux PC running the CVLAN Server. Substitute port with the appropriate port number (the default port number is 8080). The OAM interface displays the Logon page. 38 CVLAN Installation and Basic Administration Guide

39 Logging on to CVLAN OAM 2. Type your username and password and click Login. Recall that you can not log on to CVLAN OAM as root. The system displays the Welcome page. cvadmin 3. Review the status messages that are displayed on the Welcome page, and click Help for more information. Issue 1 March

40 Administering Avaya CVLAN Server 9.0 for Linux Commands and Web pages you will be using This chapter relies on a basic subset of the CVLAN administrative commands and Web pages. Table 3-1: Quick reference to OAM Web pages provides a quick reference for the OAM Web pages that you will be using. Table 3-1: Quick reference to OAM Web pages Web page Switch connections Ping Host Links Edit Link Edit Clients Link Status and Control Function Lets you create a Connection Name. A connection name can refer to: one IP address or multiple IP addresses (up to 64) that are assigned to the C-LAN boards on the Avaya Media server. one host name or multiple host names (up to 64) that are that are assigned to the C-LAN boards on the Avaya Media server. a collection of host names and IP addresses that are assigned to the C-LAN boards on the Avaya Media server. The total of host names and IP addresses can not exceed 64. Note: Note: The ability to use a connection name that refers to multiple connections requires a multiple connection license. Lets you determine if the server running Avaya Communication Manager (switch) is online and communicating with the CVLAN Server. Lets you administer your links. Lets you edit settings for each link. Lets you add CVLAN clients. Lets you observe the status of links and enables you to take a link out of service, put a link into service, or disconnect a link. Additionally it lets you set the time interval for capturing information about message traffic. 40 CVLAN Installation and Basic Administration Guide

41 Basic CVLAN administration procedure Basic CVLAN administration procedure Follow this procedure to set up your CVLAN Server and to enable your CVLAN Clients to communicate with the Avaya Communication Manager (by way of the CVLAN Server). This administration procedure assumes you are using two Network Interface Cards (NIC). If you are only using one NIC, skip Step 2.! Important: Important: To ensure that you are viewing the most current state of an OAM Web page, you mush either press Shift and click Refresh, or set up your browser to stop caching pages. This procedure assumes that you have logged on to CVLAN OAM. If you have not logged on, see Logging on to CVLAN OAM on page In the left panel of the OAM Web page, click Local IP. The system displays the Local IP page Follow Steps a through c to complete the Local IP page. a. In the list box under Select local IP address for Switch connectivity, select the IP address of the NIC card you want to use for communications with Avaya Communication Manager. It is recommended that you use a private LAN connection between the CVLAN Server and Avaya Communication Manager. b. In the list box under Select local IP address for Client connectivity, select the IP address of the NIC card you want to use for communications with CVLAN clients. In the case of Client connectivity you might find it advantageous to use a public LAN connection between the CVLAN Server and CVLAN clients. c. Click Apply to put your changes into effect. Issue 1 March

42 Administering Avaya CVLAN Server 9.0 for Linux 2. In the left panel of the OAM Web page, click Switch Connections. The system displays the Switch Connections page. 3. In the Add Connection text box, type a name you want to assign to the switch (for example, demo) and click Add Connection. (The name can be any name you want to use -- switch names allow alphanumeric characters and only one special character, the dash - ). 42 CVLAN Installation and Basic Administration Guide

43 Basic CVLAN administration procedure The system displays a new page with the title Edit IP - demo (the page title reflects the name of the connection that was just added) At this point you can add an IP address (or addresses) of C-LAN boards that you want to associate with that particular connection name. Each IP address you add appears as the last member of the list of IP addresses. You can change the priority of the IP address by selecting the IP address and clicking Up (sets it to a higher priority) or Down (sets it to a lower priority). Issue 1 March

44 Administering Avaya CVLAN Server 9.0 for Linux 5. In the left panel of the OAM web page, click Ping Host. The system displays the Host/IP Page. 6. In the Host/IP list box, type the IP address of the C-LAN board and click Ping. If the system displays a message that indicates a packet size and a packet count the ping is successful. For example. Packet Size : 64 bytes Packet Count : 5 44 CVLAN Installation and Basic Administration Guide