+ All Categories
Home > Documents > PathTrak/WebView 2.5 MACTrak Setup Tutorial · Upgrade WebView 2.5 1. Place the JDSU PathTrak...

PathTrak/WebView 2.5 MACTrak Setup Tutorial · Upgrade WebView 2.5 1. Place the JDSU PathTrak...

Date post: 20-Jun-2020
Category:
Upload: others
View: 33 times
Download: 0 times
Share this document with a friend
26
PathTrak/WebView 2.5 MACTrak Setup Tutorial Jim Walsh Product Manager - PathTrak Systems & Software Cable Networks Division 5808 Churchman Bypass Indianapolis, IN 46203-6109 [email protected]
Transcript

PathTrak/WebView 2.5MACTrak Setup TutorialJim WalshProduct Manager - PathTrakSystems & SoftwareCable Networks Division5808 Churchman BypassIndianapolis, IN [email protected]

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION2

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’sInstall/Upgrade WebView 2.5Import UCD InfoCheck for carrier/UCD matchBegin Solving Problems!

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION3

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION4

What Do You Need To Get Started?Does your PathTrak and/or WebView server meet minimum requirements (http://tinyurl.com/yjo3lfo)

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION5

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/Client

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION6

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 PathTrakServer/Client upgrade procedure is a two stepprocedure, 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 MUSTadd 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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION7

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’s

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION8

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION9

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’sInstall/Upgrade WebView 2.5

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION10

Upgrade WebView 2.5

1. 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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION11

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’sInstall/Upgrade WebView 2.5Import UCD Info

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION12

UCD Import InformationWhat 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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION13

UCD Import Tool Installation and ConfigurationDSAM Requirements

Must have version 3.6 or higher firmwareMust have DOCSIS2.0 or higher hardware to capture DOCSIS2.0 UCD’s

Installation Instructions:Obtain a copy of UCD Import Tool InstallerLaunch 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 onlySelect 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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION14

UCD Import Process: Online MethodUsed When Network Connectivity to WV Server Is Available

Serial Cable

Laptop with UCD Import Tool Installed

RF Connection

to Downstream

Tech Runs UCD Import ToolMenu: DSAM Import DSAM DirectEnter Import NameEnter Downstream FrequencyClick “Import”Click “Save” to Complete (Output will be sent to WV Server)

WebV

iew

Ethernet

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 installed5. 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.

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION15

UCD Import Process: Offline MethodUsed When Network Connectivity to WV Server Is NOT Available

Serial Cable

Laptop with UCD Import Tool Installed

RF Connection

to Downstream

Tech Runs UCD Import ToolMenu: DSAM Import DSAM DirectEnter Import NameEnter Downstream FrequencyClick “Import”Click “Save” to Complete (Output will be saved to laptop drive)

WebV

iew

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 installed3. 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

-----------------------------------------------------------------------------------------------------------1. Transfer file to WebView server via flash drive, email, or other method at a

later time2. 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.

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION16

UCD Import Process: Remote DSAM MethodUsed 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

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.

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION17

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’sInstall/Upgrade WebView 2.5Import UCD InfoCheck for carrier/UCD match

Note: It may take up to 15 minutes for imported UCD’s to be recognized by QAMTrak

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION18

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION19

PathTrak/WebView 2.5 – Getting Started

Do You Have All Required Items?Install/Upgrade PathTrak Server/ClientUpgrade HCU/RPM’sInstall/Upgrade WebView 2.5Import UCD InfoCheck for carrier/UCD matchBegin Solving Problems!

Click Here for WebView 2.5 User Training Video (71MB, 33 minutes)

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION20

How to Specify Which Carrier to DemodulateAuto Channel Detect vs Manual Channel Specification

Choose “Upstream Channels” Tab to pick from a list of auto-detected channelsAll parameters will be set automatically once channel is chosenMACTrak will be available if indicated in far right column

This is the recommended approach

Choose “Advanced” Tab to manually specify channel parametersProper Carrier Level and Attenuation settings are critical to demod operationMACTrak and Codeword Error detection will NOT be available when in Advanced mode

Use this approach only when absolutely needed

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION21

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION22

Backup Material

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION23

What Is A Codeword Error?

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 bytesQ: 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!)

Codeword 1 Codeword 2 Codeword n…

Byte 1 Byte 2 Byte k…

Bit 1 Bit 2 Bit n…

Symbol

Typically 5-8 CW’s/Packet (64QAM)

Typically k + 2 * T Bytes/CW(Normally ~100-255 Bytes/CW)

8 Bits/Byte

6 Bits/Symbol for 64QAM (4 for 16QAM)

Upstream DOCSIS Packet

2 * T Parity Bytes

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION24

What Are CWEs and Why Are They So Important?

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)

• 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 100-255 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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION25

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

© 2010 JDSU. All rights reserved. JDSU CONFIDENTIAL & PROPRIETARY INFORMATION26

How to Properly Set Carrier Level and AttenuationNot Needed When Using Auto Carrier Detection!!!

QAMTrak analyzer will stop demodulating if an Overrange condition is detectedQAMTrak analyzer can deliver anomalous results if Carrier Level is set too low

– Spot in center of constellation is an indicator of level set too lowRemember – if using auto-carrier detect these setting are done automatically for you

To Set Carrier Level/Attenuation:Open Spectrum Analyzer for node to be analyzedSet RBW to match the carrier of interestLook 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


Recommended