Nortel AS 5300 Application Programming Interface Download Page 26

26

Using the Bulk Provisioning Tool

In most cases, variables and properties used by the BPT provisioning
methods map to fields in the Provisioning Client. For Provisioning Client
field descriptions, see AS 5300 Provisioning Client Help, NN42040-502.

For example, the

addRole

provisioning method maps to the

Add a New

Role

window of the Provisioning Client (

Admins > Add Roles

).

Batch processing

A maximum of 1000 entries are processed together at a time. All bulk
processing is on an all-or-none basis.

For example, you can do a bulk add of 3000 subscribers to the system
from a file. Each subscriber is one line in the file. The BPT processes the
information in three blocks of 1000 lines each. If an error occurs during
processing of a block, such as a user name already in use, the BPT will
not process any lines in that block.

Resource use

The BPT processes the provisioning information before uploading it
to the database. During the processing, the BPT uses all available
CPU resources, whether the processing is performed on a server or a
workstation. CPU usage declines as the provisioning data is uploaded to
the database.

When performing bulk provisioning using files with a large number of
entries, use a BPT residing on a workstation. Performing the task on
a server can affect the performance of in-progress sessions using the
component services running on the server.

Nortel recommends using the BPT during off-peak times or maintenance
windows when large amounts of information are being added.

Bulk provisioning of users

Bulk provisioning of users (through BPT or an OPI client) puts a large
load on the database in the AS 5300 system. Therefore, bulk provisioning
must be throttled to prevent the database from becoming overloaded
while handling the BPT "add user" requests. The BPT or OPI client must
implement the following required sleep/wait times between "add user"
requests when adding users in bulk:

For a system running at 80 percent call capacity, add 500 users at
a time. Sleep/wait at least 300 seconds before adding the next 500
users. This rate is approximately 6000 users added an hour.

For a system running at 20 percent call capacity, add 500 users at
a time. Sleep/wait at least 225 seconds before adding the next 500
users. This rate is approximately 8000 users added an hour.

Nortel AS 5300

Nortel Application Server 5300 Application Programming Interfaces Reference

NN42040-110

01.01

Standard

11 June 2008

Copyright © 2008 Nortel Networks

.

Summary of Contents for AS 5300

Page 1: ...Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference Release 1 0 Document Revision 01 01 www nortel com NN42040 110...

Page 2: ...is believed to be accurate and reliable except as otherwise expressly agreed to in writing NORTEL PROVIDES THIS DOCUMENT AS IS WITHOUT WARRANTY OR CONDITION OF ANY KIND EITHER EXPRESS OR IMPLIED The...

Page 3: ...ripts 16 Files 16 Scripts 17 BPT conventions and examples 17 Method and file syntax conventions 17 Create and manage provisioning roles using the BPT 21 BPT Help option 24 BPT limitations 25 BPT mappi...

Page 4: ...visioning Interface clients 39 Downloading the Axis toolkit 41 Retrieving the error codes 41 Configuring the class path 41 Downloading the WSDL file 42 Compiling the client stubs 42 Writing a client t...

Page 5: ...er AS 5300 Release 1 0 This document is new for Nortel AS 5300 Release 1 0 Other changes Table 1 Revision history June 11 2008 Standard 01 01 This document is new for Nortel AS 5300 Release 1 0 Nortel...

Page 6: ...6 New in this release Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networks...

Page 7: ...ntals page 9 Using the Bulk Provisioning Tool page 13 Using the Open Provisioning Interface page 29 Starting the Bulk Provisioning Tool page 35 Creating Open Provisioning Interface clients page 39 Acc...

Page 8: ...8 Introduction Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networks...

Page 9: ...provision the AS 5300 system OPI is based on version 1 1 of the Simple Object Access Protocol SOAP and the emerging Web services standard SOAP is a cross platform cross language text based protocol u...

Page 10: ...e commands available through the OPI Communications between the BPT and the Provisioning server use the OPI OPI itself is the Simple Object Access Protocol SOAP over HTTP Attention Do not use the BPT...

Page 11: ...run the BPT Table 2 Bulk Provisioning Tool requirements Minimum PC or terminal requirements Java 1 6 JRE in the system classpath For telnet remote access Compatible tested telnet terminals Windows Tel...

Page 12: ...lication Programming Interface fundamentals Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Net...

Page 13: ...option page 24 BPT limitations page 25 Install and launch the BPT For procedures on downloading installing and launching the BPT see Starting the Bulk Provisioning Tool page 35 BPT main menu The BPT m...

Page 14: ...number at the prompt For example to access the Domain Operations submenu type 1 and press Enter The BPT displays the Domain Operations submenu Figure 2 Accessing the Domain Operations submenu Nortel...

Page 15: ...age for a given method method name using parm a parm b Execute the given method with the required parameters The parameter list must be separated by commas and must adhere to the order presented in th...

Page 16: ...vailable in a zip file OPIJavaDocs zip included on the AS 5300 Documentation CD To access the OPI Web services documentation see Accessing the OPI Java docs page 47 BPT files and scripts Files and scr...

Page 17: ...script updated 2008 04 01 BPT conventions and examples This section describes the command syntax and usage conventions for Bulk Provisioning Tool BPT provisioning methods and an example of a provision...

Page 18: ...to the screen by default Brackets Brackets are required around the parameters when shown in the BPT provisioning method syntax For example the following is the syntax for the getRole provisioning meth...

Page 19: ...pically the bar is used for the data entry option entering the data in the command line or using data in a file For example the following is the syntax for the getRole provisioning method getRole usin...

Page 20: ...ods require a fully qualified user name a user name that is complete with the domain name for example joe mydomain com This information is available in the Provisioning Client field descriptions Succe...

