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
Description: