Avaya Business CommunicationsManager—IVR Upgrade Guide4.0NN40070-400, 02.02September 2010
Chapter 4 — Developer Upgrade on Windows WorkstationDiscusses steps necessary to port PeriProducer 2.30 applications to PeriProducer 3.00, aswell as p
100 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Notation Descriptioncross-reference A cross-reference appears on the screen in blue. Click the cross-reference to access the referenced location. A cr
Two-Button (Windows) vs. Three-Button (Solaris) MouseTrademark ConventionsThe following trademark information is presented here and applies throughout
Chapter 2: New in this releaseThe following sections detail what’s new in Avaya Business Communications Manager—IVR UpgradeGuide for release 4.0.Navi
New in this release14 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Chapter 3: Avaya BCM - IVR 2.1 UpgradeOverviewThis chapter covers:1. The Avaya BCM-IVR 2.1 Upgrade2. New or updated features of Avaya BCM-IVR 2.13. P
New or Updated Features of Avaya BCM-IVR 2.1In previous Avaya BCM-IVR systems (such as the Avaya BCM-IVR 1.X system), both theAvaya BCM 3.X and the IV
Avaya BCM-IVR 2.1 ConfigurationThe following figure shows a typical Avaya BCM-IVR 2.1 system configuration.Avaya BCM-IVR 2.1 ConfigurationAvaya Busine
Avaya BCM - IVR 2.1 Upgrade Overview18 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Prerequisites for the Avaya BCM-IVR 2.1 UpgradeApplication DeveloperApplication Developers create applications that run on the Avaya BCM-IVR system. A
© 2010 Avaya Inc.All Rights Reserved.NoticeWhile reasonable efforts have been made to ensure that theinformation in this document is complete and accu
A System Administrator must obtain the following CDs in order to upgrade the Avaya BCM-IVR system:• MPS 2.1 Software, Documentation and Update CD—MPS
New PeriProducer 3.00 BlocksPeriProducer 3.00 introduces several new toolkit blocks; however, some are not supported inthe Avaya BCM environment. The
(Busy, Reorder, and so on) in the condition data. See the PeriProducer 3.00 User Guide fordetails.PeriProducer 3.00 Block ChangesMany PeriProducer 3.0
Disconnect BlockAbandoned Call Counter RemovedThe MPS does not automatically track system abandoned calls. The Mark as abandonedoption is removed. To
Setting Host Environment ParametersHost environment parameters are sent from the Send Host block. This function replaces theEnvironment block "ho
Receive Fax BlockReceive Fax Direct into TIFF FileApplications can save an incoming fax directly to a TIFF-format file. In previous versions ofPeriPro
Discontinued Features and FunctionsFax CompositionFax composition is not supported in PeriProducer 3.00. Faxes to be sent must be created byexternal a
Obsolete FunctionsThe Media Operations block in PeriProducer has rendered obsolete the file-to-message,message-to-item and message-to-file functions.O
2.30 Environment Option 3.00 Equivalentfirst DtmfFirst (Application and System Environmentoptions)inter DtmfInter (Application and System Environmento
2.30 Environment Option 3.00 Equivalentfreevt Supported for legacy applications only. Use the SendHost block "Free VT" (in Control > Func
ContentsChapter 1: Preface...7Scope.
2.30 Environment Option 3.00 Equivalenthnowait Unsupported (a corresponding VENGINE runtimeoption is available)intermsg intermsgmaxmessage Unsupported
2.30 Condition 3.00 Condition Conversionaddsucc importcmp importcmpaltlinkdown altlinkdown altlinkdownansfail answerfail answerfailasrdet asrdet asrde
2.30 Condition 3.00 Condition Conversiondcdown Unsupporteddcup Unsupporteddeadlock deadlock deadlockdelcomp delcmp delcmpdelfail delfail delfaildialtn
2.30 Condition 3.00 Condition Conversionfromphone fromphone fromphonefrstim getinputfail w/Status"ErrFirst" in condition datagetinputfailfto
2.30 Condition 3.00 Condition Conversionin condition data (failed toreceive map)hrcvtxtfail w/Status"ErrNoData" or "ErrTimeout"in
2.30 Condition 3.00 Condition Conversionlockfail lockfail lockfaillogdeny logdeny logdenylost Unsupportedmarshall mailshall marshallmmfhigh mmfhigh mm
2.30 Condition 3.00 Condition Conversionof (gen'd by VENGINE) $ofsndfaxfail w/Status"ErrNoFaxAvail" in conditiondata (failed send fax)$
2.30 Condition 3.00 Condition Conversionqiderr qiderr qiderrqzero qzero qzerorcverr rcvrsrcfail $rcverrrcvnull Dependent upon event that caused rcvnul
2.30 Condition 3.00 Condition Conversionrlost Unsupportedrngback Unsupportedrred Unsupportedrscoc rscoc rscocrscof rscof rscofrsilence Unsupportedrvoi
2.30 Condition 3.00 Condition Conversionttdata getinputcmp getinputcmpttdet ttdet ttdetttfail getinputfail w/Status"ErrFirst" in condition d
Discontinued Features and Functions...26Fax
Transition Issues for the System AdministratorMinor changes to PeriView and PeriView Consolidator impact how System Administratorsadminister IVR scrip
Chapter 4: Administrator on the WindowsWorkstationThis chapter covers:1. Windows Workstation Operating System Upgrade2. Avaya BCM-IVR 1.X Uninstall P
Avaya BCM-IVR 1.X Uninstall ProceduresUninstall Procedures with MPS 2.1 Software and DocumentCDIf Avaya Business Communications Manager (Avaya BCM) IV
PERIrel5Patch Bundle 27 BundleCutDate-20031007PkgCutDate-20010611PERIgrs 2.2PkgCutDate-20030729PERIperl 1.0.1PERIrel5Patch Bundle 27 BundleCutDate-200
b. or by selecting Setting > Control Panel > Add/Remove.The Add/Remove list contains the list of all PERI packages to beuninstalled.2. Back up o
5. The following window appears. Select YES.6. After the system has rebooted, select Add/Remove Programs from the ControlPanel menu to confirm that al
Avaya BCM-IVR 2.1 Installation ProceduresThe installation of the Avaya BCM-IVR 2.1 is a three-part process:Example1. Installation of PeriProducer 3.00
4. Select Typical when prompted to select the type of installation. Click Next. Note:highly recommends Typical installation. Only users with the most
Click Yes.In a Typical Installation, the PERI packages install in the following order:PERIperl > Auto Reboot > PERIfw > PERIglobl > PERIgr
8. Install the Startup Service by entering the following command:perisvc -install -dispname " Networks Startup Service"9. Confirm that srp i
System Transfer Connection ID Datacard...85Assign
10. Ensure PERI packages are installed on the Windows workstation by running thefollowing command:C:\>perl -S perirev.plx outfile=STDOUTC:\>perl
MPS2.1Patch_Bundle_9 BundleCutDate-20050223PkgCutDate-20030729PERIperl 1.0.1MPS2.1Patch_Bundle_9 BundleCutDate-20050223PkgCutDate-20020116PERIplic 1.2
Note:If you already had the Avaya BCM-IVR Toolkit installed prior to upgrading to Avaya BCM-IVR 2.1, recommends that you remove it prior to installin
Installing the Avaya BCM-IVR ToolkitExample1. On the Avaya BCM-IVR Toolkit CD, open READ_1st.htm.2. Click the BCM Toolkit link to execute the toolkit
The plicnum command produces an output containing the MAC address of theworkstation.The command output is similar to the following sample output:Inter
6. Confirm that the license server obtained the appropriate licenses and activatedthem on the workstation by entering the command:C:\>plicmon <h
PeriView 2.1 and PeriView 2.1 Consolidator InstallationOverviewPeriView 2.1 is an integrated systems management application suite that provides fullad
Installing Avaya BCM-IVR 2.1 PeriView ConsolidatorExample1. From MPS 2.1 Software, Documentation and Update CD, select Preinstall andinstall the JAVA
During a Typical PeriView Consolidator installation, packages are installed in thefollowing order:PERIperl > Auto Reboot > PERIfw > PERIglobl
Note:You may be required to stop the Microsoft Internet Information Server duringthe installation of web-based PeriView.7. Install any PERI service p
6 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
PERIview2.10 MPS2.1Patch_Bundle_9 BundleCutDate-20050223PkgCutDate_200210029. In C:\Program Files\\PERIpdp\etc, back up the userdb.xml file.10. Copy t
c. Check that the Host box contains the PeriView Consolidator IPaddress.d. Check that the Port box contains "9191".e. Click OK to log on.You
Note:To ensure the Data Provider host name translates to its corresponding IPaddress, make a DNS entry or place an entry in the consolidator host fil
Launching Applications in PeriViewThis section describes how to launch an IVR application from the user PC and send it to theAvaya BCM. The section in
In the preceding fiugure, the Windows host workstation is JVARGH. The iconrepresenting the host worktation JVARGH is green in the left area of the Per
6. Browse the .vex folder. In the following figure, the .vex folder is located in C:\Program Files\\PERIppro\sample and contains only one application(
Note:Note that PeriView automatically creates the . acfg file when a .vex file is loaded to theApplication Configuration utility. Note:Note that you
Assigning and Starting ApplicationsExample1. Return to the PeriView launch screen and click APPLICATION MANAGEMENT.The Application Management window a
3. Enter the Avaya BCM component number in the TYPE box.4. In the LINES boxes, select the lines where the IVR application runs. In thefollowing exampl
The application selected is represented by a Telephone icon in the Locations list.Note that the Telephone icon is yellow. This indicates that no appli
Chapter 1: PrefaceScopeAvaya Business Communications Manager (Avaya BCM) with Interactive Voice Response(IVR) capabilities is a communications platfo
The PeriView launch screen shows the application running on two Avaya BCMports.To validate the IVR application, use any phone connected to your Avaya
When you obtain the IVR DN, validate the IVR application by using any phoneconnected to your Avaya BCM to call the IVR DN.Assigning and Starting Appli
Administrator on the Windows Workstation72 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Chapter 5: Administrator on the Avaya BCM4.0 PlatformThis chapter covers:1. Numbering Components using Business Element Manager2. Enabling Host Commu
3. The Interactive Voice Response window with three tabs appears. Select BasicSettings.To administer many IVR systems on different Avaya BCMs, IVR sys
Prior to contacting your Technical Support organization, obtain the MAC address for the AvayaBCM interface that communicates with the Host:Example1. L
3. Click Maintenance.4. Select Attach Shared Volume . Select the shared folder you created in Retrievingexisting Host Communications License File so i
5. Return to the Maintenance page and select Execute a Command. Copy the HostCommunications License File from the Avaya BCM to the shared folder that
To receive the Avaya BCM Host Communications keycode, you must provide the Level 2Keycode Support Prime with the following:Example• the Avaya BCM MAC
Application ResourcesFor more information about Application Resources, including Service Manager, Keycode, IVRAdvanced Commands, and the Advanced Comm
Navigation•Getting technical documentation on page 8•Getting product training on page 8• Getting help from a distributor or reseller on page 8• Gettin
Administrator on the Avaya BCM 4.0 Platform80 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Chapter 6: Developer Upgrade on WindowsWorkstationThis chapter covers:1. Porting PeriProducer 2.30 Applications to PeriProducer 3.002. Porting Events
Converting Standard PeriProducer 2.30 Applications toPeriProducer 3.00Applications that used the standard PeriProducer 2.30 are automatically converte
Porting EventsDuring application porting, the following events occur:Example• Conditions and environment options are converted when possible. See Othe
name. The application containing the condition reacts the same way inPeriProducer 3.00; however, it uses a different condition name.2. Warning: A warn
the associated Resource block. Depending on the resource type, you may not be able to usethe application with PeriProducer 3.00.Resource Block Convers
Developer Upgrade on Windows Workstation86 Avaya Business Communications Manager—IVR Upgrade Guide September 2010
Chapter 7: Developer Upgrade on FedoraWorkstationThis chapter covers:1. Overview2. Installing Fedora3. Installing IVR Plugin Development Environment4
Installing FedoraFedora Core 3 is available for download at http://fedora.redhat.com.Installing IVR Plugin Development EnvironmentTransfer the .tgz fi
tar xzf /tmp/.tgz (or sudo tar xzf /tmp/.tgz)3. Log on again as a regular user and access the IVR Plugin developmentenvironment in /usr/local/.A direc
How to Use This ManualThis manual uses many standard terms relating to computer systems, software applicationfunctions, and the Internet. However, it
The output appears in the /usr/local//examples/lib directory.2. To compile your own code, run the makecall_tux command with your own filename. For exa
Chapter 8: Database Access ConfigurationThis chapter covers:1. Overview2. Configuring periq on the Windows Node3. Configuring sqlclnt on the Windows
VMST 3 on the Avaya BCM NodeEnsure vmst is running on the Avaya BCM node where the applications requiring databaseaccess are running. The following co
#sqlclnt_bcmpso- - 0 0 "sqlclnt -v 1 -N bcm1000 -s 221 -U MG2gojitTV3Rd3X8M###periq_bcmpso - - 0 0 &qu
sqlclnt -v 3 -s 230 -N nodeA -u sa/peri@database -m odbc -q odbcq32-P 16 -Q 5This command specifies the system to start the sqlclnt service and connec
IndexSpecial Characters.ppr Source Code ...39.vex files ...
cticond ...30ctidown ...
hostfail ...30hostup ...
oscoc ......30oscof .....
sentcp ..................30serverdown ...............
Komentarze do niniejszej Instrukcji