Page 21: ...Name of the Provisioning Role Description of the Role The Provisioning Right Type The Read privilege The write privilege The delete privilege The Provisioning Right Type The Read privilege The write p...

Page 22: ...od succeeded or failed as shown in the following figure Figure 3 BPT showing a successful add View the new provisioning role To view the new provisioning role in the BPT use the getRole provisioning m...

Page 23: ...sed to create the new role see Define the new provisioning role page 21 Delete the new provisioning role To delete the new role use the provisioning method removeRole with the following syntax removeR...

Page 24: ...and its associated text file For example to view the help on the addRole provisioning method enter help addRole or if using the BPT Main menu number shortcut enter help 1 The BPT displays the BPT OPI...

Page 25: ...be aware of when using the Bulk Provisioning Tool Navigation BPT mapping to the Provisioning Client page 25 Batch processing page 26 Resource use page 26 Provisioning data visibility page 27 BPT mapp...

Page 26: ...erforming bulk provisioning using files with a large number of entries use a BPT residing on a workstation Performing the task on a server can affect the performance of in progress sessions using the...

Page 27: ...e instance of the Provisioning Manager However it can take up to five minutes before the same data is visible to clients connected to a second instance of a Provisioning Manager running in the system...

Page 28: ...28 Using the Bulk Provisioning Tool Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networks...

Page 29: ...OPI supports security through the use of opicert cer Secure Socket Layer SSL certificate file opitruststore key store file These files are required when you connect to the Provisioning Server through...

Page 30: ...Authentication page 30 WS Security UsernameToken page 30 HTTP Basic Authentication Onboard Authentication The username and password of the user are configured in the HTTP Headers The following figure...

Page 31: ...NET client this must be done differently The AS 5300 OPI currently supports HTTP and HTTPS authentication and the authentication headers must be set to Base64 encoded authentication on the client sid...

Page 32: ...ate domains Widget com Gadget com and Sprocket com An administrator WidgetAdmin can be created with only Widget com in the list of provisionable domains This limits WidgetAdmin to provisioning activit...

Page 33: ...he skeleton in the Provisioning Manager The skeleton translates the SOAP message back to an object and sends it to the Provisioning Manager data access processes The data access processes communicate...

Page 34: ...or validation fails a SOAP fault is sent back to indicate the failure and the action is not performed Access stubs from the third party application When the interface accesses or invokes the stubs the...

Page 35: ...workstation This facilitates the use of files and scripts without affecting the performance of the server hosting the Provisioning Manager Starting the Bulk Provisioning Tool Nortel AS 5300 Nortel Ap...

Page 36: ...System folder 3 Click Tools The BPT download window appears Figure 11 BPT download window 4 Follow the instructions in the BPT download window to install the required files onto the local workstation...

Page 37: ...dministrator username and password The Bulk Provisioning Tool main menu appears See Figure 1 BPT main menu page 14 End Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces...

Page 38: ...38 Starting the Bulk Provisioning Tool Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networks...

Page 39: ...opment be comfortable using DOS commands have the Java Developer Kit JDK 1 6 have the Java executable available in the system path have the AXIS toolkit version 1 3 Final Attention Toolkits other than...

Page 40: ...he error codes page 41 Configuring the class path page 41 Downloading the WSDL file page 42 Compiling the client stubs page 42 Writing a client to perform some specific OPI operations page 43 Nortel A...

Page 41: ...ieving the error codes Use this procedure to retrieve error codes Procedure Steps Step Action 1 Open Axis Fault file 2 Get FaultDetails from the AxisFault 3 Get the value for the child element with th...

Page 42: ...Use the following procedure to download the WSDL file The WSDL file for the AS 5300 is stored on the System Manager server Procedure Steps Step Action 1 Retrieve the WSDL file from the loads director...

Page 43: ...not compile You must edit this file by hand to split the large static block into two or three smaller ones so that it compiles This is a known issue due to the fact that the code is automatically gen...

Page 44: ...the Provisioning Server to determine the version of the provisioning client and return data that the Provisioning Client can understand 6 Make the OPI provisioning method call for example getUser by...

Page 45: ...f the OPI Stubs and executed The OPI Stub classes and AXIS toolkit jars must be present in the classpath during execution as demonstrated in the following figure Nortel AS 5300 Nortel Application Serv...

Page 46: ...ioning Interface clients Figure 13 Compiling the client class Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyrig...

Page 47: ...ption Language WSDL version Each OPI web service has an associated WSDL version You must configure the appropriate WSDL version in the SOAP header for every OPI web service you request Procedure Steps...

Page 48: ...use the AdminAuthe ntication OPI web service navigate to and click on the AdminAuthentication subfolder in the OPI Java Docs folder A list of sub folders and files related to the AdminAuthentica tion...

Page 49: ...The javadoc for the AdminAuthentication OPI Web service opens in the browser You can go through the various links available in the javadoc to get a description of the AdminAuthentication Web service t...

Page 50: ...50 Accessing the OPI Java docs Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networks...

Page 51: ...tool presents details about the certificate and gives the fingerprint of the certificate for validation The tool prompts Trust this certificate no 4 If the certificate is correct enter yes OR If the c...

Page 52: ...Importing a CA Certificate into the BPT Nortel AS 5300 Nortel Application Server 5300 Application Programming Interfaces Reference NN42040 110 01 01 Standard 11 June 2008 Copyright 2008 Nortel Networ...

Page 53: ......

Page 54: ...com documentfeedback www nortel com Sourced in Canada LEGAL NOTICE While the information in this document is believed to be accurate and reliable except as otherwise expressly agreed to in writing NO...

Reviews: