background image

3G CDMA NIM/Cellular Interface

 Troubleshooting

61700801G1-29.1H

Copyright © 2010 ADTRAN, Inc.

53

3. You can then select 

Start Debug

 and begin receiving debug information for the item you selected.

CLI Troubleshooting

After configuring the 3G CDMA cellular interface and the demand routing interface, several different 

debug 

commands can be issued from the Enable mode in the CLI to assist in troubleshooting. The 

debug

 

commands send messages when certain types of activity are detected on the interface, and work 
hand-in-hand with the 

show 

commands to verify proper configuration and performance. The 

show

 

commands are described in 

Viewing Interface Statistics Using the CLI

 

on page 47

 

of this guide. The 

debug 

commands are detailed in the following table.

Table 6. Cellular and Demand Routing Interface Debug Command Summary  

Command

Explanation

#

debug interface cellular 

<slot/port> 

diagnostic 

 

[tx | rx | both]

Enables debug events to decode the packets sent between the 
3G CDMA NIM module and the cellular modem along the 
diagnostic channel. 

Tx

 specifies the debugging of packets sent 

from the NIM module to the modem (optional). 

Rx

 specifies the 

debugging of packets sent from the modem to the NIM module 
(optional). 

Both

 specifies the debugging of both transmitted and 

received packets (optional).

#

debug interface cellular 

<slot/port> 

data

Activates debug messages for handshaking signals on the data 
channel.

#

debug interface cellular 

<slot/port> 

data-hdlc

Activates debug messages for high-level data link control (HDLC) 
errors on the data channel.

#

debug interface cellular 

<slot/port> 

diag-hdlc

Activates debug messages for HDLC errors on the diagnostic 
channel.

#

debug interface cellular 

<slot/port>

 download

Activates debug messages for errors regarding application 
downloads.

Summary of Contents for 3G CDMA NIM

Page 1: ...ssary for 3G CDMA cellular connectivity This guide also includes a troubleshooting section outlining the proper uses of the Web based graphical user interface GUI and the AOS command line interface CLI to verify that the 3G CDMA NIM and cellular interface have been configured correctly This guide consists of the following sections 3G CDMA NIM Product Overview on page 2 3G CDMA and Cellular Technol...

Page 2: ...ennas one primary and one diversity to connect to the cellular network The NIM also includes four LEDs which signify the type of connection being used and the signal strength Figure 1 depicts the rear panel of the 3G CDMA NIM Figure 1 3G CDMA NIM Rear Panel The 3G NIM s LEDs reveal information regarding signal strength power status transmission status and service availability Table 1 describes the...

Page 3: ...niversally and reduce interference between users 3G the latest version of CDMA technology allows a greater opportunity for quick connection to wireless services at a much faster rate than previous versions Cellular Wireless Technologies The 3G CDMA NIM operates using one of three technologies All three are incorporated into the NIM to ensure optimal use of wireless technology The three technologie...

Page 4: ...e or user profiles Revision A is capable of transfer speeds of up to 3 1 Mbps in a single 1 25 MHz FDD carrier and speeds up to 800 kbps in commercial networks Cellular Technology Speed Influences Although the 3G CDMA NIM is capable of operating at any of the available speeds transfer rate and signal type will depend upon the coverage area in which the unit is operating Performance decreases as pr...

Page 5: ...demand interface draws on the demand routing resource pool to connect with the public network while the cellular interface connects with physical interface on the public side of the network to complete the connection The relationship of the 3G CDMA NIM the cellular interface and the demand interface is shown in Figure 2 Figure 2 Internal Traffic Flow with the 3G CDMA NIM Ethernet physical interfac...

Page 6: ...the 3G CDMA NIM The keepalive value must be set to 0 using the keepalive value CLI command on the demand routing interface For more details about this command refer to the AOS Command Reference Guide available on the AOS Documentation CD shipped with your base unit or online at http kb adtran com article number 2219 In addition the Verizon 3G CDMA NIM requires a backoff algorithm that delays calls...

Page 7: ...e CDMA service plan with your wireless service provider The electronic serial number ESN might be needed for this process The ESN can be obtained from the label on the 3G modem or by using the show interface cellular hardware command Refer to Viewing Cellular Hardware Statistics on page 49 for more details Accessing the GUI To begin configuring the 3G CDMA NIM and cellular interface through the GU...

