PathTrak/WebView 2.5 MACTrak Setup Tutorial

Transcription

1 PathTrak/WebView 2.5 MACTrak Setup Tutorial Jim Walsh Product Manager - PathTrak Systems & Software Cable Networks Division 5808 Churchman Bypass Indianapolis, IN Jim.walsh@jdsu.com

2 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s Install/Upgrade WebView 2.5 Import UCD Info Check for carrier/ucd match Begin Solving Problems! 2

3 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? 3

4 What Do You Need To Get Started? Does your PathTrak and/or WebView server meet minimum requirements ( If upgrading is your current PathTrak server at version 2.4 or higher? If upgrading is your current WebView server at version 2.1 or higher? Do you have a valid license key for PathTrak and WebView servers if new installs Do you have a DOCSIS 2.0 or higher DSAM with version 3.6 or higher firmware Do you have a serial cable for DSAM and PC with serial port capability (or USB-COM adapter) Only required for certain UCD import methods Do you have a copy of PathTrak Server/Client version 2.5 and WebView version 2.5 software Download from JDSU.com/PathTrak 4

5 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client 5

6 Upgrade PathTrak Server/Client Simplified Instructions (From version 2.3 SP7 or higher) Server Upgrade from version 2.4 or higher: It is important to note that the PathTrak Server/Client upgrade procedure is a two step procedure, the setup.exe file must be executed twice to successfully complete the installation. Your PathTrak server will not be operational after the reboot following the first setup.exe execution, it will not be capable of resuming operation until after setup.exe is executed the second time and the server is rebooted again. Place the PathTrak CD in the CD-ROM of the PC or note the directory containing downloaded setup files. From the Start Button select Run. Browse to the drive that contains the PathTrak CD or downloaded setup files. Select Setup.exe from the list of files. In order to upgrade the server version of the software, you MUST add the following switch to the Setup.exe file before running it: server. The file name in the Run window should read, X:\Setup.exe server, where X is letter of the computer s CD-ROM drive or path to downloaded setup files. Click the OK button. You will then be prompted to reboot the PC and execute setup.exe after the first reboot is complete. Once the reboot is complete repeat Step 2 from above (run setup.exe /server AGAIN) You will now be welcomed to the PathTrak installation. Click on the Next button and follow prompts to complete server upgrade The client on the server will be upgraded automatically PathTrak cannot be installed or upgraded on the server PC via remote access (VNC, RAdmin, Windows Remote Desktop, etc.) program. Any attempt to do this may result in the total loss of all data as corruption of the database will occur!!! Click Here for Full PathTrak Server/Client Install Guide 6

7 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s 7

8 Upgrade HCU and RPM Cards PathTrak FW upgrade process has changed in PathTrak 2.5! All PathTrak FW upgrades are now contained within the HCU upgrade package RPM and HSM upgrades occur automatically when an HCU upgrade is performed RPM and HSM firmware versions are checked upon each HCU boot cycle, upgrades occur automatically if not at latest version HCU Upgrade Process: Select the HCU from the System View in PathTrak Client From the Tools menu, select Update firmware The Upgrade Summary dialog box is displayed showing Firmware versions available within the current PathTrak Server version Click OK to continue HCU upgrades will require approximately 5 minutes to execute While the upgrade is in progress the HCU and all RPM cards contained within it will be grayed out and inaccessible for use The Wrench icon on the HCU indicates an upgrade is in progress (see picture) When the upgrade is complete the HCU and all RPM cards contained within it will automatically re-enable 8

9 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s Install/Upgrade WebView 2.5 9

10 Upgrade WebView Place the JDSU PathTrak WebView CD in the PathTrak WebView Server s CD-ROM drive or navigate to the location of the downloaded setup file 2. Launch the WebView Installer executable file 3. NOTE: THERE WILL BE A DELAY BEFORE INSTALLER STARTS UP 4. Exit all running programs and click the Next button 5. Accept the license agreement, click the "Next" button 6. Confirm the folder to install the JDSU PathTrak WebView upgrade 7. Next follow the screen prompts to install the UCD Import Tool program and icons 8. Once the installation is complete, click the Done button 9. When InstallAnywhere is finished close all PathTrak WebView windows Click Here for Full WebView Install Guide 10

11 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s Install/Upgrade WebView 2.5 Import UCD Info 11

12 UCD Import Information What is a UCD and why do I need to import them to fully utilize WebView 2.5? UCD: Upstream Channel Descriptor Information sent by the CMTS during the Range/Register process and typically every two seconds thereafter to all cable modems telling them how to communicate on the DOCSIS network The UCD contains information needed by WebView to decode the MAC address from an upstream DOCSIS packet and to detect Codeword Errors Examples of UCD Content: modulation type, symbol rate, preamble information, FEC settings, etc UCDs are frequently common across CMTS ports within a chassis as well as CMTSs of the same make/model within a system PathTrak automatically determines which UCD is associated with an upstream (if a match can be found) What is the UCD Import Tool? The UCD Import Tool is a standalone JDSU tool used to acquire Upstream UCD information from the downstream(s) associated with upstreams on each node In bonded downstream environments only Primary downstreams contain UCD information UCD Import Tool is installed on the WebView Server machine plus as many additional machines as desired (technician laptops, etc) How does the import process work (High-Level): The UCD Import Toll will command a DSAM with an RF connection to the HFC to begin the Range/Register process on a specified downstream The DSAM will capture needed UCD parameters from the downstream and feed them back to UCD Import Tool The PC running the UCD Import Tool will then: Send UCD information directly to WebView server if LAN connectivity exists Save the UCD information to a local file for future export if LAN connectivity does not exist 12

13 UCD Import Tool Installation and Configuration DSAM Requirements Must have version 3.6 or higher firmware Must have DOCSIS2.0 or higher hardware to capture DOCSIS2.0 UCD s Installation Instructions: Obtain a copy of UCD Import Tool Installer Launch Setup.exe and follow prompts to install the application Configuration Instructions: Launch application and select File Properties and enter IP address of WebView server Not necessary if PC with tool installed is to be used in offline mode only Select the appropriate DOCSIS Annex under the File Properties menu item Annex A: Europe, China, Australia Annex B: Unites States, South America, Korea, Taiwan, Japan Click Here for Full UCD Import Tool Users Guide 13

14 UCD Import Process: Online Method Used When Network Connectivity to WV Server Is Available Laptop with UCD Import Tool Installed WebView Ethernet Serial Cable RF Connection to Downstream Tech Runs UCD Import Tool Menu: DSAM Import DSAM Direct Enter Import Name Enter Downstream Frequency Click Import Click Save to Complete (Output will be sent to WV Server) 1. Ensure that UCDImportTool is configured with correct WebView Server IP address (File Properties menu in ucdimporttool) 2. If connectivity is successfully established with WebView server the green Database Online indicator will illuminate in lower left corner of ucdimporttool screen shortly after app is launched 3. Connect the DSAM s RF port 1 to the DOCSIS downstream 4. Connect the DSAM s serial cable to the PC with the ucd import tool installed 5. From the UCD Import Tool menu select Import DSAM Direct. The tool will display an import config dialog 6. Enter the Import name and the DOCSIS Downstream channel frequency and click the import button 7. The application will search the serial ports for the connected DSAM and initiate a DOCSIS range and register cycle. As a result of the range and register the DSAM will send the UCD information to the tool 8. When completed the dialog will display the upstreams that were detected and illuminate the Save button. Press the Save button to save the UCD info on the WebView server. 14

15 UCD Import Process: Offline Method Used When Network Connectivity to WV Server Is NOT Available Laptop with UCD Import Tool Installed WebView Serial Cable RF Connection to Downstream Tech Runs UCD Import Tool Menu: DSAM Import DSAM Direct Enter Import Name Enter Downstream Frequency Click Import Click Save to Complete (Output will be saved to laptop drive) 1. Connect the DSAM s RF port 1 to the DOCSIS downstream 2. Connect the DSAM s serial cable to the PC with the ucd import tool installed 3. From the UCD Import Tool menu select Import DSAM Direct. The tool will display an import config dialog 4. Enter the Import name and the DOCSIS Downstream channel frequency and click the import button 5. The application will search the serial ports for the connected DSAM and initiate a DOCSIS range and register cycle. As a result of the range and register the DSAM will send the UCD information to the tool 6. When completed the dialog will display the upstreams that were detected and illuminate the Save button. Press the Save button to save the UCD info Transfer file to WebView server via flash drive, , or other method at a later time 2. From WebView server or any PC with connectivity to the WV server, select File, Import DSAM File, select the import file from above, and click Open. 3. After successful import file name should be visible in tree structure. 15

16 UCD Import Process: Remote DSAM Method Used When Network Connectivity to WV Server Is Available WebView Server with UCD Import Tool Installed -or- PC with LAN access to WV server RF Connection to Downstream Tech Instructions: Connect the DSAM s RF port 1 to the DOCSIS downstream Connect the DSAM s ethernet port to a LAN that access to the PC with the UCD Import Tool installed Configure the DSAM in remote DSAM mode and communicate IP address of the DSAM to WebView Administrator How to access Remote DSAM function: Config Round Button General Softkey Diagnostic Menu Item Use Virtual DSAM Menu Item WebView Admin Instructions: Ensure that UCDImportTool is configured with correct WebView Server IP address (File Properties menu in ucdimporttool) From the UCD Import Tool menu select Import Remote DSAM The tool will prompt the user for the DSAM s IP address, Enter the IP address and press Ok. The tool will display an import configuration dialog Enter the Import name and the DOCSIS Downstream channel frequency and click the import button. The application will connect to the DSAM and initiate a DOCSIS range and register cycle. As a result of the range and register the DSAM will send the UCD information to the tool. When completed the dialog will display the upstreams that were detected and enable the Save button. Press the save button to save the UCD info. 16

17 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s Install/Upgrade WebView 2.5 Import UCD Info Check for carrier/ucd match Note: It may take up to 15 minutes for imported UCD s to be recognized by QAMTrak 17

18 Checking for UCD Match (MACTrak Available?) Objective: Sample nodes from the upgraded server to determine if additional UCD imports are necessary From the Webview Reports menu, select QAMTrak Analyzer link Select HCU containing a node of interest Note: Search can be used to find node based on Node Label as defined in PathTrak Client QAMTrak Analyzer Settings screen will be presented If no Upstream Channels are displayed then right-click within the blank selection area and select Scan For Upstream Channels If the list of upstream channels is incorrect or incomplete right click and select Clear Then Scan For Upstream Channels Note: There must be modem traffic present for a channel to be detected by the PathTrak auto channel scan Note: Channel Scan will occur automatically once per day Once all upstream channels are displayed note the MACTrak Available column: All carriers should show MACTrak as available If not, UCD import must be performed for downstream(s) serving this node Repeat this process sampling nodes until you are satisfied that UCD captures are complete In MOST systems sampling all upstreams on one or two nodes per CMTS is adequate to gain high confidence that UCD coverage is complete 18

19 PathTrak/WebView 2.5 Getting Started Do You Have All Required Items? Install/Upgrade PathTrak Server/Client Upgrade HCU/RPM s Install/Upgrade WebView 2.5 Import UCD Info Check for carrier/ucd match Begin Solving Problems! Click Here for WebView 2.5 User Training Video (71MB, 33 minutes) 19

20 How to Specify Which Carrier to Demodulate Auto Channel Detect vs Manual Channel Specification Choose Upstream Channels Tab to pick from a list of auto-detected channels All parameters will be set automatically once channel is chosen MACTrak will be available if indicated in far right column Choose Advanced Tab to manually specify channel parameters Proper Carrier Level and Attenuation settings are critical to demod operation MACTrak and Codeword Error detection will NOT be available when in Advanced mode This is the recommended approach Use this approach only when absolutely needed 20

21 Filtering Using the QAMTrak Analyzer Choose the Filter Tab from the QAMTrak Analyzer Settings Screen Select which item(s) you wish to filter on Filters can be combined any combination of the three MER filter can use Equalized or Unequalized MER Codeword Error filter can filter on packets with Uncorrectable codeword errors or any Codeword errors Filters on number of CWE s per packet, not CWE rate MAC address filter can use., ;, or no separators between character pairs 21

22 Backup Material 22

23 What Is A Codeword Error? Upstream DOCSIS Packet Codeword 1 Codeword 2 Codeword n Typically 5-8 CW s/packet (64QAM) Byte 1 Byte 2 Byte k 2 * T Parity Bytes Typically k + 2 * T Bytes/CW (Normally ~ Bytes/CW) Bit 1 Bit 2 Bit n 8 Bits/Byte Symbol 6 Bits/Symbol for 64QAM (4 for 16QAM) Q: What is a codeword? A: A data container within a DOCSIS packet normally comprised of k + 2 * T bytes of data, where k is the number of FEC information bytes and 2 * T is the number of FEC parity bytes Q: What is a Codeword Error (CWE)? A: A codeword with one or more errored bytes resulting from errored symbols which requires forward error correction (FEC) algorithm intervention to restore data integrity Q: What s the difference between a Correctable and Uncorrectable CWE? A: If FEC can reconstruct the packet at the bit level, it is correctable A: If number of errored bytes is greater than T and/or there are errors in decoded 2 * T parity bytes, correction can t be accomplished and it is an uncorrectable (Data is lost!) 23

24 What Are CWEs and Why Are They So Important? What is a Codeword? A codeword is a data bucket within a DOCSIS packet Typical 64-QAM data packet has 5-8 codewords Typical 64-QAM CW contains bytes What Is a Codeword Error?: A byte-level data packet corruption resulting from displacement of individual QAM symbols across constellation decision boundaries Correctable vs Uncorrectable determined by number of corrupted symbols relative to CMTS forward error correction level settings = Normal Symbol Location = Displaced Symbol Why Are They So Important? CWEs capture impact of all HFC impairments on customer packets! If you are having CWEs you may be losing data Uncorrectable CWEs indicate dropped packets (think post-fec BER in DS) Retransmit is required for recovery with HSD uses There is no recovery from dropped packets for real-time apps like VOIP! Correctable CWEs are an early-warning that the uncorrectable threshold is near! (think pre-fec BER in DS) 24

25 What Is An Errored Symbol? All symbols contained within their correct decision boundaries Likely Result: No CWE s One symbol crosses decision boundary into neighboring cell. Likely Result: Correctable CWE Many symbols cross decision boundaries into neighboring cells. Likely Result: Uncorrectable CWE 25

26 How to Properly Set Carrier Level and Attenuation Not Needed When Using Auto Carrier Detection!!! QAMTrak analyzer will stop demodulating if an Overrange condition is detected QAMTrak analyzer can deliver anomalous results if Carrier Level is set too low Spot in center of constellation is an indicator of level set too low Remember if using auto-carrier detect these setting are done automatically for you To Set Carrier Level/Attenuation: Open Spectrum Analyzer for node to be analyzed Set RBW to match the carrier of interest Look for red Overrange indicator in upper right corner of display If indicator appears, increase attenuation 2-3 db at a time until Overrange goes away Note value where Overrange went away, this is your QAMTrak Attenuation setting Note the carrier level in peak hold build-up, this will be your Carrier Level setting in QAMTrak 26