ip access IPA219C 3G Picocellular basestation User Manual nano3GAP Operations Manual

ip.access ltd 3G Picocellular basestation nano3GAP Operations Manual

Operating guide

nano3GAP Operations Manual N3G_OPM_300 1.0 ip.access Ltd Building 2020 Cambourne Business Park Cambourne Cambridgeshire CB23 6DW United Kingdom www.ipaccess.com
nano3GAP Operations Manual © ip.access Ltd Revision History Version Change Summary Date Author 0.1 First draft 21 Jul 2009 ZN1 0.2 Updates throughout the manual 24 Jul 2009 ZN1 0.3 Updated from feedback 27 Jul 2009 ZN1 0.4 Style sheet corrections 28 Jul 2009 AM4 0.5 Implemented review corrections 29 Jul 2009 ZN1 0.6 Implemented further review comments 29 Jul 2009 ZN1 1.0 Released for N3G_1.1 29 Jul 2009 ZN1 Approved by e-mail. The information contained in this manual is commercially confidential and must not be disclosed to third parties without prior consent.
nano3GAP Operations Manual © ip.access Ltd Table of Contents 1 Introduction ..................................................................................................... 1 1.1 Overview ........................................................................................................... 1 1.1.1 Configuration from a Provisioning PC.................................................................... 1 1.1.2 Configuration and Administration from the OMC-R Client ..................................... 1 1.2 Related Information........................................................................................... 1 1.3 Terminology ...................................................................................................... 2 2 Common Procedures...................................................................................... 3 2.1 Restart a nano3GAP......................................................................................... 3 2.2 Using the OMC-R Client ................................................................................... 3 2.2.1 Start the OMC-R Client .......................................................................................... 3 2.2.2 Find an AP in the OMC-R ...................................................................................... 5 2.2.3 Change the Administrative State of an AP............................................................. 5 2.3 nano3GAP-4 Objects in the OMC-R ................................................................. 6 2.3.1 Useful Information .................................................................................................. 6 2.3.2 Actions.................................................................................................................... 7 2.3.3 AP Configuration .................................................................................................... 9 2.4 Using Network Listen ........................................................................................ 9 2.4.1 Run Network Listen Tests ...................................................................................... 9 2.4.2 View Network Listen results ................................................................................. 10 2.4.3 Apply Frequency Correction................................................................................. 11 3 Troubleshooting the nano3GAP.................................................................. 13 3.1 Monitoring Alarms from the nano3GAP .......................................................... 13 3.2 Modifying the AP Configuration ...................................................................... 13 3.2.1 Create an Attribute Configuration File for an AP.................................................. 13 3.2.2 Download the Attribute Configuration File to the AP............................................ 13 3.3 Modifying the AP-AC Connection ................................................................... 13 3.3.1 Modify the Connection to the AP.......................................................................... 13 3.3.2 Edit the IP Configuration of the AP ...................................................................... 13 3.4 AP Diagnostics from the OMC-R .................................................................... 14 3.4.1 Automatic Crash Log Upload ............................................................................... 14 3.4.2 Report Diagnostics............................................................................................... 14 3.4.3 Diagnostics Tuning of the AP............................................................................... 16 3.5 Factory Reset.................................................................................................. 17
nano3GAP Operations Manual Introduction © ip.access Ltd Page 1 1 Introduction This document provides information on managing and troubleshooting the ip.access nano3GAP-4 AP, an indoor local area access point. 1.1 Overview This manual is intended for use by individuals engaged in the day-to-day management of the nano3GAPs. It describes direct operation, administration and maintenance of the APs. 1.1.1 Configuration from a Provisioning PC The nano3GAP includes a web server that can be accessed via a web browser running on the provisioning PC. The web server can be used during commissioning only because it is only available when the AP is in the factory reset state. For instructions, see [INST_300]. 1.1.2 Configuration and Administration from the OMC-R Client A nano3GAP can be configured and managed from the OMC-R Client, a Java application that can run on Windows. It connects to the OMC-R Server, which in turn connects to one or more ACs. Hence, the OMC-R Client can provide a view of the whole network. This view may be restricted according to user permissions. Following commissioning (see [INST_300]), nano3GAP objects are created automatically by the AC to which the AP first connected. Once a 3GAP object has connected to a nano3G AC, they are visible in the OMC-R, and they can be configured and managed remotely. When a nano3GAP has been added to the database, its configuration attributes can be changed in the OMC-R Client and additional features, such as Measurement Functions, can be used with the nano3GAP. Furthermore, the OMC-R Client has full alarm management capability. Alarm notifications from a nano3GAP or the controlling AC are grouped into lifecycles according to the unique ID of the object that raised an alarm. Hence, the alarm status of a particular object can be tracked as it changes, until the lifecycles ends when the alarm clears. Alarms can be acknowledged and optionally notes may be added to an alarm. For more information, see [OPM_410]. 1.2 Related Information [GST_100] nano3G System Overview Manual (N3G_GST_100) [GST_300] nano3GAP Product Description (N3G_GST_300) [INST_300] nano3GAP Installation Manual (N3G_INST_300) [OPM_410] nano3G OMC-R Client Operations Manual (N3G_OPM_410) [OPM_430] nano3G PM/DL Server Operations Manual (N3G_OPM_430) [REF_105] nano3G System Glossary (N3G_REF_105)
nano3GAP Operations Manual Introduction © ip.access Ltd Page 2 [REF_130] nano3G Alarm Data Reference Manual (N3G_REF_130) [21.905] Vocabulary for 3GPP Specifications, 3rd Generation Partnership Project 1.3 Terminology For standard nano3G System terminology, see [REF_105]. For additional standard GSM terminology, see [21.905].
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 3 2 Common Procedures 2.1 Restart a nano3GAP To restart an AP: • Power cycle it. • Invoke a reinitialize action from the OMC-R, see section 2.3.2. The AP will start up in the same administrative state in which it was before the restart. 2.2 Using the OMC-R Client 2.2.1 Start the OMC-R Client The OMC-R Server provides a web page to start the OMC-R Client. 1) Start a web browser application. 2) Enter the URL for the OMC-R server’s web page as: http://<server-hostname>/omcr Where <server-hostname> is the fully qualified hostname of the OMC-R server. Note: This assumes that DNS is correctly configured on the management network: the OMC-R server can be found by using its host name from client computers on the same network. 3) Press the Enter key and the OMC-R web page will be displayed. 4) If it has not been installed on the client computer, click the link to download and install the Java runtime (JRE version 1.5) for Windows®. This will allow a Windows® client computer to run the OMC-R Client.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 4 Note: When installed on Windows®, the JRE may automatically update to version 1.6. The OMC-R Client will operate correctly with JRE 1.6. However, do not install any version later than 1.6 (or allow JRE to be automatically updated; for example, decline the update if prompted). The Java Control Panel may be used to disable automatic updates and/or disable usage of JRE versions later than 1.6. 5) The OMC-R Client is automatically installed when it is started. Click the link or icon for Start 3G OMC-R Client. If this is the first time the OMC-R Client has been started from this client computer, or if the client version on the OMC-R Server has been updated, the client application will download (which also installs the application). If a security warning appears about verification of the digital signature for the application, click the Run button. 6) The OMC-R Client will initialize and connect to the OMC-R Server. A login prompt will appear. The first time the client is used from a particular computer, the User name will be set to the login ID used for the current session on the client computer. 7) Enter the username and password, then click OK. The user name will be remembered at the next login. 8) The OMC-R Client will initialize and connect to the OMC-R Server. The following screen appears: 9) Double-click through the tree (Management Views > Configuration Management) to navigate to the AP to configure.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 5 2.2.2 Find an AP in the OMC-R Note: The serial number of the required AP must be known. 1) Click the handles to open the Management Views and Configuration Management nodes in the Explorer pane, then the Network View and Root nodes. The ACs connected to the OMC-R will be listed. 2) Open the node for the AC serving the required AP, then open its RNS node and then the ApController node. The ApConnections will be shown for all the APs connected to the AC. 2.2.3 Change the Administrative State of an AP The nano3GAP has the following administrative states: • Locked • Shutdown • Unlocked Most attributes can be configured with the AP in the unlock state, but some attributes can only be configured when an AP is in the locked state and does not provide operational service. The attributes that require the AP to be in the locked state are shown in red in the Properties pane. To change the Administrative State: 1) Find the required AP in the OMC-R (as above). 2) Right-click the AP object (below the ApConnection object). A context menu will appear. The menu includes three administrative state options (the current state is unavailable, or 'greyed out'): o Lock Lock the AP immediately. This will take the AP out of service immediately. Any active calls will be dropped and UEs camped on are disconnected. A padlock is shown against the AP object and its administrative state is set to Locked. o Shutdown Lock the AP as soon as all active calls have ceased. This will take the AP out of service and lock it as soon as all active calls are complete. No new calls can be established. UEs camped on are disconnected. An arrow pointing down is shown against the AP object, which changes to a padlock once it locks.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 6 o Unlock Return the AP into service so that it may allow UEs to camp on and make calls. 3) Click the menu option for the required Administrative State. 2.3 nano3GAP-4 Objects in the OMC-R The AP object in the OMC-R can be used to: • Provide information about the AP. • Configure the AP. • Perform other actions on an AP (such as changing administrative state). 2.3.1 Useful Information 2.3.1.1 General Information When an AP object is selected in the Explorer or Workspace pane, the General package is initially selected in the Navigation pane, with its attributes shown in the Properties pane. This shows the basic state of an AP in terms of Operational State, Administrative State and Availability Status. An AP should be providing service normally when these are indicated as Enabled, Unlocked and blank respectively (as in the example above). The Availability Status usually only has a value when the AP is not providing service. This information is also shown by a tooltip when the mouse pointer is paused over an AP object.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 7 Select the AP Admin Package to see more information about the general status of an AP. In particular, this shows the MIB Version, which must match the MIB Version used by the OMC-R and the AC. 2.3.1.2 Bands Supported To verify the UMTS bands supported by the AP hardware, go to the Network Listen Status Package and drill down to UMTS Bands Supported. The GSM bands supported by NWL can also be inspected, to show the valid bands to use when configuring the Static GSM Neighbour List. 2.3.1.3 Hardware Information To check the exact hardware version of an AP, select the Factory NV Package in the Navigation pane and inspect the Hardware Version attribute. This package also shows the serial number and other factory configured information. 2.3.2 Actions The context menu for the AP object (available from right-click on the object) has an Actions sub-menu: Action Behaviour Enable Service Automatically initiated by the nano3G AC once the BSMIS Synchronisation procedure has completed and the AC is ready for the AP to start providing service. Lock Changes the administrative state to LOCKED. The AP immediately releases all RRC connections and turns off its radio. Reinitialise The AP will reboot. Shutdown Changes the administrative state to SHUTTING_DOWN. The AP will wait until all RRC connections are closed before turning off the radio and transitioning to the locked state. Unlock Changes the administrative state to UNLOCKED. The AP will turn on its radio. Report Alarms Generates an alarm report. If no parameters are provided, the configuration from the Alarm Report Control package is used. The value of the attribute alarmReportDetail specifies the content of the report and the value of the attribute alarmReportingUrl specifies its destination. The component behaviour on receiving this action is similar to the component behaviour for Periodic Alarm Reporting. The key difference is that the periodic timers are left unchanged while the time of the next scheduled report remains the same.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 8 Report Diagnostics Now The AP will report its current log files to the URL contained in the action.Perform Software Download The AP will download the new software image from a specified URL. The optional attribute swDownloadOps controls what operations the AP performs following the download; this can be used to change the default SW version of the AP and to reboot it. If this parameter is not present, then the AP performs the download and changes the default SW version, but does not reboot. Swap Default Software The AP will change its default software version, that is, the software that will be run the next time the AP reboots. The attribute defaultSwVersion in the AP Admin package, which reports the current default software version, will change when the Swap Default Software action is completed. Report Measurements The AP wil send a measurement report, as set up in the Measurement Control package. The component behaviour on receiving this action is similar to the component behaviour for Periodic Measurement Reporting. The key difference is that the periodic timers are left unchanged while the time of the next scheduled report remains the same. Abort Network Listen Test Stops all Network Listen activities and resets the value of the attribute nwlTestStatus to "NWL_IDLE". Apply Frequency Correction Uses the results of the most recent BCCH Detect test to adjust the crystal oscillator of the AP. When the adjustment is done, the value of the attribute estimatedFreqOffset is set to zero. Frequency correction is not possible if either the value of the attribute estimatedFreqOffset is zero or the BCCH Detect results are older than one hour. Factory Restore Restores the AP settings to their factory defaults and triggers a reinitialization. Start BCCH Detect Test Invokes the BCCH Detect Test that performs an RSSI scan followed by an attempt to decode BCCH (GSM) and CPICH (UMTS) for each ARFCN or UARFCN that has an RSSI value above the associated decode threshold. Note: This test is recommended only as part of a diagnostic procedure. Start RSSI Scan Test Invokes the RSSI Scan Test that scans the enabled bands and ARFCNs. Note: This test is recommended only as part of a diagnostic procedure. Start Sequential NWL Tests Invokes a sequence of Network Listen tests: RSSI scan, BCCH Detect Test and Frequency Accuracy Test. The order of the tests is identical to that of a scheduled NWL test.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 9 Delete CRLs The AP will delete its CRLs. The currently open secure connections are not disconnected. The next time the AP attempts to open a secure connection, it has to connect to the CRL server to get an up-to-date CRL. 2.3.3 AP Configuration The essential configuration steps for commissioning an AP using the OMC-R are described in [INST_300]. This section provides additional information about configuration changes that may be of interest. • Network Listen Control Package • Cell Package • NAS Package • Location Package 2.4 Using Network Listen Network Listen (NWL) is used by a nano3GAP to scan the local RF environment and gather information from neighbouring cells. Network Listen can detect WCDMA cells, both macro and other nano3G and GSM cells. The AP can use the information gathered for the following: • Check neighbour cells for handover and reselection • Automatic clock frequency calibration 2.4.1 Run Network Listen Tests 1) Find the required AP by its serial number or object name (see section 2.2.2). 2) Right-click the AP object and a menu will appear. 3) Move the pointer down to Actions and a sub-menu will appear.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 10 4) Click Start BCCH Detect Test, Start RSSI Scan Test or Start Sequential NWL Tests. 5) The AP will administratively shut down (wait for calls to complete) and lock, then the tests will run. The AP will then unlock once the tests are complete. 2.4.2 View Network Listen results Once the nano3GAP has booted up and performed an RF scan, it is possible to see the results in the OMC-R Client. 1) Find the required AP by its serial number or object name (see section 2.2.2). 2) Right-click the AP object and select View Network Listen Results from the menu. 3) The Network Listen Results viewer will appear (see below). 4) Alternatively, select the Network Listen Results Package in the Navigation pane and select the following: o Cell Results o RSSI Results o UMTS UL Results The view has a graphical representation of the Network Listen results on the Chart tab, and a list of detected cells on the Table tab.
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 11 Click a detected cell (in Chart view the line changes to blue) to show more details in the Selected ARFCN tab on the right. Note: Optionally use the detected results to fill in the static neighbour lists. 2.4.3 Apply Frequency Correction First check the possible frequency adjustment as follows: 1) Find the required AP by its serial number or object name (see section 2.2.2). 2) In the Navigation pane, select the Network Listen Status Package. 3) In the Properties pane, inspect the Estimated Frequency Offset (PPB) value. 4) If the offset magnitude is more than 50 (that is more than +50 or less than -50), it may be useful to apply frequency correction. Note: If the offset is within +/- 50ppb, that offset will never be used. A correction will only be applied if the Network Listen results are more than 10 minutes old and a rescan results in a recalculated offset magnitude greater than 50ppb. If it is necessary to apply a frequency correction, use the following procedure: 5) Right-click the AP object and a menu will appear. 6) Select Shutdown and wait for the AP to lock or Lock to lock the AP immediately. 7) When the AP is locked, with the padlock symbol, right-click the AP object again and the menu will appear. 8) Move the pointer down to Actions and a sub-menu will appear. 9) Click Apply Frequency Correction. The AP will do the following: o The time of the last scan is checked. If the scan is older than 10 minutes, a new scan takes place and a replacement offset value is recalculated. If the offset is smaller than +/- 50ppb, there is no further action (that is, no offset is applied).
nano3GAP Operations Manual Common Procedures © ip.access Ltd Page 12 Note: When no offset is applied, the NWL Test Status in the Network Listen Status Package is set back to NWL Idle. This can happen very quickly and there may be no visible change to NWL Test Status. If the NWL Test Status appears to have stayed at NWL Idle for more than one minute, it can be assumed that nothing has happened and the AP may be unlocked. o If the process continues, the frequency correction is applied. o A new scan takes place to check that the new setting has improved the frequency offset. If the new offset is worse than the offset just applied, the frequency correction is reversed. Otherwise, the new value is retained. o The Estimated Frequency Offset (PPB) value in the Network Listen Status Package is reset to 0 until the offset is recalculated by another Network Listen scan. The NWL Test Status in the Network Listen Status Package is set to NWL Idle. 10) Right-click the AP object again and select Unlock.
nano3GAP Operations Manual Troubleshooting the nano3GAP © ip.access Ltd Page 13 3 Troubleshooting the nano3GAP 3.1 Monitoring Alarms from the nano3GAP For instructions see [OPM_410]. For information on the alarms, see [REF_130]. 3.2 Modifying the AP Configuration 3.2.1 Create an Attribute Configuration File for an AP The properties of the AP can be set from the OMC-R. Optionally, attributes can be imported from a text file. For the description of the text file format and for instructions on how to use it, see [INST_300]. 3.2.2 Download the Attribute Configuration File to the AP For instructions, see [INST_300]. 3.3 Modifying the AP-AC Connection The configuration of a nano3GAP can be modified in a web interface from the provisioning PC. The AP-AC connection and the IP configuration of the AP can be managed this way. The web interface is only enabled by default during commissioning when the AP is in factory reset state. To enable the web interface, the nano3GAP needs to be put into factory reset state (see section 3.5). 1) Start a web browser and go to the following address: http://192.168.0.1:8089/ 2) Enter the username and password. 3.3.1 Modify the Connection to the AP For instructions, see [INST_300]. 3.3.2 Edit the IP Configuration of the AP For instructions, see [INST_300].
nano3GAP Operations Manual Troubleshooting the nano3GAP © ip.access Ltd Page 14 3.4 AP Diagnostics from the OMC-R 3.4.1 Automatic Crash Log Upload It is possible to enable uploading a crash log file automatically from the OMC-R to a server that is capable of HTTPS PUT. Note: By default Apache does not allow HTTP PUT. The apfiaglog file is created by a bash script /opt/ipaccess/bin/diagupload. It collates all of the files needed to troubleshoot and analyse issues in the field. The diagupload script will create a tar.gz file stored temporarily in the /tmp folder, for example: apdiaglogs_000295-000000007804_1246441198_demand.tar.gz The tar file contains the following files: File Description tcpdump.pcap0 and 1 Rolling tcpcapture. procmon output Contains the same information as the printout of the ps command, with additional details. Furthermore, it contains a log rotated version that is updated every 30 seconds, which helps when looking for memory leaks. Log files For example: dmesg, bootlogs, apdiag cli output, syslog, klog Legacy configuration files Software version information Crash files In case of a crash 3.4.2 Report Diagnostics To generate a status report of the AP: 1) Log in to the OMC-R. 2) Find the required AP by its serial number or object name (see section 2.2.2). 3) Right-click the AP object and select Report Diagnostics Now from the menu.
nano3GAP Operations Manual Troubleshooting the nano3GAP © ip.access Ltd Page 15 4) Enter the URL where the diagnostic report should be displayed.
nano3GAP Operations Manual Troubleshooting the nano3GAP © ip.access Ltd Page 16 3.4.3 Diagnostics Tuning of the AP It is possible to modify some AP settings remotely from the OMC-R. 1) Log in to the OMC-R. 2) Find the required AP by its serial number or object name (see section 2.2.2) and select it. 3) In the attribute frame, select the Diagnostics Tuning attribute. 4) Edit the following parameters as needed: File Description Start-up CLI commands CLI commands run automatically once MgrApp has started up. Allows CLI commands, such as “ma::dbgtask 16 on” to be run which turns on task 16’s CLI output. Immediate CLI commands CLI commands to be run immediately. Nv_env.sh Bash environment variables Used by the platform and bash based scripts to change the behaviour of the AP.
nano3GAP Operations Manual Troubleshooting the nano3GAP © ip.access Ltd Page 17 3.5 Factory Reset Factory reset can be used when there are no ways to repair the AP-AC connection. The AP configuration needs to be redone manually after the factory reset, see [INST_300]. To perform factory reset, press the factory reset button and hold it for more than 5 seconds. When the button is initially pressed, the LED will blink fast (50ms on:50ms off) for 5 seconds, then it will start to blink slowly (200ms on: 200ms off). When the factory restore process has completed, the LED will extinguish and the AP will automatically reboot, take the fixed IP address and enable the web interface for configuration section 3.3.2.

Navigation menu