Alcatel A1000 DSLAM SW4.7 Cartridge Guide - Oracle Documentation

188 Pages·2008·0.56 MB·English

by  Oracle Corporation

Oracle Communications® ASAP™ Cartridge 1.0
for Alcatel A1000 DSLAM
Alcatel A1000 DSLAM
SW4.7 Cartridge Guide
Second Edition
October 2008
Copyright and Trademark Information
Copyright © 1992, 2008, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of
their respective owners.
This software and related documentation are provided under a license agreement containing restrictions on use
and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license
agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit,
distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering,
disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you
find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of
the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license
terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the
Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License
(December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may create
a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take
all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of this software. Oracle
Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous
applications.
This software and documentation may provide access to or information on content, products and services from
third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of
any kind with respect to third party content, products and services. Oracle Corporation and its affiliates will not
be responsible for any loss, costs, or damages incurred due to your access to or use of third party content,
products or services.
Contents
1. Cartridge Overview ......................................................................................1
Cartridge content ...................................................................................................................2
Prerequisites .........................................................................................................................2
About this guide ....................................................................................................................2
Services, features, and options .............................................................................................3
Hardware and software requirements ...................................................................................6
Network element (NE) interface ............................................................................................6
ASAP version ........................................................................................................................6
Connecting to the NE ............................................................................................................6
2. Installing and Testing the Cartridge ...........................................................7
Downloading the cartridge ....................................................................................................7
Starting ASAP .......................................................................................................................8
Installing the cartridge using scripts ......................................................................................8
Uninstalling the cartridge using scripts ..................................................................................9
Testing the cartridge installation ...........................................................................................9
Configuring loopback and live mode parameters .........................................................10
Modifying Alcatel_DSLAM_SW4_7_ne_config.xml ......................................................11
Testing the installation ..................................................................................................13
3. Atomic Service Description Layer (ASDL) Commands ..........................15
ASDL commands ................................................................................................................17
A_ALA-A1000_SW4-7_ACT_ADSL-PROFILE .............................................................18
A_ALA-A1000_SW4-7_ACT_CRS-VC .........................................................................20
A_ALA-A1000_SW4-7_ACT_CRS-VP .........................................................................21
A_ALA-A1000_SW4-7_ADD_ADSL-COMMON-PROFILE ..........................................23
A_ALA-A1000_SW4-7_ADD_ADSL-DMT-PROFILE ...................................................25
A_ALA-A1000_SW4-7_ADD_ADSL-DOWNSTREAM-PROFILE .................................27
A_ALA-A1000_SW4-7_ADD_ADSL-LINE-PROFILE ...................................................30
A_ALA-A1000_SW4-7_ADD_ADSL-PORT ..................................................................32
A_ALA-A1000_SW4-7_ADD_ADSL-PROFILE ............................................................34
A_ALA-A1000_SW4-7_ADD_ADSL-UPSTREAM-PROFILE .......................................36
A_ALA-A1000_SW4-7_ADD_ATM-PORT ....................................................................38
A_ALA-A1000_SW4-7_ADD_ATM-PVCL-LT ...............................................................41
A_ALA-A1000_SW4-7_ADD_ATM-PVCL-NT ..............................................................43
A_ALA-A1000_SW4-7_ADD_ATM-PVPL ....................................................................45
A_ALA-A1000_SW4-7_ADD_ATMACC-PROFILE .......................................................48
A_ALA-A1000_SW4-7_ADD_CAC-PROFILE ..............................................................50
A_ALA-A1000_SW4-7_ADD_CDVT-PROFILE ............................................................53
A_ALA-A1000_SW4-7_ADD_CRS-VC .........................................................................55
A_ALA-A1000_SW4-7_ADD_CRS-VP .........................................................................57
A_ALA-A1000_SW4-7_ADD_OC3-INTERFACE .........................................................59
A_ALA-A1000_SW4-7_ADD_SHDSL-PARAMETERS ................................................61
A_ALA-A1000_SW4-7_ADD_SIG-CHANNEL ..............................................................64
Alcatel A1000 DSLAM SW4.7 Cartridge Guide 3
A_ALA-A1000_SW4-7_ADD_SIG-CHANNEL-PARAMS .............................................67
A_ALA-A1000_SW4-7_ADD_SVC-USER ....................................................................70
A_ALA-A1000_SW4-7_ADD_T1DS1-INTERFACE ......................................................72
A_ALA-A1000_SW4-7_ADD_T3DS3-INTERFACE ......................................................74
A_ALA-A1000_SW4-7_ADD_TRAFFDESC-PROFILE ................................................76
A_ALA-A1000_SW4-7_ADD_XDSL-PORT ..................................................................79
A_ALA-A1000_SW4-7_DEACT_CRS-VC ....................................................................81
A_ALA-A1000_SW4-7_DEACT_CRS-VP ....................................................................83
A_ALA-A1000_SW4-7_DEL_ADSL-PORT ..................................................................85
A_ALA-A1000_SW4-7_DEL_ATM-PVCL-LT ...............................................................86
A_ALA-A1000_SW4-7_DEL_ATM-PVCL-NT ...............................................................88
A_ALA-A1000_SW4-7_DEL_ATM-PVPL .....................................................................89
A_ALA-A1000_SW4-7_DEL_ATMACC-PROFILE .......................................................91
A_ALA-A1000_SW4-7_DEL_CAC-PROFILE ...............................................................92
A_ALA-A1000_SW4-7_DEL_CDVT-PROFILE .............................................................94
A_ALA-A1000_SW4-7_DEL_CRS-VC .........................................................................95
A_ALA-A1000_SW4-7_DEL_CRS-VP .........................................................................97
A_ALA-A1000_SW4-7_DEL_DSL-PROFILE ...............................................................99
A_ALA-A1000_SW4-7_DEL_SIG-CHANNEL ............................................................100
A_ALA-A1000_SW4-7_DEL_SVC-USER ..................................................................102
A_ALA-A1000_SW4-7_DEL_TRAFFDESC-PROFILE ...............................................103
A_ALA-A1000_SW4-7_DEL_XDSL-PORT ................................................................104
A_ALA-A1000_SW4-7_MOD_SHDSL-PARAMETERS ..............................................106
4. Service Definition .....................................................................................109
CSDL commands ..............................................................................................................111
C_ALA-A1000_SW4-7_ACT_ADSL-PROFILE ...........................................................112
C_ALA-A1000_SW4-7_ACT_CRS-VC .......................................................................113
C_ALA-A1000_SW4-7_ACT_CRS-VP .......................................................................114
C_ALA-A1000_SW4-7_ADD_ADSL-COMMON-PROFILE ........................................115
C_ALA-A1000_SW4-7_ADD_ADSL-DMT-PROFILE .................................................116
C_ALA-A1000_SW4-7_ADD_ADSL-DOWNSTREAM-PROFILE ...............................118
C_ALA-A1000_SW4-7_ADD_ADSL-LINE-PROFILE .................................................120
C_ALA-A1000_SW4-7_ADD_ADSL-PORT ................................................................122
C_ALA-A1000_SW4-7_ADD_ADSL-PROFILE ..........................................................123
C_ALA-A1000_SW4-7_ADD_ADSL-UPSTREAM-PROFILE .....................................129
C_ALA-A1000_SW4-7_ADD_ATM-PORT .................................................................130
C_ALA-A1000_SW4-7_ADD_ATM-PVCL-LT .............................................................132
C_ALA-A1000_SW4-7_ADD_ATM-PVCL-NT ............................................................134
C_ALA-A1000_SW4-7_ADD_ATM-PVPL ..................................................................135
C_ALA-A1000_SW4-7_ADD_ATMACC-PROFILE ....................................................137
C_ALA-A1000_SW4-7_ADD_CAC-PROFILE ............................................................139
C_ALA-A1000_SW4-7_ADD_CDVT-PROFILE ..........................................................141
C_ALA-A1000_SW4-7_ADD_CRS-VC ......................................................................142
C_ALA-A1000_SW4-7_ADD_CRS-VP .......................................................................143
C_ALA-A1000_SW4-7_ADD_OC3-INTERFACE .......................................................144
C_ALA-A1000_SW4-7_ADD_SHDSL-PARAMETERS ..............................................146
C_ALA-A1000_SW4-7_ADD_SIG-CHANNEL ............................................................147
4 Oracle Corporation
C_ALA-A1000_SW4-7_ADD_SIG-CHANNEL-PARAMS ...........................................149
C_ALA-A1000_SW4-7_ADD_SVC-USER ..................................................................151
C_ALA-A1000_SW4-7_ADD_T1DS1-INTERFACE ...................................................153
C_ALA-A1000_SW4-7_ADD_T3DS3-INTERFACE ...................................................154
C_ALA-A1000_SW4-7_ADD_TRAFFDESC-PROFILE ..............................................155
C_ALA-A1000_SW4-7_ADD_XDSL-PORT ................................................................157
C_ALA-A1000_SW4-7_DEACT_CRS-VC ..................................................................159
C_ALA-A1000_SW4-7_DEACT_CRS-VP ..................................................................160
C_ALA-A1000_SW4-7_DEL_ADSL-PORT ................................................................161
C_ALA-A1000_SW4-7_DEL_ATM-PVCL-LT .............................................................162
C_ALA-A1000_SW4-7_DEL_ATM-PVCL-NT .............................................................163
C_ALA-A1000_SW4-7_DEL_ATM-PVPL ...................................................................164
C_ALA-A1000_SW4-7_DEL_ATMACC-PROFILE .....................................................165
C_ALA-A1000_SW4-7_DEL_CAC-PROFILE .............................................................166
C_ALA-A1000_SW4-7_DEL_CDVT-PROFILE ..........................................................167
C_ALA-A1000_SW4-7_DEL_CRS-VC .......................................................................168
C_ALA-A1000_SW4-7_DEL_CRS-VP .......................................................................169
C_ALA-A1000_SW4-7_DEL_DSL-PROFILE .............................................................170
C_ALA-A1000_SW4-7_DEL_SIG-CHANNEL ............................................................171
C_ALA-A1000_SW4-7_DEL_SVC-USER ..................................................................172
C_ALA-A1000_SW4-7_DEL_TRAFFDESC-PROFILE ...............................................173
C_ALA-A1000_SW4-7_DEL_XDSL-PORT ................................................................174
C_ALA-A1000_SW4-7_MOD_SHDSL-PARAMETERS .............................................175
5. Configuring ASAP to Support Additional NE Instances ......................177
Extracting source files .......................................................................................................181
Loading a new XML file ..............................................................................................181
Alcatel A1000 DSLAM SW4.7 Cartridge Guide 5
6 Oracle Corporation
1
Cartridge Overview
ASAP cartridges are discrete software components that are developed for the ASAP product.
An ASAP cartridge offers specific domain behavior on top of the core ASAP software, and
provides the configuration that supports a set of services on a network element (NE).
An ASAP cartridge is not a stand-alone component, but operates in conjunction with the
ASAP core product. ASAP cartridges offer the following benefits:
(cid:139) Reduced Time to Market - time to market of new services is reduced through simplified
development, implementation, and extension of cartridges on customer sites.
(cid:139) Extendable - cartridges can be extended to include additional services and components
that deliver business value, without requiring changes to the original cartridge.
(cid:139) Simplified Effort - the effort and technical knowledge that is required to perform
customizations is reduced.
(cid:139) Ease of Installation - cartridges can be installed into an ASAP environment without
interfering with the existing install base.
An ASAP cartridge can be used to configure ASAP to provision the following:
(cid:139) NEs from a specific vendor, such as Nortel or Lucent.
(cid:139) Technologies, such as Asynchronous Transfer Mode (ATM) and Frame Relay switches, or
Internet Protocol (IP) routers.
(cid:139) Services that are supported on the NE, such as ATM, IP Virtual Private Networks (VPN),
Wireless, or Optical.
Cartridges are designed for a specific technology, software load, and service.
An ASAP cartridge supports a particular set of services on an NE. These services are
independent of customer-specific service definitions. Professional Services or systems
integrators can perform extensions to the cartridge to support customer-specific requirements.
For more information on extending a cartridge, refer to the ASAP Cartridge Development
Guide for Service Activation.
Alcatel A1000 DSLAM SW4.7 Cartridge Guide 1
Chapter 1: Cartridge Overview
Cartridge content
An ASAP cartridge contains the following:
(cid:139) An interface to the NE
(cid:139) A set of scripts, such as State Tables or Java methods
(cid:139) A set of atomic actions in the form of Atomic Service Description Layer (ASDL)
commands
(cid:139) A set of Common Service Description Layer (CSDL) commands that form meaningful
services
(cid:139) Sample work orders
(cid:139) Installation scripts
Prerequisites
System integrators such as managers, designers, programmers, and testers who are responsible
for the adaptation and integration of ASAP-based solutions should use this manual as a
reference. It assumes that readers possess the following skills:
(cid:139) A knowledge of ASAP programming concepts
(cid:139) A good working knowledge of the UNIX operating system
(cid:139) A thorough understanding of service and network provisioning
(cid:139) Familiarity with telecommunications
About this guide
This guide provides a detailed description of the Alcatel A1000 DSLAM cartridge. It contains
overview and technical information to assist with extending and integrating the cartridge into a
customer environment.
The scope of this guide includes ASAP as it pertains to the use of this cartridge. It is not
intended to be a complete ASAP reference guide.
For additional information when using this cartridge, refer to the following supporting
documentation:
(cid:139) Activation documentation set—for detailed information on the ASAP component.
(cid:139) ASAP Cartridge Development Guide for Service Activation—for information on how
to extend a cartridge.
The Alcatel A1000 DSLAM cartridge provides the ASAP service configuration and network
element (NE) interface to activate provisioning services on ALA_DSL_HOST NEs.
2 Oracle Corporation
Services, features, and options
Services, features, and options
This cartridge supports the following services:
(cid:139) Configures ATM services
(cid:139) Configures DSL services
(cid:139) Configures Interfaces
(cid:139) Configures Switched Virtual Circuit
The following table lists the supported services and its features.
Table 1: Supported Services
Service Description
ATM Services
Configure ATM Port This service configures the data associated with ATM ports
(NT or LT) on NE.
Create a VCL Link This service creates a Virtual Channel Link on an NT or LT
interface.
Remove a VCL Link This service removes a Virtual Channel Link from an NT or LT
interface.
Create a VPL Link This service creates a Virtual Path Link on an NT or LT
interface.
Remove a VPL Link This service removes a Virtual Path Link from an NT or LT
interface.
Create a VC cross-connect This service creates a VC level cross connection between NT
and LT cards.
Activate VC cross-connect This service activates the VC cross connect previously created.
Deactivate VC cross-connect This service deactivates a VC cross connect.
Remove a VC cross-connect This service removes a VC cross connection between NT and
LT cards.
Create a VP cross-connect This service creates a VP cross-connection between NT and LT
cards.
Activate a VP cross-connect This service activates a VP cross connection.
Deactivate a VP cross-connect This service deactivates a VP cross connection.
Alcatel A1000 DSLAM SW4.7 Cartridge Guide 3
Chapter 1: Cartridge Overview
Table 1: Supported Services
Service Description
Remove a VP cross-connect This service removes a VP cross-connection between NT and
LT card.
Create Access Profile This service creates an ATM access profile.
Remove Access Profile This service removes an ATM access profile.
Create CAC Profile This service creates an ATM connection admission control
profile.
Remove CAC Profile This service removes an ATM connection admission control
profile.
Create CDVT Profile This service creates an ATM cell delay variance tolerance
profile for Switched Virtual Circuit (SVC) connections.
Remove CDVT Profile This service removes an ATM cell delay variation tolerance
profile for Switched Virtual Circuit (SVC) connections.
Create Traffic Descriptor Profile This service creates an ATM traffic descriptor profile.
Remove Traffic Descriptor Profile This service removes an ATM traffic descriptor profile.
DSL Services
Configure ADSL (LT) Port This service configures provisioning data associtated with an
ADSL facility on an LT card.
Remove ADSL (LT) Port This service unassigns (free) an ADSL port used by a user.
Create ADSL Line Profile This service configures ADSL line profile.
Create ADSL COM Profile This service configures ADSL modem provisioning
parameters that are common to both upstream and downstream
directions in a newly created (inactivated) ADSL profile.
Create ADSL DN Profile This service configures ADSL line provisioning parameters for
the downstream direction (from ATU-C to ATU-R) in a newly
created (inactivated) ADSL profile.
Create ADSL UP Profile This service configures ADSL line provisioning parameters for
the upstream direction (from ATU-R to ATU-C) in a newly
created (inactivated) ADSL profile.
Create ADSL DMT Profile This service configures the ADSL DMT (Discrete Multi-Tone)
carrier-mask in a newly created ADSL profile.
4 Oracle Corporation