Netspan Northbound If User Guide SR6

Northbound Interface User Guide
Software Release 6.5 UGD-D00022
Northbound Interface User Guide SR 6.5
Copyright by Airspan Networks Inc., 2008. All rights reserved worldwide.
The information contained within this document is proprietary and is subject to all relevant copyright, patent and other laws protecting intellectual property, as well as any specific agreements protecting Airspan Networks Inc. rights in the aforesaid information. Neither this document nor the information contained herein may be published, reproduced or disclosed to third parties, in whole or in part, without the express, prior, written permission of Airspan Networks Inc. In addition, any use of this document or the information contained herein for the purposes other than those for which it is disclosed is strictly forbidden. Airspan Networks Inc. reserves the right, without prior notice or liability, to make changes in equipment design or specifications. Information supplied by Airspan Networks Inc. is believed to be accurate and reliable. However, no responsibility is assumed by Airspan Networks Inc. for the use thereof nor for the rights of third parties which may be effected in any way by the use of thereof. Any representation(s) in this document concerning performance of Airspan Networks Inc. product(s) are for informational purposes only and are not warranties of future performance, either expressed or implied. Airspan Networks Inc. standard limited warranty, stated in its sales contract or order confirmation form, is the only warranty offered by Airspan Networks Inc. in relation thereto. This document may contain flaws, omissions or typesetting errors; no warranty is granted nor liability assumed in relation thereto unless specifically undertaken in Airspan Networks Inc. sales contract or order confirmation. Information contained herein is periodically updated and changes will be incorporated into subsequent editions. If you have encountered an error, please notify Airspan Networks Inc. All specifications are subject to change without prior notice. Product performance figures quoted within this document are indicative and for information purposes only.
Page 2
Commercial in Confidence
UGD-D00022 Rev A
Revision History
Revision Draft 1.0 Originator David Cann Date 31/01/2008 Description Updated with comments from K. Dudzinski Updated with comments from K. Dudzinski and D. Thiru
Draft 2.0
David Cann
04/02/2008
Revision A
David Cann
05/02/2008
Page 3
UGD-D00022 Rev A
Worldwide Headquarters: Airspan Networks Inc. 777, Yamato Road, Suite 105, Boca Raton, FL 3341-4408, USA Tel: +1 561 893 8670 www.airspan.com
Main Operations: Airspan Communications Ltd Cambridge House, Oxford Road, Uxbridge, Middlesex, UB8 1UN, UK Tel: +44 (0)1895 467100
UK WEE Registration number: WEE/AB0207WZ Airspan Networks Inc acknowledges the following trademarks used within this document:
Internet Information Services (IIS) Microsoft Corporation http://www.microsoft.com
Page 4
UGD-D00022 Rev A
Table of Contents
Table of Contents.................................................................................................................. 5 Glossary of Terms............................................................................................................... 10 Summary of Figures and Tables ......................................................................................... 12 1 Introduction .................................................................................................................. 14 1.1 General Overview ................................................................................................. 14 Northbound Interface ..................................................................................... 14
1.1.1 1.2 1.3 1.4 2
Where Northbound Interface fits into the Netspan Architecture ............................. 15 Consuming Web Services ..................................................................................... 15 Using Asynchronous Clients ................................................................................. 16
Get Started with the Northbound Interface ................................................................... 17 2.1 2.2 Workflow of the Northbound Interface ................................................................... 17 Navigating the Northbound Interface..................................................................... 18
Enable or Disable Northbound Interface ...................................................................... 21 3.1 3.2 Disabling the Northbound Interface ....................................................................... 21 Enabling the Northbound Interface........................................................................ 21
Enable or Disable Authentication and Authorisation ..................................................... 22 4.1 4.2 Disabling Authentication ....................................................................................... 23 Enabling Authentication ........................................................................................ 23
Provision Service and Define Service Profiles .............................................................. 24 5.1 SS Provisioning .................................................................................................... 24 Provisioning SS [ProvisionSS] ....................................................................... 25 Provisioning Fixed SS [ProvisionFixedSS] ..................................................... 26 Provisioning a Custom SS [ProvisionCustomSS] ........................................... 26 Re-provisioning the SS [Reprovision] ............................................................. 26 De-provisioning the SS [Deprovision] ............................................................. 26 Commercial in Confidence UGD-D00022 Rev A
5.1.1 5.1.2 5.1.3 5.1.4 5.1.5
Page 5
5.1.6 5.1.7 5.1.8
Disabling Service on the SS [DisableService] ................................................ 26 Enabling Service on the SS [EnableService] .................................................. 26 Getting the SS Provisioning Configuration [GetSSProvisioningConfig] .......... 26
5.1.9 Getting the SS Custom Provisioning Configuration [GetSSCustomProvisioningConfig]............................................................................... 26 5.1.10 5.1.11 Getting the SS Provisioning Status [GetProvisioningStatus] .......................... 26 Provisioning a Custom SS within the NMS [ProvisionCustomSSV2] .............. 27
5.1.12 Getting the Custom SS Provisioning Configuration [GetSSCustomProvisioningConfigV2] .......................................................................... 27 5.2 Service Profiles ..................................................................................................... 27 Producing the Service Profiles List [GetServiceProductList]........................... 27 Retrieving the Custom Configuration List [GetSSCustomConfigList] .............. 28 Producing the VLAN List [GetVlanList] ........................................................... 28 Retrieving Global Configuration Profiles [GetGlobalConfig]............................ 28 Producing the SS VLAN Port Profiles List [GetSSVlanPortProfileList] ............ 28 Retrieving the Global SSV2 Configuration [GetGlobalConfigV2] .................... 28
5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.3
View Inventory ...................................................................................................... 28 Producing the BS Sector List [BSSectorList] .................................................. 28
5.3.1 5.4
Service Product .................................................................................................... 28 Producing the Service Product List [ServiceProductList] ................................ 28 Creating the Service Product Name [ServiceProductCreate] ......................... 29 Deleting the Service Product Name [ServiceProductDelete] .......................... 29 Producing the Service Flow Template List [ServiceFlowTemplateList] ........... 29 Getting the Service Flow Template Configuration [ServiceFlowTemplateGet] 29 Creating the Service Flow Template [ServiceFlowTemplateCreate] ............... 29 Deleting the Service Flow Template [ServiceFlowTemplateDelete] ................ 29 Updating the Service Flow Template [ServiceFlowTemplateUpdate] ............. 29 Commercial in Confidence UGD-D00022 Rev A
5.4.1 5.4.2 5.4.3 5.4.4 5.4.5 5.4.6 5.4.7 5.4.8
Page 6
5.4.9 Producing the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersList] ........................................................................... 29 5.4.10 Clearing the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersClear] ........................................................................ 29 5.4.11 Adding the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersAdd] .......................................................................... 29 5.4.12 Removing Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersRemove] ................................................................... 29 5.5 Service Class ........................................................................................................ 30 Producing the Service Class List [ServiceClassList]....................................... 30 Getting Service Class [ServiceClassGet] ....................................................... 30 Creating Service Class [ServiceClassCreate] ................................................ 30 Deleting Service Class [ServiceClassDelete] ................................................. 30 Updating Service Class [ServiceClassUpdate] ............................................... 30
5.5.1 5.5.2 5.5.3 5.5.4 5.5.5 5.6
Packet Classifier ................................................................................................... 30 Producing the Packet Classifier List [PacketClassifierList] ............................. 30 Getting the Packet Classifier [PacketClassifierGet] ........................................ 30 Creating the Packet Classifier [PacketClassifierCreate] ................................. 30 Deleting the Packet Classifier [PacketClassifierDelete] .................................. 30 Updating the Packet Classifier [PacketClassifierUpdate] ............................... 31
5.6.1 5.6.2 5.6.3 5.6.4 5.6.5 5.7
Virtual LAN ........................................................................................................... 31 Producing VLAN List [VlanList] ...................................................................... 31 Getting the VLAN Name [VlanGet] ................................................................. 31 Creating the VLAN [VlanCreate] .................................................................... 31 Deleting the VLAN [VLANDelete] ................................................................... 31 Updating the VLAN [VlanUpdate] ................................................................... 31
5.7.1 5.7.2 5.7.3 5.7.4 5.7.5 5.8
Provision the SS VLAN Port Profile ....................................................................... 31 Producing the SS VLAN Port Profile List [SSVlanPortProfileList] ................... 31 Commercial in Confidence UGD-D00022 Rev A
5.8.1
Page 7
5.8.2 5.8.3 5.8.4 5.8.5 5.8.6 5.8.7 5.8.8 5.8.9 6
Getting the SS VLAN Port Profile [SSVlanPortProfileGet] .............................. 31 Creating the SS VLAN Port Profile [SSVlanPortProfileCreate] ....................... 31 Deleting the SS VLAN Port Profile VLANS [SSVlanPortProfileDelete] ........... 32 Updating the SS VLAN Port Profile VLANS [SSVlanPortProfileUpdate] ......... 32 Getting the SS VLAN Port Profile VLANS [SSVlanPortProfileVlansList] ......... 32 Clearing SS VLAN Port Profile VLANS [SSVLANPortProfileVLANsClear] ...... 32 Adding SS VLAN Port Profile VLANS [SSVlanPortProfileVlansAdd] .............. 32 Removing SS VLAN Port Profile VLANS [SSVlanPortProfileVlansRemove] .. 32
Manage Faults ............................................................................................................. 33 6.1 Listing Active Alarms Read Only ........................................................................ 33 AlarmList........................................................................................................ 33 AlarmListChanged ......................................................................................... 33 AlarmListForBSDU......................................................................................... 33 AlarmListForBSTRx ....................................................................................... 34 AlarmListForSS.............................................................................................. 34 AlarmListForSector ........................................................................................ 34 AlarmListForShelf .......................................................................................... 34 AlarmDetailsGet ............................................................................................. 34
6.1.1 6.1.2 6.1.3 6.1.4 6.1.5 6.1.6 6.1.7 6.1.8 6.2
Editing and Deleting Active Alarms ................................................................... 34 AlarmAcknowledge ........................................................................................ 34 AlarmRelease ................................................................................................ 34 AlarmDelete ................................................................................................... 35 AlarmDetailsCommentSet .............................................................................. 35 AlarmDetailsCommentAppend ....................................................................... 35
6.2.1 6.2.2 6.2.3 6.2.4 6.2.5 7
Appendix ...................................................................................................................... 36 7.1 Parameters and Return Values for Northbound Interface Methods ....................... 36 Page 8 Commercial in Confidence UGD-D00022 Rev A
7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9
SS Provisioning ............................................................................................. 36 ServiceProfiles ............................................................................................... 45 Inventory ........................................................................................................ 48 ServiceProduct .............................................................................................. 48 ServiceClass .................................................................................................. 57 Packet Classifier ............................................................................................ 62 VirtualLan ...................................................................................................... 68 SSVlanPortProfile .......................................................................................... 71 Fault Management ......................................................................................... 78
Page 9
UGD-D00022 Rev A
Glossary of Terms
AAA AAS AF ARQ ASN ASN GW ATCA BS BWA CHAP CPE CQI CSN DSM DTM EAP FA FBSS FDD GUI HA H-ARQ HO IIS IMS IP IPsec LR MAC MDH MIMO MIP Authentication, Authorization and Accounting Advanced Antenna System Application Function Automatic Repeat reQuest Access Service Network ASN Gateway Advanced Telecommunications Computing Architecture Base Station Broadband Wireless Access Challenge Handshake Authentication Protocol Customer Premises Equipment Channel Quality Indicator Connectivity Service Network Digital Surface Model Digital Terrain Model Extensible Authentication Protocol Foreign Agent Fast Base Station Switching Frequency Division Duplex Graphical User Interface Home Agent Hybrid Automatic Repeat reQuest Handover/Handoff Internet Information Services Microsoft Corporation IP Multimedia Subsystem Internet Protocol IP security Location Register Media Access Control Macro Diversity Handover Multiple Input Multiple Output Mobile IP
Page 10
UGD-D00022 Rev A
MRC MS NAP NAS NLOS NSP NWG OBSAI OFDMA PA PAAA PC PF PHY PMIP PPP RADIUS RRA RRC RRM SAS SDR SFA SFM SIM SIP SOFDMA STC TDD VoIP X.509
Maximal Ratio Combining Mobile Station Network Access Provider Network Access Server Non Line of Sight Network Service Provider Network Working Group Open Base Station Standard Initiative Orthogonal Frequency Division Multiplexing (Multiple Access) Paging Agent Proxy AAA Paging Controller Policy Function PHYsical Layer Proxy MIP Point-to-Point Protocol Remote Authentication Dial In User Service Radio Resource Agent Radio Resource Controller Radio Resource Management Smart Antenna System Software Defined Radio Service Flow Authorization Service Flow Management Subscriber Identity Module Session Initiation Protocol Scalable Orthogonal Frequency Division Multiplexing (Multiple Access) Space Time Coding Time Division Duplex Voice over IP ITU-T standard for PKI digital certificates
Page 11
UGD-D00022 Rev A
Summary of Figures and Tables