Page 8: ...UI 61700801G1 29 1H Copyright 2010 ADTRAN Inc 8 4 At the prompt enter your user name and password and select OK Activating the 3G CDMA NIM 1 Navigate to System Physical Interfaces in the menu on the left The default user name is admin and the default password is password ...

Page 9: ...te the 3G CDMA NIM and cellular interface 4 Enter a Description of the cellular interface check the Enable box and select Apply The 3G CDMA NIM and cellular interface is now activated and enabled The next step in configuration is to specify interesting traffic to be used by the demand routing interface The Reset button reboots the module and erases any configuration changes made in the current con...

Page 10: ...and routing interface intercepts interesting outbound traffic it will attempt to originate a connection and will reset the idle timer on a connected link When the demand routing interface intercepts interesting inbound traffic it allows the call to remain connected To create an ACL used for defining demand routing interface interesting traffic follow these steps 1 Navigate to Data Firewall Firewal...

Page 11: ...11 6 Select Add New Traffic Selector 7 Enter the parameters to define which packets will be monitored by the ACL 8 In this example the ACL is set to Filter Type Permit Protocol any To limit what brings up the demand routing interface or what brings it down consider setting the protocol to your specific network needs ...

Page 12: ...e configured for cellular network connection To configure the demand routing interface follow these steps 1 Navigate to Data Router Bridge Demand Routing 2 Select the demand 1 interface 3 Enter the demand configuration parameters as shown Resource Pool CELLULAR Connect Mode Originate Interface Recovery Enabled Acl Name LOCAL_LAN_OUT Match traffic Direction both IP Address Type Negotiated The ACL e...

Page 13: ... CDMA NIM Cellular Interface Configuring the 3G CDMA NIM Using the GUI 61700801G1 29 1H Copyright 2010 ADTRAN Inc 13 The other parameters should be left at their default values Select Apply when completed ...

Page 14: ...r interface must be defined as a resource in the demand routing interface configuration To configure the cellular interface as a demand routing resource follow these steps 1 Navigate to Data Router Bridge Demand Routing To function properly keepalive packets must not be transmitted by the 3G CDMA NIM The keepalive value must be set to 0 using the keepalive value CLI command on the demand routing i...

Page 15: ... from the Resource Pool drop down menu Enter 1 for the Priority When the parameters have been set select Add 3 The cellular interface appears as a member of the current resource pool Setting the Demand Routing Sequence Number The demand routing interface connect sequences provide instructions to the demand routing interface on how to use the resource pool and dial string number to connect to the c...

Page 16: ...ce Select Add The Sequence 1 configuration parameters are now available 4 Enter 777 as the Dial String Select forced cellular from the drop down menu Select Apply This configuration specifies the number to dial for connection which is 777 The forced cellular option constrains the resource pool so that this interface will only use cellular interfaces for this particular connect sequence 5 The creat...

Page 17: ...in the Destination Address and Destination Mask fields Add this route to the demand 1 interface by selecting it from the drop down menu and select Add 3 The new route appears in the route table and the demand interface now has a route to the Internet If the new route is the primary connection to the Internet then either the previously existing default routes must be deleted or the newly created ro...

Page 18: ...ustom profile settings can be configured for the 3G CDMA NIM These profile settings can be enabled or disabled at any time and are useful for services that require manual activation rather than automatic activation such as over the air service provisioning OTASP or Open Mobile Alliance Device Management OMA DM activation Even with stored manual activation settings users can still use automatic act...

Page 19: ...n and accounting AAA primary home agent address secondary home agent address shared secret and the profile home address 1 To create custom profile settings for manual activation navigate to System Physical Interfaces 2 Select the cellular interface from the list of interfaces Not all service providers use the same methods for establishing private IP services over 3G networks Check with your servic...

Page 20: ...ser identification and the password is equivalent to an AAA shared secret The user name can consist of up to 72 characters and the password can consist of up to 16 characters Specify the home agent shared secret The home agent shared secret can be up to 16 characters in length Specify the primary home agent IP address Specify the secondary home agent IP address Specify the home IP address After en...

