Bulk ONT Provisioning

Panorama PON includes a "Bulk ONT Provisioning” script which enables users to more quickly provision ONTs, bypassing the manual GUI ONT equipment provisioning and activation procedures. For the typical GUI procedures.

Bulk ONT Provisioning is typically performed following auto-provisioning of the OLT. The bulk provisioning script does not “provision” the ONT, but rather automatically applies User Labels to ONTs that are auto-provisioned during the Add OLT process. The ONT Bulk Provisioning script applies User Labels to auto-provisioned ONTs at approximately 3 ONTs per second vs. 20–30 seconds each if entered manually into pre-provisioned ONTs.

To manually provision ONTs, including the User label.

The Panorama PON CD ROMs (provided for Windows contain the bulk provisioning scripts, provisionONT.bat.

The ONT bulk provisioning script takes up to seven arguments in a comma-separated value (.csv) input file, as listed in the following table.

Use the following procedure to utilize the ONT Bulk Provisioning script to apply User labels to pre-provisioned ONTs:

1. Create a .csv input file, with the required field information, in the format shown in the input file example above. To make a .csv file, a spreadsheet program, such as Microsoft® Excel on the Windows platform, or a utility program on Unix, such as TextEditor. Create the file with one header row as shown in the following example:
   Note: The header row is required but is ignored from being processed by the utility.

   ---

   IPAddress,Slot,PON,ONT,Serial Number,ONT Label,Auto 172.28.128.207,1,4,27,TSLS00000001,ONTLabel27,

   172.28.136.193,2,1,5,TSLS00001215,,

   ,,,,TSLS00001215,1215,auto 172.28.128.207,1,4,28,TSLS00000028,ont1,

   1.1.1.1,1,1,1,TSLS00001111,ont2,auto

   172.28.136.193,1,1,1,TSLS00001111,ont3, abc,1,1,1,TSLS00000001,ontUL, 1.1.1.a,1,1,1,TSLS00000001,ontUL,

   1.1.1.1,1,1,1,TSLS00000001,ontUL,

   172.28.136.193,a,1,1,TSLS00000001,ontUL,

   172.28.136.193,22,1,1,TSLS00000001,ontUL,

   172.28.136.193,5,1,1,TSLS00000001,ontUL,

   172.28.136.193,1,a,1,TSLS00000001,ontUL,

   172.28.136.193,1,5,1,TSLS00000001,ontUL,

   172.28.136.193,1,1,a,TSLS00000001,ontUL,

   172.28.136.193,1,1,72,TSLS00000001,ontUL,

   172.28.136.193,1,1,2,TSLS00000001,ontUL,

   ,,,,TSLS0000001,ontUL,auto

   ,,,,TSLS000000%1,ontUL,auto

   ,,,,TSLS00000002,ontUL,auto

   ,,,,TSLS00000001,ontUL,abcd
   ,,,,TSLS00000002,ontUL,auto

The contents of the .csv input file should contain one line for each ONT to be provisioned, with each of the data fields separated by a comma. The example below shows a typical ONT data file created in Microsoft ® Excel:
 

Upon execution of the script (provisionONT.ksh), the ONT data is processed one line at a time to the provisioning database, creating an output file as shown below:

C:\Tellabs\PanoramaPON\bbmgr\client1400>ProvisionONT.bat C:\Tellabs\PanoramaPON\bbmgr\client1400\ONTData.csv

Contacting EMS server at 172.28.103.29 and port 7101 Connected to EMS server

Reading data from input file C:\Tellabs\PanoramaPON\bbmgr\client1400\ONTData.csv Processing ONT data 172.28.128.207,1,4,27,TSLS00000001,ONTLabel27,,SUCCEEDED Processing ONT data 172.28.136.193,2,1,5,TSLS00001215,,,SUCCEEDED

Processing ONT data ,,,,TSLS00001215,1215,auto,SUCCEEDED

Processing ONT data 172.28.128.207,1,4,28,TSLS00000028,ont1,,SUCCEEDED

Processing ONT data 1.1.1.1,1,1,1,TSLS00001111,ont2,auto,SUCCEEDED Processing ONT data 1.1.1.1,1,1,1,TSLS00001111,ont2,auto,SUCCEEDED Processing ONT data 172.28.136.193,1,1,1,TSLS00001111,ont3,,SUCCEEDED

Processing ONT data abc,1,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid IP Address:abc Processing ONT data 1.1.1.a,1,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid IP Address:1.1.1.a

Processing ONT data 1.1.1.1,1,1,1,TSLS00000001,ontUL,,FAILED,Cannot locate the Network Ele ment with the given IP Address

Processing ONT data 172.28.136.193,a,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid Slot:a. Must be a number in the range not to exceed number of slots in shelf (MDS5=1-16 MDS7=1-14 1134=1-4)

Processing ONT data 172.28.136.193,22,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid Slot:2

1. Must be a number in the range not to exceed number of slots in shelf (MDS5=1-16, MDS7=1 -14, 1134=1-4)

Processing ONT data 172.28.136.193,5,1,1,TSLS00000001,ontUL,,FAILED,Cannot provision ONT in EMS server probably because no ONT is found at target location

Processing ONT data 172.28.136.193,1,a,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid PON:a.

Must be a number in the range of 1 to 4

Processing ONT data 172.28.136.193,1,5,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid PON:5.

Must be a number in the range of 1 to 4

Processing ONT data 172.28.136.193,1,1,a,TSLS00000001,ontUL,,INVALID INPUT,Invalid ONT:a.

Must be a number in the range of 1 to 32

Processing ONT data 172.28.136.193,1,1,72,TSLS00000001,ontUL,,INVALID INPUT,Invalid ONT:72

. Must be a number in the range of 1 to 32

Processing ONT data 172.28.136.193,1,1,2,TSLS00000001,ontUL,,FAILED,Cannot provision ONT i n EMS server probably because no ONT is found at target location

Processing ONT data ,,,,TSLS0000001,ontUL,auto,INVALID INPUT,Invalid ONT Serial Number:TSL S0000001. Must only contain 12 alpha-numeric characters

Processing ONT data ,,,,TSLS000000%1,ontUL,auto,INVALID INPUT,Invalid ONT Serial Number:TS LS000000%1. Must only contain 12 alpha-numeric characters

Processing ONT data ,,,,TSLS00000002,ontUL,auto,FAILED,Cannot locate the ONT with the seri al number TSLS00000002

Processing ONT data ,,,,TSLS00000001,ontUL,abcd,INVALID INPUT,Invalid auto mode:abcd. If n ot blank, it must be auto or AUTO

Processing ONT data ,,,,TSLS00000002,ontUL,auto,FAILED,Cannot locate the ONT with the seri al number TSLS00000002
ONT provisioning is complete. The summary file can be found at C:\Tellabs\PanoramaPON\bbmgr\client1400\ONTData_summary.csv

If there are duplicate entries, the last entry encountered is the entry that appears in the database. A summary (*_summary.csv) file is generated providing a record of the processing and any failures that may have been encountered. The summary file is saved to the same folder containing the original .csv file. An example of the *_summary.csv file is shown below:

IPAddress,Slot,PON,ONT,Serial Number,ONT Label,Auto,Status,Details 172.28.128.207,1,4,27,TSLS00000001,ONTLabel27,,SUCCEEDED,

172.28.136.193,2,1,5,TSLS00001215,,,SUCCEEDED,

,,,,TSLS00001215,1215,auto,SUCCEEDED, 172.28.128.207,1,4,28,TSLS00000028,ont1,,SUCCEEDED,

1.1.1.1,1,1,1,TSLS00001111,ont2,auto,SUCCEEDED,

1.1.1.1,1,1,1,TSLS00001111,ont2,auto,SUCCEEDED,

172.28.136.193,1,1,1,TSLS00001111,ont3,,SUCCEEDED,

abc,1,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid IP Address:abc 1.1.1.a,1,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid IP Address:1.1.1.a

1.1.1.1,1,1,1,TSLS00000001,ontUL,,FAILED,Cannot locate the Network Element with the given IP Address

172.28.136.193,a,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid Slot:a. Must be a number in the range not to exceed number of slots in shelf (MDS5=1-16 MDS7=1-14 1134=1-4) 172.28.136.193,22,1,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid Slot:22. Must be a number

in the range not to exceed number of slots in shelf (MDS5=1-16 MDS7=1-14 1134=1-4) 172.28.136.193,5,1,1,TSLS00000001,ontUL,,FAILED,Cannot provision ONT in EMS server probably because no ONT is found at target location 172.28.136.193,1,a,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid PON:a. Must be a number in the range of 1 to 4

172.28.136.193,1,5,1,TSLS00000001,ontUL,,INVALID INPUT,Invalid PON:5. Must be a number in

the range of 1 to 4

172.28.136.193,1,1,a,TSLS00000001,ontUL,,INVALID INPUT,Invalid ONT:a. Must be a number in the range of 1 to 32

172.28.136.193,1,1,72,TSLS00000001,ontUL,,INVALID INPUT,Invalid ONT:72. Must be a number in

the range of 1 to 32

172.28.136.193,1,1,2,TSLS00000001,ontUL,,FAILED,Cannot provision ONT in EMS server probably because no ONT is found at target location

,,,,TSLS0000001,ontUL,auto,INVALID INPUT,Invalid ONT Serial Number:TSLS0000001. Must only contain 12 alpha-numeric characters

,,,,TSLS000000%1,ontUL,auto,INVALID INPUT,Invalid ONT Serial Number:TSLS000000%1. Must only contain 12 alpha-numeric characters

,,,,TSLS00000002,ontUL,auto,FAILED,Cannot locate the ONT with the serial number TSLS00000002

,,,,TSLS00000001,ontUL,abcd,INVALID INPUT,Invalid auto mode:abcd. If not blank, it must be auto or AUTO
,,,,TSLS00000002,ontUL,auto,FAILED,Cannot locate the ONT with the serial number TSLS00000002

2. Save the input file as a CSV (Comma-Separated Value) format file.
3. When the data input file has been created, it must be copied to a Panorama PON client machine, preferably a client of the target server.
   Note 1: If the file was created using Microsoft ® Excel, ASCII files created on a Windows platform contain an extra carriage-return character at the end of each line which must be removed.
   Note 2: If the script files used for the bulk provisioning of ONTs, UNIs and voice lines are being executed from a remote client, the IP address and optionally, the RMI port address, if not the default RMI port address (7101 for Windows) of the other server, are required. Refer to “Bulk UNI Provisioning” for UNI provisioning procedures and “Bulk Voice Line Provisioning” for Voice Line provisioning procedures.

4. On Windows, open a command window with elevated privileges, and navigate to the folder containing the provisionONT.bat batch file.
          cd c:\Tellabs\PanoramaPON\bbmgr\client
5. In the command window, enter the following command, and press Enter.
          provisionONT.bat c:\temp\input.csv 1.2.3.4 xxxx

where:

   – c:\temp\input.csv – represents the location and name of the .csv file

–1.2.3.4 – represents the IP address of the target server (required if the script is being executed from a remote client)

           and

– xxxx – represents the RMI port of the target server (required if the server RMI port is not the default OR the script is being executed from a remote client and the RMI port of the target server is not the default of 7101)

6. As each entry in the .csv file is executed, the entry is displayed, followed by the status.
7. Upon completion, an output summary file is generated in the same directory as the input file.
8. Check the output file, i.e., summary_input.csv, for a listing of provisioned ONTs, as well as any possible errors and causes.
9. ONT activation can be verified by checking the ONT Property and Status information for the ONT’s that were provisioned by the script (refer to “ONT Property” and “ONT Status” for details on how to check ONT Property and Status information).