Figure 1 Northbound Interface Architecture Model ........................................................... 14 Figure 2 Workflow of Northbound Interface ...................................................................... 17 Figure 3 Web browser showing Web Services Index........................................................ 18 Figure 4 Web browser showing SSProvisioning web service methods ............................. 19 Figure 5 Web browser showing SSProvisioning WSDL .................................................... 19 Figure 6 Web browser showing SSProvisioning GetSSProvisioningConfig method details ........................................................................................................................................... 20 Figure 7 Netspan Web Services Users Administration ..................................................... 22
Page 12
UGD-D00022 Rev A
About this Guide

This section discusses the purpose, intended audience, references and organisation for this guide.
Purpose
This guide provides the workflows and step-by-step procedures for operating the Northbound Interface feature of the Netspan element manager (EM) for the WiMAX System current release. These procedures include: Enabling or Disabling the Northbound Interface Authenticating and Authorising access to the Northbound Interface Provisioning network elements and services Managing Faults listing, editing and deleting
Intended Audience
This guide is intended for persons who are responsible for commissioning the product. These persons should have a working knowledge of both the WiMAX system and the Netspan EM.
Referenced Documentation
Netspan Northbound Interface Reference Manual Rev E. December 2007 Netspan Content Specification Release 6.5 Rev E. December 2007
Organisation of this Guide

This guide is organised into the following Sections: Introduction Get Started with Northbound Interface Enable or Disable Northbound Interface Enable or Disable Authentication and Authorisation Provision Service and Define Service Profiles Manage Faults Appendix
Page 13
UGD-D00022 Rev A
1 Introduction
This section (Section 1) provides a descriptive overview of the feature and its place in the product suite.
1.1 General Overview 1.1.1 Northbound Interface

The Netspan Northbound Interface uses industry-standard Web Services technology. The communication between the Web Service client or consumer and Web Service server or Provider (hosted by Netspan), is achieved via the exchange of SOAP messages over HTTP. The services exposed by the Web Service are defined using WSDL (Web Service Description Language) files, which specify the contract between the client and server. There are a number of software toolkits to automatically generate the Web service client code from WSDL files, thereby facilitating the easy development of Web service clients using most major programming languages / operating systems.
Figure 1 Northbound Interface Architecture Model
Page 14
UGD-D00022 Rev A
1.2 Where Northbound Interface fits into the Netspan Architecture

The Netspan Northbound Interface is used typically when operators wish to provision SS in Netspan using their existing, higher level management system. For example, consider that a customer service agent receives a call directly from a customer requesting a new service or a change to an existing service package. The agent could make the requested changes to the customer management system, where the relevant command then would filter down remotely by way of any high-level OSS and be passed seamlessly to Netspan. Alternatively, the command would be passed as part of an automated self-provisioning system, in which case, after purchasing an SS, a customer would enter their credentials into an authenticating front-end server to obtain service. Note: Netspan does not provide an out of the box application / GUI for using and viewing data across the Northbound Interface.
1.3 Consuming Web Services

Northbound interface Web services can be consumed by any client that is capable of making a request over HTTP and parsing out the returned XML. As standard practice, the role of a type library is taken by the WSDL description of a Web Service. Get the WSDL description dynamically by calling the Web Service URL appended by the WSDL parameter; in this case, simply http://<ServerName>/wimaxws1/SSProvisioning.asmx?WSDL where <ServerName> is the name of the server running Netspan. This is the preferred method, because it always gives an up-to-date description of the service. There are a number of software toolkits to automatically generate the Web service client code from WSDL files, thereby facilitating the easy development of Web service clients using most major programming languages / operating systems. The Microsoft .NET framework has a tool for creating something called a Web service proxy that greatly simplifies access to a Web service. Web service proxy can be created in two ways. Using Visual Studio .NET, add what is called a Web Reference by pointing Visual Studio .NET to the URL of the Web service. If not using Visual Studio .NET, use a tool called Web Service Description Language Tool (wsdl.exe) to create the Web service proxy. wsdl.exe utility requires a path to a Web service or to the WSDL that describes the Web service. Given this, it will generate the proxy class. This class has the same method signatures as the Web service and hides the implementation details so that calling the Web service is transparent. That is: Running wsdl.exe against the SSProvisioning in a command line as shown below: Wsdl http://<ServerName>/WiMaxWS1/SSProvisioning.asmx /language:cs gets back a new file named after the class contained within the SSProvisioning.asmx file, SSProvisioning.cs. Page 15 Commercial in Confidence UGD-D00022 Rev A
Note: The instructions above refer to the .NET development environment. The developer of the WS client should refer to the documentation of their development system and the language libraries for help on how to do the similar tasks in the environment of their choice.
1.4 Using Asynchronous Clients

XML Web services are a convenient way to access services of Northbound Interface over HTTP. This can introduce some uncertainties in calling methods of the Web services, due to the latencies involved in transiting data from client to server or server to client over the Internet and during method execution (depending on the server and the method called) over peak times. This can cause the application to behave as if blocked or appear to be sluggish while retrieving information from a web service. The solution is to call the Web service in an asynchronous fashion. This enables the application to send the request to a Web service and then continue doing other work. When the Web service response returns, the application retrieves the data and displays it to the user. Asynchronous access is more useful in a windows-form type of application, where one can go ahead and make the form available to the user immediately. When the data becomes available, just update it in the form already displayed.
Page 16
UGD-D00022 Rev A
2 Get Started with the Northbound Interface

2.1 Workflow of the Northbound Interface
The Workflow required to start and operate the Northbound Interface is shown in the following diagram:
Figure 2 Workflow of Northbound Interface
Page 17
UGD-D00022 Rev A
2.2 Navigating the Northbound Interface

Navigate the Northbound Interface by entering the URL of the web service in the address bar of a web browser as shown in the following screen images. The Index page provides links to specific web services.
Figure 3 Web browser showing Web Services Index
View the particular web service by clicking on its link in the list.
Page 18
UGD-D00022 Rev A
Figure 4 Web browser showing SSProvisioning web service methods
View the underlying WSDL by clicking on Service Description.
Figure 5 Web browser showing SSProvisioning WSDL
Page 19
UGD-D00022 Rev A
View information regarding an individual web service method by returning to the SSProvisioning methods screen then clicking on the name of the method.
Figure 6 Web browser showing SSProvisioning GetSSProvisioningConfig method details
Page 20
UGD-D00022 Rev A
3 Enable or Disable Northbound Interface

By default, the Northbound Interface is enabled.
3.1 Disabling the Northbound Interface

The step-by-step procedure to disable the interface is as follows: 1. Locate the WebServices subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebServices). 2. Edit the Web.Config file in this directory using any standard text editor. 3. Locate the line in subsection <WiMaxWS1.WS> <add key="WebServiceEnabled" value="true" /> and change the value=true to value = false. 4. Locate the WebUI.Netspan subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebUI.Netspan). 5. Edit the Web.Config file in this directory using any standard text editor. 6. Locate the line in subsection <WiMaxWS1.WS> <add key="WebServiceEnabled" value="true" /> and change the value=true to value = false. 7. Restart IIS so that the changes to the Web.Config files take effect.
3.2 Enabling the Northbound Interface

The step-by-step procedure to enable the interface is as follows: 1. Locate the WebServices subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebServices). 2. Edit the Web.Config file in this directory using any standard text editor. 3. Locate the line in subsection <WiMaxWS1.WS> <add key="WebServiceEnabled" value="false" /> and change the value=false to value = true. 4. Locate the WebUI.Netspan subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebUI.Netspan). 5. Edit the Web.Config file in this directory using any standard text editor. 6. Locate the line in subsection <WiMaxWS1.WS> <add key="WebServiceEnabled" value="false" /> and change the value=false to value = true. 7. Restart IIS so that the changes to the Web.Config files take effect.
Page 21
UGD-D00022 Rev A
4 Enable or Disable Authentication and Authorisation