Page 21: ...or to the 3G CDMA NIM Quick Start Guide shipped with the NIM or available online at http kb adtran com article number 2330 Activating the 3G CDMA NIM The 3G CDMA NIM and cellular interface are activated through the CLI using either the cdma activate otasp or the cdma activate oma dm command This command activates the cellular modem setting the default cellular network and updating the modem s pref...

Page 22: ...mode The name parameter in this command specifies the resource pool to which the cellular interface will be assigned The priority parameter is optional and specifies the priority value of using this interface as a demand routing interface resource over other interfaces in the same pool The priority is set by using numbers between 1 and 255 with lower numbers indicating a higher priority Interfaces...

Page 23: ...he demand routing interface Once you have access to the extended access control list commands enter the action protocol source destination parameters to define traffic to be observed for packet matching purposes Enter the parameters as follows config ext nacl action protocol source destination config ext nacl permit ip any any In creating ACLs for cellular connection purposes the action will be pe...

Page 24: ...nal demand routing interface parameters Accessing the Demand Routing Interface The demand routing interface configuration mode is accessed from the Global Configuration mode using the interface demand number command The number parameter specifies the interface number a range of 1 to 1024 Enter the command as follows config interface demand 1 config demand 1 The following sections deal specifically...

Page 25: ...nbound interesting traffic is received For more information refer to the match interesting ip command in the AOS Command Reference Guide available on the AOS Documentation CD or online at http kb adtran com article number 2219 Defining the Demand Routing Interface Resource Pool Once matching traffic has been specified the demand routing interface must be associated with a physical interface In thi...

Page 26: ... behavior of the demand routing interface should the connection attempt fail These instructions are given through the connect sequence interface recovery command This command specifies that the interface will go down when the connect sequence attempts value is exhausted In the case of cellular configuration this command specifies that this demand routing interface will go down if the attempted con...

Page 27: ... as follows config demand 1 ppp chap password mypassword Activating the Demand Routing Interface To activate the demand routing interface use the no shutdown command This command specifies that the interface is enabled and active allowing data to pass through Enter the command as follows config demand 1 no shutdown Specifying Optional Demand Routing Interface Commands The demand routing interface ...

Page 28: ...iption text command Enter the command as follows config demand 1 description Cellular Demand Interface Example Demand Routing Interface Configuration Using the previous examples the following is a sample demand routing interface configuration for use with a cellular interface 3G CDMA NIM config interface demand 1 config demand 1 match interesting ip LOCAL_LAN_OUT out config demand 1 match interest...

Page 29: ... the Configuring Internet Access Many to one NAT with the Firewall Wizard in AOS training video article number 2185 available online at http kb adtran com Configuring Custom Profile Settings Custom profile settings can be configured for the 3G CDMA NIM These profile settings can be enabled or disabled at any time and are useful for services that require manual activation rather than automatic acti...

Page 30: ...n 1 Create a user name using either the custom profile username username password ascii password command or the custom profile username username password hexadecimal password These commands specify the user name which is equivalent to NAI user identification and the password which is equivalent to an AAA shared secret The first command uses a plain text password and the second uses a hexadecimal p...

Page 31: ...decimal secret The shared secret can be up to 16 characters long Using the no form of this command removes the shared secret from the custom profile configuration Enter either command from the cellular interface configuration prompt as follows config cellular 1 1 custom profile ha shared secret ascii SHAREDSECRET 5 Specify the custom profile home address using the custom profile home address ip ad...

Page 32: ...NIM as a primary WAN connection In this example a small business has decided to use the 3G CDMA NIM in conjunction with a NetVanta 3448 to create a cellular connection for Internet access The cellular connection is chosen by this company because they do not want to wait for an asymmetric digital subscriber line ADSL to be installed nor do they need the bandwidth provided by the ADSL Once the 3G CD...

Page 33: ... LOCAL_LAN_OUT in connect sequence 1 dial string 777 forced cellular connect sequence attempts 0 connect sequence interface recovery connect mode originate description Cellular Demand Interface keepalive 0 ip address negotiated no shutdown interface ethernet 0 1 ip access policy Private ip address 192 168 1 1 255 255 255 0 no shutdown ip access list standard wizard ics remark Internet Connection S...

Page 34: ...3G CDMA NIM Cellular Interface Example 3G CDMA NIM Cellular Interface Configurations 61700801G1 29 1H Copyright 2010 ADTRAN Inc 34 ...

