Installation Guide Version 4.X and 5.X Copyright © 1997-2011 by Impact Technologies, Inc.
TRAFFIC ANALYST INSTALLATION GUIDE Copyright © 1997-2011 by Impact Technologies, Inc. All rights reserved. Information in this document is subject to change without notice. No part of this document may be photocopied, reproduced, or translated by any means without the prior written consent of Impact Technologies, Inc. Impact Technologies, Inc. 16650 Chesterfield Grove Chesterfield, MO 63005-1409 Main: (314) 743-1400 Technical Support: (314) 743-1420 Fax: (314) 743-1401 http://www.impacttech.
Table of Contents OVERVIEW 5 SECTION 1: SWITCH PREPARATION ...................................................................................................................6 1.1. SIEMENS HIPATH 4000 ..................................................................................................................................... 6 1.1.1. Pre-Installation Notes................................................................................................................................. 6 1.2.
.1. CONFIGURING IIS WITH ARR (WINDOWS 7, 2008, VISTA).................................................................................
Overview This document contains sections on everything you need to know to install Traffic Analyst including estimated time of completion. It is organized into the following sections: Section 1: Switch Preparation Before you can poll, the switch may need to be prepared. Read the sections for those switch types you are interested in, and if necessary, take the actions required to get them ready.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Section 1: Preparation The preparation required for each type of switch is described in this section. 1.1. Server preparation for the Traffic Analyst Installer Make sure Internet Information Services (IIS), IIS 7 for windows 2008 is installed on the Traffic Analyst server. Make sure .NET Framework 3.5 is installed on the Traffic Analyst server. Windows 2008 R2 need to “Start” the Application Pool for ASP .NET V2.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E From this next tab, choose the “General Settings” option from the list of the left. (If you have more than one OpenScape Voice switch, choose the appropriate switch and repeat the following steps for each of the OpenScape Voice.) Select the CDR Settings option under General Settings. You will see a Configure CDR settings window display. On the Configure CDR settings window, select “Pull” as the “CDR Delivery Method”.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E You can check the fields on the Options tab, but they don’t normally need to be changed. The default of 30 days for the data retention period is good unless you are worried about disk space and want to lower it. Normally, Traffic Analyst will collect this data daily regardless, so this data retention period here is only helpful if Traffic Analyst hasn’t collected for some reason and needs to go back and get older data.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E In the General tab of the Business Group window, find the “Message Detail Records” section at the bottom of the screen. Complete the “Customer Identification” field by entering a string of numbers by which you will identify this business group in reports. Note: Each business group is not required to have a unique Customer ID.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E At the “Login:” prompt, enter “sysad”. You should then see the main menu. Pick option 6,Application-Level Management. You’ll then see the Application-Level Management menu.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Now pick option 8, Network Element Security Management Pick option 4, Packet Filter Rules Security Management. Now we need to create a rule that will given the PC running Traffic Analyst access to the OSV API. You will need to know the IP address of that PC. You will also need to enter a mask to go with that IP address. To allow access for only that one IP address, use the mask value 255.255.255.255.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E To create a new rule, pick option 1, Create. • For the Packet Filter Rule Name, enter “Traffic”. • For the description, enter “TA Rule”. • Then hit enter at the Remote FQDN prompt. • Enter the IP address of the PC running Traffic Analyst at the Remote IP prompt. • Then enter the mask you chose at the Remote NetMask prompt. • Hit enter at the Transport Protocol prompt. • Then enter 3 for bothways at the Direction prompt.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E retrieving the data from HiPath Manager or HiPath 5000 RSM, you may use a TCP/IP connection or network file access. If you will be retrieving data from HiPath Manager or HiPath 5000 RSM via TCP/IP, the File Transfer Protocol (FTP) must be used. If the data is sent via TCP/IP connection, the TCP/IP protocol must be unimpeded. In particular no router, firewall, or other network device should restrict use.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Call Duration – checked On Ringing – checked (option not available in Hicom Assistant) Output MSN – unchecked Decimal Format – checked Display amounts instead of units – unchecked Outgoing without connection – checked Output LCR number outgoing or dialed number incoming – unchecked Next, in the Output format dropdown (located in the CDR systems section of the window), select LAN-TCP-Client (or None if using HiPath 5000 RSM).
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Separator - ; You must click the Apply button to save the changes. If retrieving data from HiPath 5000 RSM, it must be configured to receive CDR data from the switch. When the above activities are done, go to the section entitled “Traffic Analyst Software Installation”. 1.6. Siemens Hicom 300E and 9751 Models 30 and 80 1.6.1.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 1.6.2.2. Obtain Switch Username & Password Obtain the switch user name and password that must be defined and available for Traffic Analyst to log-on to the switch. The username and password must provide access to the "UDSC" menu and contain the LTDR (List Traffic Data Retrieval) option. It is OK if other menu options also appear. Suggested to use the rsca username. 1.6.2.3.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E • • • • • • • • • • consoles lines internode or INL tone senders DTMF registers rotary senders conference bridges event and peg counts PhoneMail system information After polling, the data is parsed and stored into hourly results in the Traffic Analyst database. 1.7.2. Installation Instructions As you complete the following activities, put a check mark in the box next to each of the following items: 1.7.2.1.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 1.8. Nortel SL1 and M1 – All Models 1.8.1. Pre-Installation Notes (Call Accounting) For CDR data, Nortel switches create CDR files that can be pulled from the switch using FTP. Alternatively, the CDR data can be streamed to a buffer box, with the data being pulled from the buffer box using FTP. The CDR parameters should be set to output the “New” SL-1 CDR format. This corresponds to setting the FCDR in LD 17 to “NEW”.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 1.8.3.1. Configuring the Switch Traffic data is the only data that should be configured on the port. CDR, alarms, and maintenance messages must be output to a separate port from the LD 2 traffic data. The data streams cannot be sent to the same port. 1.8.3.1.1. Choose the Type of Configuration 1.8.3.1.1.1.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E steps used by Traffic Analyst with a serial connection or IP connection using a Lantronix UDS-10 terminal server. • • Establish the rlogin session with the Nortel switch. “rlogin –l CPSIDnnnn nnn.nnn.nnn.nnn” where the four digits after “CPSID” are a set of ones and zeros, and nnn.nnn.nnn.nnn is the IP Address of the Nortel switch. Once the rlogin connection is established enter a to launch the Nortel interactive shell.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E • • • • • PASS? After the log-in confirmation message type a return. At “>” prompt enter: LD 2 At ”.” prompts invoke Load 2 commands to retrieve traffic data, such as: . Invc 0 2 . Invc 0 3 . Invs 1 When finished with Load 2 commands type four (4) asterisks “****”. Drop the SSH connection. These commands can be performed by hand for confirmation.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 1234567 these numbers represent the days of the week to be stored. (Sunday – Saturday) Note: When the above activities are done, go to the section entitled “Traffic Analyst Software Installation”. 1.9. Avaya – All Models 1.9.1. Pre-Installation Notes Avaya switch CDR data is retrieved either from the switch’s hard disk (called Survivable CDR) or the CDR may be streamed to a buffer box.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E JANUARY 2011 1. Start ASA and select File | New Voice System. 2. Choose Add New Voice System and select OK.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 3. Enter a Voice System Name and select Next. 4. Choose the type of connection used to communicate with the switch then select Next. Modem or data module Direct serial port connection Network connection a) For Modem or data module connection: Choose Device from the drop-down list and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Choose the appropriate Port from the drop-down list and select Next. Choose the appropriate Port Settings for the communication device and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Enter the Phone Number of the switch to be dialed, making sure to include any outside access numbers if necessary, then select Next. Leave this screen at the default values and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Choose the appropriate Port from the drop-down list and select Next. Choose the appropriate Port Settings for the communication device and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Enter the FQDN or IP address of the switch. Accept the default TCP/IP Port Number of 23 and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Accept the defaults and select Next. 5. Choose I want Avaya SA to log me in automatically. Select Next. 6. JANUARY 2011 Enter the Login ID (Super-user permissions) and choose either Password or ASG radio button.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E a) For Password option: Enter Password then select Next. b) For ASG option: Enter Secret Key and select Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 7. Review the Summary Screen. Select Test to attempt the connection with the switch. If test fails, make appropriate changes to the communications until the test is successful then select Next. 8. JANUARY 2011 Select Finish to complete the setup.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 1.9.3.1.2. Data Collection Scheduling Data Collection may be scheduled daily or hourly with Traffic Analyst. Data collection will be scheduled hourly when an hourly alarm is assigned to a switch. Follow the appropriate instructions below based on how data collection is scheduled within Traffic Analyst. 1.9.3.1.2.1. Hourly Scheduling Four reports must be polled from the switch in order to perform Hourly Polling of Traffic Analyst.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 4. In the Command(s) field enter: list measurements trunk-group hourly ;list aca-parameters;list measurements outage-trunk last-hour;list measurements lightly-used-trunk last-hour; Note: The first command “list measurements trunk-group hourly ;” must be entered for each trunk group. Example: A switch has 5 trunk groups with trunk group number 1,2,3,10,15.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 8. Select the Browse (…) button next to Export to file field. 9. Select Append to existing file. 10. Select the Browse (…) button next to Export file field. 11. Change the File name to hourlydata.txt. If multiple switches, either create a separate folder for each switch or make the filename unique (e.g. ChicagoHourlyData.txt, BostonHourlyData.txt, etc.).
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 12. Select the target directory from which Traffic Analyst will retrieve the file. 13. Select Open. 14. Select OK. 15. Select OK.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 16. Enter the desired start date. This should be the first date you want to start doing Traffic analysis. 17. Enter a 12:10:00 AM for the Time. If your start date is today you will need to readjust the time of day to be 10 minutes after the next hour. This allows the switch time generate the data for the previous time interval. So if it is currently 1:40 PM set the time to 2:10:00 PM. 18. Select Frequent as the Recurrence Pattern. 19.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Scheduling Daily Reports 1. Open ASA. 2. If more than one switch is defined select System | Target System.. | 3. In the Tasks tab, under the Advanced section, click on Report. 4.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 5. Select Export fields to file. 6. Select Append to existing file. 7. Select Append to existing file always. 8. Select Browse (…) next to the Export to file field. 9. Select Append to existing file. 10. Select Browse (…) next to the Export file field.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 11. Change File name to dailydata.txt. If multiple switches, either create a separate folder for each switch or make the filename unique (e.g. ChicagoDailyData.txt, BostonDailyData.txt, etc.). 12. Select the target directory from which Traffic Analyst will retrieve the file. 13. Select Open. 14. Select OK. 15. Select OK. 16. Enter the desired start date (tomorrow or later). This should be the first date you want to start doing Traffic analysis.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 17. Enter 12:15:00 AM for the Time. You will need to adjust the time of day if the switch is in a different time zone. You will want to poll 15 minutes after midnight on the switch. 18. Select Weekly for the Recurrence Pattern. 19. Select all days of the week. 20. Select Disconnect from system after task has been processed. 21. Select OK. 1.10. Cisco Unified Communications Manager 1.10.1.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E If you are using Traffic Analyst for more than one cluster, make sure that Cluster ID is set to a unique string of characters. The other CDR settings under Enterprise Parameters do not apply to Traffic Analyst’s CDR processing. 1.10.1.2. Cisco CDR Repository Manager The Cisco Unified Communication Manager sends CDR files to the Cisco CDR Repository Manager which then distributes the files to other applications.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Section 2: Traffic Analyst Software Installation Before installing the software, the switch(es) should be prepared for polling. Make sure all required Windows components have been installed. It is advised to double check for these. • .Net Framework 3.5 or greater • IIS or IIS 7 if using Windows 2008 Important Note: You must have administrative privileges to successfully install.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Run the ImpactInstall.exe program. Note: If using Windows Server 2008, right-click ImpactInstall.exe and select “Run as Administrator.” This is done so that proper security access is given to the install process.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E In this example we are going to install the Application Server and Web Service on a 32 bit OS.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Accept license agreement and click on Next The computer name will append to the default database name Database-ServerImpact, it is suggested to accept this name and click Next. If you change the name just make a note of the new name as you can not have two installations with the same database name.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Click on Next. If you need to change the drive you will do so here. Must be a local drive. Installation will start.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E The first step has completed now it will start the application installation.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Accept the license agreement and click on Next Click on Next JANUARY 2011 I M P AC T T E CH N O L OG I ES , I N C CONFI DENTI AL AND PROPRI ETARY 49
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Click on Next. If you need to change the drive you will do so here. Must select a drive with the appropriate disk space available. Must be a local drive. Default is 512. If you have 2 GB RAM enter 1024, IF 3GB RAM enter in 1536.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Application server is now completed. See Section 2.2 “Installing Web Application” for step by step instructions. The other components selected for installations will start now. When completed the Install Utility Screen will appear. All installed components are now displayed in “Bold” letters.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 2.1.1. Installing Traffic Analyst Client on Workstation Before installing the client software you will need to know the database name of the database installed on Traffic Analyst server. Also IP or Host name of the server where the database is running. Copy the TrafficAnlaystClientSetup.msi file from the Install CD to the workstation for installation.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E JANUARY 2011 I M P AC T T E CH N O L OG I ES , I N C CONFI DENTI AL AND PROPRI ETARY 53
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 2.1.2. Adding Traffic Analyst to the Startup Folder You can add Traffic Analyst to the Startup folder so that it starts up automatically whenever its computer is rebooted. Here are the steps: 1. Create a shortcut to the Traffic Analyst program file named ta2000.exe. On most systems, this is found in the c:\Impact Technologies\Traffic Analyst\bin directory. Copy this shortcut into the Startup Folder. 2.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Next the License screen will appear Accept license after reviewing and click on Next A window displays prompting you to accept the default installation directory for Traffic Analyst Web. Accept the default or browse to select a different location for the installation, and then click on Next.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E A window appears asking for the URL (Universal Resource Locator) for your database. If the web component is being installed on the same machine as the Traffic Analyst Server (recommended), then the URL is jdbc:sybase:Tds:localhost:2638. If the web component and Traffic Analyst Server are not installed on the same system, then the URL will be the same except replace localhost with the computer name of the Traffic Analyst Server.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E A window displays showing the location and size of the installation. Click on Next to continue. If you wish to change anything, click on Back to return to the appropriate window. You will then see an “Installing Traffic Web…Please wait.” window. When the progress shows 100%, there may be a few minutes before the next window appears while the configuration finishes. When finished, a window appears showing the installation as successful.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Please note that you may see a window prompting you to reboot if the install had to update any files that were already in use on your system. After you restart your computer (if necessary), you are finished installing Traffic Analyst on this machine.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Section 3: Installation of Additional Devices 3.1. Lantronix Device Server Traffic Analyst works with the UDS-10 Device Server manufactured by Lantronix. Lantronix UDS-10 Setup To configure the Lantronix, the following Network information is needed: ♦ A static IP address ♦ Subnet Mask IP Address ♦ Gateway IP Address Connect via PC serial port to UDS-10 serial port using Standard Modem cable.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E While powering on the UDS-10, hold down the “x” key on the keyboard until the UDS10 Menu appears. ♦ Hit [Enter] to get to the Change Setup menu. ♦ Hit 0 (zero) and [Enter]. ♦ Enter the static IP address that you will be using. ♦ Answer “Y” to Set Gateway. ♦ Enter the gateway address the same way as the IP address. ♦ Netmask: You will need to enter the number of bits that match your network configuration.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E • Scannex Following is a discussion on setting up these boxes. 3.2.1. Western Telematic 3.2.1.1. PollCat NetLink – NetLink Jr Traffic Analyst can poll data from Western Telematic's PollCat NetLink via TCP/IP or modem. It does this once a day, usually just after midnight and before the next day starts. The PollCat Netlink will accumulate all data for a day and provide it to Traffic Analyst on request.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E This portion will need to be completed if polling with TCPIP or Modem: Now select PBX Port A, PBX Port B or PBX Port AUX, whichever one that the Traffic data will be coming in on, and hit [Enter]. For POLLCAT Jr. (NLJ-512), you will only have a PBX Port A. Settings 1-4 for the PBX Port MUST match the settings to the port you are going to be using on the PBX, otherwise the PollCat will not be able to communicate with the switch.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 2. Traffic Analyst first looks for the prompt "PollCat-NetLink" and if it sees it, Traffic Analyst sends the password defined in its Switch Communications settings and waits for a "Ready" prompt to display. (Note: the password is case sensitive, so be careful that it is entered into Traffic Analyst correctly.) If Traffic Analyst does not see the "PollCat-Netlink" prompt, it looks for the "Ready" prompt anyway, and proceeds if it finds it.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Once you have finished configuring the Poll-Safe, you now need to connect it to your switch. The Input port is Configured as DTE port, most PBX ports are configured as DCE therefore most likely required configuration is a just a straight through cable. If the PBX port is also DTE you will need a NULL modem adapter also. Connect the serial cable to the Poll-Safe Input port. When this connection is properly made, the RXD IN LED should turn GREEN.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E JANUARY 2011 2. Click on the Spyglass icon. The ip.buffer should now be seen in the box below. Single click the buffer and then click the World symbol. 3. This should now take you to the web browser page of the ip.buffer. Click on the Setup tab and enter the Username (admin) and Password (secret). 4. Click on Global Settings.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E JANUARY 2011 5. Now click on Network (Network & System) settings …………show tab. 6. Change the fields to match your chosen IP address Subnet & Gateway, and then go to the bottom of the page and click Save. 7. Click on Global Date & Time and check to be sure that the time is correct. Click on Save when satisfied. 8. Click on Channels ….Channel 1.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E 9. In Source, the default should be Com 1 Serial, which is correct. 10. In Destination, select the correct output, FTP Server. Then click the Show tab to adjust the settings to your requirements. 11. In the Autodelete field, make sure that Delete After Download is selected. 12. Note the Username, Password, and Filename in the FTP Server section. This information needs to be entered in the Traffic Analyst Communication tab for this switch.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Section 4: Appendix 4.1. Configuring IIS with ARR (Windows 7, 2008, Vista) Follow the steps below to ensure that TrafficWeb is properly configured for using IIS to send Web requests to and from the TrafficWeb application via Tomcat services. NOTE: If not already on the server, IIS must be installed first, before installing ARR. To check if IIS is installed, open Administrative Tools from the Control Panel and then open the IIS Manager.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Click the Install button. Another window will appear. Click “I Accept” to agree to Microsoft license terms. Note: You may be prompted to reboot your computer after the installation is complete. If so, reboot your computer and continue with configuration. When ARR is finished installing, a window will appear informing you that the install was successful. Select Finish to close this window.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E After ARR is successfully installed, open the IIS Manager. You are going to configure IIS with a new ARR “Rewrite URL” rule. To configure IIS and ARR, click on the main IIS entry in the IIS Manager tree. You should see an “Application Request Routing” option. Select this option to open ARR. The following screen appears. Select Server Proxy Settings from the sidebar on the right to go on to the next step.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Scroll down to see the rest of the fields on this screen. Once this is configured, click Apply (located on the right sidebar in the Application Request Routing screen) to save your changes. Then, click on the URL Rewrite… option, also located in the right sidebar. The URL Rewrite screen will appear. Select Add Rule(s)… from the right sidebar.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E An Add Rule(s) dialog box will appear. Under Inbound Rules, select Blank Rule and click OK. You are now on the Edit Inbound Rule screen. Designate a name (e.g. TomcatProxy) for this rule in the Name field and make sure these fields are filled out as follows: • Requested URL – Matches the pattern • Using – Wildcards • Pattern – trafficweb* • Ignore case – checked • Action type – Rewrite • Rewrite URL – http://127.0.0.
T R AF F I C AN AL Y S T I N S T AL L A T I O N G UI D E Be sure to click Apply (in the right sidebar) to save your changes.