NX Soap v2b1
NX Soap v2b1
Important Notice
Allot Communications Ltd. ("Allot") is not a party to the purchase agreement under which NetEnforcer was purchased,
and will not be liable for any damages of any kind whatsoever caused to the end users using this manual, regardless of
the form of action, whether in contract, tort (including negligence), strict liability or otherwise.
SPECIFICATIONS AND INFORMATION CONTAINED IN THIS MANUAL ARE FURNISHED FOR
INFORMATIONAL USE ONLY, AND ARE SUBJECT TO CHANGE AT ANY TIME WITHOUT NOTICE, AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY ALLOT OR ANY OF ITS SUBSIDIARIES. ALLOT
ASSUMES NO RESPONSIBILITY OR LIABILITY FOR ANY ERRORS OR INACCURACIES THAT MAY
APPEAR IN THIS MANUAL, INCLUDING THE PRODUCTS AND SOFTWARE DESCRIBED IN IT.
Please read the End User License Agreement and Warranty Certificate provided with this product before using the
product. Please note that using the products indicates that you accept the terms of the End User License Agreement and
Warranty Certificate.
WITHOUT DEROGATING IN ANY WAY FROM THE AFORESAID, ALLOT WILL NOT BE LIABLE FOR ANY
SPECIAL, EXEMPLARY, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND,
REGARDLESS OF THE FORM OF ACTION WHETHER IN CONTRACT, TORT (INCLUDING NEGLIGENCE),
STRICT LIABILITY OR OTHERWISE, INCLUDING, BUT NOT LIMITED TO, LOSS OF REVENUE OR
ANTICIPATED PROFITS, OR LOST BUSINESS, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
Copyright
Copyright © 1997-2010 Allot Communications. All rights reserved. No part of this document may be reproduced,
photocopied, stored on a retrieval system, transmitted, or translated into any other language without a written permission
and specific authorization from Allot Communications Ltd.
Trademarks
Products and corporate names appearing in this manual may or may not be registered trademarks or copyrights of their
respective companies, and are used only for identification or explanation and to the owners' benefit, without intent to
infringe.
Allot and the Allot Communications logo are registered trademarks of Allot Communications Ltd.
NOTE: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the
equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case
the user will be required to correct the interference at his own expense.
Changes or modifications not expressly approved by Allot Communication Ltd. could void the user's authority to operate
the equipment.
Version History
Table of Contents
1. Introduction ............................................................................................................ 6
1.1. Allot’s NetXplorer System .............................................................................. 6
1.2. Terms and Concepts ........................................................................................ 6
1.2.1 Catalog ..................................................................................................... 6
1.2.2 Line .......................................................................................................... 6
1.2.3 Pipe .......................................................................................................... 6
1.2.4 Virtual Channel ........................................................................................ 7
1.2.5 Tube ......................................................................................................... 7
1.2.6 NetEnforcer .............................................................................................. 7
1.2.7 Service Gateway ...................................................................................... 7
1.3. Acronyms ........................................................................................................ 8
1.4. Web Services ................................................................................................... 8
2. Typical NX Data Flow ........................................................................................... 9
3. NX WSDL Overview ........................................................................................... 10
3.1. WSDL Files ................................................................................................... 10
3.2. Operations ..................................................................................................... 10
3.3.1 Policy Operations ................................................................................... 10
3.3.2 Catalog Operations................................................................................. 10
3.3.3 Topology Operations ............................................................................. 10
3.3.4 Web Update Operations ......................................................................... 10
3.3. Typical Work-Flow ....................................................................................... 11
4. WSDL Methods ................................................................................................... 11
4.1. Policy Methods .............................................................................................. 11
4.1.1 Policy ..................................................................................................... 11
4.1.2 TCAs ...................................................................................................... 12
4.1.3 TubeGroups............................................................................................ 12
4.1.4 Pipe ........................................................................................................ 13
4.1.5 VC .......................................................................................................... 13
4.2. Catalog Methods ........................................................................................... 14
1. Introduction
1.1. Allot’s NetXplorer System
Allot’s NetXplorer system provides essential functions to manage IP/broadband
services efficiently and profitably. NetXplorer is a highly scalable centralized
management platform providing a single access point for Allot NetEnforcer® or
Service Gateway deployments of any size, delivering unsurpassed network visibility.
Managers can monitor, provision and consolidate information simultaneously across
multiple Allot Network elements.
1.2.1 Catalog
Catalog entries, which are defined in the catalog editor, serve as conditions or actions
in the rules which make up a policy. In this way, they can be seen as the building
blocks of your policy. Once a catalog has been defined in the catalog editor, it can be
reused in different rules.
1.2.2 Line
A line is a logical entity within a policy and represents the highest level of hierarchy.
The total bandwidth running through the NetEnforcer or Service Gateway can be
divided into lines and each line can then be managed as if it were an independent link.
A line consists of a rule based on one or more sets of conditions and a set of actions
that apply when all of the conditions are met. The default fallback line exists in every
policy. Additional lines can then be added above the fallback line in the policy table.
The fallback line consists of a filter which cannot be modified or deleted. Traffic
which is not classified in any of the lines above it in the hierarchy, will be classified in
the fallback line. Every line, including the fallback line, contains one or more pipes.
1.2.3 Pipe
A pipe is a logical entity within a policy. The total bandwidth running through each
line can be divided into pipes, and each pipe can then be managed independently.
Each pipe consists of a rule based on one or more sets of conditions and a set of
actions that apply when all of the conditions are met. By default, every line contains
at least one pipe – the fallback pipe. Additional pipes can then be added above the
fallback pipe in the policy table. The filter of the fallback pipe cannot be modified or
deleted, and traffic that is not classified into any other pipes within a given line will
be classified in the fallback pipe. Every pipe, including the fallback pipe, contains one
or more virtual channels.
1.2.5 Tube
A generic term, used to designate a line, pipe or VC
1.2.6 NetEnforcer
The NetEnforcer is a broadband optimization device which collects traffic statistics
from the network and can implement quality of service per application and per
subscriber. Traffic statistics are collected in order to provide both real-time and long-
term data about the network. As well as collecting detailed information about the
traffic passing through, it, the NetEnforcer can also shape that traffic, applying quality
of service parameters which have been pre-defined by the user.
1.3. Acronyms
3. NX WSDL Overview
3.2. Operations
There are 4 different NX Web Service operations:
4. WSDL Methods
4.1. Policy Methods
4.1.1 Policy
Method Description Parameters Return Value
getPolicy Used to view the current Integer – deviceID Array (TubeDTO)
policy on a given NE or
Integer – PolicyID
SG
Boolean – skeleton
(alerts)
updatePolicy Used to update your Integer – deviceID void
policy (e.g: to add, update
Integer – PolicyID
or delete lines, pipes and
VCs in a policy) Array (TubeDTO)
Boolean - local
Boolean –
isEventSource
exportPolicy Used to export the policy Integer - deviceId Void
of one device to another
exportDefaultPolicy Used to roll a device’s DeviceTopology Void
policy back to the default DTO
policy
4.1.2 TCAs
Method Description Parameters Return Value
getTubeTCAs Used to view the threshold Integer - tubeId Array -
crossing alarms currently (Tube2Alert2Actio
nDTO)
assigned to a line, pipe or
VC
updateTubeTCA Used to change the Tube2Alert2A Void
assignment of threshold ctionDTO
crossing alarms to a line,
pipe or VC
getDeviceTCAs Used to view the threshold Integer - Array -
crossing alarms currently deviceId (Device2Alert2
assigned to a NE or SG ActionDTO)
updateDeviceTCAs Used to change the Device2Alert2 Void
assignment of threshold ActionDTO
crossing alarms to a NE or
SG
4.1.3 TubeGroups
4.1.4 Pipe
4.1.5 VC
existing QoS
catalog entries
getQoSEntriesByIds Used to retrieve a Array(Integer) Array(QosDTO)
list of QoS catalog
entries by ID
entries
updateVlanCatalogEntries Used to update Array(VlanDTO) void
existing VLAN
catalog entries
getVlanEntriesByIds Used to retrieve a Array(Integer) Array(VlanDTO)
list of VLAN
catalog entries by
ID
4.2.10. Host
4.2.12. Service
4.2.14. Time
4.3.1. Devices
Method Description Parameters Return Value
getDeviceById Used to view the NEs or Integer - DeviceTopology
SGs currently in the deviceId DTO
network by ID
getDeviceByName Used to view the NEs or String- uiName DeviceTopology
SGs currently in the DTO
network by name
addDevice Used to add an NE or SG DeviceTopolog DeviceTopology
to the network yDTO DTO
ImportDevice Used to import an NE or DeviceTopolog void
SG into the network yDTO
deleteDevice Used to delete an NE or DeviceTopolog void
SG from the network yDTO
4.4.1. Device
4.4.2. Server