Page 35: ...ion CD shipped with your base unit or online at http kb adtran com article number 2219 In AOS firmware release 17 09 00 the match interesting command was changed to require the ip keyword If you are using firmware released prior to 17 09 00 enter the match interesting list name in out or the match interesting reverse list name in out commands rather than the match interesting ip commands from the ...

Page 36: ...choice to make sure they can still connect to the WAN if something happens to their primary connection Once the 3G CDMA NIM is installed in the second slot of the NetVanta 3305 the company sets up a secondary connection to the network The network diagram for this example is shown in Figure 6 Figure 6 3G CDMA NIM as Backup WAN Connection Sample CLI Configuration The following is a sample CLI config...

Page 37: ...shutdown interface demand 1 ip access policy Public DR resource pool CELLULAR match interesting ip list LOCAL_LAN_OUT out match interesting ip reverse list LOCAL_LAN_OUT in connect sequence 1 dial string 777 forced cellular connect sequence attempts 0 connect sequence interface recovery connect mode originate description Cellular Demand Interface ip address negotiated no shutdown interface etherne...

Page 38: ...nterface so that it is connected to the 3G network at a specific time the following are needed a configured schedule that is activated at the desired time a probe to test the connection and send interesting traffic using the demand interface and a track whose state is reliant upon the schedule In addition the demand interface must be configured in a manner similar to the following example and an A...

Page 39: ...ack INBAND 3G test if schedule MIDNIGHT no shutdown interface demand 1 idle timeout 70 resource pool 3G match interesting ip list Interesting out match interesting ip reverse list Interesting in connect sequence 1 dial string 5555000 connect sequence attempts 0 connect mode originate ip address negotiated ppp chap hostname netvanta ppp chap password adtran no shutdown ip access list extended Inter...

Page 40: ...le 3G CDMA NIM Cellular Interface Configurations 61700801G1 29 1H Copyright 2010 ADTRAN Inc 40 Sample GUI Configuration The same cellular interface parameters can be set by using the GUI configuration method described beginning on page 8 ...

Page 41: ...ce configuration config cellular 1 1 description text Creates a descriptive name to identify the interface up to 80 alphanumeric characters config cellular 1 1 resource pool member name priority Assigns the cellular interface to a resource pool for the demand routing interface config cellular 1 1 no custom profile Clears all custom profile settings and returns profile settings to the default value...

Page 42: ...on mode config ext nacl action protocol source destination Specifies the traffic that the ACL will monitor For more information about ACLs refer to Configuring IP ACLs in AOS available online at http kb adtran com article number 3087 Table 4 Demand Routing Interface Configuration Commands Prompt Command Description config interface demand number Accesses the demand interface configuration mode con...

Page 43: ...nect mode answer originate either Specifies that the demand interface will answer or originate calls or both For cellular connections the demand routing interface should be set to originate config demand 1 ip address negotiated Specifies that the demand interface will be assigned an IP address from the far end PPP connection config demand 1 no shutdown Specifies that the interface is enabled confi...

Page 44: ...atistics that aid in monitoring the activity and status of each interface To access 3G CDMA cellular interface statistics follow these steps 1 Navigate to System Physical Interfaces config demand 1 ppp chap password password Creates an authentication password for the modem to use in SIP connections The commands listed for configuring the demand routing interface pertain only to configuring the int...

Page 45: ...pyright 2010 ADTRAN Inc 45 2 Select the appropriate cellular interface from the list of system interfaces 3 Scroll to the bottom of the screen and view the statistics for the cellular interface To view the statistics for the demand routing interface follow these steps ...

Page 46: ...3G CDMA NIM Cellular Interface Troubleshooting 61700801G1 29 1H Copyright 2010 ADTRAN Inc 46 1 Navigate to Data Router Bridge Demand Routing 2 Select the appropriate demand interface from the list ...

Page 47: ...viewed using show commands from the Enable mode as shown in Table 5 Examples of command usage and output are contained in the following sections Table 5 Show Commands Prompt Command Description show interface cellular slot port Displays statistics for the specified cellular interface show interface cellular slot port profile Displays cellular profile statistics for the specified cellular interface...