By default, authentication is enabled. In this mode, the user name and password of a user entitled to access the Netspan Web services must be provided in the SOAP Header of every Web Service method request. Netspan is pre-configured with an administrative user for web services, called wsadmin, which has the WS Administrators role. This role automatically has rights to all Netspan web services. An additional role, WS Service Provisioners, whose access is restricted to purely the SS Provisioning procedures in the web service interface, is also supplied. Provided the web service interface is enabled, the wsadmin user is visible from the Users page in Netspan, and it is possible to create new users having either the WS Administrators or WS Service Provisioners role. Any user having the WS Administrators or WS Service Provisioners role should be authorised to access any of the procedures described in this document. Since authentication is enabled by default, in order to use the Internet Explorer test page with Netspan Web services then it is necessary to disable authentication. In this mode, no credentials need to be supplied to access any of the Web Service procedures. Note: The IE test page can only be used as a way of testing a local Web Service; testing of a remote Web Service is not supported.
Figure 7 Netspan Web Services Users Administration
Page 22
UGD-D00022 Rev A
4.1 Disabling Authentication

The step-by-step procedure to disable authentication is as follows: 1. Locate the WebServices subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebServices). 2. Edit the Web.Config file in this directory using any standard text editor. 3. Locate the line in subsection <Sys.Common.Security> <add key="authenticationenabled" value="true" /> and change the value=true to value=false. 4. Restart IIS so that the changes to the Web.Config files take effect.
4.2 Enabling Authentication

The step-by-step procedure to disable authentication is as follows: 1. Locate the WebServices subdirectory of the Netspan Installation (typically C:\Program Files\Airspan Networks Inc\AS8200 Netspan V8\WebServices). 2. Edit the Web.Config file in this directory using any standard text editor. 3. Locate the line in subsection <Sys.Common.Security> <add key="authenticationenabled" value="false" /> and change the value=false to value=true. 4. Restart IIS so that the changes to the Web.Config files take effect.
Page 23
UGD-D00022 Rev A
5 Provision Service and Define Service Profiles

Configuration Management Provisioning Service of Subscriber Stations The following three Web Services that do not require a licence are provided for Provisioning SS: SSProvisioning - allows management of Subscriber Provisioning, such as Provision, De-provision, Re-Provision, Enable and Disable Services on SS. ServiceProfiles - allows retrieving Services and Profiles available on the NMS. This data is used by the SS Provisioning web service above to provision SS. Inventory - allows retrieving BS TRx Channels configured in the NMS. This data is used by the SS Provisioning web service above to provision SS.
Configuration Management Defining Service Profiles The following five web services are provided for the management of services and profiles on the NMS and require a special licence key to use: Service Product - provides facilities to view, create and delete operations of Service Product and Service Flow Templates in NMS. Service Class - assists with view, update, create and delete operations of Service Classes in NMS. Packet Classifier - provides operations to retrieve, create, modify and delete Packet Classifiers in NMS. SSVlan Port Profile - provides operations to retrieve, create, modify and delete SS Vlan Port Profile in NMS. Virtual LAN - Web Service has been provided to assist with view, update, create and delete operations of Virtual LAN in NMS.
5.1 SS Provisioning
The Netspan Northbound interface concentrates on SS Provisioning. This service allows the provisioning of SSs and also the execution of a number of other standard operations related to SS Provisioning, e.g. Enabling or Disabling service on an SS. The interface can be viewed by browsing to http://<webserver>/WiMaxWS1/SSProvisioning.asmx. SSProvisioning methods can be grouped as Obsolete methods, Deprecated methods, Status methods and Action methods. Obsolete methods that are no longer supported include the following: ProvisionCustomSS
ProvisionCustomSS is replaced by ProvisionCustomSSV2 Page 24 Commercial in Confidence UGD-D00022 Rev A
Deprecated methods are retained for compatibility with existing web service clients, and these methods include the following: GetSSCustomProvisioningConfig
GetSSCustomProvisioningConfig is replaced by GetSSCustomProvisioningConfigV2. Status methods return status information for a particular SS, and these methods include the following: GetProvisioningStatus GetSSCustomProvisioningConfigV2 GetSSProvisioningConfig
Action methods perform an action for a particular SS and have further categories as given in the following: Provision an SS ProvisionCustomSSV2 ProvisionFixedSS ProvisionSS
Deprovision an SS Deprovision
Disable / Enable service on an SS DisableService EnableService
Resend existing provisioned configuration to the BSs Reprovision
The following SSProvisioning methods are supported:
5.1.1 Provisioning SS [ProvisionSS]

Provision an SS within the NMS with the specified Service Product. The Service Product must already exist within the NMS. If the SS does not already exist in the NMS it is created, otherwise the existing SS is updated.
Page 25
UGD-D00022 Rev A
5.1.2 Provisioning Fixed SS [ProvisionFixedSS]

Provision an SS within the NMS with the specified Service Product on the specified sector only. The Service Product and sector must already exist within the NMS. If the SS does not already exist in the NMS it is created, otherwise the existing SS is updated.
5.1.3 Provisioning a Custom SS [ProvisionCustomSS]

This action is no longer supported in SR6.1. It returns error E02015, message This method is no longer supported.
5.1.4 Re-provisioning the SS [Reprovision]

Resend the configuration information related to Provisioning for this SS to every Sector it has recently registered on. Users can track the progress of this re-provisioning by calling GetProvisioningStatus() on this SS. Returns an error if the SS does not already exist.
5.1.5 De-provisioning the SS [Deprovision]

Remove any provisioning configuration that has been assigned to this SS in the NMS. As a result of this change, the system will asynchronously remove the configuration information related to provisioning for this SS from every Sector it has recently registered on. Users can track the progress of this de-provisioning by calling GetProvisioningStatus() on this SS. Returns an error if the SS does not already exist.
5.1.6 Disabling Service on the SS [DisableService]

Disable service on the specified SS. As a result of this change, the system will asynchronously remove the configuration information related to provisioning for this SS from every Sector it has recently registered on. Returns an error if the SS does not already exist.
5.1.7 Enabling Service on the SS [EnableService]

Enable service on the specified SS. As a result of this change, the system will asynchronously configure the information related to provisioning for this SS on every Sector it has recently registered on. Returns an error if the SS does not already exist.
5.1.8 Getting the SS Provisioning Configuration [GetSSProvisioningConfig]

Get the standard Provisioning parameters, (as defined in 802.16f), that are configured for the specified SS.
5.1.9 Getting the SS Custom Provisioning Configuration [GetSSCustomProvisioningConfig]

Get the Provisioning parameters, (those defined in 802.16f and proprietary custom extensions), that are configured for the specified SS.
5.1.10
Getting the SS Provisioning Status [GetProvisioningStatus]
Gets the status of the provisioning for this SS on every Sector it has recently registered on. If the SS has not recently registered on any Sector, returns an empty array.
Page 26
UGD-D00022 Rev A
5.1.11 Provisioning a Custom SS within the NMS [ProvisionCustomSSV2]

Method version 2 was first introduced in SR5.0. Provision an SS within the NMS with the specified provisioning properties. The Provisioning parameters include those permitted in 802.16f and additional proprietary custom quantities. If the SS does not already exist in the NMS, it is created, otherwise the existing SS is updated.
5.1.12 Getting the Custom SS Provisioning Configuration [GetSSCustomProvisioningConfigV2]

Method version 2 was first introduced in SR5.0. Get the Provisioning parameters, (those defined in 802.16f and proprietary custom extensions), that are configured for the specified SS.
5.2 Service Profiles

To assist SS Provisioning, an additional Web Service has been provided to permit enumeration of those templates/ profiles used in SSProvisioning. Note: This interface is read-only, i.e. templates can be neither created, modified nor deleted over the Web Services interface. The interface can be viewed by browsing to http://<webserver>/WiMaxWS1/ServiceProfile.asmx. ServiceProfiles methods can be grouped as Deprecated methods and Current methods. Deprecated methods are retained for compatibility with existing web service clients, and these methods include the following: GetGlobalConfig
GetGlobalConfig is replaced by GetGlobalConfigV2. Current methods return data that is useful for the SSProvisioning web service, and these methods include the following: GetGlobalConfigV2 GetSSCustomConfigList GetVlanList GetSSVlanPortProfileList GetServiceProductList
The following ServiceProfiles procedures are supported:
5.2.1 Producing the Service Profiles List [GetServiceProductList]

Produces a list of the names of the Service Products configured in the NMS.
Page 27
UGD-D00022 Rev A
5.2.2 Retrieving the Custom Configuration List [GetSSCustomConfigList]

Produces a list of the names of the SS Custom configurations configured in the NMS.
5.2.3 Producing the VLAN List [GetVlanList]

Produces a list of the Vlans configured in the NMS.
5.2.4 Retrieving Global Configuration Profiles [GetGlobalConfig]

Retrieves the default global profiles configured in the NMS for the SSs.
5.2.5 Producing the SS VLAN Port Profiles List [GetSSVlanPortProfileList]

Produces a list of the SS Vlan Port Profiles configured in the NMS.
5.2.6 Retrieving the Global SSV2 Configuration [GetGlobalConfigV2]

Retrieves the extended set of default global profiles configured in the NMS for the SSs.
5.3 View Inventory

Inventory Web Service has been provided to assist with view operations of Inventories in NMS. These are new actions in SR6.0. The interface can be viewed by browsing to http://<webserver>/wimaxws1/Inventory.asmx. Inventory currently has only one method as follows: BSSectorList - Produces a list of names of BS TRx Channels configured in the NMS. Returns a null if no BS TRx Channels are found.
The following Inventory procedures are supported:
5.3.1 Producing the BS Sector List [BSSectorList]

Produces a list of existing Base Station TRx Channel list names from NMS.
5.4 Service Product

ServiceProduct Web Service has been provided to assist with view, create and delete operations of Service Product and Service Flow Templates in NMS. These are new procedures in SR6.0. Note: Access to these actions is allowed based on an appropriate electronic license key. The interface can be viewed by browsing to http://<webserver>/wimaxws1/ServiceProduct.asmx. The following actions are supported:
5.4.1 Producing the Service Product List [ServiceProductList]

Produces a list of the names of Service Products configured in NMS.
Page 28
UGD-D00022 Rev A
5.4.2 Creating the Service Product Name [ServiceProductCreate]

Creates a Service Product with no service flows.
5.4.3 Deleting the Service Product Name [ServiceProductDelete]

Deletes an existing Service Product.
5.4.4 Producing the Service Flow Template List [ServiceFlowTemplateList]

Produces a list of Service Flow Template names for the specified Service product name in NMS.
5.4.5 Getting the Service Flow Template Configuration [ServiceFlowTemplateGet]

Gets a Service Flow Template configuration from the NMS for the specified Service Product and Service Flow Template.
5.4.6 Creating the Service Flow Template [ServiceFlowTemplateCreate]

Creates a Service Flow Template in a Service Product with the specified parameters.
5.4.7 Deleting the Service Flow Template [ServiceFlowTemplateDelete]

Deletes an existing Service Flow Template from the specified Service Product.
5.4.8 Updating the Service Flow Template [ServiceFlowTemplateUpdate]

Updates an existing Service Flow Template in the specified Service Product with the specified parameters.
5.4.9 Producing the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersList]

Produces a list of Classifier names for an existing Service Flow Template in the specified Service Product.
5.4.10 Clearing the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersClear]

Clears all the PacketClassifier from an existing Service Flow Template in the specified Service Product.
5.4.11 Adding the Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersAdd]

Adds an existing Packet Classifier to and existing Service Flow Template in the specified Service Product.
5.4.12 Removing Service Flow Template Classifiers List [ServiceFlowTemplateClassifiersRemove]

Removes existing Packet Classifier from a Service Flow Template in the specified Service Product.
Page 29
UGD-D00022 Rev A
5.5 Service Class

ServiceClass Web Service has been provided to assist with view, update, create and delete operations of Service Classes in NMS. Note: Access to these actions is allowed based on an appropriate electronic license key. The interface can be viewed by browsing to http://<webserver>/wimaxws1/ServiceClass.asmx. The following actions are supported:
5.5.1 Producing the Service Class List [ServiceClassList]

Produces a list of Service Class names configured in NMS.
5.5.2 Getting Service Class [ServiceClassGet]

Gets the configuration of the specified Service Class.
5.5.3 Creating Service Class [ServiceClassCreate]

Creates a new Service Class with the specified parameters passed.
5.5.4 Deleting Service Class [ServiceClassDelete]

Removes existing Service Class in NMS.
5.5.5 Updating Service Class [ServiceClassUpdate]

Updates an existing Service Class in NMS with the parameters passed.
5.6 Packet Classifier

PacketClassifier Web Service has been provided to assist with view, update, create and delete operations of Packet Classifiers in NMS. These are new actions in SR6.0. Note: Access to these actions is allowed based on an appropriate electronic license key. The interface can be viewed by browsing to http://<webserver>/wimaxws1/PacketClassifier.asmx. The following actions are supported:
5.6.1 Producing the Packet Classifier List [PacketClassifierList]

Produces the list of existing Packet Classifier names configured in NMS.
5.6.2 Getting the Packet Classifier [PacketClassifierGet]

Get the configuration of the specified Packet Classifier in NMS.
5.6.3 Creating the Packet Classifier [PacketClassifierCreate]

Creates a new Packet Classifier in the NMS.
5.6.4 Deleting the Packet Classifier [PacketClassifierDelete]

Removes an existing Packet Classifier in NMS.
Page 30
UGD-D00022 Rev A
5.6.5 Updating the Packet Classifier [PacketClassifierUpdate]

Updates an existing Packet Classifier in the NMS with the parameters passed.
5.7 Virtual LAN

VirtualLan Web Service has been provided to assist with view, update, create and delete operations of Virtual LAN in NMS. Note: Access to these actions is allowed based on an appropriate electronic license key. The interface can be viewed by browsing to http://<webserver>/wimaxws1/VirtualLan.asmx. The following actions are supported.
5.7.1 Producing VLAN List [VlanList]

Produces a list of VLANs configured in NMS.
5.7.2 Getting the VLAN Name [VlanGet]

Gets VLAN configuration of the specified VLAN Name in NMS.
5.7.3 Creating the VLAN [VlanCreate]

Creates a new VLAN in the NMS.
5.7.4 Deleting the VLAN [VLANDelete]

Deletes an existing VLAN in NMS.
5.7.5 Updating the VLAN [VlanUpdate]

Updates an existing VLAN with new parameters specified.
5.8 Provision the SS VLAN Port Profile

SSVlanPortProfile Web Service has been provided to assist with view, update, create and delete operations of SS Virtual LAN Port Profiles in NMS. These are new actions in SR6.0. Note: Access to these actions is allowed based on an appropriate electronic license key. The interface can be viewed by browsing to http://<webserver>/wimaxws1/SSVlanPortProfile.asmx. The following actions are supported:
5.8.1 Producing the SS VLAN Port Profile List [SSVlanPortProfileList]

Produces a list of the SS VLAN Port Profiles configured in the NMS.
5.8.2 Getting the SS VLAN Port Profile [SSVlanPortProfileGet]

Gets the configuration of an existing SS VLAN Port Profile in NMS.
5.8.3 Creating the SS VLAN Port Profile [SSVlanPortProfileCreate]

Creates a new SS VLAN Port Profile in NMS with the specified parameters.
Page 31
UGD-D00022 Rev A
5.8.4 Deleting the SS VLAN Port Profile VLANS [SSVlanPortProfileDelete]

Deletes all VLANs from and existing SS VLAN Port Profile in the NMS.
5.8.5 Updating the SS VLAN Port Profile VLANS [SSVlanPortProfileUpdate]

Updates an existing VLAN to an existing SS VLAN PORT Profile in the NMS.
5.8.6 Getting the SS VLAN Port Profile VLANS [SSVlanPortProfileVlansList]

Gets an existing VLAN from and existing SS VLAN Port Profile in NMS.
5.8.7 Clearing SS VLAN Port Profile VLANS [SSVLANPortProfileVLANsClear]

Clears all VLANs from and existing SS VLAN Port Profile in the NMS.
5.8.8 Adding SS VLAN Port Profile VLANS [SSVlanPortProfileVlansAdd]

Adds an existing VLAN to an existing SS VLAN PORT Profile in the NMS.
5.8.9 Removing SS VLAN Port Profile VLANS [SSVlanPortProfileVlansRemove]

Removes an existing VLAN from and existing SS VLAN Port Profile in NMS.
Page 32
UGD-D00022 Rev A
6 Manage Faults
Faults Management The following Fault Management web service does not require a special licence key to use: Fault Management - Provided to assist with the operations of Fault Management of NMS, such as retrieving, releasing, acknowledging and commenting Alarms. Note: To view Parameters and Return Values for all the methods listed in this section, please turn in this document to the Appendix.
6.1
Listing Active Alarms Read Only
The Fault Management Web Service has been provided to assist with the operations of Fault Management of NMS. These are new methods in SR6.5. The Fault Management interface can be viewed by browsing to http://<webserver>/wimaxws1/FaultManagement.asmx. The interface can be classified as follows: Active Alarms Read Only APIs to retrieve active alarms from NMS AlarmList AlarmListChanged AlarmListForBSDU AlarmListForBSTRx AlarmListForSS AlarmListForSector AlarmListForShelf AlarmDetailsGet
The following read only methods are supported:
6.1.1 AlarmList
Produces a list of active alarms in the NMS. Returns a null if no Alarms are found.
6.1.2 AlarmListChanged
Produces a list of active alarms changed since lastChangedTime in the NMS. Returns a null if no Alarms are found.
6.1.3 AlarmListForBSDU
Produces a list of active alarms for the specified BSDU macAddress in the NMS. Returns a null if no Alarms are found.
Page 33
UGD-D00022 Rev A
6.1.4 AlarmListForBSTRx
Produces a list of active alarms for the specified BSID in the NMS. Returns a null if no Alarms are found.
6.1.5 AlarmListForSS
Produces a list of active alarms for the specified SS macAddress in the NMS. Returns a null if no Alarms are found.
6.1.6 AlarmListForSector
Produces a list of active alarms for the specified Sector BSID in the NMS. Returns a null if no Alarms are found.
6.1.7 AlarmListForShelf
Produces a list of active alarms for the specified shelfId in the NMS. Returns a null if no Alarms are found.
6.1.8 AlarmDetailsGet
Gets detailed information on an active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
6.2 Editing and Deleting Active Alarms

Active Alarms Edit and Delete The Fault Management interface can be viewed by browsing to http://<webserver>/wimaxws1/FaultManagement.asmx. APIs to modify and delete an active alarm in the NMS AlarmAcknowledge AlarmDelete AlarmDetailsCommentAppend AlarmDetailsCommentSet AlarmRelease
The following edit and delete methods are supported:
6.2.1 AlarmAcknowledge
Acknowledges (sets acknowledged flag of) an existing active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
6.2.2 AlarmRelease
Releases (clears acknowledged flag of) an existing active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
Page 34
UGD-D00022 Rev A
6.2.3 AlarmDelete
Deletes an existing active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
6.2.4 AlarmDetailsCommentSet
Sets comment on an existing active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
6.2.5 AlarmDetailsCommentAppend
Appends a comment on an existing active Alarm with AlarmID that exists in the NMS. Returns an error if the AlarmID does not already exist.
Page 35
UGD-D00022 Rev A
7 Appendix
7.1 Parameters and Return Values for Northbound Interface Methods 7.1.1 SS Provisioning 7.1.1.1 ProvisionSS
Method Description
ProvisionSS( string macAddress, string serviceProductName) Provision an SS within the NMS with the specified Service Product. The Service Product must already exist within the NMS. If the SS does not already exist in the NMS it is created, otherwise the existing SS is updated.
Parameters macAddress Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit.
Mandatory parameter. The name of an existing Service serviceProductName product within the NMS Return Values E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02004: A Service Product name must be supplied for this service E02005: No Service Product exists with the supplied name E02012: For this method to be supported, a default SS Custom Configuration must be specified in the NMS E02013: For this method to be supported, a default SS VLAN Port Profile must be specified in the NMS.
7.1.1.2 ProvisionFixedSS
Page 36
UGD-D00022 Rev A
Method Description
ProvisionFixedSS( string macAddress, string serviceProductName, string homeSectorBSID) Provision an SS within the NMS with the specified Service Product on the specified sector only. The Service Product and sector must already exist within the NMS. If the SS does not already exist in the NMS it is created, otherwise the existing SS is updated.
Parameters macAddress Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where x is a hex digit.
Mandatory parameter. The name of an existing Service serviceProductName product within the NMS Optional parameter. BSID is of the format xxxxxx:xxxxxx where x is a hex digit. Must identify an existing Sector in the NMS. E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02002: Invalid BS Id. Please supply a string of format xxxxxx:xxxxxx where x is a hex digit. E02003: No Sector exists with the supplied BS Id E02004: A Service Product name must be supplied for this service E02005: No Service Product exists with the supplied name E02012: For this method to be supported, a default SS Custom Configuration must be specified in the NMS E02013: For this method to be supported, a default SS VLAN Port Profile must be specified in the NMS.
homeSectorBSID Return Values
7.1.1.3 ProvisionCustomSS
Page 37
UGD-D00022 Rev A
This method is no longer supported in SR5.0. It returns error E02015, message This method is no longer supported.
7.1.1.4 Reprovision
Method Description
Reprovision ( string macAddress) Resend the configuration information related to Provisioning for this SS to every Sector it has recently registered on. Users can track the progress of this reprovisioning by calling GetProvisioningStatus() on this SS. Returns an error if the SS does not already exist.
Parameters macAddress Return Values Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. E00000: No Error E02009: Web Service Authorisation Failure E02001: No SS with this Mac Address exists E01036: Reprovisioning this SS has no effect as the SS has Service Disabled
7.1.1.5 Deprovision
Method Description
Deprovision ( string macAddress) Remove any provisioning configuration that has been assigned to this SS in the NMS. As a result of this change, the system will asynchronously remove the configuration information related to provisioning for this SS from every Sector it has recently registered on. Users can track the progress of this de-provisioning by calling GetProvisioningStatus() on this SS. Returns an error if the SS does not already exist.
Parameters macAddress Mandatory parameter. Mac Address is specified using format
Page 38
UGD-D00022 Rev A
xx:xx:xx:xx:xx:xx where xx is a hex digit. Return Values E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02001: No SS with this Mac Address exists.
7.1.1.6 DisableService
Method Description
DisableService( string macAddress) Disable service on the specified SS. As a result of this change, the system will asynchronously remove the configuration information related to provisioning for this SS from every Sector it has recently registered on. Returns an error if the SS does not already exist.
Parameters macAddress Return Values Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02001: No SS with this Mac Address exists.
7.1.1.7 EnableService
Method Description
EnableService( string macAddress) Enable service on the specified SS. As a result of this change, the system will asynchronously configure the information related to provisioning for this SS on every Sector it has recently registered on. Returns an error if the SS does not already exist.
Page 39
UGD-D00022 Rev A
Parameters macAddress Return Values Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02001: No SS with this Mac Address exists.
7.1.1.8 GetSSProvisioningConfig
Method Description GetSSProvisioningConfig( string macAddress) Get the standard Provisioning parameters, (as defined in 802.16f), that are configured for the specified SS.
Parameters macAddress Returns SSProvisioningConfig Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. Properties: MacAddress Service Product Name Home Sector BSID SS Description1 SS Description2 SS Description3 SS Description4 SS Description5
7.1.1.9 GetSSCustomProvisioningConfig
Method
GetSSCustomProvisioningConfig( string macAddress) Get the Provisioning parameters, (those defined in 802.16f and proprietary custom extensions), that are configured for the specified SS.
Description
Page 40
UGD-D00022 Rev A
Parameters macAddress Return SSCustomProvisioningConfig Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. Properties: MacAddress Service Product Name Home Sector BSID VlanList (integer array of Vlan IDs of Vlans the SS is a member of) CustomConfigName SS Description1 SS Description2 SS Description3 SS Description4 SS Description5
7.1.1.10 GetProvisioningStatus
Method Description
GetProvisioningStatus( string macAddress) Gets the status of the provisioning for this SS on every Sector it has recently registered on. If the SS has not recently registered on any Sector, returns an empty array.
Parameters macAddress Returns Array of SSProvisioningStatus (1 per Sector recently registered with). Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where xx is a hex digit. Properties: BS Name BS IP Address BS Id of Sector NMS-BS ConnectionState ProvisioningState RegistrationState Time first detected on this Sector Time last detected on this Sector Stats on pending configuration changes for this SS on the given sector. Stats are: Total changes New (unprocessed) changes In Progress changes (SNM P changes being built UGD-D00022 Rev A
Page 41
by Provisioning Service. AwaitingResponse changes (SNMP changes sent to Job Service for transmission but no response received at Provisioning Service). Queued (stored in Provisioning Service for dispatch to the Job Service). Failed Changes which have received a NACK from the BS.
7.1.1.11 ProvisionCustomSSV2
This is a new method in SR5.0.
Method
ProvisionCustomSSV2(string macAddress, string serviceProductName, string homeSectorBSID, string customConfigName, string vlanPortProfileName) Provision an SS within the NMS with the specified provisioning properties. The Provisioning parameters include those permitted in 802.16f and additional proprietary custom quantities. If the SS does not already exist in the NMS, it is created, otherwise the existing SS is updated.
Description
Page 42
UGD-D00022 Rev A
Parameters string macAddress Mandatory parameter. Mac Address is specified using format xx:xx:xx:xx:xx:xx where x is a hex digit. Mandatory parameter. The name of an existing Service product within the NMS Optional parameter. BSID is of the format xxxxxx:xxxxxx where x is a hex digit. Must identify an existing Sector in the NMS. Optional parameter. The name of an existing SS Custom Configuration within the NMS. If no name is specified then the NMS must have a default SS Custom Configuration configured. Optional parameter. The name of an existing SS Vlan Port Profile within the NMS. If no name is specified then the NMS must have a default SS Vlan Port Profile configured.
string serviceProductName
string homeSectorBSID
string customConfigName
string vlanPortProfileName
Page 43
UGD-D00022 Rev A
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E01018: Invalid Mac Address E02002: Invalid BS Id. Please supply a string of format xxxxxx:xxxxxx where x is a hex digit. E02003: No Sector exists with the supplied BS Id E02004: A Service Product name must be supplied for this service E02005: No Service Product exists with the supplied name E02006: No SS Custom Config exists with the supplied name. E02010: If no SS Custom Configuration is supplied, then a default SS Custom Configuration must be configured in the NMS. E02017: If no SS Vlan Port Profile is supplied, then a default SS Vlan Port Profile must be configured in the NMS. E02016: No SS Vlan Port Profile exists with this name..
7.1.1.12 GetSSCustomProvisioningConfigV2
Method Description
GetSSCustomProvisioningConfigV2( string macAddress) Get the Provisioning parameters, (those defined in 802.16f and proprietary custom extensions), that are configured for the specified SS.
Parameters Mandatory parameter. Mac Address is specified Page 44 Commercial in Confidence UGD-D00022 Rev A
macAddress Return SSCustomProvisioningConfig
using format xx:xx:xx:xx:xx:xx where xx is a hex digit. Properties: MacAddress Service Product Name Home Sector BSID CustomConfigName VlanPortProfileName Description1 Description2 Description3 Description4 Description5
7.1.2 ServiceProfiles 7.1.2.1 GetServiceProductList
Method Description Parameters
GetServiceProductList() Produces a list of the names of the Service Products configured in the NMS None
Returns Array of ServiceProductDetails
Properties: Name Description
7.1.2.2 GetSSCustomConfigList
Method Description
GetSSCustomConfigList() Produces a list of the names of the SS Custom configurations configured in the NMS
Page 45
UGD-D00022 Rev A
Parameters
None
Returns Array of CustomConfigDetails
7.1.2.3 GetVlanList
GetVlanList() Produces a list of the Vlans configured in the NMS None
Returns Array of VlanDetails
Properties: Name Vlan ID
7.1.2.4 GetGlobalConfig
GetGlobalConfig() Retrieves the default global profiles configured in the NMS for the SSs.. None
Returns
Properties:
Page 46
UGD-D00022 Rev A
GlobalConfigDetails
ServiceProductName CustomConfigName Vlan ID
7.1.2.5 GetSSVlanPortProfileList
GetSSVlanPortProfileList() Produces a list of the SS Vlan Port Profiles configured in the NMS. None
Returns Array of VlanPortProfileDetails
7.1.2.6 GetGlobalConfigV2
GetGlobalConfigV2() Retrieves the extended set of default global profiles configured in the NMS for the SSs.. None
Returns
Properties:
Page 47
UGD-D00022 Rev A
GlobalConfigDetails
ServiceProductName CustomConfigName VlanPortProfileName
7.1.3 Inventory 7.1.3.1 BSSectorList
Method
BSSectorList
Description Parameters
Produces a list of existing Base Station TRx Channel list names from NMS None
Returns Array of BSSectorDetails
Properties: Channel Name Channel BSID
7.1.4 ServiceProduct 7.1.4.1 Service Product List
ServiceProductList() Produces a list of the names of Service Products configured in NMS None
Returns Array of
Properties: Name Description UGD-D00022 Rev A
Page 48
ServiceProductDetails
7.1.4.2 Service Product Create
Method Description Parameters serviceProductName
ServiceProductCreate(string serviceProductName) Creates a Service Product with no service flows
Mandatory parameter. The name of the new Service Product to create
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02037: WSServiceProductNameEmpty E02019:WSServiceProductAlreadyExists
7.1.4.3 Service Product Delete
ServiceProductDelete(string serviceProductName) Deletes an existing Service Product
Mandatory parameter. The name of the new Service Product to create
Return Values
E00000: No Error E02009: Web Service Authorisation Failure
Page 49
UGD-D00022 Rev A
E02014: WSWebServiceDisabled E02037: WSServiceProductNameEmpty E02018: WSServiceProductDoesNotExist E02020: WSCannotDeleteServiceProductInUse
7.1.4.4 Service Flow Template List
ServiceFlowTemplateList(string serviceProductName) Produces a list of Service Flow Template names for the specified Service product name in NMS
Mandatory parameter. The name of the new Service Product
Returns Array of ServiceFlowTemplateDetails
7.1.4.5 Service Flow Template Get
Method
ServiceFlowTemplateGet(string serviceProductName, string serviceFlowTemplateDescription) Gets a Service Flow Template configuration from the NMS for the specified Service Product and Service Flow Template
Description
Parameters serviceProductName Mandatory parameter. The name of the Service product Mandatory parameter. The name of the Service Flow Page 50 Commercial in Confidence UGD-D00022 Rev A
serviceFlowTemplateDescription Template description Return ServiceFlowTemplateConfig Properties: ServiceProductName ServiceFlowTemplateDescription Direction ServiceClassName InitialState ConvergenceSublayerType
(to get Service Flow Template Classifier List use ServiceFlowTemplateClassifiersList)
7.1.4.6 Service Flow Template Create
Method
ServiceFlowTemplateCreate(ServiceFlowTemplateConfi g serviceFlowTemplateConfig) Creates a Service Flow Template in a Service Product with the specified parameters.
Description Parameters ServiceFlowTemplateConfi g
Mandatory parameter. ServiceProductName Mandatory parameter. ServiceFlowTemplateDescription Mandatory parameter. Direction Mandatory parameter. ServiceClassName Mandatory parameter. InitialState Mandatory parameter. ConvergenceSublayerType
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02039: WSServiceClassNameEmpty E02038: WSServiceFlowTemplateDescriptionEmpty
Page 51
UGD-D00022 Rev A
E02037: WSServiceProductNameEmpty E02025: WSServiceClassDoesNotExist E02023: WSServiceFlowTemplateAlreadyExists E02021: WSServiceProductInUse E02018: WSServiceProductDoesNotExist
7.1.4.7 Service Flow Template Delete
Method
ServiceFlowTemplateDelete(string serviceProductName, string serviceFlowTemplateDescription) Deletes an existing Service Flow Template from the specified Service Product
Description
Parameters serviceProductName Mandatory parameter. The name of the Service Product
serviceFlowTemplateDescription Mandatory parameter. The name of the Service Flow Template description
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02022: WSServiceFlowTemplateDoesNotExist E02021: WSServiceProductInUse E02018: WSServiceProductDoesNotExist E02038: WSServiceFlowTemplateDescriptionEmpty E02037: WSServiceProductNameEmpty
Page 52
UGD-D00022 Rev A
7.1.4.8 Service Flow Template Update
Method Description
ServiceFlowTemplateUpdate(ServiceFlowTemplateConf ig serviceFlowTemplateConfig) Updates an existing Service Flow Template in the specified Service Product with the specified parameters
Parameters ServiceFlowTemplateConfi g Mandatory parameter. ServiceProductName Mandatory parameter. ServiceFlowTemplateDescription Mandatory parameter. Direction Mandatory parameter. ServiceClassName Mandatory parameter. InitialState Mandatory parameter. ConvergenceSublayerType Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02039: WSServiceClassNameEmpty E02038: WSServiceFlowTemplateDescriptionEmpty E02037: WSServiceProductNameEmpty E02018: WSServiceProductDoesNotExist E02021: WSServiceProductInUse E02022: WSServiceFlowTemplateDoesNotExist E02025: WSServiceClassDoesNotExist
7.1.4.9 Service Flow Template Classifiers List
Method
ServiceFlowTemplateClassifiersList(string serviceProductName, string Commercial in Confidence UGD-D00022 Rev A
Page 53
serviceFlowTemplateDescription) Description Produces a list of Classifier names for an existing Service Flow Template in the specified Service Product.
Parameters serviceProductName serviceFlowTemplateDescription Mandatory parameter. The name of the Service Flow Template description Returns Array of ServiceFlowTemplateClassifierDetails Properties: Name Mandatory parameter. The name of the Service Product
7.1.4.10 Service Flow Template Classifiers Clear
Method
ServiceFlowTemplateClassifiersClear(string serviceProductName, string serviceFlowTemplateDescription) Clears all the PacketClassifier from an existing Service Flow Template in the specified Service Product.
Description Parameters serviceProductName
Mandatory parameter. The name of the Service Product
serviceFlowTemplateDescription Mandatory parameter. The name of the Service Flow Template description Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02021: WSServiceProductInUse E02038: WSServiceFlowTemplateDescriptionEmpty
Page 54
UGD-D00022 Rev A
E02037: WSServiceProductNameEmpty E02018: WSServiceProductDoesNotExist E02022: WSServiceFlowTemplateDoesNotExist E02028: WSPacketClassifierDoesNotExist
7.1.4.11 Service Flow Template Classifiers Add
Method
ServiceFlowTemplateClassifiersAdd(string serviceProductName, string serviceFlowTemplateDescription, string packetClassifierName) Adds an existing Packet Classifier to and existing Service Flow Template in the specified Service Product
Description
Parameters serviceProductName Mandatory parameter. The name of the Service Product
serviceFlowTemplateDescription Mandatory parameter. The name of the Service Flow Template description packetClassifierName Mandatory parameter. The name of the Packet Classifier Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02038: WSServiceFlowTemplateDescriptionEmpty E02037: WSServiceProductNameEmpty E02040: WSPacketClassifierNameEmpty E02021: WSServiceProductInUse E02018: WSServiceProductDoesNotExist E02022: WSServiceFlowTemplateDoesNotExist
Page 55
UGD-D00022 Rev A
E02028: WSPacketClassifierDoesNotExist E02029: WSPacketClassifierAlreadyExists
7.1.4.12 Service Flow Template Classifiers Remove
Method
ServiceFlowTemplateClassifiersRemove(string serviceProductName, string serviceFlowTemplateDescription, string packetClassifierName)
Description
Removes existing Packet Classifier from a Service Flow Template in the specified Service Product.
Parameters serviceProductName Mandatory parameter. The name of the Service product
serviceFlowTemplateDescription Mandatory parameter. The name of the Service Flow Template description packetClassifierName Mandatory parameter. The name of the Packet Classifier Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02038: WSServiceFlowTemplateDescriptionEmpty E02037: WSServiceProductNameEmpty E02040: WSPacketClassifierNameEmpty E02021: WSServiceProductInUse E02018: WSServiceProductDoesNotExist E02022: WSServiceFlowTemplateDoesNotExist
Page 56
UGD-D00022 Rev A
E02028: WSPacketClassifierDoesNotExist
7.1.5 ServiceClass 7.1.5.1 Service Class List
Method Description Parameters Returns Array of ServiceClassDetails
ServiceClassList () Produces a list of Service Class names configured in NMS None Properties: Name
7.1.5.2 Get Service Class
Method
ServiceClassGet(string serviceClassName)
Description Parameters serviceClassName Return ServiceClassConfig
Gets the configuration of the specified Service Class
Mandatory parameter. The name of the Service Class Properties: Name SchedulingType TrafficPriority ReqTxPolicyBroadcastBWReqOn ReqTxPolicyPiggybackReqOn ReqTxPolicyFragmentationOn ReqTxPolicyPHSOn UGD-D00022 Rev A
Page 57
ReqTxPolicySDUPackingOn ReqTxPolicyCRCOn MaxSustainedRate MaxTrafficBurst MinReservedRate MinRsvdTolerableRate ToleratedJitter MaxLatency FixedVsVariableSduInd SduSize ExtPollPeriod
ARQ (s not supported by hardware category: MicroMAX. The configuration system will not set ARQ objects on targets of this type.) ArqEnable ArqWindowSize ArqFragmentLifetime ArqSyncLossTimeout ArqDeliverInOrder ArqRxPurgeTimeout ArqBlockSize
7.1.5.3 Create Service Class
Method
ServiceClassCreate(ServiceClassConfig)
Description Parameters ServiceClassConfig
Creates a new Service Class with the specified parameters passed.
Mandatory parameter. Name Mandatory parameter. SchedulingType Mandatory parameter. TrafficPriority Mandatory parameter. ReqTxPolicyBroadcastBWReqOn Mandatory parameter. ReqTxPolicyPiggybackReqOn
Page 58
UGD-D00022 Rev A
Mandatory parameter. ReqTxPolicyFragmentationOn Mandatory parameter. ReqTxPolicyPHSOn Mandatory parameter. ReqTxPolicySDUPackingOn Mandatory parameter. ReqTxPolicyCRCOn Mandatory parameter. MaxSustainedRate Mandatory parameter. MaxTrafficBurst Mandatory parameter. MinReservedRate Mandatory parameter. MinRsvdTolerableRate Mandatory parameter. ToleratedJitter Mandatory parameter. MaxLatency Mandatory parameter. FixedVsVariableSduInd Mandatory parameter. SduSize Mandatory parameter. ExtPollPeriod
ARQ (s not supported by hardware category: MicroMAX. The configuration system will not set ARQ objects on targets of this type.)
Mandatory parameter. ArqEnable Mandatory parameter. ArqWindowSize Mandatory parameter. ArqFragmentLifetime Mandatory parameter. ArqSyncLossTimeout Mandatory parameter. ArqDeliverInOrder Mandatory parameter. ArqRxPurgeTimeout Mandatory parameter. ArqBlockSize Return Values E00000: No Error
Page 59
UGD-D00022 Rev A
E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02039: WSServiceClassNameEmpty E02026: WSServiceClassAlreadyExists
7.1.5.4 Delete Service Class
Method
ServiceClassDelete(string serviceClassName)
Description Parameters serviceClassName Return Values
Removes existing Service Class in NMS
Mandatory parameter. The name of the Service Class E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02039: WSServiceClassNameEmpty E02025: WSServiceClassDoesNotExist
7.1.5.5 Update Service Class
Method
ServiceClassUpdate(ServiceClassConfig)
Description Parameters ServiceClassConfig
Updates an existing Service Class in NMS with the parameters passed
Mandatory parameter. Name
Page 60
UGD-D00022 Rev A
Mandatory parameter. SchedulingType Mandatory parameter. TrafficPriority Mandatory parameter. ReqTxPolicyBroadcastBWReqOn Mandatory parameter. ReqTxPolicyPiggybackReqOn Mandatory parameter. ReqTxPolicyFragmentationOn Mandatory parameter. ReqTxPolicyPHSOn Mandatory parameter. ReqTxPolicySDUPackingOn Mandatory parameter. ReqTxPolicyCRCOn Mandatory parameter. MaxSustainedRate Mandatory parameter. MaxTrafficBurst Mandatory parameter. MinReservedRate Mandatory parameter. MinRsvdTolerableRate Mandatory parameter. ToleratedJitter Mandatory parameter. MaxLatency Mandatory parameter. FixedVsVariableSduInd Mandatory parameter. SduSize Mandatory parameter. ExtPollPeriod
ARQ (s not supported by hardware category: MicroMAX. The configuration system will not set ARQ objects on targets of this type.)
Mandatory parameter. ArqEnable Mandatory parameter. ArqWindowSize Mandatory parameter. ArqFragmentLifetime Mandatory parameter. ArqSyncLossTimeout
Page 61
UGD-D00022 Rev A
Mandatory parameter. ArqDeliverInOrder Mandatory parameter. ArqRxPurgeTimeout Mandatory parameter. ArqBlockSize Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02039: WSServiceClassNameEmpty E02025: WSServiceClassDoesNotExist
7.1.6 Packet Classifier 7.1.6.1 Packet Classifier List
Method
PacketClassifierList()
Description Parameters Returns Array of PacketClassifierDetails
Produces the list of existing Packet Classifier names configured in NMS None Properties: Name
7.1.6.2 Get Packet Classifier
Method
PacketClassifierGet(string packetClassifierName)
Description
Get the configuration of the specified Packet Classifier in NMS
Page 62
UGD-D00022 Rev A
Parameters packetClassifierName Return PacketClassifierConfig Name Priority Action L3 Rules IpTosLow IpTosHigh IpTosMask IpProtocol IpAddressType IpSourceAddress IpSourceMask IpDestAddress IpDestMask SourcePortStart SourcePortEnd DestPortStart DestPortEnd L2 Rules SourceMacAddress SourceMacMask DestMacAddress DestMacMask EnetProtocolIDType EnetProtocolID VlanId UserPriLow UserPriHigh Payload header Suppression PhsSize PhsMask PhsVerify VLAN Tagging Dot1QtagEnabled Dot1QtagVlanId Dot1QTagPriority Mandatory parameter. The name of the Packet Classifier Properties:
Page 63
UGD-D00022 Rev A
7.1.6.3 Create Packet Classifier
Method
PacketClassifierCreate(PacketClassifierConfig packetClassifierConfig)
Description Parameters PacketClassifierConfig
Creates a new Packet Classifier in the NMS
Mandatory parameter. Name Mandatory parameter. NPriority Mandatory parameter. NAction L3 Rules Mandatory parameter. NIpTosLow Mandatory parameter. NIpTosHigh Mandatory parameter. NIpTosMask Mandatory parameter. NIpProtocol Mandatory parameter. NIpAddressType Mandatory parameter. NIpSourceAddress Mandatory parameter. NIpSourceMask Mandatory parameter. NIpDestAddress Mandatory parameter. NIpDestMask Mandatory parameter. NSourcePortStart Mandatory parameter. NSourcePortEnd Mandatory parameter. NDestPortStart Mandatory parameter. NDestPortEnd L2 Rules Mandatory parameter. NSourceMacAddress
Page 64
UGD-D00022 Rev A
Mandatory parameter. NSourceMacMask Mandatory parameter. NDestMacAddress Mandatory parameter. NDestMacMask Mandatory parameter. NEnetProtocolIDType Mandatory parameter. NEnetProtocolID Mandatory parameter. NVlanId Mandatory parameter. NUserPriLow Mandatory parameter. NUserPriHigh Payload header Suppression Mandatory parameter. NPhsSize Mandatory parameter. NPhsMask Mandatory parameter. NPhsVerify VLAN Tagging Mandatory parameter. NDot1QtagEnabled Mandatory parameter. NDot1QtagVlanId Mandatory parameter. NDot1QTagPriority Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02040: WSPacketClassifierNameEmpty E02029: WSPacketClassifierAlreadyExists
7.1.6.4 Delete Packet Classifier
Method
PacketClassifierDelete(string packetClassifierName)
Page 65
UGD-D00022 Rev A
Description Parameters packetClassifierName Return Values
Removes an existing Packet Classifier in NMS
Mandatory parameter. The name of the Packet Classifier E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02040: WSPacketClassifierNameEmpty E02028: WSPacketClassifierDoesNotExist
7.1.6.5 Update Packet Classifier
Method
PacketClassifierUpdate(PacketClassifierConfig packetClassifierConfig)
Description Parameters PacketClassifierConfig
Updates an existing Packet Classifier in the NMS with the parameters passed
Mandatory parameter. Name Mandatory parameter. NPriority Mandatory parameter. NAction L3 Rules Mandatory parameter. NIpTosLow Mandatory parameter. NIpTosHigh Mandatory parameter. NIpTosMask
Page 66
UGD-D00022 Rev A
Mandatory parameter. NIpProtocol Mandatory parameter. NIpAddressType Mandatory parameter. NIpSourceAddress Mandatory parameter. NIpSourceMask Mandatory parameter. NIpDestAddress Mandatory parameter. NIpDestMask Mandatory parameter. NSourcePortStart Mandatory parameter. NSourcePortEnd Mandatory parameter. NDestPortStart Mandatory parameter. NDestPortEnd L2 Rules Mandatory parameter. NSourceMacAddress Mandatory parameter. NSourceMacMask Mandatory parameter. NDestMacAddress Mandatory parameter. NDestMacMask Mandatory parameter. NEnetProtocolIDType Mandatory parameter. NEnetProtocolID Mandatory parameter. NVlanId Mandatory parameter. NUserPriLow Mandatory parameter. NUserPriHigh Payload header Suppression Mandatory parameter. NPhsSize Mandatory parameter. NPhsMask Mandatory parameter. NPhsVerify VLAN Tagging
Page 67
UGD-D00022 Rev A
Mandatory parameter. NDot1QtagEnabled Mandatory parameter. NDot1QtagVlanId Mandatory parameter. NDot1QTagPriority Return Values E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02040: WSPacketClassifierNameEmpty E02028: WSPacketClassifierDoesNotExist
7.1.7 VirtualLan 7.1.7.1 VlanList
VlanList () Produces a list of VLANs configured in NMS None
Returns Array of VlanDetails
Properties: Name Vlan ID
7.1.7.2 Get Vlan
Method
VlanGet(string vlanName)
Gets VLAN configuration of the specified VLAN Name in NMS
Page 68
UGD-D00022 Rev A
vLANName Returns VlanConfig
Mandatory parameter. The name of the VLAN to get Properties: Name VlanID Description DHCPRelayAgentActive SingleUser MACForcedForwarding MACForceForwardIPAddress BroadcastServiceClassName AddToEveryBsPortListOnCreate
7.1.7.3 Create Vlan
Method Description Parameters VlanConfig
VlanCreate(VlanConfig vlanConfig) Creates a new VLAN in the NMS
Mandatory parameter. Name Mandatory parameter. VlanID Mandatory parameter. Description Mandatory parameter. DHCPRelayAgentActive Mandatory parameter. SingleUser Mandatory parameter. MACForcedForwarding Mandatory parameter. MACForcForwardIPAddress Mandatory parameter. BroadcastServiceClassName Mandatory parameter. AddToEveryBsPortListOnCreate
Return Values
E00000: No Error E02009: Web Service Authorisation Failure
Page 69
UGD-D00022 Rev A
E02014: WSWebServiceDisabled E02040: WSVlanNameEmpty E02043: WSParameterEmpty E02032: WSVlanAlreadyExists E02025: WSServiceClassDoesNotExist
7.1.7.4 Delete Vlan
Method
VLANDelete(string vLANName)
Description Parameters vlanName Return Values
Deletes an existing VLAN in NMS
Name of VLAN to delete E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02040: WSVlanNameEmpty E02031: WSVlanDoesNotExist
7.1.7.5 Update Vlan
Method
VlanUpdate(VlanConfig vlanConfig)
Description Parameters VlanConfig
Updates an existing VLAN with new parameters specified
Mandatory parameter. Name
Page 70
UGD-D00022 Rev A
Mandatory parameter. VlanID Mandatory parameter. Description Mandatory parameter. DHCPRelayAgentActive Mandatory parameter. SingleUser Mandatory parameter. MACForcedForwarding Mandatory parameter. MACForcForwardIPAddress Mandatory parameter. BroadcastServiceClassName Mandatory parameter. AddToEveryBsPortListOnCreate
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02040: WSVlanNameEmpty E02043: WSParameterEmpty E02031: WSVlanDoesNotExist E02025: WSServiceClassDoesNotExist
7.1.8 SSVlanPortProfile 7.1.8.1 SS Vlan Port Profile List
Method
SSVlanPortProfileList()
Description
Produces a list of the SS VLAN Port Profiles configured in the NMS. None
Parameters
Page 71
UGD-D00022 Rev A
Returns Array of VlanPortProfileDetails
7.1.8.2 Get SS Vlan Port Profile
Method
SSVlanPortProfileGet(string ssVlanPortProfileName)
Description Parameters ssVLANPortProfileName Returns VlanPortProfileConfig
Gets the configuration of an existing SS VLAN Port Profile in NMS
Mandatory parameter. The name of the SS VLAN Port Profile to get Properties: Name Description PortMode AllowedFrameType PortVlanIDName IngressFilterEnabled DeafultPriority
To get the Port VLAN list in SS VLAN Port Profiles use SSVlanPortProfileVLANsList()
7.1.8.3 Create SS Vlan Port Profile
Method
SSVlanPortProfileCreate(VlanPortProfileConfig vlanPortProfileConfig )
Page 72
UGD-D00022 Rev A
Description Parameters VlanPortProfileConfig
Creates a new SS VLAN Port Profile in NMS with the specified parameters Properties: Mandatory parameter. Name Mandatory parameter. Description Mandatory parameter. PortMode Mandatory parameter. AllowedFrameType Mandatory parameter. PortVlanIDName Mandatory parameter. IngressFilterEnabled Mandatory parameter. DeafultPriority
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02043: WSParameterEmpty E02042: WSSSVLANPortProfileNameEmpty E02035: WSSSVlanPortProfileAlreadyExists E02041: WSVlanNameEmpty E02031: WSVlanDoesNotExist
7.1.8.4 Delete SS Vlan Port Profile
Method
SSVlanPortProfileDelete(string ssVlanPortProfileName)
Deletes an existing SS VLAN Port Profile in NMS
Page 73
UGD-D00022 Rev A
ssVlanPortProfileName Return Values
Name of SS VLAN Port Profile to delete E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02042: WSSSVLANPortProfileNameEmpty E02034: WSSSVlanPortProfileDoesNotExist
7.1.8.5 Update SS Vlan Port Profile
Method
SSVlanPortProfileUpdate(VlanPortProfileConfig vlanPortProfileConfig)
Description Parameters VlanPortProfileConfig
Update an existing SS VLAN Port Profile in the NMS Properties: Mandatory parameter. Name Mandatory parameter. Description Mandatory parameter. PortMode Mandatory parameter. AllowedFrameType Mandatory parameter. PortVlanIDName Mandatory parameter. IngressFilterEnabled Mandatory parameter. DeafultPriority
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02043: WSParameterEmpty
Page 74
UGD-D00022 Rev A
E02042: WSSSVLANPortProfileNameEmpty E02034: WSSSVlanPortProfileDoesNotExist E02041: WSVlanNameEmpty E02031: WSVlanDoesNotExist
7.1.8.6 SS Vlan Port Profile Vlans List
Method
SSVlanPortProfileVlansList(string ssVlanPortProfileName)
Description Parameters ssVlanPortProfileName Returns Array of VlanDetails
Gets a list of VLANs in an existing SS VLAN Port Profile in the NMS
Name of SS VLAN Port Profile Properties: Name VlanID
7.1.8.7 Clear SS Vlan Port Profile Vlans
Method
SSVLANPortProfileVLANsClear(string ssVLANPortProfileName)
Description Parameters ssVlanPortProfileName Return Values
Clears all VLANs from and existing SS VLAN Port Profile in the NMS
Name of SS VLAN Port Profile E00000: No Error
Page 75
UGD-D00022 Rev A
E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02042: WSSSVLANPortProfileNameEmpty E02034: WSSSVlanPortProfileDoesNotExist
7.1.8.8 Add SS Vlan Port Profile Vlans
Method
SSVlanPortProfileVlansAdd(string ssVlanPortProfileName, string vlanName)
Description
Adds an existing VLAN to an existing SS VLAN PORT Profile in the NMS
Parameters ssVlanPortProfileName vlanName Return Values Name of SS VLAN Port Profile Name of VLAN E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02042: WSSSVLANPortProfileNameEmpty E02034: WSSSVlanPortProfileDoesNotExist E02041: WSVlanNameEmpty E02031: WSVlanDoesNotExist
Page 76
UGD-D00022 Rev A
7.1.8.9 Remove SS Vlan Port Profile Vlans
Method
SSVlanPortProfileVlansRemove(string ssVlanPortProfileName, string vlanName)
Description Parameters ssVlanPortProfileName vlanName Return Values
Removes an existing VLAN from and existing SS VLAN Port Profile in NMS
Name of SS VLAN Port Profile Name of VLAN to remove E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02042: WSSSVLANPortProfileNameEmpty E02034: WSSSVlanPortProfileDoesNotExist E02041: WSVlanNameEmpty E02031: WSVlanDoesNotExist
Page 77
UGD-D00022 Rev A
7.1.9 Fault Management 7.1.9.1 AlarmList
Method
AlarmList
Description Parameters Returns Array of Alarm
Produces a list of active alarms in the NMS. Returns a null if no Alarm is found. None Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
7.1.9.2 AlarmDetailsGet
Method
AlarmDetailsGet(decimal alarmID)
Description Parameters alarmID
Gets detail information on an active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Mandatory parameter. The alarmID
Page 78
UGD-D00022 Rev A
Method
AlarmDetailsGet(decimal alarmID)
Returns AlarmDetails
Properties: AlarmID AlarmType AlarmSource AlarmInfo Comment Severity FirstReceived LastReceived AlarmCount RaiseCount Acknowledged UserName ITUEventType ProbableCause Description UserDescription
7.1.9.3 AlarmAcknowledge
Method Description
AlarmAcknowledge(decimal alarmID) Acknowledges an existing active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Parameters alarmID Return Values Mandatory parameter. The alarmID E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02044: WSInvalidAlarmID E02035: WSUnknownAlarmID
Page 79
UGD-D00022 Rev A
7.1.9.4 AlarmRelease
Method
AlarmRelease(decimal alarmID)
Description
Releases an existing active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Parameters alarmID Return Values Mandatory parameter. The alarmID E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02044: WSInvalidAlarmID E02035: WSUnknownAlarmID
7.1.9.5 AlarmDelete
Method
AlarmDelete(decimal alarmID)
Description Parameters alarmID
Deletes an existing active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Mandatory parameter. The alarmID
Page 80
UGD-D00022 Rev A
Return Values
E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02044: WSInvalidAlarmID E02035: WSUnknownAlarmID
7.1.9.6 AlarmDetailsCommentAppend
Method Description
AlarmDetailsCommentAppend(decimal alarmID, string comment) Appends a comment on an existing active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Parameters alarmID comment Return Values Mandatory parameter. The alarmID Mandatory parameter. The comment E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02044: WSInvalidAlarmID E02035: WSUnknownAlarmID
7.1.9.7 AlarmDetailsCommentSet
Method
AlarmDetailsCommentSet(decimal alarmID, string comment)
Page 81
UGD-D00022 Rev A
Method
AlarmDetailsCommentSet(decimal alarmID, string comment)
Description Parameters alarmID comment Return Values
Sets comment on an existing active Alarm with alarmID that exist in the NMS. Returns an error if the alarmID does not already exist.
Mandatory parameter. The alarmID Mandatory parameter. The comment E00000: No Error E02009: Web Service Authorisation Failure E02014: WSWebServiceDisabled E02044: WSInvalidAlarmID E02035: WSUnknownAlarmID
7.1.9.8 AlarmListChanged
Method Description Parameters lastChangedTime Returns Array of Alarm
AlarmListChanged(string lastChangedTime) Produces a list of active alarms changed since lastChangedTime in the NMS. Returns null if no Alarm is found.
Mandatory parameter. The lastChangedTime Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName UGD-D00022 Rev A
Page 82
7.1.9.9 AlarmListForBSDU
Method Description
AlarmListForBSDU(string macAddress) Produces a list of active alarms for the specified BSDU macAddress in the NMS. Returns null if no Alarm is found.
Parameters macAddress Returns Array of Alarm Mandatory parameter. The macAddress Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
7.1.9.10 AlarmListForBSTRx
Method Description Parameters BSID
AlarmListForBSTRx(string BSID) Produces a list of active alarms for the specified BSID in the NMS. Returns null if no Alarm is found.
Mandatory parameter. The BSID
Page 83
UGD-D00022 Rev A
Method Returns Array of Alarm
AlarmListForBSTRx(string BSID) Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
7.1.9.11 AlarmListForSS
Method Description Parameters macAddress Returns Array of Alarm
AlarmListForSS(string macAddress) Produces a list of active alarms for the specified SS macAddress in the NMS. Returns null if no Alarm is found.
Mandatory parameter. The macAddress Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
7.1.9.12 AlarmListForSector
Page 84
UGD-D00022 Rev A
Method Description Parameters BSID Returns Array of Alarm
AlarmListForSector(string BSID) Produces a list of active alarms for the specified sector BSID in the NMS. Returns null if no Alarm is found.
Mandatory parameter. The BSID Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
7.1.9.13 AlarmListForShelf
Method Description Parameters shelfID Returns Array of Alarm
AlarmListForShelf(string shelfID) Produces a list of active alarms for the specified shelfID in the NMS. Returns null if no Alarm is found.
Mandatory parameter. The shelfID Properties: AlarmID AlarmType AlarmSource AlarmInfo Severity LastReceived AlarmCount Acknowledged LastAcknowledged UserName
Page 85
UGD-D00022 Rev A
Page 86
UGD-D00022 Rev A

Netspan Northbound If User Guide SR6

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Netspan Northbound If User Guide SR6

Uploaded by

Copyright:

Available Formats

Northbound Interface User Guide

Software Release 6.5 UGD-D00022

Northbound Interface User Guide SR 6.5

Copyright by Airspan Networks Inc., 2008. All rights reserved worldwide.

Northbound Interface User Guide SR 6.5

Northbound Interface User Guide SR 6.5

Internet Information Services (IIS) Microsoft Corporation http://www.microsoft.com

Northbound Interface User Guide SR 6.5

1.1.1 1.2 1.3 1.4 2

5.1.1 5.1.2 5.1.3 5.1.4 5.1.5

Northbound Interface User Guide SR 6.5

5.1.6 5.1.7 5.1.8

5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.3

View Inventory ...................................................................................................... 28 Producing the BS Sector List [BSSectorList] .................................................. 28

5.4.1 5.4.2 5.4.3 5.4.4 5.4.5 5.4.6 5.4.7 5.4.8

Northbound Interface User Guide SR 6.5

5.5.1 5.5.2 5.5.3 5.5.4 5.5.5 5.6

5.6.1 5.6.2 5.6.3 5.6.4 5.6.5 5.7

5.7.1 5.7.2 5.7.3 5.7.4 5.7.5 5.8

Northbound Interface User Guide SR 6.5

5.8.2 5.8.3 5.8.4 5.8.5 5.8.6 5.8.7 5.8.8 5.8.9 6

6.1.1 6.1.2 6.1.3 6.1.4 6.1.5 6.1.6 6.1.7 6.1.8 6.2

6.2.1 6.2.2 6.2.3 6.2.4 6.2.5 7

Northbound Interface User Guide SR 6.5

7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9

Northbound Interface User Guide SR 6.5

Northbound Interface User Guide SR 6.5

Northbound Interface User Guide SR 6.5

Summary of Figures and Tables

Northbound Interface User Guide SR 6.5

About this Guide

Organisation of this Guide

Northbound Interface User Guide SR 6.5

1.1 General Overview 1.1.1 Northbound Interface

Figure 1 Northbound Interface Architecture Model

Northbound Interface User Guide SR 6.5

1.2 Where Northbound Interface fits into the Netspan Architecture

1.3 Consuming Web Services

Northbound Interface User Guide SR 6.5

1.4 Using Asynchronous Clients

Northbound Interface User Guide SR 6.5

2 Get Started with the Northbound Interface

Figure 2 Workflow of Northbound Interface

Northbound Interface User Guide SR 6.5

2.2 Navigating the Northbound Interface

Figure 3 Web browser showing Web Services Index

Northbound Interface User Guide SR 6.5

Figure 4 Web browser showing SSProvisioning web service methods

View the underlying WSDL by clicking on Service Description.

Figure 5 Web browser showing SSProvisioning WSDL

Northbound Interface User Guide SR 6.5

Figure 6 Web browser showing SSProvisioning GetSSProvisioningConfig method details

Northbound Interface User Guide SR 6.5

3 Enable or Disable Northbound Interface

3.1 Disabling the Northbound Interface

3.2 Enabling the Northbound Interface

Northbound Interface User Guide SR 6.5

4 Enable or Disable Authentication and Authorisation

Figure 7 Netspan Web Services Users Administration

Northbound Interface User Guide SR 6.5

4.1 Disabling Authentication

4.2 Enabling Authentication