Page 48: ...stics contain information regarding the network access identifier NAI of the modem the home agent shared secret HA SS the home agent security parameter index HA SPI the authentication authorization and accounting shared secret AAA SS the AAA security parameter index AAA SPI the reverse tunneling preference the modem s permanent home address and the primary and secondary home IP addresses of the mo...

Page 49: ... number MDM the mobile station ID MSID the system ID SID and the network ID NID The ESN is the code that uniquely identifies the cellular modem the PRL is the database of cell towers on which the cellular modem can roam and the MDM is the 10 digit mobile phone number assigned to the modem The MSID is a 10 digit number identifying the cellular modem on the network it is typically the same as the MD...

Page 50: ...mand 1 Examples of demand interface statistics are shown in Figure 11 and Figure 12 Figure 11 Sample Output from Show Interface Demand Command unconnected Show Interface Demand Not Connected show interface demand 1 Demand 1 is UP Spoofing Configuration Keep alive is set 10 sec Admin MTU 1500 Mode Originate 1 dial entry idleTime 120 fastIdle 20 Resource pool CELLULAR SentAuth CHAP SentUsername Rout...

Page 51: ...dleTime 120 fastIdle 20 Resource pool CELLULAR SentAuth CHAP SentUsername Router IP address negotiated Connect Sequence Successes 1 Failures 0 Seq DialString Technology Successes Busys NoAnswers NoAuths InUse 1 777 CellForced 1 0 0 0 YES Current values Local IP address 10 0 0 1 Peer IP address 10 0 0 2 Last interesting pkt None Queueing method weighted fair Output queue 0 0 428 64 0 size highest m...

Page 52: ...ging abilities follow these steps 1 Navigate to Utilities System Debug Unit menu 2 Select the Add Debug Filter button and choose the desired item to debug from the following Category drop down menu Select Apply when the correct item is chosen The item you have selected to debug will appear in the Debug Category tab in the middle of the screen ...

Page 53: ...mand Routing Interface Debug Command Summary Command Explanation debug interface cellular slot port diagnostic tx rx both Enables debug events to decode the packets sent between the 3G CDMA NIM module and the cellular modem along the diagnostic channel Tx specifies the debugging of packets sent from the NIM module to the modem optional Rx specifies the debugging of packets sent from the modem to t...

Page 54: ...lular 1 1 Usb Device Has Been Removed 2010 02 19 16 12 01 DIALUP_INTERFACE cellular 1 1 Usb 3G Device Found 2010 02 19 16 12 03 INTERFACE_STATUS cellular 1 1 changed state to up 2010 02 19 16 12 15 DIALUP_INTERFACE cellular 1 1 Dialing 777 2010 02 19 16 12 20 DIALUP_INTERFACE cellular 1 1 Connect CONNECT 2010 02 19 16 12 25 PPP NEGOTIATION LCP up 2010 02 19 16 12 25 PPP NEGOTIATION demand 1 IPCP u...

Page 55: ...54 CELL_INTERFACE cellular 1 1 DIAG RX MDN_REQUEST MDN 2023020919 2010 02 19 16 04 54 CELL_INTERFACE cellular 1 1 DIAG TX NONVOL_READ_REQUEST NV_ITEM 10 2010 02 19 16 04 54 CELL_INTERFACE cellular 1 1 DIAG RX SERVICE_PREFERENCE_MODE Mode HYBRID 2010 02 19 16 04 54 CELL_INTERFACE cellular 1 1 DIAG TX SUBSYSTEM_REQUEST CM_STATE 2010 02 19 16 04 54 CELL_INTERFACE cellular 1 1 DIAG RX SUBSYSTEM_REQUES...

Page 56: ... interface demand number command After you have verified the preceding information and you are still having ping and connectivity failures use the following debug utilities to verify your cellular configurations 1 Debug the cellular interface using the debug interface cellular slot port data command detailed in Table 6 on page 53 2 Debug demand routing using the debug demand command detailed in Ta...

Page 57: ...lete 1 1 During this backoff interval the NIM is placed in a retry state This can be seen in the output of the show interface cellular command when the service type is None and the connection state is Disconnecting The following output is an example show interface cellular 1 1 cellular 1 1 is DOWN ACTIVATED Service type setting is set to AUTO Service type is NONE PN Offset is Unavailable Frequency...

Reviews: