Home

CNAM System Administration Manual

1. Isnrctl start exit Configuration and Naming Conventions 2 18 These are some configuration issues and naming conventions that the customer needs to follow in order to create Oracle Database Instances for the CNAM ezCallerID gateway Configuration For ezCallerID version 2 0 DSET supports a single Service Center for one gateway The Account Number for the Service Center is 111111 The Oracle databases include e One database instance for the CNAM IGP This holds the documents e One database instance for the Security Agent This holds the user accounts their passwords and privilege levels on Admin GUI operations This configuration will make sure that the documents for each ILEC get into the corresponding gateway s database instance Naming Conventions The following convention allows easily identifiable database instances for each Gateway instance The name of the database instance should be no longer than 8 characters Since there is going to be one gateway instance per one ILEC the name of the database instances should ILEC specific 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerlD For example let s say the ILEC is Southwestern Bell Use a three character name to uniquely represent this ILEC say SWB e The name of CNAM IGP database CNAM e The name of Security database CNSECDB The configuration files for this ILEC should be named e CNAM IGP SWB cnamI
2. A window displays indicating a successful change Click OK to close the window User Forgets A Password When Service Representatives forget passwords you cannot use the ezCallerID to look up the password corresponding to the User ID Instead you modify the password by deleting the User ID s account and recreating the User ID with the default password Then the user can log in and modify the password according to suggestions See Choosing Acceptable Passwords on page 3 5 Modifying the Privilege Level Assigned to a User ID The Administrator can modify the privilege level of a user 1 November 15 1999 Select Admin gt User Menu gt Modify The User Modify window appears 1091 B DRAFT 3 25 Defining Users and Privilege Levels ezCallerID System Administration Manual Figure 3 25 User Modify window 2 Type the User ID 3 Type the new privilege level 4 Click OK The Operation Response window appears indicating that the operation was successful X Click OK to close the window Viewing All User IDs and their Privilege Levels The Administrator can view a list of all users who are established within ezCallerID 1 Select Admin gt User Menu gt View The User View window appears Figure 3 26 User View window 2 Click OK 3 26 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels The User View Response window provides a list of all Use
3. CNAM Calling Name Delivery Former name for the ezCallerID application The name and telephone number of the originating party is displayed on a Caller ID device at the destination subscriber s telephone CORBA Common Object Request Broker Architecture CORBA is an industry specification for the design of Object Request Brokers ORBs ORBs allow different kinds of computer systems to exchange object data with each other PowerBRoker is an example of an Object Request Broker that conforms to the CORBA specification DSI DownSiream Interface The portion of the gateway that collects service orders into files translates data into the desired format and sends the data to a service center The interface also receives confirmation and error messages reformats them and passes the files back to the user interface GUI Graphical User Interface The generic name for any computer interface that substitutes graphic elements windows menus drop down selection lists and so on for character commands IDL Interface Definition Language OMG s Interface Definition Language an implementation neutral language used to specify interface definitions in CORBA IGP Interconnectivity Gateway Platform The portion of the DSET software that controls storing service order documents and the resulting notification messages November 15 1999 1091 B DRAFT A 1 Glossary A 2 ezCallerID System Administration Manual Table A 1 Glossary 2
4. es startup KEY ILEC C ezCallerID process ie O ezCallerID component Center Figure B 1 High Level Process Flow of ezCalleriD components November 15 1999 1091 B DRAFT B 1 Technical Reference ezCallerID System Administration Manual Configuration Files The ezCallerID uses a set of configuration files to setup the directory paths and customize the variables to your environment The configuration files for the startup namemgr secAgent cnamIlgp and cnamgw processes are SDP_DIR cnam d dir etc D_nameTailor e SDP_DIR cnam d dir etc Gl DB e SDP_DIR cnam config lt prefix gt cnamIgp cfg e SDP_DIR cnam config lt prefix gt cnamgw cfg e SDP_DIR cnam config security cfg e SDP_DIR cnam config cnam startup Note These filenames are case sensitive What was Installed Now that your installation was successful this is a list of all the processes now running e secAgent e thttpd cnamigp namemgr cnamgw e startup The script used to start the application Configuration Files The configuration files in DP_DIR cnam config directory B 2 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Technical Reference security cfg lt prefix gt cnamgw cfg lt prefix gt cnamlgp cfg cnam startup Executable Files The executable files in SDP_DIR cnam bin directory igpApp cnam cnamlgp cnamgw profile secAgent startup thttp
5. The Privilege Level window displays as shown in Figure 3 18 Privilege Level Privilege Type Privilege Operations Use the scroll bar to view all the Operation Codes Privilege Level Create Privilege Level Modi z 4 gt OK Cancel ey Unsigned Java Applet Window Figure 3 18 Privilege Level Create window See for field descriptions November 15 1999 1091 B DRAFT 3 19 Defining Users and Privilege Levels ezCallerID System Administration Manual 2 Type the Privilege Level number zero is already done for you 3 Type a brief description of the privilege level in the Privilege Type field This field accepts up to 100 alphanumeric characters 4 Select each operation from the list 5 Click OK The Operation Response window displays indicating that the operation was successful 6 Click OK Repeat these steps for each Privilege Level Users with Privilege Level 0 or a Privilege Level that permits deleting or modifying other ezCallerID users profiles can delete or change the ezCallerID Administrator s profile Users with a Privilege Level 0 or a Privilege Level that permits them to delete or modify Privelege Levels can delete or change all the privilege levels including Privilege Level 0 What to Do Next Once all the Privilege Levels are determined you associate Privilege Levels to User IDs See Creating a User ID and Assigning a Privilege Level on page 3 24 Modif
6. Ensures that the ezCallerID directories have 20 Mb of available disk space Verifies that the ezCallerID System Administrator user ID for example CNAM has super user status and the user ID s password exists Unpacks the cnam DSET tar Z file and checks to see that all files defined in the distList file installation file list exist in the ezCallerID file directories Asks the user to supply the ezCallerID System Administrator User ID for example CNAM and verifies their administrative authority Creates standard DSET system directories and integrates the supplied System Administrator user ID into the product s internal security Gives ownship of all installed ezCallerID application files to the System Administrator Creates a sample profile file that must be supplied to all ezCallerID users Removes any temporary files used during this phase of the installation 1091 B DRAFT 2 31 Installing ezCallerID ezCallerID System Administration Manual Install the ezCallerID Application Before you perform the third major section of the installation procedure you need to have the information required to answer all the questions asked by the ezCallerID application install script You will be prompted for installation options database names process names and communication port numbers Port Numbers 2 32 Note Once you have decided upon the ezCallerID port numbers to use be careful that other DSET applications such as ez
7. The ezCallerID GUI Processing a Request ezCallerID Interconnectivity Gateway Platform IGP The ezCallerID IGP is the nucleus of the ezCallerID It does the actual processing of the tasks the users perform The ezCallerID IGP Creates modifies and displays ezCallerID documents Displays Notification and Error messages Creates modifies and displays DownStream Interface DSI and Service Center information Displays Log files 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Introducing ezCallerID Security Agent Ss ezCallerlD Gateway windows CNAM IGP z Interconnection Gateway Platform Service Center DownStream Interface ezCallerlD Gateway Figure 1 1 ezCallerlD Interconnectivity Gateway Platform Security Agent When a user enters the ezCallerID login information is validated by the Security Agent The Security Agent accesses a database sec_db and validates the user ID and password If the user ID is valid the Security Agent sends a message to the ezCallerID Gateway confirming the ID Otherwise the Agent sends back an invalid user message and login is denied It also insures users are not able to perform functions outside of their authority Figure 1 2 illustrates the user ID validation process by the Security Agent November 15 1999 1091 B DRAFT 1 9 Introducing ezCallerID ezCallerID System Administration Manual 1 User ID logs in to ezCallerlD Gat
8. ee ee eeeecceeseeeeeeesecaeecaecseeaeceenseenseneeeeeees on page 5 24 Throughout this chapter the ezCallerID Oracle database instances are referred to as CNAM for the ezCallerID orders documents database and CNSECDB for the Security Agent database Preventative Monitoring As the System Administrator we recommend you monitor the ezCallerID application and third party software activity on your UNIX system in these areas Checking Disk Spaces cs scce sesccd secu eee ana aioe ieioea on page 5 1 Application Process healthier ansen a E EA on page 5 3 Viewing ezCallerID logs Application operation eseeeererseeerserereersrererereeee on page 5 5 Checking Disk Space As the ezCallerID System Administrator you can monitor the ezCallerID Gateway on a regular basis You have three areas where you will be storing ezCallerID information on the UNIX machine November 15 1999 1091 B DRAFT 5 1 Maintenance and Troubleshooting ezCallerID System Administration Manual e The DSET ezCallerID application files e CNAM orders in an Oracle tablespace e Notification and error messages The ezCallerID Installation Use the UNIX commands on the ezCallerID file directory to monitor disk space e df number of free disk blocks e du number of disk blocks in use Check the amount of disk space in use for your entire ezCallerID installation and determine the number of free kilobytes allocated kilobytes and disk usage for the installati
9. export ORAC 5 E_LISTENER export u02 oracle app oracle product 8 0 export ORAC 5 ne iE TO export ORACL twork admin P export u02 oracle app oracle admin ry _US ER _HOME var home oracle export ORACL F i_DS ET SQL DP_DIR cnam schemas Save the commands as a profile file source the profile and use these variables as part of the Oracle database creation procedures B Create Directories for Database Mount Points Create the CNAM and CNSECDB database Name directories at the Oracle mount points 3 Change to the appropriate directory to define the Oracle Database DATA files cd SORACLE_MOUNT 4 For the CNAM document database mkdir oraclel oradata CNAM mkdir oracle2 oradata CNAM mkdir oracle3 oradata CNAM 5 For the CNSECDB Security Agent database mkdir oraclel oradata CNSECDB mkdir oracle2 oradata CNSECDB mkdir oracle3 oradata CNSECDB C Create Admin Directories for Oracle Databases 6 Create the top level Oracle administration directories mkdir SORACLE_ E E mkdir SORACLE_ 2 10 OP CNAM OP CNSECDB 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Create Oracle administration sudirectories for the CNAM document database cd S ORACLE_TOP CNAM mkdir bdump cdump create pfile udump Create Oracle administration sudirectories for the CNSECDB sec
10. ezCallerID System Administration Manual Installing ezCallerlD Note The rm command has no impact on the CNAM customer orders stored in the Oracle CNAM database or the User IDs and privilege levels stored in the Oracle CNSECDB datbase November 15 1999 1091 B DRAFT 2 59 Installing ezCallerID ezCallerID System Administration Manual 2 60 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Chapter 3 Defining Users and Privilege Levels This chapter provides instructions for setting up User IDs and defining application Privilege Levels Getting Started The next pages show you how to login to the ezCallerID user interface Login to ezCallerID 1 Start your Internet Browser and type the ezCallerID URL Note Your system administrator will provide the full URL and directory pathname in the format http _ host name _ _ HTTP port number _ The host name IP address is the name or IP address of the machine on which the ezCallerID application is running The http port number is the port number the browser uses to access the software You may want to bookmark this URL in your Internet Browser so that you can quickly access the ezCallerID application My ezCallerID URL is The Web Browser displays the Index Of directory links as shown in Figure 3 1 November 15 1999 1091 B DRAFT 3 1 Defining Users and Privilege Levels ezCallerID System Administration Manual Index of Click to login to ezCa
11. The Get DSI Info window displays as shown in Figure 4 13 Service Center oooo01 OK Cancel ey Unsigned Java Applet Window Figure 4 13 Get DSI Info window 2 Select the appropriate Service Center from the drop down selection list in the Service Center field 3 Click OK Figure 4 14 illustrates the resulting DSI Info window that displays 4 14 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers Service Center 123456 eekMask starth 10 startm 30 stoph 23 sto periodic ABSENT ezCallerlD data transmission at assigned times during the week DownStream Frequency ezCallerlD data transmission at regular intervals OK Ss Unsigned Java Applet Window Figure 4 14 DSI Info window See UNRESOLVED XREF for field descriptions 4 Click OK If you want to view the data transfer times you will examine the details of the DownStream Frequency information DownStream Frequency Details You can view the DownStream frequency for when the system checks for new ezCallerID documents It can be set to e Specific times on selected days of the week A constant time interval between data transfers WeekMask This data transfer schedule specifies the actual times starting and stopping when the ezCallerID performs the operations Each day has its own schedule 1 Hold down the lt Shift gt key and click the wee
12. b If a User ID is requested use an Anonymous FTP login with the values User ID anonymous Password lt Insert your email address gt c Change to this directory to locate the latest 8 0 5 software patch files server patchsets unix SUN_SOLARIS2 80patchsets d Change to the latest subdirectory The patch files at the date of this manual s publication are found in subdirectory 80521 Note The files in the Patch sets are cumulative For example 8 0 5 3 includes all the fixes in 8 0 5 1 and 8 0 5 2 as well as new fixes for 8 0 5 3 This means that unless the patch set documentation indicates otherwise the patch set can be applied to any earlier 8 0 5 version There is no requirement to install all intermediate patch sets 4 View the patch_note html document using a web browser to understand gt System requirements for installing the patch gt Instructions for installing the patch gt List of bugs fixed with this and previous patches gt De installing patch procedures November 15 1999 1091 B DRAFT 2 5 Installing ezCallerID ezCallerlID System Administration Manual De Installing a Patch Set There is no mechanism provided for de installing patch sets If you are concerned about being able to de install a patch set Oracle Corporation recommends that you back up your software installation before applying the patch set 5 Follow the instructions to install the Oracle 8 0 5 software patch found in solaris_8052patchset
13. structure where the Log Root is a subdirectory of the Web Server Root directory similar to e Web Server Root Directory CNAM Log Root Directory The log directory must be a subdirectory of the Web Server root directory so it is accessible to the web server and the user s web browser Once you understand the UNIX file structure for the DSET logs a System Administrator can use either UNIX commands or the Web Browser in the ezCallerID application to view logs The ezCallerID logs reside in the UNIX directories see Figure 5 2 SDP_DIR cnam www cnam log lt trading partner gt Cnamlgp SDP_DIR cnam www cnam log lt trading partner gt Canmgw SDP_DIR cnam www cnam log lt trading partner gt Security The lt trading partner gt is usually expressed as a three or four letter ILEC designation such as PAC Pacific Bell SWB Southwestern Bell USW US West etc 1091 B DRAFT 5 5 Maintenance and Troubleshooting ezCallerID System Administration Manual See Table 5 2 for a description of the contents of different log files Web Server Root Directory CNAM Log Root Directory Trading Trading Trading Partner 1 Partner 2 Partner 3 Figure 5 2 Log Directory Structure 5 6 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Index of mode links bytes last changed name dr x 3 512 Sep 16 16 00 dr x 3 512 Sep 16 15 56 r 1 992438 Sep 1
14. 1 Figure 3 2 Figure 3 3 Figure 3 4 Figure 3 5 Figure 3 6 Figure 3 7 Figure 3 8 Figure 3 9 Figure 3 10 Figure 3 11 Figure 3 12 Figure 3 13 Figure 3 14 Figure 3 15 Figure 3 16 Figure 3 17 Figure 3 18 Figure 3 19 Figure 3 20 Figure 3 21 Figure 3 22 Figure 3 23 Figure 3 24 Figure 3 25 Figure 3 26 November 15 1999 ezCallerID Interconnectivity Gateway Platform ieee eeeeeeeeeeeeeeeeeeneenaes 1 9 The Security Agent Process FIOW ccccecssesseesseesecssenssenteoseeessnnevensseevesesenenees 1 10 Download Process of ezCallerID requests eee eee ceseeseceseeeeceseeeeeeeeeseeeeeeaes 1 12 Example DSET UNIX Product Directory Structure eee eeseeeeeeeeeeeeees 2 25 Log Directory Structure eee eee ceeeseececnsecsecaeesecesceseceseesesseeeseseeseaeseaeeaaenaes 2 27 Initial Installation Instructions 000 0 eee cseesecseeesececeseeeceseeeceeeeseseaeeaeseneeaee 2 29 Orbix Home Directory Instructions 0 0 ee eee ceeeeceeceseceeceseeeeceeeeeeeeseeeeseaeenaes 2 37 Example Console Output from the command Ldd cnamIgp 2 51 Example Console Output for Oracle Databases eee eceeeeeceseeereeseeeseeneeeaes 2 52 Portion of the Activity LOS seoses sees E E R EREA 2 57 The Index of Directory in the Web Browser windoW ssssseesseeeseressersereresresesee 3 2 The ezCallerE gt window eee errearen tasssepcosts suvevsosausdevcsosescepeuemeaeneees evestapevenses 3 3 User Login window nesmie nh ke
15. As auser who creates deletes and modifies customer LIDB records you do not control the portion of the software that decides when to transmit customer records to the Service Centers and when the ezCallerID receives notification or error messages in return Consult your ezCallerID System Administrators regarding the days and times that ezCallerID information is transferred between your computer and the Service Centers Only these individuals can actually change the data transfer schedules You have the ability privileges permitting to see how often the DownStream Interface DSI transfers data 1 Select DownStream Interface gt View DSI Info The Get DSI Info window displays as shown in Figure 3 12 Service Center oooo01 OK Cancel ey Unsigned Java Applet Window Figure 3 12 Get DSI Info window 2 Select the appropriate Service Center from the drop down selection list in the Service Center field 3 Click OK Figure 3 13 illustrates the resulting DSI Info window that displays November 15 1999 1091 B DRAFT 3 11 Defining Users and Privilege Levels ezCallerID System Administration Manual 123456 eekMask starth 10 startm 30 stoph 23 sto periodic ABSENT ezCallerlD data transmission at assigned times during the week Service Center DownStream Frequency ezCallerlD data transmission at regular intervals ox ey Unsigned Java Applet Window Figure 3 13 DSI Info wind
16. Constraints for Interval Of Day Window eee eee eee cseeeeeeneeeeees C 5 Field Value Constraints for Interval Window cescccesccesseceececeeceeeceeseeenaeceneeees C 5 Field Value Constraints for ezCallerID Create Window cece eeceeeeeeseeeneeeeeees C 10 Field Value Constraints for Privilege Level Create Window 0 eee eee C 14 Field Value Constraints for Privilege Level Modify Window e eee C 15 Field Value Constraints for User Create Window eccesscceeecsseeeneeeeeeenseeeeees C 17 1091 B DRAFT xv November 15 1999 List of Tables ezCallerID System Administration Manual xvi 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Preface About This Manual This ezCallerID System Administration Manual provides all the information the system administrator needs to install maintain and troubleshoot the ezCallerID software Additional procedures cover some of the initial steps the ezCallerID System Administrator must perform add service centers add privilege levels and add user IDs Audience The ezCallerID System Administration Manual is for installing the software monitoring the software processes and maintaining the system Where to Find Information in the Manual Use this guide to start installing the ezCallerID system or as a reference to sections November 15 1999 Chapter 1 is an introduction to the ezCallerID Chapter 2 provides step by step instruc
17. E Yellow Pages Download Find Sites C4 Cha Index of log JMONT mode links bytes last changed name dr x 5 512 Sep 29 11 09 For this example we dr x 3 512 Sep 29 11 09 selected the Cnamlgp log dr x 2 512 Sep 29 13 24 CnamIgp a directory dr x 3 512 Sep 29 12 57 Cnamgw dr x 2 512 Sep 29 11 21 Security car Document Done ele Zl Z Figure 5 4 Index of log directory window This is a list of the log directories available to this ezCallerID application Each directory provides specific information to the System Administrator Table 5 1 Log Directories Directory Name Description Contains daily logs that show the order document activity through the ezCallerID gateway The trace logs highlight significant software events from a developer s Cnamgw perspective This information is usefully to DSET customer service personnel to help determine solutions to problems Cnaml Contains daily logs that define the activity of documents sent to the trading partner and gP any notification messages errors received from the trading partner ILEC This file describes all the security activity establish User IDs establish Privilege levels Security change User ID privileges assign or change functionality of privilege levels 5 8 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting 3 Click the directory to display a
18. Oracle DSET application databases CNAM and CNSECDB easy we need to define several UNIX variables to correspond to the key Oracle directory pathnames Note Define each of the UNIX environment variables in Table 2 4 to correspond to the Oracle file directory structure used at your company Table 2 4 Variables that Define Oracle Directory Pathnames Environment Variable Name ORACLE_MOUNT Pathname an example export u02 oracle data Description Parent directory for Oracle data files ORACLE_HOME export u02 oracle app oracle product 8 0 5 Oracle s installed home directory ORACLE_TOP export u02 oracle app oracle admin Parent directory for defining Oracle database administration files ORACLE_LISTENER export u02 oracle app oracle product 8 0 5 network admin Directory with Listener ora tnsnames ora andsqinet log ORACLE_USER_HOME var hnome oracle Oracle User ID Home Directory ORACLE_DSET_SQL November 15 1999 SDP_DIR cnam schema See Table 2 7 1091 B DRAFT Oracle SQL scripts to create databases insert table schema and perform maintenance operations Installing ezCallerID ezCallerID System Administration Manual 2 Type the following UNIX commands with a text editor to define the environment variables F iE_MO export ORAC export ORACL UNT export u02 oracle data ry _HO E export u02 oracle app oracle product 8 0
19. SMS Service Management System An SS7 operations support system OSS used to help the provisioning and loading of data into the ezCallerlID ezCallingCard service control point SCP database 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual Glossary Table A 1 Glossary 3 of 3 Acronym TBS Telecom Business Solution The Operation Support System OSS provided by MetaSolv Software that acts as a user interface to create CNAM orders through the DSET ezCallerlID gateway TNS Transparent Network Substrate A simple way to manage many combinations of communications protocols that can access a single Oracle database instance UFS UNIX File System The tree structured file system supported by the UNIX operating system URL Universal Resource Locator An internet address that locates a file on any computer connected to the Internet in the world The URL is ultimately translated to a TCP IP address and a directory location on that computer November 15 1999 1091 B DRAFT A 3 Glossary ezCallerID System Administration Manual A 4 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Appendix B Technical Reference This chapter describes the technial processes of the ezCallerID and the configuration parameters necessary to run the application Process Flow This illustration shows a high level process flow of the ezCallerID and how the components interact with each other
20. and Troubleshooting ezCallerID System Administration Manual Replace lt CNAM_processes gt with each of these processes startup lsrgw lsrigp secAgent namemgr and thttpd 4 When all processes have stopped restart the Gateway from the same directory cnam start CORBA Orbix Software Determine if CORBA Daemon Running To verify that Orbix is running properly for CORBA OSS configuration users 1 From the console that the software was installed type the command ps aef grep orbixd Manually Kill the CORBA Daemon Process These are the UNIX commands that force the CORBA Orbix process to terminate PID ps f grep orbixd grep v greplawk print 2 ey if n SPID then kill 9 SPID 2 gt amp 1 gt dev null fi Manually Start the CORBA Daemon Process 2 Ifthe Orbix daemon is not running switch to directory etc rc2 d 3 Type the command S99iona start This restarts the Orbix daemon 4 Restart the CNAM Gateway see Starting the ezCallerID Gateway on page 5 17 If the Orbix daemon CORBA is running the OSS is able to contact the CNAM Gateway 5 18 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting If the Orbix daemon is running and the OSS is unable to contact the LSR Gateway go to SDP_DIR 1sr config and locate file lt ILEC gt lsrgw cfg 5 Using VI or another text editor edit the variable RMT_CORBA_HOST_NAME It ne
21. and their Privilege Levels 0 0 0 eee cesses ceeceeeceeeeeeeeneeseesaeenaesaes 3 26 Deletitig2a User UD essccscssccsecouedeawuusatocsceuechaues Goa vahaes A rivers cvves peu segids Se A EA EAN ETE 3 27 Communicating with Service Centers sesesseseesosoesesseseosesoesesoosessossesoesessesossesoesesoosessosoesoesessesossesosesossesseseses 4 1 Creating a New Service Centers s sccicisesesscchiocs sssgieecs sper eo sh E EE EEE TETEE TEES S es REA EES 4 1 Viewing All Servi Centers iis iiiie uh e ae Ate E E E eee ee 4 3 Deletinga Service Comte tics seyvonesee e e ar eraoo EE Ea pees EEE ES ATE re Seedertnteeedaugeaes 4 4 DownStream Interface DSI receno ro eseten rer riet eni e Seere ous Ki serttir eri err aetas 4 5 Scheduling Sending and Receiving Data sssessssesesseeesrsseerestesrsreererreertsserresreresreeenrrereees 4 5 Creating the DownStream Interface 0 0 ceeeseceeceseeeeceeeeeceeeeeeseaeeeeseneeseecaecaaecaessaeeaes 4 5 Modifying the DownStream Interface eee eee ceceseeeeeeseeeeceeeeseesneeeeecaeesaecaecsaecaeesaees 4 11 Viewing the Data Transfer Schedule 00 0 eee cee ceeceseeseceeceeeceseeeeeneeseecaeeseecaecsaesaecsseeseseseneseeenees 4 14 DownStream Frequency Details 00 0 0 ceseeeecesceseeeeeeeeseeeeseeeaecaaeeaecaassaecnecsaeesensees 4 15 Maintenance and Troubleshooting scsscsscsssssscsssssscscssscsscssscsscssccsseesecesessecssecsesescsescsssssesessssssssessees 5 1 Preventative Monitoring sei
22. app oracle product 8 0 5 echo SORACLE_TOP export u02 oracle app oracle admin echo SORACLE_LISTENER export u02 oracle app oracle product 8 0 5 network admin echo SORACLE_USER_HOME var home oracle echo SORACLE_DSET_SQL ezConnect home cnam cnam2 0 6 cnam schema E Verify Library Paths for Processes Once all the environmental variables are correct we need to make a quick check that key software processes can find all shared software library objects they need and the application has permissions to access all library files 7 Switch to the bin product subdirectory see Figure 2 2 and list all the dynamic dependencies UNIX 1dd command or shared objects that would be loaded when the process file is executed cd SDP_DIR cnam bin ldd secAgent ldd cnamgw ldd cnamIgp lt may use Orbix CORBA library 2 50 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID ldd thttpd ldd startup ldd d dir bin namemgr Figure 2 5 illustrates an example of the console output you see for each of the six ezCallerID application processes libdl so l1 gt usr lib libdl so 1 libsocket so 1 gt usr lib libsocket so 1 libnsl so l1 gt ausr lib libnsl so 1 libelf so l1 gt usr lib libelf so 1 libclntsh so 1 0 gt export u02 oracle app oracle product 8 0 5 lib libclntsh so 1 0 libc so 1 gt usr lib libc so 1 libaio so l gt usr
23. be deleted 4 4 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers DownStream Interface DSI The DownStream Interface DSI is used to transfer the ezCallerID documents to the Service Center for processing DSI information must be established for each Service Center Scheduling Sending and Receiving Data When you set up the DSI you are defining how often you want the ezCallerID to retrieve information from the Service Center and how often you want the ezCallerID to send information to the Service Center There are two ways you can set up receiving and sending data e Indicate a set time for uploads or downloads to occur each day This is called a Week Mask Schedule e Indicate when uploads and downloads should occur throughout the day at timed intervals This is called a Periodic Schedule UpStream Frequency refers to the upload of data from the Service Center to the ezCallerID DownStream Frequency refers to the download of data from the ezCallerID to the Service Center Factors to Consider Downloading and uploading information causes traffic on your network To minimize traffic and enhance performance you should download and upload information only when necessary For instance if your service representatives cannot process more than four ezCallerID requests in an hour you should not have a periodic download set up to occur every 15 minutes Also if the Service Cent
24. check for downstream information November 15 1999 1091 B DRAFT C 5 Catalog of Windows and Fields ezCallerID System Administration Manual Modifying DSI Information To Access DownStream Interface gt Modify DSI Service Center oooo01 OK Cancel ey Unsigned Java Applet Window Figure B 8 Modify DSI Info window Service Center 123456 ekMask D00000 DownStream Frequency periodic ABSENT OK Cancel ey I Unsigned Java Applet Window Figure B 9 Modify DSI Info details window Viewing DownStream Interface Information To Access DownStream Interface gt View DSI Info C 6 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual November 15 1999 Get DSI Info Figure B 10 Get DSI Info window Catalog of Windows and Fields DSI Info Figure B 11 DSI Info window 1091 B DRAFT starth 10 startm 30 stoph 23 stop if Catalog of Windows and Fields ezCallerID System Administration Manual Viewing WeekMask Download Frequency Sunday Monday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin H Tuesday Wednesday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin E Thursday Friday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin E Saturday StartHr StartMin StopHr StopMin ox E Unsigned Java Applet Window Figure B 12 Week Mask window C 8 1091 B DRAFT N
25. e E EE EEE E TEET EE a EES 2 5 CORBA SoftWare ss eirese r 5 ee e an E EE E o ese he heh gba S 2 6 Integrated OSS Configuration is 5c5 scsseeccassesicsscoseesstesss oio Eris orak svasdeeesseudsbebsosce SEE sacgpneeeees 2 6 Create Oracle Databases 0 c23i aie s a E aig T E e dale abate 2 7 IO UC HOM seene e A A E T AE E E EA Garett 2 7 Overview Creating Oracle DSET ezCallerID Databases e ssseesesseeessseesrsessrrrrserrrereersreee 2 8 A Define Environment Variables sisese poves rostos eev sesir toeon essees sopek Sis K ES Ehen poe e siese 2 9 B Create Directories for Database Mount Points essesessesseeesrsresrsresesrsreerrsrerrsreerereereees 2 10 C Create Admin Directories for Oracle Databases sseeseeeessseesesseerreesrrereseessrereseereseeee 2 10 D Build Initialization and Configuration Files sssesseseeeeseeeeseseesrsresesresrerreseersseeresreresesse 2 11 E Create Links for Initialization and Configuration Files esssseseseesesseereersreerrrrerrsessees 2 12 F Create Scripts to Allocate Database Space oo eee eecsessecseeesecneceseeeeeeeeeeeeeeeeeseneeaee 2 12 G Run CNAM and CNSECDB Table Creation Scripts 0 0 csecee cee ceeeseeeeeeeees 2 13 H Mount the Databases siennes epee eeen ee oerein neea EE oV io Eor E E N eree 2 14 I Create a DSET Product DBA User ID ou ceeceeceeceeeeeceeeeeeceeeeseeeeeeseecaesnaeeaes 2 14 J Set up Oracle Network Communications 0 cece eececseeseecsee
26. ezCallerl D Components siss 5 cccscs i esceces cue seocs sees sec ch tun caseves sutca EEEE EE EE E SEEE SA EE EE EEE 1 7 Generating a Request s c siccsssivesshesecckshcsbcoesess ca sseetcedys tases araeo ES E pE RETES EEE Ren TER ATES Epoo ES eSEE 1 7 TheezcaleriD GULA en E e haba E AE EEE EE AA A 1 8 Processing a RegU st cnisia ioris erir e re EE E p E EE EEEE E E rE E EE eoSt 1 8 Converting to A Common Format ieee ececseseecsecssecneceseesecescnseceseeeseaeeseseneeseecaeesaeeaes 1 10 TNE SEEVICE COMET riena atara aE RA e a EEE EE seta O EEA 1 13 Installing ezCaler ID viccscccsscicsssvsseseesssesesssccrsensecsossdenseseesucestaseedassebadenscacabasecsesenscassbnsoadessssecenscaveduecsseoassecensesees 2 1 COVEN VIE Wises seca Seek tee E E a aN TRB CG SA Des aha whet Sag aa Sao E aah ap a gen Sep ae Fe ethos Oe 2 1 Pre Installation Tasks chic cases ece en chek Seaee elas cecen dh ek eoaueablusvganaecbol cqielonncedueces neces oblvannenenoenduegseungobenounes 2 2 Referentes 25 1455 cava seuva E T EAE E a eave sb evn E ES E R TT e 2 3 November 15 1999 1091 B DRAFT v Contents vi ezCallerID System Administration Manual Install Third party SoftWare ic s ccsss chic cscsbechescascepscisced sass sssvnataessscoaessenscphesbssiseedoghessopenssednsapetess erio EEST 2 4 Oracle Software Requirement eee cee csesecseeseceeceseeeceseeseceseeeeseaeeseseaseseeeaecsaeeaessaenaes 2 4 Oracle Server Softw are cs ssiccsssescesyscsceisehh ages E
27. home directory 2 37 register DSET processes 2 44 remote names host 2 39 server 2 39 software home directory 2 2 installation 2 6 troubleshooting 5 18 customer service change configuration files 2 41 contacting xx dial in procedures 2 58 installation 2 19 D defaults HTTP daemon port number 2 33 Security Agent port number 2 33 server port number 2 33 dial in procedures coordinate with customer service 2 58 disk space checking 5 1 CNAM orders documents 2 8 CNAM orders in Oracle 5 2 free kilobytes 5 2 issues 5 2 Oracle databases allocated by scripts 2 12 requirements DSETinstallation 2 2 third party software 2 2 User IDs and privileges 2 7 diskspace allocated kilobytes 5 2 Index 2 ezCallerID System Administration Manual documentation DSET application 2 28 DSET database creation 2 8 installing Oracle software patches 2 5 DownStream Frequency See DownStream Interface DownStream Interface DSI defined A 1 DownStream Frequency 3 13 4 7 4 16 Periodic 4 10 WeekMask 4 7 modifying 4 11 operating at a selected interval 3 14 4 17 operating at selected times 3 12 4 15 drop Oracle database tables 5 28 DSET Installation Team activities 2 19 DSI description 4 5 DSI See DownStream Interface due dates possible states 1 5 E editing scripts Oracle databases 2 13 environment DSET application 2 28 environment variables access by system administrator 2 47 DSET application 2 48 Oracle databases CNA
28. in Step 10 on page 2 37 Define the Oracle Software Home Directory Important Contact your Oracle Database Administrator for the Oracle directory pathname 12 For the Oracle database to store CNAM documents and implement security the installation script displays Type the complete pathname to the Oracle Database home directory Example tools oracle app oracle product 8 0 5 Oracle home directory Type the home directory for the Oracle server software You must manually type the home directory name 13 Once you type the Oracle home directory the installation script echoes your response and requests confirmation Path to oracle home directory is export u02 oracle app oracle product 8 0 5 CONFIRMATION is this Oracle pathname correct y n Type Y to confirm the Oracle software home directory pathname or type N to return to the prompt in Step 12 on page 2 38 2 38 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID TCP IP Gateway and Security Agent Port Numbers 14 The ezCallerID CNAM server port number identifies the TCP IP port for the gateway This is the port with which the ezCallerID System Administration GUI communicates with the ezCallerID gateway The server port number should be greater than 1024 and less than 99999 Type th zCallerID CNAM Gateway port number 9999 default Type the gateway port number for the ezCallerID application The value in parenthesi
29. namemgr Process 5 20 Several processes in the ezCallerID Gateway use the namemgr to register information If it is not running the following message may appear startup Make sure namemgr is running before you start the agent Verify that the namemgr process is running when this error happens If the process is running and this problem occurs the time lag between the namemgr and the other processes in the startup configuration file is not enough for your system Increase the time lag then stop and restart the LSR Gateway 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Backup and Archival For the ezCallerID application the System Administrator will need to backup the ezCallerID logs and the actual CNAM orders documents stored in the Oracle database The ezCallerID logs can be backed up with standard UNIX utilities The Oracle files can be backed up as necessary using the standard Oracle utitlities or the database orders can be archived removed from the files and any needed disk space reclaimed e Backing up Oracle ezCallerID orders 00 0 eee ec ceeeecseesee cee ceneceeceseeeeenseeseens on page 5 22 e Archiving ezCallerID logs 0 enei ti sra enia n i e E on page 5 23 When you reach 80 capacity of UNIX disk space or Oracle tablespace size you need to begin to archive CNAM documents along with notification messages and errors Once you have archived all documents and
30. need to select a directory to install it This directory should be empty Also you need to assign a DSET administrator from the logins on this system You will be prompted for this DSET administrator login name later during the installation The following shell utilities must be in your path rm tar df awk tail fgrep hostid chown chgrp hostname Please make sure you are prepared for all these requirements before you proceed with the installation If you decide to go on please type y at the prompt now otherwise type n to cancel this installation and start all over later Figure 2 3 Initial Installation Instructions 9 If you ve completed the pre installation checklist installed all required third party software have at least 150 Mb of free hard disk space and have any required Oracle databases set up answer Y at the prompt This script will take approximately 5 minutes to complete If you typed a Y and do not have at least 20 Mb of free disk space for the installation this prompt displays Free disk space in is less than 20MB installation may fail Proceed y n If you proceed without making 20 Mb of free disk space available the installation may fail To ensure correct installation type N and remove files to free up the required disk space then proceed with Step 7 again November 15 1999 1091 B DRAFT 2 29 Installing ezCallerID ezCallerID Syste
31. the ezCallerID you may configure it to use with other web servers Verify that the log directories are configured in the web server root directory You should also comment out the thttpd line in the cnam startup script file and add your own web server to this file 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Technical Reference Removing ezCallerlD Remove the ezCallerID from your system by deleting all the files in the cnam directory BE MORE SPECIFIC AT THIS POINT Variables that DCAMS for generic agent SCHEMA _DCAM ezConnect home cnam cnam2 0 5 cnam bin libIgpSch so MANAGER_DCAM ezConnect home cnam cnam2 0 5 cnam bin libIgpMgr so Gl BEH DCAM ezConnect home cnam cnam2 0 5 cnam bin libcnambehD so DB_DCAM Added for LIDB SCC_COMPANY_CODE DSE SCC_COMPANY_NAME DSE OUTPUT_DIR_NAME ezConnect home cnam cnam2 0 5 cnam DATA ACNTS 111111 output COUNTY_ID 1234 STAT ID TX E LIDB_AGENT_NAME cnamAgent November 15 1999 1091 B DRAFT B 9 Technical Reference SVC_C SCC_R SCC_FORMAT_VI ENT ER NAMI B 111111 FAL EAS KN UMB ER 100 ERSION 1 1091 B DRAFT ezCallerID System Administration Manual November 15 1999 ezCallerlID System Administration Manual Appendix C Catalog of Windows and Fields Service Center
32. the process ID that identifies Orbix and 16 55 56 is the current time root 307 1 0 Oct 26 0 12 opt iona OrbixMT_2 3c bin orbixd cnam 4893 4877 0 16 55 56 pts 11 0 00 grep orbix Refer to Chapter 5 Maintenance and Troubleshooting to determine what actionsare needed when the CORBA software is not functioning 1091 B DRAFT 2 21 Installing ezCallerID ezCallerID System Administration Manual Prepare Basic DSET Environment Table 2 5 ezCallerID Basic DSET Environment Check here Once You Have Performed Oo Integrated Configuration only If you intend to use the MetaSolv Telecom Business Solution TBS application you must install TBS v4 0 1 software The software requires 80 Mb of hard disk space m Integrated Configuration only You need to install Orbix v2 3 c from IONA Technologies PLC Orbix v2 3 c requires 70 Mb of hard disk space m Create a new ezCallerID System Administrator User ID for your UNIX system We recommend the User ID of CNAM m Ensure that these UNIX commands are available to the CNAM User ID profile rm Delete files tar Copy files from tape df Determine amount of disk space available awk Pattern matching program tail tnxtract information from file s records grep Find literal match to string in files host id Get hexadecimal number of host server chown Change file ownership chgrp Change file ownership to new group hostname Determine na
33. the schedule 5 Next you enter the UpStream Frequency Your options are the same as the DownLoad Frequency This determines how often information is returned from the Service Center Entering UpStream Frequency This determines how often information is returned from the Service Center Note You can schedule the UpStream to occur dialy or by a time period Not Both Decied which method to use then see below for directions 4 10 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers For Daily Schedule The options are the same for UpStream as for DownStream Follow through in the to enter the daily UpStream Schedule For Periodic Schedule The options are the same for UpStream as for DownStream Follow through in the to enter the daily UpStream Schedule 6 Click OK when you complete all the schedule for the transmissions The DSI information is created an you can now communicate with the Service Center Modifying the DownStream Interface 1 Select DownStream Interface gt Modify DSI The Modify DSI Info window displays 2 Select the appropriate Service Center from the pull down menu 3 Click OK The Modify DSI Info window displays as shown in Figure 4 10 Service Center oooo01 OK Cancel ey Unsigned Java Applet Window Figure 4 10 Modify DSI Info window See for field descriptions 4 Modify the information using the s
34. the tape drive number is different than 1 use the appropriate number November 15 1999 1091 B DRAFT 2 27 Installing ezCallerID ezCallerlID System Administration Manual 4 The terminal console should display the list of files copied to the ezCallerID home file directory distList list of files that are in the DSET tar Z file cnam DSET tar Z_ Contains the ezCallerID application software Script that sets up DSET s product environment and verifies installDSET the system is ready for installing the ezCallerID before executing the instal1CNAM script Script that does the actual installation of the ezCallerID installCNAM application cnam_sm pdf ezCallerID System Administration Manual in PDF format cnam_um pdf ezCallerID User Manual in PDF Format Run the instalIDSET Script 5 Verify the PATH environment variable includes the path to the installation files echo SPATH 6 Change the permissions on the two ezCallerID installation script files chmod 755 installDSET installCNAM 7 Run the first installation script installDSET cnam installCNAM 8 Immediately you receive a set of installation information and a request that asks if you want to proceed with the installation 2 28 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID This installation should be performed by a super user To install DSET products you
35. to send orders x IMPORTANT Contact your SYSTEM ADMINISTRATOR for the DSET GUI information Do you want to use intergrated GUI CORBA TBS OSS solution to create CNAM orders y n y Type a Y if you have installed the Orbix v2 3 c software MetaSolv s TBS software and want to use the integrated installation configuration Note The ezCallerID installation script now creates temporary copies of key configuration files that will edited as you respond to questions in the upcoming installation steps Define ezCallerID Gateway Process Name 4 The script displays the prompt Type th zCallerID gateway process name cnamgw default The value in parenthesis is the default value You must manually type the ezCallerID gateway process name if you want to use a name other than the default The ezCallerID gateway process can not have the name cnamCorbaGw or cnamAsciiGw November 15 1999 1091 B DRAFT 2 35 Installing ezCallerID ezCallerID System Administration Manual 5 Once you type the ezCallerID gateway process name the installation script echoes your response and requests confirmation ezCallerID gateway process name is cnamgw CONFIRMATION Is this process name correct y n y Type Y to confirm the process name or type N to return to the prompt in Step 4 on page 2 35 Define ezCallerID Security Process Name 6 The script displays the prompt Type the security agent process name secAgent def
36. 101 os wm TA Figure 5 5 Index Of log Cnamgw directory window November 15 1999 1091 B DRAFT 5 9 Maintenance and Troubleshooting ezCallerID System Administration Manual Type of Logs The ezCallerID performs five types of activity software event monitoring and security logging The different types of logs generated include Table 5 2 Types of Logs File Name Description Contains logs that show when the IGP receives orders from the gateway or messages errors from the trading partner CnamlgpActivity YY Y YMMDD YYYY is a 4 digit year MM is a 2 digit month DD is a 2 digit day Logs generated primarily for troubleshooting of the ezCallerID Igp CnamlgpTrace YYYYMMDD module It has printed statements at different software checkpoints that is operation entry operation exit and error conditions This file contains security changes made to user ID validation files on SecurityTrace YYYYMMDD the indicated date Contains all user ID logins and logouts as well as ezCallerID s key CnamgwActivity Y YYYMMDD functions of handling CNAM orders Also reflects the ezCallerID orders passed from the CORBA OSS software This file contains error reports or other unusual activities happening in CnamgwTrace YYYYMMDD the ezCallerlD Gateway This log primarily is for troubleshooting It has trace statements at different software checkpoints Directory where CNAM documents reside when the link between the CNAM Gateway and th
37. 5 13 41 DsetCnamapplet jar r 1 169 Mar 3 1999 GEN html r al 176 Sep 16 16 00 SUB html dr x 3 512 Sep 16 15 57 log r 1 634 sug main GEN html r 1 634 Sep main SWB html Root Log Directory Figure 5 3 Index of web server root directory window Figure 5 3 shows the top level directory of the web server It contains the root directory for all the ezCallerID logs and Java HTML software for a specific trading partner In this example the trading partner is Southwestern Bell denoted by SWB Finding Specific ezCalleriD Logs While it is possible to UNIX commands to navigate through the ezCallerID log subdirectories and view individual files the DSET standalone GUI permits you to view the file directory structure and the contents of any log file easily 1 Login to the ezCallerID application see Login to ezCallerID on page 3 1 2 Select the Log gt View command on the ezCallerID primary console window A web browser displays with the Index of the Log file directory as shown in Figure 5 4 November 15 1999 1091 B DRAFT 5 7 Maintenance and Troubleshooting ezCallerID System Administration Manual t Index of log JMONT Netscape OF Xx File Edit View Go Communicator Help 1 e A a a sts ct Back Forward Reload Home Search Netscape Print Security Stop I sy Bookmarks A Location http dallas 6601 og JMONT gt Ga What s Related amp Instant Message E WebMail E Contact People
38. 6 G gateway check status 5 3 define process name 2 35 Graphical User Interface GUI defined A 1 starting DSET application 2 54 GUI See Graphical User Interface H home directories CORBA Orbix software 2 2 CORBA software Orbix 2 37 DSET application 2 2 Oracle software 2 38 home pages DSET application 2 43 2 54 hosts UNIX define CORBA name 2 40 DSET application 2 42 remote CORBA name 2 39 1091 B DRAFT Index 3 Index HTTP Daemon installation port number 2 33 IDL See Interface Definition Language IGP See Interconnectivity Gateway Platform ILEC See Incumbent Local Exchange Carrier Incumbent Local Exchange Carrier ILEC current provider 1 1 defined A 2 naming 2 36 initial steps create service center 2 55 Downstream Interface created 2 55 initialization files Oracle databases 2 11 installation activities done by DSET 2 19 application environment 2 28 assigned port numbers 2 32 backups 2 57 copy files distribution media 2 27 CORBA 2 2 disk space checking 2 29 requirements 2 2 third party software 2 2 DSET script final steps 2 44 instructions 2 29 responses 2 33 environment details 2 30 hardware 2 2 initial hardware and software 2 2 initial sysadmin procedures 2 58 Java browser support 2 2 key configuration decision 2 35 operating system 2 2 Oracle databases preliminary steps 2 20 Index 4 1091 B DRAFT ezCallerID System Administration Manual ready 2 34 order creation configuration 2 35
39. 9 and ezCallingCard are assigned unique TCP IP HTTP daemon and Security Agent port numbers If you know that you already have existing DSET applications running on the UNIX system and you want to install ezCallerID contact the other DSET application System Administrators and determine what port numbers were assigned to each application Table 2 8 An Example of DSET Product Port Numbers DSET Security HTTP TCP IP Application Agent Daemon Application ez911 6500 6501 6502 ezCallerID 6600 6601 6602 ezCallingCard 6700 6701 6702 The HTTP Daemon port number is the value used to access this DSET application with the Web Browser See J Start ezCallerID Web Browser Standalone GUI on page 2 54 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Reponses for ezCallerID Installation Script Table 2 9 ezCallerID Application Installation Responses Response Specific Installation Information Installation Step Oracle software and databases ready Step 2 on page 2 34 CORBA OSS or Standalone GUI Step 3 on page 2 35 ezCallerID gateway process name Step 4 on page 2 35 ezCallerID Security Agent process name Step 6 on page 2 36 ILEC Designation Step 8 on page 2 36 CORBA OSS Only Orbix CORBA software home directory pathname Step 11 on page 2 38 Oracle server v8 0 5 software home directory pathname Step 12 on page 2 38 TCP IP port number of th
40. CallerhD ap creires iisi asees i ano Er r ET Eer ESE EE r EERTE EE ESS 3 7 Organization of Menu Commands ccccesesseeseescsscsesssesecsecssessssecsesssesessesessesscsesssessesesseseseeeseees 3 8 Thesei ce Center aee a ara feb ce are ae a e dete ae araen E eaP o S aE n 3 9 Viewing the Data Transfer Schedule eee isnie essipessi Tenita iess reri Esses 3 11 DownStream Frequency Details eee eceseesceseeceeceeceseseeeeceeeeseseeeeesesesseesaessaecaeesaeeaes 3 12 Default System Administrator User ID and Passwords 00 eeeeeecseeseeeeeeeeeeneeseeeneeaeeaes 3 15 Navigation eo ineert e erna Se E E E cmetoticaens tity E Melee 3 15 November 15 1999 1091 B DRAFT vii Contents ezCallerID System Administration Manual Privilege DA E E E Last sachs TEE ibe scgvesb aca scehsch us tdvets shesceesbdavtuesansusbans stoves 3 17 Operation CodeS essnee itn ee E E E E I ohh on dee 3 17 Privilege Level Sample srecen ieii epe aae E E EE E E R aS 3 18 Creatine Privilege evels 34 iiscra iin cietieah dst eat E EE E E I ao 3 19 What to Do Nex AE E T ET ET 3 20 Deleting Privilege Levels rrinin hh ane n E E Ee EE desea ee bebbee onan 3 23 Creating a User ID and Assigning a Privilege Level eeeececeeeceeeeeeeeneeseecneesaeaee 3 24 Changing Passwords vs i ciscs csc ccs cedccac ss aiaes ses cate casei lub cuvoecs sess deh E EE AE 3 24 Modifying the Privilege Level Assigned to a User ID 00 eee eeeeceneeeeeeseecnecneenaeenees 3 25 Viewing All User IDs
41. D Documents window N ezCallerlD Document Info x OTC Number SC jinn NPA NXX LINE Value 214 jpzo a36 OCN 2222 RAO pa Calling Name MyName ss Transaction Type ji Presentation Indicator IR Effective Date wal a A iy Unsigned Java Applet Window Figure B 17 ezCallerID Documents Info window C 12 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual EXISTING CATALOG FROM SYSTEM ADMIN MANUAL Privilege Levels Screens Creating New Privilege Levels Access by Admin gt Privilege gt Create November 15 1999 1091 B DRAFT Catalog of Windows and Fields C 13 Catalog of Windows and Fields ezCallerID System Administration Manual Privilege Operations N Privelege Level Create Ea Privilege Level Privilege Type Privilege Level Create Privilege Level Modi E2 4 OK Cancel Ey Unsigned Java Applet Window Figure B 18 Privilege Level Create window Table B 6 Field Value Constraints for Privilege Level Create Window Field Name Length Type Description possible values Privilege Level Up to 8 digits The privilege level indicator that determines the functions a user can perform Privilege Type 100 alphanumeric characters A description of the functions a user can perform when given this privilege level Privilege Operations Choose from the list Modifying Privilege Level Access by Admin gt Privilege gt Modify C 14 1091 B DRAFT A se
42. E E ESEESE on page 2 46 November 15 1999 1091 B DRAFT 2 1 Installing ezCallerID ezCallerID System Administration Manual Pre Installation Tasks Complete the ezCallerID Pre Installation Checklist before you create Oracle databases prepare the Basic DSET environment install the ezCallerID application and perform post installation operations Table 2 1 ezCallerID Pre Installation Checklist Check here if you have this Installation Requirement Oo Server Sun SPARC 20 Central Processing Unit CPU or better Minimum of 128 Mb of RAM Minimum of 150 Mb hard disk space for ezCallerID software Minimum of 230 Mb hard disk space for optional Orbix TBS and Oracle software SUN Solaris 2 5 1 or later with all year 2000 patches installed UNIX Korn Shell ksh Industry Standard Uy o o o o o An Internet browser that supports Java applets Java Developers Kit 1 1 5 or later DSET recommends Netscape Communicator version 4 06 or later or Internet Explorer version 4 15 or later m The DSET ezCallerID installation tape 4mm or 8mm or CD ROM containing the ezCallerID 2 0 software m CORBA OSS only If you intend to use the MetaSolv Telecom Business Soluion TBS application you must have TBS v4 0 1 software mj CORBA OSS only If you have chosen to create an integrated solution you need to have the UNIX Orbix v2 3 c software from IONA Technologies PLC u CORBA OSS on
43. FROM THE CHAPTER Default System Administrator User ID and Passwords When you installed ezCallerID two User IDs and passwords with System Administrator Privilege Level zero were defined All USer IDs and Passwords are case sensitive For mor information on Passwords see Choosing Acceptable Passwords on page 3 5 Table 3 1 Default User IDs and Passwords User ID Password s adm00 SEC ADM1 n adm10 NET ADM1 Navigation This illustration may assist you with finding your way around tin the ezCallerID November 15 1999 1091 B DRAFT 3 15 Defining Users and Privilege Levels Figure 3 17 Navigation for ezCallerID 3 16 1091 B DRAFT ezCallerID System Administration Manual November 15 1999 ezCallerlID System Administration Manual Defining Users and Privilege Levels Privilege Levels Users are entered into the system based on the privilege level determined by the administrator The administrator determines which functionality is enabled for each privilege level For example privilege level 1 may have view only permission for the entire system Users at this level are unable to enter any data or save any material Similarly a user with privilege level 6 may have edit and save permissions for any files in the system Operation Codes The administrator creates privilege levels based on the Operations Codes Each menu option in the GUI is assigned an Operation Code as shown in the Privilege Operation Codes Table The admi
44. Local Exchange Carrier ILEC to change the service There are many pieces of information that are part of telephone service one of these pieces is the Line Information Database LIDB information It contains information relating to the customer s name calling card security code and third party billing Background Information November 15 1999 A telephony service provider uses a Line Information Database LIDB to store subscriber data for a set of telephony services Line Information Database services can include Alternative Billing Services ABS Calling Card Service 3rd Party Billing Service Collect Billing Service Calling Name CNAM IntraLATA Presubscribed Carrier ILP local long distance carrier information Originating Line Number Screening OLNS defines calling restrictions on an originating line Specific Call Number Blocking SCNB defines blocking calls for numbers or sets of numbers 1091 B DRAFT 1 1 Introducing ezCallerID ezCallerID System Administration Manual e GetData defines custom services and data set up In addition to being a repository for subscriber data LIDBs are revenue generating entities for the their owners For example a customer subscribes to calling name presentation When this subscriber originates a call the called party s CNAM data must be retrieved from a LIDB There is a fee charged for accessing this information The database accesses are frequently referre
45. M orders 5 2 Oracle directory pathnames 2 9 Oracle CORBA validate 2 49 setting 2 47 validate for DSET 2 48 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual examples activity log contents 5 11 5 12 activity log shows order 2 57 application port numbers 2 32 CORBA process active 2 52 5 4 DSET application startup 2 53 DSET processes running 2 53 environment variables CORBA 2 49 DSET application 2 49 Oracle software 2 50 log file names 5 9 shared object libraries 2 51 F field descriptions displayed in status area xx file directories application processes 2 26 application configuration 2 26 application logs 5 8 CNAM orders in Oracle 5 2 CORBA software 2 37 DSET applications 2 24 DSET databases 2 10 DSET installation 2 2 2 24 DSET product subdirectories 2 25 gateway activity 5 8 logs 2 26 Oracle databases administration 2 10 SQL scripts 2 26 Oracle environment variables 2 9 Oracle software 2 9 2 38 organization for logs 2 27 5 6 5 22 security actions 5 8 shared library paths 2 50 trading partner ILEC 2 36 2 37 November 15 1999 Index files DSET application home page 2 43 listener 2 18 Oracle databases init config 2 11 init config file links 2 12 links to startup 2 12 listener 2 17 scripts to create 2 12 TNS names 2 15 profile holds environment variables 2 47 TNS names 2 15 trading partners naming conventions 2 18 finding Oracle software patches 2 5 frequencies 3 13 4 1
46. OSS software 2 2 overview 2 1 planning checklist 2 2 possible configurations xix 2 23 post install tasks 2 46 RAM memory 2 2 references 2 3 relational database 2 2 requires Oracle 8 software 2 34 Security Agent process name 2 36 specify trading partner 2 36 third party software 2 4 UNIX commands required 2 22 integrated configuration choose during installation 2 35 definition 2 23 libraries required 2 51 requirements 2 22 Interconnectivity Gateway Platform IGP defined A 1 Interface Definition Language IDL Caller ID customer records 1 7 defined A 1 Internet Browser See Web Browser intervals jeopardy 1 5 provisioning 1 5 ade Java Applets supported byweb browser 2 2 jeopardy interval can miss due date 1 5 K keyboard keys typographical conventions xviii November 15 1999 ezCallerID System Administration Manual Korn shell source variables automatically 2 47 L libraries required for configuration 2 51 links overwriting existing 2 12 login connecting user to ezCallerID 3 1 logs activity order received 2 57 CNAM order activity 5 10 directories 5 8 directory structure 2 27 5 6 5 22 documents through gateway 5 10 examples of names 5 9 file directories 2 26 security actions performed 5 10 security activity 5 8 trace actions for orders 5 10 trace IGP software actions 5 8 5 10 tracking a service order 5 7 types for DSET applications 5 10 M manual changes xix menus overview of ezCallerID command
47. Plus are trademarks of Oracle Corporation Microsoft Windows Windows NT and Explorer are trademarks of Microsoft Corporation UNIX is a registered trademark in the United States licensed exclusively through X Open Company Limited Acrobat is a trademark of Adobe SPARC and Solaris are registered trademarks of Sun Microsystems Inc Java and all Java based name including HotJava and Java Developers Kit JDK are trademarks of Sun Microsystems Inc All other products or services mentioned in this manual are covered by the trademarks service marks or product names as designated by the companies who market those products Product Updates It is the policy of DSET to improve products as new technology software hardware and firmware become available DSET therefore reserves the right to change specification without prior notice All features functions and operation describe herein may not be available worldwide For Technical Support call the Technical Assistance Center TAC 877 ASK DSET ezCallerID Software Version 2 0 System Administration Manual Issue Date November 15 1999 Manual Number 1091 B DRAFT ezCallerlID System Administration Manual Contents PLefACE AE TE E OT NE O E O O AAT E xvii Ab t This Mantal enei temaren oats ava a e o r e E eai aa a ie Ga cok senate xvii Vaalo Ta 1e S AREER TEE TAEA A T xvii Where to Find Information in the Manual s sesseeeeeeseeeeeees
48. RAFT November 15 1999 ezCallerID System Administration Manual Index A Acrobat Reader displays online manual xviii activity logs example contents 5 11 5 12 allocate disk space Oracle databases 2 12 application installation See installation applications components 1 7 documentation 2 28 DSET gateway Oracle performance 5 25 DSET log directories 5 8 environment creating 2 22 established 2 28 installation 2 22 required information 2 23 variables 2 48 gateway startup 2 53 home directory 2 2 login 3 1 naming conventions 2 18 uninstalling 2 58 UNIX crash 5 14 UNIX User ID 2 22 B backups DSET installation 2 57 books references for installation 2 3 November 15 1999 browser access See web browser C Calling Name Delivery CNAM defined A 1 CD ROM DSET installation 2 27 check disk space 5 2 status 5 3 checking disk space 5 1 process health 5 3 checklist planning for installation 2 2 clean up Oracle databases reasons 5 27 CLEC See Competitive Local Exchange Carrier CNAM See ezCallerID commands df and du 5 2 non functional 3 8 Competitive Local Exchange Carrier CLEC defined A 1 new provider 1 1 configuration choices available 2 23 integrated CORBA OSS 2 23 2 35 standalone GUI 2 54 configuration files DSET application 2 26 ILEC trading partners 2 19 Oracle databases 2 11 conventions typographical xviii 1091 B DRAFT Index 1 Index CORBA check process 2 52 definition A 1 gateway 2 2
49. RAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID argvO oracleCNSECDB args DESCRIPTION LOCAL YES ADDRESS PROTOCOL BEQ envs ORACLE_HOME export u02 oracle app oracle product 8 0 5 ORACLE_SID CNSECDB Gl Edit the Oracle Listener File Each Oracle server on a network must contain a listener ora file This file lists the names and addresses of all of the TNS listener processes on the machine and the instances they support 28 Change to the Oracle file directory that contains the file listener ora cd SORACLE LISTENER 29 Using a UNIX text editor go to the Instance Definitions section denoted by the words SID_LIST_LISTENER 30 Make two copies of an instance description and insert the two Oracle database instance names CNAM and CNSECDB SID_DESC GLOBAL _DBNAME gorda dal dset com ORACLE_HOME export u02 oracle app oracle product 8 0 5 SID_NAME CNAM T SID_DESC GLOBAL_DBNAME gorda dal dset com ORACLE_HOME export u02 oracle app oracle product 8 0 5 November 15 1999 1091 B DRAFT 2 17 Installing ezCallerID ezCallerID System Administration Manual SID_NAME CNSECDB Start the Listener 31 First stop the Oracle listener and then restart the process login as the Oracle user sqlplus dbadm dbadm Ilsnrctl stop
50. SWB Southwestern Bell might look like lt ezCallerID Install Directory gt cnam www cnam log SWB Note Define the CORBA Software Home Directory Important Contact your UNIX System Administrator for the IONA Orbix directory path 10 If you have chosen to configure the ezCallerID application to use the CORBA OSS integrated configuration the installation script displays the explanation IONA is a company which provides a CORBA application Orbix R To start the ezCallerID CNAM gateway you need provide the UNIX pathname of the top level directory for the IONA software package Often th following directories are used for IONA software tools iona default for DSET installation opt iona or opt iona Orbix X X where X X is software release the complete path to the IONA Orbix top level directory tools iona Type Figure 2 4 Orbix Home Directory Instructions Type the home directory for the CORBA software produced by IONA Technologies PLC You must manually type the home directory name November 15 1999 1091 B DRAFT 2 37 Installing ezCallerID ezCallerlID System Administration Manual 11 Once you type the Orbix home directory the installation script echoes your response and requests confirmation Path to IONA home is opt iona OrbixMT_2 3c CONFIRMATION is this correct pathname y n y Type Y to confirm the Orbix software home directory pathname or type N to return to the prompt
51. T November 15 1999 ezCallerID System Administration Manual Introducing ezCallerID DSET s Current LIDB Service Gateways Overview DSET currently offers two LIDB gateway products ezCallingCard and ezCallerID These gateways are designed to bridge the gap between a CLEC s OSS and Iluminet Illuminent is a company with a Signaling System 7 SS7 network and access or access agreements to the LIDBs for each of the ILECs Illuminet provides a standard interface and protocol for all CLECs and hides the details necessary to access the individual Line Information Databases Illuminet provides CLECs the ability to update LIDBs with CNAM ABS and OLNS feature information Version 1 0 of the ezCallerID supports a browser based graphical user interface GUD for ezCallerID customer order data entry and viewing It collects the orders stores them locally creates data transfer files and sends the files to IIluminet The ezCallingCard gateway supports features similar to the ezCallerID There is no gateway at this time for changing OLNS data Illuminet does not presently support the file transfer protocol FTP for sending the Customer orders are saved in ASCII format on diskettes and sent to Iluminet An ezCallerID transaction works like this 1 Customer wants to add change or delete calling name information 2 The request is entered either directly in the ezCallerID or through an existing system which communicates with the Operating Supp
52. al is configurable from the ezCallerID interface When the Collector receives the ezCallerID request it invokes the Translator component of the DSI Translator The Translator converts the ezCallerID request in the Collector from ezCallerID format to ASCII format for the UFS The Translator also reads the Notification and Error messages arriving in the opposite direction from the Service Center These are converted from ASCII format back to the ezCallerID format Information Types November 15 1999 There are two types of information transmitted between the Service Center and the ezCallerID Each type of information glows in a specific direction e ezCallerID Request information ezCallerID request flows are called Downloads the information in the ezCallerID request travels from the ezCallerID down to the Service Center e Notification Message information Notification messages flow are called Uploads the message travels from the Service Center up to the ezCallerID 1091 B DRAFT 1 11 Introducing ezCallerID ezCallerID System Administration Manual The ezCallerlID Requests Download This illustrates the ezCallerID request download process Figure 1 3 Download Process of ezCallerlID requests 1 12 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Introducing ezCallerID The Servic November 15 1999 e Center The Service Center is similar to an electronic mail drop ILECs deposit Caller ID documen
53. am invoked on pts 2 by cnam Date Mon Nov 1 18 59 07 CST 1999 Checking for environment variables Killing Process Id 4820 CNAM successfully shutdown 2 When all processes have stopped restart the ezCallerID Gateway by typing command SDP_DIR cnam bin cnam start November 15 1999 1091 B DRAFT 5 15 Maintenance and Troubleshooting ezCallerID System Administration Manual Manually Ending ezCallerID Processes Note If executing the cnam stop script does not end all the ezCallerID gateway processes you can manually stop the processes using the ps and kill 2 commands Manually stop the process IDs for the following processes thttpd startup namemgr cnamgw secAgent and cnamIgp 3 Ifthe ezCallerID application was not successfully started you may receive this message and need to manually terminate the application processes with the kill command ezConnect home cnam cnam2 0 6 cnam d dir files CNAM start pid cnam does not exist You may not have started CNAM 4 If not determine the process identification number for individual process names with the command ps ef grep lt ezCallerID_process_name gt The Process Identification PID is listed 5 Using the PID number from Step 4 terminate the process with the command kill 2 lt ezCallerID_process_name PID gt This last line means you need to find the process that belongs to the owner cnam and manually kill this process 6 Make sure ALL ezCallerID processes have st
54. ame method as you created it See Creating the DownStream Interface on page 4 5 5 Click OK when finished November 15 1999 1091 B DRAFT 4 11 Communicating with Service Centers ezCallerID System Administration Manual END OF EXISTING MATERIAL IN SYSTEM ADMIN GUIDE STUFF FROM USER MANUAL A Service Center is the communication link between you and the Line Information Database LIDB It is needed to port exchange telephone number information It works similar to an electronic mail box You use DSET s ezCallerID to request changes to a customer s caller ID information and the request is manually sent via email to a Service Center The Service Center is a hub for the clearinghouse to confirm data with the LIDB and transfer the information back to the CLEC Only the System Administrator can create a Service Center however you can display information about it For assistance with logging into ezCallerID see Login to ezCallerID on page 3 1 4 12 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers Viewing the List of Service Centers You can display a list of all Service Centers This information cannot be changed 1 Select Service Centers gt View all Service Centers A list of all Service Centers display as shown in Figure 4 11 Service Center Name Description 333333 test OK E Unsign
55. ariables that Define Oracle Directory Pathnames ieee eeeereeseeeseeeees 2 9 ezCallerID Basic DSET Environment 0 ceeeeeseeencceseeeeeceeeeceseeeneeceeeecneeeeaeens 2 22 Third party Information for ezCallerID Installation Script eee eects 2 23 eZCallerID Product Subdirectories cessesececsceeseceeeeceseceececereeeseceeneeseeesaeeeees 2 25 An Example of DSET Product Port Numbers 00 0 0 see ceesseceseeseceeceseeeeeeeeeeeeeaes 2 32 ezCallerID Application Installation Responses 0 c ec eseeeeseeesceeeeeeseeeeseeeneenes 2 33 ezCallerID Post Installation Steps 0 0 eee eeceseeeeecseeeseceeeseceecsseeeceseeereeeeeeeeees 2 46 DSET ezCallerID Application Environment Variables 0 cee eeeeeeeseeereeeee 2 48 Default User IDs and Passwords c ccssccesseceseecsseeeeceeseeecseceeeceseeenaeceneecneeeeneens 3 15 Privilege Operation COMES ess e0 eisereen aenep dene eiee ori aea EnS S E eSEE 3 17 Privilege Level Samplesinnecnnreni n a E E E E EE 3 18 Log Directories inre e a E R A dais E E RA 5 8 Types of EOS ern Relies eee AN E O E A E 5 10 ezCallerID Problem Determination sssessssssesseseseeeeseseeseesereseeseesserseesrensersressesse 5 13 LE KOTSE T in E EE NEEE EE EE NEEE EEE eae E hs So a es A 1 Field Constraints for Create Service window csccessscesseceeeeceseeeeeeeteeenaeeeeeeees C 1 Field Value Constraints for Create DSI Information Window escceesceeeees C 3 Field Value
56. ateway 2 56 viewing data transfer schedules 3 11 4 14 online manual xviii W waiting period changing config file 2 41 extract OSS orders 2 40 web browser accessing DSET application 2 54 login to ezCallerID 3 1 requires Java applet support 2 2 Web server thttpd daemon B 8 WeekMask schedule 3 13 4 16 WeekMask See DownStream Interface 1091 B DRAFT Index 9 Index ezCallerID System Administration Manual windows Activity Log Detail 5 11 5 12 Create DSi C 3 Create Service Center C 1 DSI Info 3 12 4 15 C 7 ezCallerID Create C 10 ezCallerID Documents C 12 ezCallerID Documents Info C 12 ezCallerID Gateway Console 3 4 Get DSI Info 3 11 4 14 C 7 Get ezCallerID Documents C 12 Index of Activity logs directory 5 9 Interval C 5 Interval periodic frequency 3 14 4 17 Interval viewing C 9 Interval of Day 3 14 4 17 C 5 log directories 5 8 Login Response 3 4 Logout 3 7 Modify DSI Info C 6 Modify DSI Info details C 6 Service Center Info 3 10 4 13 C 2 Service Centers 3 9 4 13 C 2 top level server root 5 7 Week Mask 3 13 4 16 Week Mask create schedules C 4 Week Mask viewing C 8 Index 10 1091 B DRAFT November 15 1999 1999 DSET Corporation ezCallerID System Administration Manual September 1999 1091 B DRAFT
57. ault The value in parenthesis is the default value You must manually type the Security Agent process name if you want to use a name other than the default 7 Once you choose the security agent process name the installation script echoes your response and requests confirmation security agent process name is SecAgent CONFIRMATION Is this security process name correct y n y Type Y to confirm the process name or type N to return to the prompt in Step 6 on page 2 36 Define Trading Partner ILEC 8 The installation script next displays 5a Q The ILEC_NAME identifies the name of an IL For example BAN may be used to identify Bell Atlantic SWB may be used to identify Southwestern Bell Type the ILEC name SWB Type the ILEC designation you want to use 2 36 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID 9 Once you choose the ILEC designation the installation script echoes your typed response and requests confirmation ILEC_NAME name you ve typed is SWB CONFIRMATION Is this ILEC name correct y n y Type Y to confirm the ILEC name or type N to return to the prompt in Step 8 on page 2 36 Figure 2 2 shows the UNIX directory structure created by the installation script based upon the ILEC name trading partner specified For example the directory pathname for the ezCallerID logs that belong to an ILEC named
58. ay transfer StartHr StartMin StopHr StopMin men ox ey Unsigned Java Applet Window Figure 3 14 Week Mask window See UNRESOLVED XREF for field descriptions 3 Select the text line under the day of the week by clicking 4 Double click on a text line to view the start and stop transmission reception times The Intervals of Day window displays in Figure 3 15 November 15 1999 1091 B DRAFT 3 13 Defining Users and Privilege Levels ezCallerID System Administration Manual Start fe hour oo min Stop 10 hour ool min OK Cancel Ey J Unsigned Java Applet Window Figure 3 15 Interval of Day window See UNRESOLVED XREF for field descriptions c Click OK to close the Interval of Day window Periodic This option controls the transfer of ezCallerID documents by time interval 1 Hold down the lt Shift gt key and click the periodic line to select it 2 If you double clicked the Periodic Frequency see Figure 3 13 the Interval window displays as shown in Figure 3 16 N Interval Ea 180 seconds OK Cancel Frequency interval j Unsigned Java Applet Window Figure 3 16 Interval window These Frequency settings tell the ezCallerID to transfer data every n seconds 3 Click OK to exit the windows 3 14 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels ALL BELOW HERE IS SYSTEM ADMIN PRIVILEGES INFORMATION
59. ber 27 The installation script needs to configure the Web Server startup file with the HTTP Daemon Port Number The script prompts you with the text To communicate with the ezCallerID Gateway from outside world you need to specify an HTTP port number This port number plus the hostname permits you to connect to the ezCallerID gateway Operations personnel will use Netscape Communicator 4 6 or later or Internet Explorer 4 15 or later to start the ezCalleriId GUI This HTTP port number SHOULD BE greater than 1024 and less than 99999 Type th zCallerID HTTP port number 7777 default The value in parenthesis is the default value You must type the HTTP Daemon Port Number name if you want to use a port number other than the default 28 Once you choose the HTTP Daemon Port Number the installation script echoes your response and requests confirmation ezCallerID HTTP port number is 6601 CONFIRMATION Is this HTTP port number correct y n November 15 1999 1091 B DRAFT 2 43 Installing ezCallerID ezCallerID System Administration Manual Type Y to confirm the HTTP Daemon Port Number or type N to return to the last portion of the prompt in Step 27 on page 2 43 Finishing the ezCallerID Installation Script You have finished providing all the information required by the ezCallerID application installation script Depending upon the installation configuration chosen OSS and or Oracle Database the installation sc
60. ccess the log files directly using UNIX commands 21 Find the top level log directory for this ILEC trading partner cd SDP_DR lt Install_Dir gt cnam www cnam log lt ILEC name gt 22 Switch to the gateway log directory with the command cd Cnamigp 23 Select the Activity Log for the date you created the CNAM order An example log for documents plus other application activity August 10 1999 would be found in the file with the name CNAMActivity 19990810 2 56 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID 24 Display the log file contents and look for this pattern to indicate order document information IGP agent New Document Received essageData OCT_STR len 282 ESSAGE cNamCreate_ nsid 3 hkey 1111111111 source n adml10 dest octnum 111111 npa 972 TKS 1 line 1112 recType 2 recSType 00 tType I piIndicator A cName John Doe ocr 1a bsp rao 2224 effdate 081199 m Figure 2 7 Portion of the Activity Log 25 Display the contents of the gateway trace log that corresponds to the document creation date An example log for August 10 1999 would be found in the file with the name CNAMActivity 19990810 cd Cnamgw N Backup Installation Directories 26 Once you have verified correct operation of the ezCallerID application use these UNIX commands to create a backup of the DSET product installatio
61. cneecseceeaeceecseceeceseeereeeeseesenes C 6 Figure B 10 Get DSI Info window inla n E E N E RRRS R C 7 Figure B 11 DSI Info Wind OW iss tees castes Seessenseeten a versons dev R E tioewe R N C 7 Figure B 12 Week Mask wWindow ccccecessecssessecesceseessceseeesceseeeeecaeecaecsaesaecseceaeceeseseeereeeeeeasenes C 8 Figure B 13 Interval Win OW ee ieee e R eaa e schsvsevedeabesten sd par o EEEE SEEE SEERE O RKN eerste C 9 Figure B 14 eZCallerID Create Window 00 eee ceeesecseceseeeeceseeeeceeeeeeseaeseeeeseesaecaecnaesaeesaees C 10 Figure B 15 Get ezCallerID Documents Window 0 00 0 ec ceseeceseeeeceeeeeeeeeeeeeecaeeseecaeesaecaeenaee C 12 xii 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual List of Figures Figure B 16 Figure B 17 Figure B 18 Figure B 19 Figure B 20 Figure B 21 Figure B 22 Figure B 23 Figure B 24 Figure B 25 November 15 1999 eZCallerID Documents WindOW 2000 eee ceeeeseceeceseeseceeceeceseeseseaeeseesaeesaecaeenaeeaes C 12 ezCallerID Documents Info Window 0 0 00 ec eececeeeeeeceseeeeeeseeeeecaeesaecneeaeenees C 12 Privilege Level Create Window eeeeeceecscessecscessececeseeseceseeeseseeseseaseaeseneeaes C 14 Privilege Level Modify window 00 cece eseececeseceeceseeeeceseseeeeseseaecaeesaecsecnaeenees C 15 Privilege Level View Request Window cccecesesceceeeceeeeseeeeeeseeeseeseecaeesaenaee C 15 Privilege Level View Window cceccecceseesecseessecsees
62. cript asks if you have the Oracle 8 Database Software Th zCaller Gateway installation needs ORACLE database software to store the customer orders Your Oracle DBA must also create two databases before you use th zCallerID Gateway Do you have Oracle 8 software and databases installed for ezCallerID gateway y n 2 Type Y to confirm that you have the Oracle 8 Enterprise Server Software see Oracle Server Software on page 2 5 plus you have created the two DSET Oracle databases CNAM and CNSECDB see Overview Creating Oracle DSET ezCallerID Databases on page 2 8 or type N to stop the ezCallerID application installation You receive this message from the installation script Error Need install the Oracle software and create the databases before you use ezCallerID Gateway EZCALLERID GATEWAY CONFIGURATION FAILED 2 34 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID CORBA OSS or Standalone GUI to Create Orders 3 The script displays the CORBA OSS or standalone GUI software question To receiv zCallerID CNAM orders th zCaller Gateway can communicate with a CORBA Operational Support System OSS or a standalone GUI For the CORBA OSS you must have the MetaSolv TBS 4 0 1 software and Orbix v2 3 c software installed to send orders to th zCaller Gateway Tf the CORBA software is not installed DSET s stand alone GUI can be used
63. d T Set ORACLE_SID variable by typing export ORACLE_SID CNSECDB 2 Start the CNAM Security Database with the Oracle server manager with commands svrmgrl connect internal startup exit out of the Oracle server manager 1091 B D RAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting 3 Login as oracle User ID unless you did it in Step 1 and start the Listener by typing the commands Ilsnrctl stop lsnrctl start exit 4 Run the scripts to define the ezCallerID security CNSECDB Oracle database tables cd DP_DIR cnam schema export SSEC_DB_NAME CNSECDB regSch sql dbadm dbadm CNSECDB SDP_DIR cnam schema regSecSch sql gt gt dev null lt continuation of command gt 5 Use these commands in a script to test for successful manual registration if 0 then echo echo Warning register SSEC_DB_NAME schema failed echo There may be permission problems echo else echo echo Register th zCallerID CNAM Oracle database echo schema is done echo fa Cleaning Up Oracle DB Schema November 15 1999 Cleaning up the Oracle database schema involves dropping the tables and the records This is sometimes necessary if the schema provided in on the DSET distribution media has to be changed for any of these reasons e Tablespaces for the database tables need to be modified e Table indexing must to be changed to ensure better perf
64. d Note The namemgr executable is in DP_DIR cnam d dir bin directory Log Directories The log directories in DP_DIR cnam www cnam log November 15 1999 cnamigp chamgw Security 1091 B DRAFT B 3 Technical Reference ezCallerID System Administration Manual Startup Script B 4 This script CNAM startup invokes and monitors the four component processes of ezCallerID If any one of the five processes stops the startup script stops all processes and restarts them The five processes invoked by the startup script are e _ d dir bin namemgr e secAgent e cnamIgp e cnamgw e thttpd These processes should be running at all times when the exCallerID Gateway is running To start the exCallerID Gateway use the UNIX system where it resides Start in directory DP_DIR cnam bin Enter script cnam start The following is a sample of the output if cnam startup is running cnamadm 13461 1 0 Dec 04 pts 20 0 00 startup export home cnamadm cnamGW cnam config cnam startup DO NOT EDIT this script Unlike the other scripts cnam startup is a script that should NOT be edited None of the variables relate directly to machines outside the exCallerID Gateway therefore changing variables without checking the Gateway s internal processes would be likely to incapacitate the system You may need to check the script to see whether all four processes are running and whether all the processes are referring correctly to the
65. d see a response similar to the following lines for the two Oracle databases CNAM and CNSECDB 1 0 16 45 13 3 06 oracleCNAM 11 ora_dbw0_CN LOCAL NO 0 Oct 26 0 A 0 Oct 26 0 04 ora_pmon_CNA 0 Oct 26 0 12 ora_lgwr_CNA Oct 26 2 40 ora_ckpt_CNA 0 A 0 A Oct 26 13 ora_smon_CN Oct 26 02 ora_reco_CN EENES ETE Oc Oc Oc Oc Oc Oc 26 2 04 ora_pmon_ 26 2 00 ora_dbw0_C 26 7 02 26 7 S25 26 214 26 7 02 BPO CT AEE ee e Figure 5 1 Example Console Output for Oracle Databases 5 4 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Viewing ezCallerID Logs Application Operation To track a CNAM order the System Administrator and key operations personnel use DSET s extensive event logging facility to monitor each step of the order transmission You can view log files to determine how an ezCallerID request is progressing Also if something goes wrong and an ezCallerID request is not processed you can determine where the problem occurred by displaying the log files To view the log files from any web browser the files should be located in a directory that is accessible to the web server Log Directory Structure November 15 1999 All processes in the ezCallerID read a configuration file to determine the UNIX directory where log files are created for each trading partner At installation you created a directory
66. d to as dips Each dip into a LIDB results in revenue for the LIDB owner CLECs have several options available for building and maintenance of LIDBs e Share LIDBs with the ILECs thus sharing revenue from dips e Contract the LIDB out to 3rd party companies e Build and maintain the LIDBs in house Regardless of how the CLECs maintain their LIDBs updates to the LIDBs are required whenever customer is added modified or deleteed from their network Using a software interface with data entry validation instead of a manual error prone and time consuming procedure and an electronic data transfer gateway results in faster Line Database updates and generates CLEC revenue faster The time spent filling out paper forms faxing or mailing forms to the LIDB entity and making corrections is eliminated reducing staff expenses for the CLEC The Market The Telecom Act of 1996 opened up the local telephone market to competition Presently there are 250 300 facilities based Competitive Local Exchange Carriers CLECs Unlike the Local Number Portability LNP and E911 federal mandates LIDBs are an optional service However since they are revenue generating entities CLECs are likely to deploy LIDBs in some form as soon as possible Based on features offered by the ILECs e CNAM and ABS are a high priority LIDB data for residential subscribers e OLNS and SCNB are more important LIDB data to maintain for business subscribers 1 2 1091 B DRAF
67. e Directories 2 24 To understand where all the software components of a DSET application will be installed you need to understand the recommended UNIX file directory structure The high level organization is useful for completing the ezCallerID application installation Knowing where the application scripts and log files reside will be useful when you perform daily maintenance operations and troubleshooting This figure shows an example directory structure that illustrates the difference between the Installation Directory the Product Directory and the Product Subdirectory 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID CNAM2 0 cnam bin libCNAMbeh so Installation Product Product Filename Directory Directory Subdirectory Figure 2 1 Example DSET UNIX Product Directory Structure High level Directory Organization DSET products have seven Product Subdirectories located under the application s home directory If the product directory was defined as cnam the resultant subdirectories would be Table 2 7 ezCallerID Product Subdirectories Product Subdirectory Contents Names cnam bin Software executables that make up the ezCallerlID product Security IGP and gateway configuration files There is often a cnam config generic set of files and a set of files for a specific trading partner The application st art up script also resides in this directory cnam d dir S
68. e Level View Response window appears aas shown in Figure 3 21 N Privilege Level View Response x Privilege Level 2 Privilege Type all Privilege Operations 100 101 102 11 OK ey Unsigned Java Applet Window Figure 3 21 Privilege Level View Response window See for field definitions The Privilege Level Details window is read only you cannot edit the fields See Table 3 2 on page 3 17 for a description of Operation Codes 3 Click OK to close the windows 3 22 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Deleting Privilege Levels The administrator can also delete privilege levels that are no longer needed 1 Select Admin gt Privilege gt Delete The Privilege Level Delete window displays N Privilege Level Delete x Privilege Level OK Cancel ey Unsigned Java Applet Window Figure 3 22 Privilege Level Delete window 2 Type the Privilege Level being deleted 3 Click OK The Operation Response dialog box displays indicating that the operation was successful N Operation Response x Operation Successful ox ey Unsigned Java Applet Window Figure 3 23 Operation Response window 4 Click OK 5 Click OK to close the window November 15 1999 1091 B DRAFT 3 23 Defining Users and Privilege Levels ezCallerID System Administration Manual Creating a User ID and Assigning a Privile
69. e OSS server is interrupted while transferring a document DROP only for CORBA interface 4 Click the specific log file you want to view From a System Administrator s viewpoint most of the useful information is contained in the CnamgwActivity YYYYMMDD and CnamIgpActivityYYYYMMDD types of logs Exerpts from the contents of several Activity log file displays An example is shown in Figure 5 6 5 Select the View gt Refresh command to update the display of the log contents 6 To stop displaying the log file contents exit the Web browser window The ezCallerID main console window displays 5 10 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting CNAM GW gt gt ACTIVITY LOG lt lt 1999 Nov 12 15 17 18 gt gt No user login Message type FROM OSS MESSAGE IgpLoginReaquest transid 1 authkey 0000000000 source s adm00 dest userid s adm00 passwd SEC ADM1 spid CNAM GW gt gt ACTIVITY LOG lt lt 1999 Nov 12 15 17 29 gt gt User s adm00 Message type FROM OSS MESSAGE CreateAccount transid 2 authkey 1111111111 source s adm00 dest acntName 11111 aText test CNAM GW gt gt ACTIVITY LOG lt lt 1999 Nov 12 15 17 46 gt gt User s adm00 Message type FROM OSS MESSAGE CreateDsi transid 4 authkey 1111111111 source s adm00 dest acntName 11111 protocol ABSENT inQ weekMask ABSENT periodic ABSENT outQ
70. e Service Reps job to check the Logs and be the first line of defense for errors that show there Privilege Level Sample Here is a sample of Privilege Level and Operations Code settings that you may find useful Table 3 3 Privilege Level Sample 1 of 2 Operation User Type Title Privilege Operations Code 0 System All operations are selected This is done automatically during Administrator installation System 1 Administrator Select all operations Assistant 3 18 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Table 3 3 Privilege Level Sample 2 of 2 Operation a 3 Code User Type Title Privilege Operations Select most of the operations Do not select DSI Info Create DSI 2 Manager Info Modify and Account Create Select View Confirmation Data View Outstanding Error Data 3 Supervisor View Account Info DSI Info View Request Activity Log Create E911 View SOI Documents Data Select View Confirmation Data View Outstanding Error Data 4 Senior Service Reps View Account Info DSI Info View Request Activity Log Create E911 View SOI Documents Data Select View Confirmation Data View Outstanding Error Data 5 Service Reps View Account Info View SOI Documents Data Creating Privilege Levels The administrator can create new privilege levels by assigning specific operations to each privilege level 1 Select Admin gt Privilege gt Create
71. e We ae bin bei ie 3 3 LG gin RESPONSE WINGO WW nnie misse i a setts eeu cevau se Ee E E 3 4 eZCallerID Console Window 0 0 0 cccecesceceseeesceeeeeeceseeeeecaeesaeceaesaecneceseeseenseeeeeeeeees 3 4 UserID Login Error Messager iae aa eera a e e euievedeerstievee teak s 3 5 User Password Modify window eesessesesssessesssseeresrenrsresreressesrsserensrerrsresesrenreresee 3 6 Logout Window sonnei eenas ER E E RE A A E 3 7 ezCallerID Menu CommandS e seseeeesseeesesessrsssterrsrerrsresrerenesrnrerersreresreresrenereesee 3 8 Service Genters WINDOW seeds oc ereere esera reme Sre Neen EEE Ey See PEE YE Ee EEEn 3 9 Service Center Info window sseessesseessseeesseessresesererserrstertrtenrerreeeresenresesresreer 3 10 Get DSL Info Window ticccsseess se sseteeeiievibeneedesrmetegione seston eka es musde E a E aR 3 11 DSH Info windows eia he de ea ee ee i ch oe eo ee S 3 12 Week Mask window vices ecreis eresse eepe tie pisoi i eane Ee S Se E ER 3 13 Interval of Day window sssesssseesesseessseersresesrsserresterrerenterrnrerrsrertsseeeesreeerreneees 3 14 Interval Wind OW eoni ene eae a R E EE E S AEE REENE 3 14 Navigation for ezCallerID oo eee ee ceceeeeeeceeeeeeeseeceecasesaeceaesaeceseeseeeeseeeeeeeeaes 3 16 Privilege Level Create WindOW ceeeceecceeeeeceseeeeecaeeseecacesaeceeceseesecsseesseneeeseeees 3 19 Privilege Level Modify window 0 cece eecessceseeeeceseecsececesecaeeaeceeeeseeseeeeeeeneeaes 3 21 Privilege Lev
72. e edit these files we can refer to these two Oracle databases by their Oracle names CNAM and CNSECDB 24 Change to the appropriate Oracle file directory cd SORACLE LISTENER November 15 1999 1091 B DRAFT 2 15 Installing ezCallerID 25 26 27 ezCallerID System Administration Manual Use a UNIX text editor to copy the following two sections from an existing portion of the tnsnames ora file We use the hostname gorda in this example for our machine CNAM DESCRIPTION ADDRESS PROTOCOL TCP Host gorda Port 1521 CONNECT_DATA SID CNAM In this portion of the tnsnames ora file we substitute the CNAM Oracle name and provide the file directory corresponding to the Oracle Home directory CNAM_BEQ DESCRIPTION ADDRESS PROTOCOL BEQ PROGRAM export u02 oracle app oracle product 8 0 5 argvO oracleCNAM args DESCRIPTION LOCAL YES ADDRESS PROTOCOL BEQ envs ORACLE_HOME export u02 oracle app oracle product 8 0 5 ORACLE_SID CNAM Repeat the previous two steps for the CNSECDB Security Agent Oracle database CNSECDB DESCRIPTION ADDRESS PROTOCOL TCP Host gorda Port 1521 CONNECT_DATA SID CNSECDB CNSECDB_BEQ DESCRIPTION ADDRESS PROTOCOL BEQ PROGRAM export u02 oracle app oracle product 8 0 5 1091 B D
73. e ezCallerID Gateway Step 14 on page 2 39 Note Default TCP IP port number is 9999 Security Agent port number for the ezCallerIDinstallation Step 15 on page 2 39 Note Security Agent port number defaults to 1111 CORBA OSS only Remote CORBA Host Name Step 16 on page 2 39 CORBA OSS only Remote CORBA Server Name Step 18 on page 2 40 Oracle ezCallerID Gateway Database Name Step 21 on page 2 41 Oracle Security Agent Database Name Step 23 on page 2 42 Sometimes TCP IP address of the ezCallerID Gateway Host Step 25 on page 2 42 HTTP daemon port number for the ezCallerID installation Step 27 on page 2 43 Note HTTP daemon port number defaults to 7117 November 15 1999 1091 B DRAFT 2 33 Installing ezCallerID ezCallerID System Administration Manual 1 The ezCallerlD Installation Script attempts to determine the name of the ezCallerID host UNIX machine If it is unable to automatically determine the Host Name the System Administrator is prompted for the TCP IP address of the host Run the ezCallerID Installation Script 1 Type the command installCNAM The ezCallerID installation script responds by displaying FREER H PETE PEEP TEEPE EPP EE EEE TEEPE EPP EHHH HEHEH HEHEH H EHEHEH HEHEH EHH EHEHEHEH START CUSTOMIZING ezCallerID CONFIGURATION E H H E H H TEEPE H HEE PETE HE HEE H HEHEH HEHE PEPE EEE HE HEHEH EEHEHE HHHH HHHH Oracle Software and Databases Installed The s
74. e other ezCallerID processes simply substitute the other process names in place of the process name startup ps aef grep cnamgw ps aef grep secAgent ps aef grep cnamigp ps aef grep thttp ps aef grep namemgr These five processes should always be running and the results should always resemble the system response in step one CORBA Orbix Software 1 Verify the CORBA software Orbix process daemon is running by using the UNIX command ps ef grep orbixd You should see a response similar to this next line where cnam is the user ID 4893 is the process ID that identifies Orbix daemon and 16 55 56 is the current time November 15 1999 1091 B DRAFT 5 3 Maintenance and Troubleshooting ezCallerID System Administration Manual root 307 1 0 Oct 26 0 12 opt iona OrbixMT_2 3c bin orbixd cnam 4893 4877 0 16 55 56 pts 11 0 00 grep orbix Oracle Software and Database Instances The UNIX script exerpt shown after this paragraph can be used to determine if any instance of an Oracle database is properly mounted and ready process ps flgrep lt Oracle DB Name gt wce 1 if Sprocess lt 6 then echo Warning Your system has not started the database echo SCNAM remember to start up the database and echo register the schema manually echo else 1 Test that the Oracle ezCallerID databases are online by typing the commands ps ef grep ora grep CNAM or ps ef grep ora grep CNSECDB You shoul
75. e stand alone GUI You must install IONA Technologies Orbix software if you want to use MetaSolv s TBS product e Determine if you want to install a remote CORBA server as the gateway The previous two decisions determine which installation configuration your company will use with the DSET ezCallerID product Oracle Software Requirements To use Oracle with DSET products you must use e Enterprise Server 8 0 5 with Oracle 8 Objects Option enabled e The latest v8 0 5 software maintenance patches e Must have the version SQL NET V2 set up for distributed databases e The two ezCallerID Oracle databases must be created with the options Character set used is WE8ISO8859P9 ISO 8859 1 West European standard Name of the Oracle tablespace used is DATA All the database tables and indices are stored in this tablespace 2 4 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Oracle Server Software To use Oracle to store the CNAM orders documents and implement security for User IDs and passwords 1 Have your company s Database Administrator install Oracle server version v8 0 5 0 on the UNIX machine you will use with the ezCallerID application 2 Install the latest Oracle 8 0 5 software maintenance patch to address recent Oracle software problems 3 Download the most recent Oracle software patch files a Go to the ftp site with the TCP IP addresss of 209 246 5 40
76. e system does not run out of space 3 November 15 1999 To remove CNAM log files type the commands cd DP_DIR cnam www cnam 1log lt Service_CenterI gt tar uvf dev rmt0O cnamgw lt use tape on dev rmt0 rm rf cnamgw lt remove gateway logs tar uvf dev rmt0O cnamIgp rm rf cenamIgp lt remove interconnectiovity gateway platform logs tar uvf dev rmt0 Security rm rf Security lt remove security logs 1091 B DRAFT 5 23 Maintenance and Troubleshooting ezCallerID System Administration Manual Oracle Database Maintenance 5 24 Handling Database Instances This section describes the handling of the Oracle database instances created by the DBA The database instances are created by the specifications after matching the customer requirements on the number of CNAM orders per week or by month Once the database instances are created you can let the ezCallerID System Administrator register the database schema by running the DSET ezCallerID Installation script Once the schema is registered it is ready for population with the CNAM orders documents If the Oracle databases are not prepared before you run the ezCallerID Installation script you must manually run the SQL scripts found in the DSET schema directory SDP_DIR cnam schema You have to use these scripts to perform the schema registration and other Oracle operations See DSET ezCallerID product subdirectories described in Table 2 7 Manuall
77. e transmitted and acknowledgements or error messages heaven forbid received we need to set the gateway parameters 18 Using the created Service Center number The ezCallerID application uses only one service center Its account number is 111111 follow the procedures in Creating the DownStream Interface on page 4 5 and DownStream Frequency Details on page 4 15 19 For test purposes only set the DownStream Frequency to be Periodic and set it for 180 seconds November 15 1999 1091 B DRAFT 2 55 Installing ezCallerID ezCallerlID System Administration Manual L Create CNAM Orders documents You can create CNAM documents using the standalone DSET GUI or the MetaSolv TBS software 20 Refer to Chapter 3 of the ezCallerID User s Manual to create CNAM documents M Verify Orders Sent through Gateway To verify the ezCallerID application worked correctly for your CNAM order you need to examine two ezCallerID log files Use Figure 2 2 as a guide to locating the correct directory where the log files are stored You can refer to Chapter 5 Maintenance and Troubleshooting to see how to use the DSET stand alone ezCallerID GUI to view the log files with a Web Browser Important Our strategy requires two steps 1 Examine one log to verify that the CNAM document was successfully created and 2 view another log to ensure it went through the gateway successfully Assuming that we do not have a web browser available we will a
78. e two time intervals defined that influence its actions with respect to the Due Date The Due Date is the target date which the CLEC has set for making the service avaliable to the customer e Provisioning Interval the time between the initial order is made and the Due Date time the CLEC believes it will take to make ezCallerID service available to the customer e Jeopardy Interval a shorter time interval in the time period prior to the due date If an order item is not completed or canceled before the jeopardy interval the probability of missing the Due Date increases At any intsant an ezCallerID customer order ccan be in one of six states Table 1 2 Due Date States 1 of 2 State Description Finished Order is completed or canceled The order items associated Due Date will not be On Time missed Jeopardy The order is within the Jeapordy Interval November 15 1999 1091 B DRAFT 1 5 Introducing ezCallerID ezCallerID System Administration Manual Table 1 2 Due Date States 2 of 2 State Description The Due Date has passed and the order is not Sate completed or canceled x A request to the customer was sent to chnage the Negotiate Due Date for an order in progress iori h Escalate Priority of the work necessary to complete the ezCallerID order is increased 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual Introducing ezCallerID The ezCallerID Components The GUI windo
79. ed Java Applet Window Figure 4 11 Service Centers Window 2 Double click the text of the Service Center The Service Centers window displays as shown in Figure 4 12 Service Center 123456 Description Ameritech OK Ey Unsigned Java Applet Window Figure 4 12 Service Center Info window The Service Center number and its description display This information is view only 3 Click OK to close the windows Creating and Modifying a Service Center Only the System Administrator privilege level can create a Service Center Once it is created it cannot be deleted See the ezCalleriID System Administration Manual November 15 1999 1091 B DRAFT 4 13 Communicating with Service Centers ezCallerID System Administration Manual Viewing the Data Transfer Schedule As a user who creates deletes and modifies customer LIDB records you do not control the portion of the software that decides when to transmit customer records to the Service Centers and when the ezCallerID receives notification or error messages in return Consult your ezCallerID System Administrators regarding the days and times that ezCallerID information is transferred between your computer and the Service Centers Only these individuals can actually change the data transfer schedules You have the ability privileges permitting to see how often the DownStream Interface DSI transfers data 1 Select DownStream Interface gt View DSI Info
80. eds to match the OSS server s name in the variable RMT_CORBA SERVER_NAME If these variables are consistent the problem may be in the OSS Checking the Oracle Databases If you see this message D_usr_opendb failed check to make sure the oracle processes are running by typing ps aef grep ora If the CNAM orders CNAM and Security databases CNSECDB and the LISTENER process are not running follow these procedures Starting the CNAM Orders Database 1 Login as oracle User Id 2 Set ORACLE_SID environment variable to JGP_Database by typing export ORACLE _SID CNAM 3 Use the Oracle server manager by commands svrmgrl connect internal startup exit out of the Oracle server manager November 15 1999 1091 B DRAFT 5 19 Maintenance and Troubleshooting ezCallerID System Administration Manual Starting the Security Agent Database 1 Login as oracle User ID unless you did it in step 1 for the CNAM Orders database 2 Set ORACLE_SID database instance environment variable to Security_Database by typing export ORACLE_SID CNSECDB 3 Use the Oracle server manager by commands svrmgrl connect internal startup exit out of the Oracle server manager Starting the Oracle Listener 1 Login as oracle User ID unless you did it in step 1 for the Security Agent database 2 Start the Listener by typing the commands lsnrctl stop Isnrctl start exit Increase the Time Lag for the
81. eeeeeesesrersstesesrsestesrerrsrenterenrerrererensee C 9 ezCallerED Documents eis c3 ie sis eeeseiis ssesbeeseatsea atic avneuseass Sage sbebasees Shodeees E r EE EE eE EE E EEE EEES C 10 Creating ezCallerID Documents ee ceceseeeeceeceeeceeeeeeeeseeseecaeesaecaecsaeeseseseerenseeaeeees C 10 Viewing ezCallerID Document ss sisccc cceckssciescets sesticedisdesssehes Deris tee iSe eSEE ne ea EEEE dees C 10 November 15 1999 1091 B DRAFT ix Contents ezCallerlID System Administration Manual Privilege Levels Screens isori reeeo teeren echs sees sssscsstesshsusssvnst ieesccunsscascebach os Saved OnE SS r Eoo EREA Ten ETEei C 13 Creating New Privilege Levels ic scccccessscsieetsstacoevetbuvacncbencevscuanes er e en EEEo Ere Ei C 13 Modifying Privilege Level iu cessci dccuevsgucscescssyecscesseel seeds sseetsees cba eror E r r Ene er ES C 14 Viewing Privilege Levels nosire ed lanes tance aea E a ache GiB Ses Gs tone eh tabla eh tence C 15 User Groups SCHECMS sce es Aegre e ea a ape a e a Ee aaae E N SE o RENEA ETER C 17 Creating amd Modifying New Users esssseesssseesesseeessreeersresrsserrsrerresrerrsrenrerenerresenerseees C 17 Views A U SETS a r i eee aE a E E E E EN C 17 Index EA ASEA T E Index 1 x 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual List of Figures Figure 1 1 Figure 1 2 Figure 1 3 Figure 2 1 Figure 2 2 Figure 2 3 Figure 2 4 Figure 2 5 Figure 2 6 Figure 2 7 Figure 3
82. eeeeseeeeeens 4 9 Figure 4 7 Intvls of Day Window lt scccissscesete cisessces sgh os sds chdsneethsuhsasdestnnsissagshsaseseves coasbesssvaeesvctuaas 4 9 Figure 4 8 Complete WeekMask window 000 ceceseesceeeeceseeeeecseeeaecaeesaeceecaeceeceseeeeeeeeeasenes 4 9 Figure 4 9 Intetval window 2 335 nei aa Sea iS E R osheeti arate eaten 4 10 Figure 4 10 Modify DSI Info window 0 0 eee eceeeececeeeeeeceseecneessecaecaeaecsaeeaecseeseseeeeeeseneeas 4 11 Figure 4 11 Service Centers WindOw secs seente arr eenia es kee pees coseess ae aE E eR SS 4 13 Figure 4 12 Service Center Info Window ieee eececeeseeeceseeeeeeseeesecseeaecsaeeaecseceseeereeeeereees 4 13 Figure 4 13 Get DSI Into Window s scecuisesecatsstenendbeeenatstensneeeninteeenin een E 4 14 Figure 4 14 DSL Into windo Werners hte ee Ae Seid ents ene a 4 15 Figure 4 15 Week Mask witdo w sccelsesestiressesdtsds o errearen sd vcbeutensdyovesver sly dusevdoseeeesessanereesteess 4 16 Figure 4 16 Interval of Day WindOW c ec ceeeseceeceseeseceseeesceeceeeeeseeeeeeaeesaecaecsaecaecaeeseeeeeseees 4 17 Figure 4 17 Interval window cncivsetec ives sic escensidevenvet E Set ated eedeie 4 17 Figure 5 1 Example Console Output for Oracle Databases eee eeeeeeeeseeeeeceeeneenaeeaee 5 4 Figure 5 2 Lo Directory StU CtUite 2 s cencefeesoseesssdecseedse aileebeds neebe a peri EE iha ARESO eeeepen stone 5 6 Figure 5 3 Index of web server root directory WindOW sesssessesessesestesssr
83. el View Windows c cssc 3 d8cuseesinteetan ns 5s e tees ESES ES EES 3 22 Privilege Level View Response Window sccscsssecseceseeseceeeseceseeseeeeeeseeeneeaes 3 22 Privilege Level Delete WindOW 0 eee eceeceeeseseeeeecseessecesesaeceecaeeseeeseeeeeneeeaeeees 3 23 Operation Response Window 0 0 ce ceececeseeeeceseeeeeeseeceecasesaeceaeeaeceseeseeeeeeeeeeeeeaes 3 23 User Create Wind ow dsni tes e duegeves E E E E 3 24 User Modify window sire n n E E e er EEEE EEE E E 3 26 User View WAdOW eene r ee area e e eSa ES EOS dyad SEER EE ees 3 26 1091 B DRAFT xi List of Figures ezCallerID System Administration Manual Figure 3 27 User View Response Window cccseceseesecesceseeesceseeseceseeeeecseeeeecaeesaecaecnaeeeenees 3 27 Figure 3 28 User Delete window isco isis ieee Siti E A EE Heald adhd hinges 3 27 Figure 4 1 Create Service Center Window eee eecessecseceseeseceseesecesceseseeeeseeeaeeseeeaecaaecaessaenaes 4 1 Figure 4 2 Service Centers window with a list of all Service Centers 00 0 cesses eeeeeee 4 3 Figure 4 3 Service Center Info window ccssc sssscssecssjensovsesssnesdetossdpbeveecpoge sencvesvgeasoevasvessosasivens 4 3 Figure 4 4 Create DSI window 8 aiccin estes Phe Rede he RE Aled ol eee ee eine 4 6 Figure 4 5 Week Mask window vices sessetess cesseciscessssctistug sacar nie Sheeteieastss gacsdansenssebianes Ea R 4 8 Figure 4 6 Daily Schedule window with days selected 0 eels cee ceseceeceseeeeeeeee
84. equest Needs Information From Quality Assurance And Customer Service To Formulate Procedures For This Section 5 12 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Troubleshooting Problems Using a set of test procedures and available programs you can determine the probable source of the difficulty with the ezCallerID application Use Table 5 3 to isolate the source of the ezCallerID application difficulty and then perform the appropriate action in the following section of this chapter to correct the problem When problems arise with the ezCallerID application always restart the CNAM Gateway This helps determine if the problem is with the ezCallerID product or with one of the third party applications with which it interacts Problem Determination Table Important Remember If ezCallerID is not performing as it normally does stop and restart it There will be no data loss and it automatically connects itself to the OSS server Table 5 3 ezCallerID Problem Determination 1 of 2 What if Then Do cnamgw Retrying connection to host paris CORBA communication Error when the remote CORBA host port 1570 OSS is not available This should prompt the System cnamgw Retrying connection to host paris Administrator to check out the CORBA daemon Orbix and port 1570 PSR Ancillary API server on the OSS system Most likely 10092 Communication failure someone rebo
85. er only sends ezCallerID responses at 8 00 a m and 2 00 p m you should not set a daily upload to occur at 7 00 a m and 1 00 p m Creating the DownSiream Interface Creating the DownStream Interface involves entering many pieces of information November 15 1999 1091 B DRAFT 4 5 Communicating with Service Centers ezCallerID System Administration Manual Note e DownStream Frequency Start and Stop by Days or by Periods e Up Stream Frequency Start and Stop by Days or by Periods We created a procedure for each piece of information you need Follow these procedures in sequence 1 Opening the Create DSI Information Window 2 Entering UpStream Frequency 3 Entering DownStream Fequency Once you enter all the information on the Create DSI box you will click OK and create the DSI You must create the Service Center before you can create DSI information Opening the Create DSI Information Window 1 Select DownStream Interface gt Create DSI The Create DSI window appears as shown in Figure 4 4 Service Center ooo Use the drop down selection list to choose the Service DownStream Frequency periodic ABSENT Center zi N Create DSI x OK Cancel ey Unsigned Java Applet Window Figure 4 4 Create DSI window See for field descriptions 2 Select the Service Center from the pull down menu in the Service Center field 1091 B DRAFT November 15 1999 ezCallerID System Admini
86. er processes in the startup config file is too small Stop the ezCallerID application edit the DP_DIR cnam config cnam startup file to increase the time lag and restart the Gateway A terrorist strike happens 1091 B DRAFT DSET believes you are on your own when this happens Best of Luck November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Actions to Resolve Problems This section provides a brief description of the responses you can use to overcome problems with the ezCallerID application s environment Should problems arise with the Gateway the first thing to check are the processes Verify that the processes listed in Application Process Health on page 5 3 are all performing properly If not stop and restart the ezCallerID application This will specify whether the problem lies in the Gateway or in one of the applications integrated with Restarting the ezCallerID Application To restart the ezCallerID use the UNIX machine where the application resides Login as ezCallerID System Administrator with the recommended Note To ensure that the Gateway has successfully shutdown issue the ps command and verify that all ezCallerID processes are not running after stopping the Gateway Similarly issue the ps command to verify that all ezCallerID processes are running after starting the ezCallerID 1 Enter command DP_DIR cnam bin cnam stop Response would be similar to Info cn
87. errseeserresrerensreresese 5 7 Figure 5 4 Index of log directory WiNdOW sesei E aE 5 8 Figure 5 5 Index Of log Cnamgw directory Window 00 eee eee eeeceeeeseceeceseceeceseeeeeeeeeeesenes 5 9 Figure 5 6 Activity Log for ezCallerID Gateway 00 eee eeceeeeeesceneeesecaeecaecseaececeseeeensees 5 11 Figure 5 7 Activity Log for the Interconnectivity Gateway Platform 0 0 0 eee 5 12 Figure 5 8 Lo Directory S Wu Cire aeni Er Rai iy shoe e E aS E E E A R NER 5 22 Figure B 1 High Level Process Flow of ezCallerID components sssssseseesseeessererrereersersrreesee B 1 Figure C 1 Create Service Cemter Window cessecsecseessernseesecserssoncesevnsensvensconeceesneenees C 1 Figure C 2 Service Centers Window eceecceceessessescecseessecsecssesecsseeseceseeeeeeeeseseaseaaeeaessaeeaees C 2 Figure C 3 Service Center Info Window csere seein us NE RENE E E ata ties C 2 Figure C 4 Create DSI window s iccis ii hte ict ee aie Se a ee ee eee C 3 Figure B 5 Week Mask add new schedules Window ccccccssssecesseceeesteeceeeceessneesseeeeesseees C 4 Figure B 6 Interval of Day WindOw ccc cesesecesceseeesceseeeeceseeeeecaeecaecasesaecascsseceseeseeeeeeseseasenes C 5 Figure B 7 Interval window cschecscits a a e e nE AT A E E eee eee C 5 Figure B 8 Modify DSI Info window eee eeceseeeeecaeessecacesaeceecseeseesseeeeeeeeseaseneseaseneesaes C 6 Figure B 9 Modify DSI Info details WindOW eee eee eceeseeeee
88. ess eee ceceeeceeceseeeeceeeeeeseseeeeeeaeesaeeaees 5 20 viii 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Contents Backup and Archival sirios eseis sci besdesess ces cageesssedinedash os sssr rosee Sonebeseescbpeciseedcasagasensscpnsecvaas uensensenegs sabes 5 21 ezCalleriD Logs Directory msinione ea ten E EE E ea ESE EEEE E EE cuba VEE cies 5 21 Oracle Database Maintenance eeno oen E E EE A Eea SE E EE Na ini 5 24 Manually Register the ezCallerID Order Database Schema sssssseeserereereeeessreerreeseesesee 5 25 Manually Register ezCallerID Security Database Schema 0 eee cece eeeeseceeceseeseeeeees 5 26 Cleaning Up Oracle DB Schema eee eceseeeseseecsecneeeseceeaeceeceseeeeseeeeceeeseeseneeseseneeaes 5 27 Deleting Existing Oracle Database Records eee eeceeeesceeeseeeeseeeeeceeeeaecasesaecnecsseeeeaeens 5 29 E EET a A T A E A 1 Technical Referents enrarir ioar CE aS IE a EFIS ERNES AFKEER EESE EAN ASEENSA ENRERE B 1 Process BLOW ssi ccd esee e a pe renee r a na Ae a AEE a Ae E S e Rr e B 1 Configuration Files spect eoori Eaa e E EEE E a eE r ET A ar EEE E E EEE EEEE EEST B 2 Whiat was Installed mnsine enc is Whe es he beck ab eo eae p Ee Hes Svea Sees Teana asioi B 2 Startirp SCrpt AA E E ves sses sa ckdbaea seek os Seesoedhss doa sbes sabes ST B 4 SLOP SCH plete Mecige ees ae pied aoa eee ao ca ah Sad ete ed ee B 5 Checking Gateway Statis anieri oieee eso niies eerie Hibs sou sok
89. esseeseesseesressesstesresseesresressesereeees xvii Viewing the Manual in Online Format e sesesesseeesseereesseeessreersresreresrerrsrenrereeresrsseresseeresre xviii Conventions en ea a a e a a eee SR A a a a a e cea ad Senet xviii What s New ir this Releases ssi a aeara a AAEE aE EE a RA NEER EAR EE EE AATE a REEERE xix Manual Sections That Changed sesessseesessesrssesreseseterstreresrssestsrerersrentsteetetenterrsseeresreersreet XIX Getting Technical Support scntas eer erri eeki e eai ane nae ons Eo oeer rE E ana OEE E EEE EErEE bee XX Contacting Customer Service oo ee eeesecsecseeecsseeseceeceseeeseeseeseceseseaecseecaecsaesaecseseseesenseeeeeegs XX Online Help E E E E XX Introducing eZCaller ID ccsscicsssssseescssssvceesscsseasecsseseesosecsucensasedacscbadanseasosusecsesenscassisvasessssessessivecaseesocaseesonsesees 1 1 Understanding the ezCallerID 0 ceseeeeceeceeeceseeseecaecseecaeesaecaecsaesaeceaeessseseeseseaeesasenesasenaeenaes 1 1 Backeround Information sc ciecscediecPisssccsesvceatsecsssees dv ccestdvadvevsesdvsescustycssencdesslvesdeas scnetsteatecneotes 1 1 The Market isiiiy cisecevensiiceeteign cerca lend eet ves dL Avoidance AE E NE 1 2 DSET s Current LIDB Service GatewayS seniem eiie esaeo ESSEE aeS ESE i 1 3 OVANEN dies eS eo BOA aS ae doe is 1 3 Order St tu Sasi mnan ne e ddesisaeedesdeceestdetceuvia tan deetnced tyes ei i ET desde tin ddonse 1 4 D e Dat s etaa E ea te ea ees ee eee ae ae 1 5 The
90. eted Order item is successfully provisioned E The customer order is currently being modified in the Creaia Eal ezCallerID GUI Canceled The order was canceled before it was finished Released Order is ready to be provisioned The order was sent to the supplier via the ezCallerID and System Processing interface and is in progress The order is on a user s work list and is awaiting an update to Manual Processin eA oe g complete the provisioning Supplier processing on the order is complete This typically Supplier Processing Complete happens when a supplier sends a provisioning complete response via an automed interface 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Introducing ezCallerID Table 1 1 Order Status States 2 of 2 Status Description Typically occurs when a user finishes working on an order Manual Processing Complete and the business process begins system processing Error During provision this order an error happened The order requires further editing before it can be released Hold para for provisioning A manual follow up must be done that is call customer and Post Complete Follow up confirm the Caller ID service is working before the order is considered complete Any post completion follow up activity is done and nothing Post Complete hellowsup Bone else is required to track the order Due Dates In the ezCallerID customer order there ar
91. etries to send the order Any orders not sent will ultimately reside in the Drop subdirectory of the Log directory The UNIX system the ezCallerID runs on crashes Restart the CORBA process daemon restart Oracle database instances roll back the Oracle databases to the last good transactions and start the ezCallerlD application Check the Logs and make sure CNAM documents were written to the CNAM Oracle Database To automatically start the CNAM Gateway during system reboot include the cnam startup script as a UNIX startup daemon The ezCallerID application goes down The Gateway restart es every time it goes down Since all the documents and user ID login information is in a persistence database there will not be any loss of information The Service Center system breaks down If the notification message is not received from the Service Center within the time you set the document is sent again The OSS server breaks down The ezCallerID will be waiting to receive transactions When the OSS server comes back up the ezCallerID will reconnect to it This Message displays D_usr_opendb failed Make sure the database files specified in the configuration files exist and have the correct permissions This Message appears Can t create SAP Make sure that namemgr is running Issue the ps command to verify namemgr is running If the process is running the time lag between the namemgr process and the oth
92. eway windows eee ezCallerlD Gateway windows 3 Checks security database ezCaller ID 2 Sends data for validation Gateway 4 Sends valid or invalid user message Security Agent 5 Continues to monitor User ID for authorized operations Figure 1 2 The Security Agent Process Flow The validation occurs during initialization and lasts for the duration of the ezCallerID session Oracle Database Logs Converting to A Common Format Before requests can be sent to the ILEC it must be converted to a format that the ILEC can read This is done in the DownStream Interface DSI DownStream Interface DSI When data is transmitted through the DownStream Interface DSI it flows through two components e Collector e Translator 1 10 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Introducing ezCallerID It receives translates and forwards ezCallerID requests Notification messages and Error messages between the ezCallerID system and the UNIX file system The DSI also holds scheduling information to trigger the collector translator and send receive documents to from the UNIX file system Collector The Collector component of the DSI periodically checks the ezCallerID IGP for documents in Pending status Pending indicates the document is ready to be sent It also receives Notification messages and Error messages arriving from the Service Center The Collector time interv
93. ewing xviii preventiative monitoring overview 5 1 Privilege Levels delete change levels warning 3 20 privilege levels 3 17 creating 3 19 deleting 3 23 modifying 3 20 operation codes 3 17 samples 3 18 viewing 3 21 problems determination matrix 5 13 evaluating situations 5 13 symptoms 5 13 procedures delete tables orders database 5 30 security database 5 30 done after installation 2 58 drop tables orders database 5 28 security database 5 29 register schema orders database 5 25 security database 5 26 processes checking health 5 3 CORBA verify 2 52 DSET application November 15 1999 Index testing 2 53 file directories 2 26 gateway defining name 2 35 HTTP daemon port number 2 43 names restrictions for gateway 2 35 Security Agent 2 36 Oracle databases verify 2 52 registering with CORBA 2 44 shared object libraries 2 51 UNIX ID 5 3 profile file Oracle environment variables 2 10 profile files DSET application 2 47 sourcing 2 47 provisioning interval time for service availability 1 5 Purchase Order Number PON defined A 2 R RAM memory required for installation 2 2 reference books help during installation 2 3 installation 2 3 requirements password 3 24 S SC See Service Centers SCP See Service Control Point scripts DSET application establish environment 2 28 DSET installation final steps 2 44 1091 B DRAFT Index 7 Index finish message 2 45 responses 2 33 installation file directory 2 48 O
94. ezCallerlID System Administration Manual Software Version 2 0 Issue Date November 15 1999 Manual Number 1091 B DRAFT Copyright Notice DSET ezCallerID software and documentation 1999 DSET Corporation All Rights Reserved The ezCallerID software product is copyrighted and all rights reserved by DSET Corporation The ezCallerID software is licensed to the original Licensee only for use according to the terms and conditions set forth in the Contract or applicable document contain the licensing provisions Copying selling or using the product contrary to those licensing terms and conditions is a violation of the law All parts of ezCallerID System Administration Manual documentation are copyrighted and all rights reserved This documentation may not be copied photocopied or reproduced in whole or in part without DSET s prior written consent except as otherwise provided in writing Any authorized copy of reproduction in whole or in part must contain the Notice statement above If you have any questions regarding the appropriate use of this software product and documentation please call DSET a Technical Assistance Center TAC 877 ASK DSET Trademark Information Netscape and Communicator are registered trademarks of Netscape Communications Corporation Orbix is a registered trademark of IONA Technologies PLC Telecom Business Solution and TBS are both trademarks of MetaSolv Software Inc Oracle Oracle8 and SQL
95. files belonging to a specific period for example say two months delete the UNIX files and remove the CNAM records from your Oracle database ezCalleriD Logs Directory The ezCallerID creates log files on a daily basis These files tend to get large quickly We recommend you set the log files to backup to tape daily or as frequently as needed based on your schedule for retrieval when needed The names of log files end with the date they were created The logs are simple ASCII files and can be backed up using tar or other UNIX utilities They are located in DP_DIR cnam www cnam 1log directory Three subdirectories are used for each DSET product to store the daily logs The ezCallerID logs reside in directories see Figure 5 8 SDP_DIR 1sr www cnam log lt trading partner gt Cnamlgp SDP_DIR 1sr www cnam log lt trading partner gt Canmgw SDP_DIR 1sr www cnam log lt trading partner gt Security The lt trading partner gt is usually expressed as a three or four letter ILEC designation such as PAC Pacific Bell SWB Southwestern Bell USW US West etc See Table 5 2 for a description of the different logs November 15 1999 1091 B DRAFT 5 21 Maintenance and Troubleshooting ezCallerID System Administration Manual wep Server Root Directory CNAM Log Root Directory Trading Trading Trading Partner 1 Partner 2 Partner 3 o Figure 5 8 Log Directory Structure Backup CNAM Orders documents To
96. ge Level Now that the Privilege Levels are established you can create a User ID and associated it to a Privilege Level 1 Select Admin gt User Menu gt Create New User The User Create window displays Figure 3 24 User Create window 2 Type the User ID 3 Type the privilege level for this user in the Privilege Level field 4 Click OK The Operation Response window displays indicating that the operation was successful 5 Click OK to close the window Changing Passwords When the System Administrator creates a User ID and assigns a Privilege Level the User ID password defaults to LNP SMS1 Only the System Administrator should use this password assign a different password immediately and ask the User to change it to a private password 3 24 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Password Requirements All passwords must begin with a letter and be eight characters Passwords must also contain one number and one special character Available special characters are amp gt and a space For Example kjones3 Follow these procedures to change a Password 1 Click Admin gt User Menu gt Modify Password The User Password Modify window displays Type the User ID Enter the current password in the Session Password field Enter the new password in the New Password field See above for password requirements Click OK
97. gp cfg e Security Agent SWB security cfg e CNAM CORBA Gateway SWB cnamgw cfg SWB cnamigp cfg and SWB security cfg_ have variables that point to the database instance The values of these variables should be set to In SWB CNAMIgp cfg the value of GEN_AGENT_DB_NAME should be CNAM In SWB security cfg the value of SEC_AGENT_DB_NAME should be CNSECDB Ongoing Tasks for Oracle Database Administrator See Chapter 5 Maintenance and Troubleshooting on page 5 1 of this System Administration Manual for preventative maintenance tasks that the Oracle DBA must perform Role of DSET Installation Team The DSET installation team will e Check that all third party software has been installed prior to running the DSET ezCallerID Application Installation script e Check that all Oracle ezCallerID databases are created e All Oracle ezCallerID databases are started and the Oracle LISTNER software is running e The Orbix Daemon is running e Run the ezCallerID application installation script e Start the ezCallerID gateway processes and verify they are running November 15 1999 1091 B DRAFT 2 19 Installing ezCallerID ezCallerID System Administration Manual e Use TBS software or a Web Browser stand alone GUI to submit CNAM orders to the ILEC e Examine the Activity and Trace logs to validate proper software operation e Arrange for dial up access for DSET customer support personnel e Plan trans
98. h a standalone Java based GUI software Inegrated Use an OSS interface to permit a large number of service representatives create customer orders and store them in an Oracle database e Revised index to identify more system administrator tasks e Insert section to show Oracle DBA the key steps necessary to setup the Oracle databases required for the DSET ezCallerID application November 15 1999 1091 B DRAFT xix Preface ezCallerID System Administration Manual Getting Technical Support Contacting Customer Service Online Help XX Table Preface 1 Contacting DSET s Customer Service Contact Method Address or Number Internet TBD Website http www dset com tech techsupport html Telephone Technical Support 877 ASK DSET Customer Service 972 312 1800 FAX 972 312 9060 Mail DSET Corporation 2201 West Plano Parkway Plano TX 75075 USA Many fields in ezCallerID windows have short context sensitive descriptions that display in the Status bar located along the bottom of each window Place your cursor in a window field to display its corresponding description 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Chapter 1 Introducing ezCallerlD Understanding the ezCallerID When a customer wants a new telephone service provider they contact a Competitive Local Exchange Carrier CLEC The CLEC must communicate with the customer s current service provider the Incumbent
99. he Profile File As the ezCallerID installation script finishes it provides you the following instructions Before starting the gateway make sure you source the PROFILE in the ezCallerId gw home directory ezConnect home cnam cnam2 0 5 cnam 1 This directory is in the product file directory a subdirectory of the Installation Directory see Figure 2 1 Type the following commands at the command prompt cd DP_DIR cnam profile be sure there is blank space between the periods All the ezCallerID application Oracle and Orbix CORBA OSS only environmental variables should be available to the application users B Provide Variables to ezCallerlD System Administrator 2 Locate the Korn Shell file SHOME kshrc in your UNIX home directory 3 Using the vi text editor or other software to edit the file and add this line to the System Administrator Korn Shell This will make the ezCallerID application variables immediately available to the administrator lt ezCallerID Installation Directory gt cnam profile 4 Save the SHOME kshrc file November 15 1999 1091 B DRAFT 2 47 Installing ezCallerID ezCallerlID System Administration Manual ezCallerID Environment Variables These are the key application and third party environment variables In the subsequent steps you should display the contents of each variable to verify that it points to the correct UNIX file directory Table 2 11 DSET ezCallerID Application Env
100. hema PL FASE WAIT register th zCallerID gateway security CNSECDB Oracle database schema is done Great Job November 15 1999 The final installation message is EZCALLERID GATEWAY HAS BEEN CONFIGURED SUCCESSFULLY followed by the post installation instructions that are covered in the next section of this chapter 1091 B DRAFT 2 45 Installing ezCallerID ezCallerID System Administration Manual Post installation Tasks Once the ezCallerID installation script completes you want to begin checking that all elements of the ezCallerID installation are working correctly Table 2 10 ezCallerID Post Installation Steps 1 of 2 ee Step Page Once You Have Performed this Step m Source the CNAM User ID profile so that all application and Oracle A 2 47 i environmental variables are set correctly for steps C and D m B 2 47 Modify the ezCallerID System Administrator s Korn Shell so that the DSET application environment variables are available m Ensure the DSET application environmental variables are set correctly DP_DIR your ezCallerID root directory where the software was installed Cc 2 48 SD_DIR base directory for the namemgr process to manage other processes S TONA_HOME CORBA OSS only QO Ensure the Oracle environmental variables are set correctly D 2 49 SORACLE_HOME installed home directory SORACLE_LISTENER Oracle net
101. iated with the Service Center Choose from the drop down selection list Service Center 6 digits This information is entered in the A a Indicates how often the system should check DownStream Frequency WeekMask window or the Periodic for downstream messages Interval window November 15 1999 1091 B DRAFT C 3 Catalog of Windows and Fields ezCallerID System Administration Manual Setting Week Mask Download Frequency N Week Mask arth 8 startm 0 stoph 9 stopm 0 Tuesday Wednesday arth 8 startm 0 stoph 10 stopm 0 Thursday Saturday OK Cancel J Unsigned Java Applet Window S Figure B 5 Week Mask add new schedules window C 4 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual Catalog of Windows and Fields Start fo hour min Stop fo hour min OK Cancel ey Unsigned Java Applet Window Figure B 6 Interval of Day window Table B 3 Field Value Constraints for Interval Of Day Window Field Name Length Type Description possible values The time interval in minutes to mn 1 2 digits check for downstream information Setting Periodic Download Frequency N Interval Ea 180 seconds OK Cancel ey Unsigned Java Applet Window Figure B 7 Interval window Table B 4 Field Value Constraints for Interval Window Field Name Length Type Description possible values The time interval in seconds to Seconds 1 5 digits
102. icates to hold down the first key and press the second key Click OK Arial bold Indicates buttons in a GUI interface requiring input or activation clicking a button or choosing an item from a drop down selection list File pull down menu Arial bold plus one or more Describes selecting a command from a pull down File gt New brackets gt menu or a sequence of cascading menus Insert gt Picture gt File File gt New Action Then next Action Provide actions so a user can reach a specific Then next Type Then next Action user interface window new name in window xviii Then next Action 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Preface What s New in this Release The most significant changes in software Version 2 0 are e The OSS server is now compatible with MetaSolv s Telecom Business Solutions TBS layer using a Common Object Request Broker Architecture CORBA interface This enables existing and multiple system configurations to communicate with the ezCallerID e The ezCallerID documents are only stored in an Oracle persistent database Manual Sections That Changed This document now conforms to the DSET Carrier Solutions Technical Communications Standards and Style Guide e There are two possible installation configurations for the ezCallerID application Standalone GUI Use a persistent Oracle database to store large numbers of ezCallerID customer orders wit
103. ine Number C 10 NXX LineNumber 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Catalog of Windows and Fields Table B 5 Field Value Constraints for ezCallerID Create Window 2 of 2 Field Name Length Type Description possible values 4 alphanumeric A valid Operating Company Number acting as the Billing OCN characters Service required for portable exchanges RAO S alpnanim ric A valid Revenue Accounting Office characters Calling Name 15 alphanumeric Subscriber name or spaces characters Type of customer transaction e Insert new line number record Transaction Type 1 alphabet C Change record e D Delete record Caller ID display option Presentation Indicator 1 alphabet e A Calling name to be displayed e R Block name from displaying Effective Date 6 alphanumeric characters Format MM DD YY Only use if you want a future processing date 1091 B DRAFT C 11 November 15 1999 Catalog of Windows and Fields ezCallerID System Administration Manual To Access ezCallerID gt View ezCallerID Document OTC Number SC 111111 NPA NXX LINE Value 214 320 0436 OK Cancel Clear Enter OCT Number ey Unsigned Java Applet Window Figure B 15 Get ezCallerID Documents window N ezCallerlID Documents x Document Count fi Servie Center Action npa nxx line o cy Unsigned Java Applet Window Figure B 16 ezCalleri
104. ion Manual Verifying ezCallerID Status Note November 15 1999 As the ezCallerID administrator you can check the status of ezCallerID At the command prompt type ps aef grep startup lt Enter gt The result will look like the following cnamadm 14951 1 0 19 51 04 pts 8 0 00 startup cnamadm is an example of a username and 14951 is a sample process id To check for the other processes replace startup with namemgr secAgent and thttpd 1091 B DRAFT Technical Reference cnamlgp cnamgw B 7 Technical Reference ezCallerID System Administration Manual Checking the Web Server B 8 Note The web server thttpd daemon is an http server that should be running on the UNIX machine where the Gateway resides This process is started as part of the startup process To access the ezCallerID windows through an HTML browser first check to make sure that the web server is running Enter command ps aef grep thttpd If it is running the response will be similar to cnamadm 16103 23455 0 16 09 14 pts 20 0 00 thttpd If the web server or thttpd daemon is not running start it in the background from the DP_DIR cnam bin directory Enter command thttpd p port number d SDP_DIR www cnam amp The port number is a 4 digit value that refers to the port number where thttpd should run DP_DIR www cnam is the root directory for the thttpd server Although the web server is included as part of
105. ion Manual Maintenance and Troubleshooting Dropping the ezCallerID Security Database 1 Ifthe Oracle Security Agent database is not online repeat the first three steps found in Manually Register ezCallerID Security Database Schema on page 5 26 2 Run the script to delete the Oracle security database tables cd DP_DIR cnam schema export ORACLE_SID CNSECDB dropDB sql dbadm dbadm CNSECDB DP_DIR cnam schema dropSecDB sql gt gt dev null lt continuation of command gt Deleting Existing Oracle Database Records The ezCallerID orders documents that populated the Oracle CNAM database tables can be deleted using one of the scripts provided by DSET Corporation You may want to do this if you want to start over with a clean database instance after your company has finished its initial testing Prior to re starting the ezCallerID application you must re register the Oracle database schema using the procedures in Manually Register the ezCallerID Order Database Schema on page 5 25 and in Manually Register ezCallerID Security Database Schema on page 5 26 The Oracle SQL scripts that define which tables to delete delDB sql delGenDB sql Called by de1DB sql1_ to delete the tables that describe the schema name changes delIgpDB sql delSecDB sql The CNAM Oracle database instance needs the de1DB sql and del IgpDB sql scripts The CNSECDB Oracle database instance needs the de1DB sql and delSecDB sql scripts to de
106. ironment Variables VELEL Description The ezCallerID Gateway installation directory see Figure 2 1 This is used by roe several application executable processes to read configuration files The directory used as base by the namemgr process to maintain and keep p2DIR track of ezCallerID Gateway processes The LD_LIBRARY_PATH should have pointers to the following software E AEA components Oracle and IONA Orbix Libraries IT_CONFIG_PATH The directory containing the CORBA software Orbix configuration files The directories to search for executables libraries etc It should include SDP_DIR cnam bin and D_DIR bin so that it picks up the ezCallerlD PATH executables If applicable it should also include the binary libraries for the CORBA Orbix and Oracle software products C Validate ezCallerID Environment Variables 2 48 Echo the ezCallerID environment variables to ensure that they point to the correct UNIX file directories as defined for your company s gateway Note Make sure DP_DTIR is set to directory path where ezCallerID installation scripts are located Ensure D_DTR is set to the directory path of the d dir subdirectory 5 Typing the UNIX echo command for each application variable should list file directories corresponding to your company s configuration for the ezCallerID gateway application An example response should look like 1091 B DRAFT November 15 1999 ezCallerID System Admini
107. ition to using transfer protocols to send CNAM orders to a service center Last minute Oracle CORBA Preparations During the installation the installation script will ask if you will use an Oracle database to store documents and perform security Answer appropriately and configure the ezCallerID system for your company During the installation the script will automatically attempt to register the schemas for the two Oracle databases CNAM and CNSECDB you created To make sure this goes smoothly 1 Start the CNAM and CNSECDB Oracle databases See H Mount the Databases on page 2 14 2 Start the Oracle LISTENER software see Start the Listener on page 2 18 so the ezCallerID Application Installation Script can successfully register the schemas 3 Use these commands to check that the two ezCallerID databases can be successfully accessed by the gateway application login as the Oracle user sqlplus dbadm dbadm CNAM sqlplus dbadm dbadm CNSECDB Refer to Chapter 5 Maintenance and Troubleshooting to determine what actions to take if an Oracle ezCallerID database is not performing correctly 2 20 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual November 15 1999 4 Installing ezCallerID Test to see if the Orbix software that controls the CORBA process daemon is running ps ef lgrep orbix You should see a response similar to this next line where cnam is the user ID 4893 is
108. ivilege Type all Privilege Operations 100 101 102 11 OK ey Unsigned Java Applet Window Figure B 22 Privilege Level View Response window C 16 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual Catalog of Windows and Fields User Groups Screens Creating amd Modifying New Users To Access Admin gt User Menu gt Create new User Then next Admin gt User Menu gt Modify User Id Privilege Level jo OK Cancel ey Unsigned Java Applet Window Figure B 23 User Create window Table B 8 Field Value Constraints for User Create Window Field Name Length Type Description possible values User ID 1 8 alphanumeric characters The ID of the user that is being added to the system The privilege level indicator associated with this user s Privilege Level Up to 8 digits ID This level determines the functions the user can perform Viewing All Users To Access Admin gt User Menu gt View Then next click OK November 15 1999 1091 B DRAFT C 17 Catalog of Windows and Fields ezCallerlID System Administration Manual N User View Response x USER ID Privelege Level s adm00 0 a n adm10 0 h 4 gt ox ey Unsigned Java Applet Window Figure B 24 User View Response window N User View Response x User Id useri Privilege Level 9 ox j Unsigned Java Applet Window Figure B 25 User View Response window C 18 1091 B D
109. k jones22 kjones and k jones are unacceptable Note If you receive the error message shown in Figure 3 6 the User ID you attempted to use is already in use by another Service Representative N Error Message x User Login failed IGP user login already exists on socket ey Unsigned Java Applet Window Figure 3 6 User ID Login Error Message November 15 1999 1091 B DRAFT 3 5 Defining Users and Privilege Levels ezCallerID System Administration Manual Modifying Passwords To change your Password 1 Select the Admin gt User Menu gt Modify Password command on the cascading menus The User Password Modify window displays as in Figure 3 7 User ID Old Password New Password OK Cancel cy Unsigned Java Applet Window Figure 3 7 User Password Modify window 2 Type the User ID 3 Type the current password in the Old Password field 4 Type the new password in the New Password field See Choosing Acceptable Passwords on page 3 5 for password requirements 5 Click OK A confirmation window displays indicating a successful password change 6 Click OK to close the window 3 6 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Exiting the ezCallerID 1 Select Session gt Exit The Logout confirmation window displays as in Figure 3 8 Do you really want to logout Yes No ey Unsigned Java A
110. k segments to cnsecdbrbl cnsecdbrb2 cnsecdbrb3 cnsecdbrb4 1091 B DRAFT 2 11 Installing ezCallerID ezCallerlID System Administration Manual E Create Links for Initialization and Configuration Files You are now going to create symbolic links from an Oracle Home directory location SORACLE_HOME dbs to the actual CNAM CNSECDB initialization and configuration files SORACLE_TOP CNAM pfile and SORACLE_TOP CNSECDB pfile 15 Create symbolic links for the CNAM document database cd S ORACLE_TOP CNAM pfile ln fs initCNAM ora SORACLE_HOME dbs ln fs configCNAM ora SORACLE_HOME dbs 16 Create symbolic links for the CNSECDB security agent database cd SORACLE_TOP CNSECDB pfile ln fs initCNSECDB ora S ORACLE_HOME dbs ln fs configCNSECDB ora SORACLE_HOME dbs On the UNIX links command 1n use the option only if you do not want any warning about overwriting an existing link F Create Scripts to Allocate Database Space 2 12 Note Now you will create the Oracle scripts to allocate tablespace disk space for each of the major files that makeup the CNAM and CNSECDB databases The example scripts you use are provided by DSET within the installation product subdirectory The example Oracle database scripts o_create sql and o_crSec sql are found in the product subdirectory defined by the pathname SDP_DIR cnam schema and the environment variab
111. kMask field to select it 2 To view the Frequency schedules that control when the transmission of ezCallerID orders happen double click the WeekMask Frequency text with the white background November 15 1999 1091 B DRAFT 4 15 Communicating with Service Centers ezCallerID System Administration Manual The WeekMask window displays as shown in Figure 4 15 Note Only the System Administrator can change the DownStream Frequency information N Week Mask x Sunday Monday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin Tuesday Wednesday StartHr StartMin StopHr StopMin a Thursday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin po Saturday StartHr StartMin StopHr StopMi Selected start and stop times of the data Friday transfer StartHr StartMin StopHr StopMin manne ox ey Unsigned Java Applet Window Figure 4 15 Week Mask window See UNRESOLVED XREF for field descriptions 3 Select the text line under the day of the week by clicking 4 Double click on a text line to view the start and stop transmission reception times The Intervals of Day window displays in Figure 4 16 4 16 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers Start fs hour Joo min Stop 10 hour ool min OK Cancel Ey J Unsigned Java Applet Window Figure 4 16 Interval of Day windo
112. le SORACLE_DSET_SOQL This directory also contains SQL scripts to register establish tables and organization database schemas and perform other Oracle maintenance operations 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID 17 18 19 20 Create the Oracle script for the CNAM document database from a template cd ORACLE_USER_HOME SQL cp ORACLE_DSET_SQL o_create sql o_crCnam sql Use a UNIX text editor and make changes in the o_crCnam sql script Replace IGPDB with CNAM for the database creation log crdb log Replace IGPDB with CNAM for the database initialization file initCNAM ora Replace IGPDB with CNAM on the create database SQL statement Insert the statement character set WE8ISO8859P1 Replace rb_t emp with cnamdbrb_temp for the rollback segments Change the rollback segment names from rb1 rb2 rb3 rb4 to cnamdbrbl cnamdbrb2 cnamdbrb3 cnamdbrb4 Replace IGPDB with CNAM anywhere in the directory pathnames throughout the script Create the Oracle script for the CNSECDB document database from a template cp SORACLE_DSET_SQL o_crSec sql o_crCnSecdb sql Use a UNIX text editor and make changes in the o_crCnSecdb sql script Replace SECDB with CNSECDB for the database creation log crdb log Replace SECDB with CNSECDB for the database initialization file initCNSECDB ora Replace SECDB with CNSECDB on the create databa
113. lerID System Administration Manual Figure 3 4 shows the Login Response window displaying a warning to unauthorized individuals N Login Response x NOTICE This is a private computer system Unauthorized access or use may lead to prosecution cy Unsigned Java Applet Window Figure 3 4 Login Response window 5 Click OK The ezCallerID Console window displays in Figure 3 5 This is the primary window where you specify commands for the ezCallerID lolx N ezCallerlD Gateway Console Session Admin ezCallerID Service Centers DownStream Interface Log ey Unsigned Java Applet Window Figure 3 5 ezCalleriD Console window 3 4 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Choosing Acceptable Passwords The first time you login to the ezCallerID you should change your password You want to choose a password that you can easily remember and that other people have great difficulty guessing Rules for passwords Your ezCallerID passwords must adhere to these rules All passwords must begin with a letter A Z a z All passwords are eight characters in length Passwords are case sensitive Passwords k jones3 is not the same as Kjones3 Passwords must contain at least one number 0 9 Passwords must contain one special character 3 amp gt or a space An example of an acceptable password is k jones3 The passwords
114. lete its tables November 15 1999 1091 B DRAFT 5 29 Maintenance and Troubleshooting ezCallerID System Administration Manual Deleting CNAM Order Tables 1 Ifthe Oracle ezCallerID Orders database is not online repeat the first three steps found in Manually Register the ezCallerID Order Database Schema on page 5 25 2 Run the script to delete the ezCallerID orders CNAM Oracle database tables cd DP_DIR cnam schema export ORACLE_SID CNAM delDB sql dbadm dbadm CNAM DP_DIR cnam schema delIgpSch sql gt gt dev null lt continuation of command gt Deleting Security DB tables 1 If the Oracle Security Agent database is not online repeat the first three steps found in Manually Register ezCallerID Security Database Schema on page 5 26 2 Run the script to delete the Oracle security database tables cd DP_DIR cnam schema export ORACLE_SID CNSECDB de1lDB sql dbadm dbadm CNSECDB DP_DIR cnam schema delSecDB sql gt gt dev null lt continuation of command gt 5 30 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Appendix A Glossary This glossary provides a description of abbreviations acronyms and terminology used in the DSET ezCallerID product guides Table A 1 Glossary 1 of 3 Acronym CLEC Competitive Local Exchange Carrier The new group of deregulated telecommunications providers that compete on a selective basis to provide long distance celular and other services
115. letter name you want We will use the default ezCallerID application names CNAM and CNSECDB provided in the DSET installation script ezCallerlID Oracle Databases There will be two Oracle databases created e CNAM used for storing CNAM documents e CNSECDB used for storing user ID accounts passwords and privileges assigned to each user ID by the ezCallerID System Administrator Storage Space Estimation The CNSECDB Security Agent Oracle Database requires an initial size of 10 Mb of disk space with an incremental increase of 10 Mb This database will require more storage only if a large number of User IDs are defined The CNAM Document Oracle Database will grow according to the volume of CNAM orders and messages used by the customer Use Table 2 2 to estimate the amount of disk space your company needs to accommodate the projected volume of ezCallerID orders November 15 1999 1091 B DRAFT 2 7 Installing ezCallerID ezCallerlID System Administration Manual Table 2 2 ezCallerID Oracle CNAM Database Size Estimation Number of CNAM Database CNAM Database Orders per Month a eh Sagan S 5 000 2 Mb 24 Mb 10 000 4 Mb 48 Mb 20 0000 8 Mb 96 Mb The table creation for this table includes a start size of 250 Mb and an increment of 10 Mb as needed The retention period of the documents in the database determines its ability to reuse disk space Old documents can be removed from the database and archived to backup media Co
116. lib libaio so 1 libm so 1 usr lib libm so 1 libthread so 1 gt usr lib libthread so 1 LbECssoub Ss usr lib libC so 5 libw so l1 gt usr lib libw so 1 libintl so 1 gt usr lib libintl so 1 libmp so 1 gt usr lib libmp so 1 Figure 2 5 Example Console Output from the command 1dd cnamIgp If any of the library pathnames are not found ensure the Oracle and CORBA Orbix library directories are included for the PATH variable in SDP_DIR cnam profile file Check with the command echo PATH Note For the processes cnamIgp and secAgent you should see the Oracle binary library listed For the cnamgw gateway process you should see the Orbix library if you are using the CORBA OSS integrated configuration November 15 1999 1091 B DRAFT 2 51 Installing ezCallerID ezCallerlID System Administration Manual F Verify CORBA Software CORBA OSS only 8 Test to see if the CORBA software Orbix process daemon is running by using the UNIX command ps ef grep orbix You should see a response similar to this next line where cnam is the user ID 4893 is the process ID that identifies Orbix and 16 55 56 is the current time root 307 1 0 Oct 26 0 12 opt iona OrbixMT_2 3c bin orbixd cnam 4893 4877 0 16 55 56 pts 11 0 00 grep orbix G Verify Oracle Databases are Started 9 Test that the Oracle ezCallerID databases are online by typing the commands ps ef grep ora grep CNAM or ps ef grep
117. ling ezCallerID 17 18 19 20 2 40 ezCallerID System Administration Manual Type the name of the host machine You must manually type the name There is no default Once you type the name of the host machine the installation script echoes your response and requests confirmation Remote CORBA hostname is paso CONFIRMATION Is this CORBA hostname correct y n Type Y to confirm the CORBA host name or type N to return to the prompt in Step 16 on page 2 39 Now you must identify the remote server name The installation script prompts you with Remote CORBA server name is the name of the OSS API server T RVER Type the remote corba server name PSRANCILLARYS default Type the name of the remote CORBA server Once you type the remote CORBA server name the installation script echoes your response and requests confirmation Remote CORBA server name is PSRANCILLARYSERVER CONFIRMATION is this correct y n Type Y to confirm the remote CORBA server name or type N to return to the prompt in Step 18 on page 2 40 Now you must select the amount of time the ezCallerID gateway waits before it extracts a CNAM order from the OSS The installation script prompts you with The ezCallerID gateway waiting period is the time the gateway waits before extracting an order from the OSS The default value is 24 hours which equals 86400 seconds Type the waiting period in seconds 86400 defa
118. list of log files contained in the directory The browser now displays all the log file names from the selected directory 7 Bookmarks A Location http gorda 6011 log Cnamlgp Index of log CnamIgp mode links bytes last changed name dr x 2 1024 Jan 4 22 37 dr x 5 512 Apr 16 1999 r 1 1786 Apr 19 1999 CnamIgpa ctivity 19990419 r 1 58952 Apr 20 1999 CnamIgpactivity 19990420 r 1 451 Sep 9 00 00 CnamIgpa ctivity 19990909 r 1 451 Jan 1 00 00 CnamIgp ctivity 20000101 r 1 451 Jan 10 00 00 CnamIgp ctivity 20000110 r 1 451 Feb 29 00 00 CnamIgp ctivity 20000229 r 1 451 Mar 1 00 00 CnamIgpa ctivity 20000301 p 1 1804 Oct 10 00 03 CnamIgpactivity 20001010 r 1 451 Jan 1 00 00 CnamIgp ctivity 20010101 r 1 481 Apr 16 1999 CnamIgpTrace 19990416 r 1 1162 Apr 19 1999 CnamIgpTrace 19990419 r 1 6670 Apr 20 1999 CnamIgpTrace 19990420 r 1 1153 Apr 23 1999 CnamIgpTrace 19990423 r 1 1153 Apr 29 1999 CnamIgpTrace 19990429 r 1 104 Sep 9 00 00 CnamIgpTrace 19990909 r 1 104 Jan 1 00 03 CnamIgpTrace 20000101 r 1 1249 Jan 3 19 40 CnamIgpTrace 20000103 r 1 1249 Jan 4 22 38 CnamIgpTrace 20000104 r 1 104 Jan 10 00 00 CnamIgpTrace 20000110 r 1 104 Feb 29 00 00 CnamIgpTrace 20000229 r 1 104 Mar 1 00 00 CnamIgpTrace z0000301 r 1 785 Oct 10 00 01 CnamIgqpTrace 20001010 r 1 104 Jan 1 00 00 CnamIquTrace 20010101 ar D http gorda 6011 log Cnamlgp Cnamlgp ctivity 20000
119. llerID mode links bytes last changed name dr x 3 512 Sep 16 16 00 dr x 3 512 Sep 16 15 56 r 1 492438 Sep 15 13 41 DsetCnamappl r 1 169 Mar 3 1999 GEN html r 1 176 Sep 16 16 00 SWB html dr x 3 512 Sep 16 15 57 log r 1 634 Aug 24 1999 main GEN html I 1 634 Sep 16 16 00 main SUB html Figure 3 1 The Index of Directory in the Web Browser window 2 When the Browser displays the Index information click the underlined text SWB html The ezCallerID Clearinghouse window displays and the User Login dialog window displays as a temporary pop up window This is shown in Figure 3 2 3 2 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels DSET ezCailerID Gateway User Login window that pops up User ID Password OK Exit I Unsigned Java Applet Window Figure 3 2 The ezCallerID window User ID s admoo Password ok Exit i l Unsigned Java Applet Window Figure 3 3 User Login window 3 Type your User ID and password in the User Login window as shown in Figure 3 3 These parameters are case sensitive Service Representatives get their initial password from the System Administrator System Administrators see the Default User IDs and Passwords section of the System Administration manual 4 Click OK November 15 1999 1091 B DRAFT 3 3 Defining Users and Privilege Levels ezCal
120. ly Home directory pathname for the Orbix v2 3 c software u Determine the Installation directory where to install the ezCallerID The UNIX file directory should be empty See DSET Application File Directories on page 2 24 for a better understanding the file directory structure Oracle server version v8 0 5 Download the latest Oracle software patches for v8 0 5 Oracle name for CNAM Document Database instance D OJ O O Oracle name for Security Agent Database instance 2 2 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID References November 15 1999 These books provide more information about the ezCallerID installation The System Administrator should have a copy of each Solaris Operating System 2 5 1 Administration Guide Volume 1 SunLink 8 1 Communication Platform Administrator s Guide Orbix Administrator s Guide Orbix 2 v2 3 Oracle 8 Release 8 0 5 for SUN SPARC Solaris 2 x Administrator s Reference Oracle DBA Handbook 8 0 Edition ezCallerID User s Manual 1091 B DRAFT 2 3 Installing ezCallerID ezCallerID System Administration Manual Install Third party Software Creating the basic DSET environment for all Gateway applications requires the ezCallerID System Administrator to make several key decisions e Determine if your company wants to use MetaSolv s Telecom Business Solutions software for an Integrated solution or use a simpl
121. m Administration Manual 10 The installation script displays Installation of DSET product starts Uncompressing the compressed tar file Extracting files from tar file Verifying distribution Installed files have been verified 11 When prompted type the ezCallerID System Administrator User ID DSET Admin Login Name root Important Do NOT use the UNIX user ID root use the ezCallerID System Administrator User ID for example CNAM you created before installation 12 The installation script continues to display the messages changing the file and directory ownership Installation of DSET Product is complete The DSET administrator needs to refer to the administration guide to set up the DSET environment before it can be used An example login profile is created as lt ezCallerID Home Directory Name gt profile Note The login profile pathname is DP_DIR profile The initial portion of the DSET product installation script is complete What the instalIDSET Script Does The instal1DSET script performs serveral vital checks of the UNIX environment to determine if you are ready to install the ezCallerID product e Itremoves any installation files left from previous ezCallerID software installations e Verifies that the ezCallerID home file directory is empty 2 30 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID November 15 1999
122. manually register the Oracle ezCallerID orders Database schema you must go through these steps November 15 1999 1 Start the CNAM Orders Database Login as oracle User Id Set ORACLE_SID variable by typing export ORACLE_SID CNAM Start the CNAM Orders Database with the Oracle server manager with commands svrmgrl connect internal startup exit out of the Oracle server manager Login as oracle User ID unless you did it in Step 1 and start the Listener by typing the commands Ilsnrctl stop Isnrctl start exit 1091 B DRAFT 5 25 Maintenance and Troubleshooting ezCallerID System Administration Manual 4 Run the two scripts to define the ezCallerID orders CNAM Oracle database tables cd DP_DIR cnam schema export SIGP_DB_NAME CNAM regSch sql dbadm dbadm CNAM SDP_DIR cnam schema regIgpSch sql gt gt dev null lt continuation of command gt 5 Use these commands in a script to test for successful manual registration if 0 then ecno echo Warning register S IGP_DB_ NAME schema failed echo There may be permission problems echo else echo echo Register th zCallerID CNAM Oracle database echo schema is done echo fi Manually Register ezCallerID Security Database Schema 5 26 To manually register the Oracle ezCallerID Security Agent Database schema you must go through these steps 1 Start the CNAM Orders Database Login as oracle User I
123. me of host machine ping Determine the TCP IP address of machines on this network Oo Determine the exact directory pathname where to install the ezCallerID The UNIX file directory should be empty See Figure 2 2 to better understand the file directory structure Steps to Define Basic DSET Environment To set up the Basic DSET environment you must 1 Determine the third party software information needed for ezCallerID Installation 2 Create a UNIX user ID with sufficient superuser authority DSET recommends that you use the name CNAM 2 22 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID 3 Create the ezCallerID home file directory 4 Copy the ezCallerID application from the distribution media tape CD ROM etc 5 Run the script that checks and defines the standard DSET product environment Determine Information Needed for ezCallerID Installation If you installed any third party software you will be asked to provide 1 home directory names 2 process names or 3 database instance identifiers to the ezCallerID installation script There are two possible installation configurations for the ezCallerID application e Standalone GUI Use a persistent Oracle database to store large numbers of ezCallerID customer orders with standalone Java based GUI software e Integrated Use an OSS CORBA GUI interface to permit a large number of service representati
124. n Manual Installing ezCallerlD To create the appropriate DSET application User ID login to the Oracle software as the Oracle user and start the Server Manager o svrmgrl connect internal create user dbadm identified by dbadm grant all privileges to dbadm connect system manager ORACLE_HOME sqlplus admin pupbld sql quit Note If the ezCaller D System Administrator has to manually start the Oracle databases or register the database schemes they will need to use this user ID and password J Set up Oracle Network Communications All the above database instances can exist in one machine holding all the CNAM documents and user security information Remote DB access means the DSET ezCallerID gateway can run on a different machine than the machine holding the Oracle database instances For this to happen the machine on which the gateway instances are running should be configured so as to make the DB instances accessible through Oracle s SQL Net e tnsnames ora Transparent Network Substrate TNS Names e listener ora Oracle Listener Client These files should point to each of the DB instances created by the above naming convention for example CNAM and CNSECDB Edit the TNS Names File Because Oracle SQL Net V2 supports multiple communications protocols we need to edit the TNS Names file to describe the 1 communications protocol and 2 connection descriptors for each Oracle database instance After w
125. n in the Service Center field This can be up to 6 digits 3 Type the full name of the Service Center in the Description field This can be up to 100 alphanumeric characters 4 Click OK The Operation Response window displays indicating your change was successful 5 Click OK to close the window November 15 1999 1091 B DRAFT 4 1 Communicating with Service Centers ezCallerID System Administration Manual 6 Next you must create the DownStream Interface DSI skip to 4 2 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers Viewing All Service Centers 1 Select Service Centers gt View all Service Centers The Get Service Centers window appears 2 Click OK The Service Centers window displays a list of all Service Centers as shown in Figure 4 2 Service Center Name Description 1333333 test OK jz Unsigned Java Applet Window Figure 4 2 Service Centers window with a list of all Service Centers 3 Double click a Service Center for more detail The Service Center Info window displays Service Center Name im Description testin g ey Unsigned Java Applet Window Figure 4 3 Service Center Info window 4 Click OK to close the windows November 15 1999 1091 B DRAFT 4 3 Communicating with Service Centers ezCallerID System Administration Manual Deleting a Service Center Once a Service Center is created it cannot
126. n on external media cd SDP_DIR tar cvf dev rmt0 cnam lt use tape on dev rmt0 November 15 1999 1091 B DRAFT 2 57 Installing ezCallerID ezCallerlID System Administration Manual O Setup DSET Customer Service Dial in Procedure Set up remote access for the cnam User ID that governs the ezCallerID application DSET customer service personnel may need to dial in and check the processes view log files and interpret key error messages to provide timely technical support Ensure that the cnam user ID has write access to the Product subdirectories see Table 2 7 under the ezCallerID installation directory What to Do Next After you start the ezCallerID the Privilege Levels and User IDs need to be defined Proceed to Chapter 3 Defining Users and Privilege Levels If the ezCallerID application does not successfully send a document through the gateway begin using the problem determination procedures in Chapter 5 Maintenance and Troubleshooting Uninstalling the ezCallerID Application 2 58 You can uninstall ezCallerID by deleting all the files in the top level cnam installation directory 1 Change to the installation directory with the command cd DP_DP 2 rm rf SDP_DIR Example rm rf cnam2 0 6 This command removes all files and subdirectories without prompting the System Admninistrator Use it when you are preparing to install an upgraded version of the ezCallerID application 1091 B DRAFT November 15 1999
127. n the ezCallerID Installation Script can not automatically find the Host Name of the UNIX machine on which the DSET application is being installed You are prompted with the text Enter the IP address of the cnam gateway host Once you type the TCP IP address of this UNIX computer the installation script echoes your response and requests confirmation The server host IP address is 192 134 67 11 CONFIRMATION is this correct y n Type Y to confirm the Host TCP IP address or type N to return to the prompt in Step 25 on page 2 42 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Build the ezCallerID Home Page During the next phase of the installation script the ezCallerID application HTML Home document is created automatically As a system administrator this is the HTML file that your Operations personnel select when they access the ezCallerID application via the HTTP port number For example if your host machine name is larry the HTTP Daemon Port Number see HTTP Daemon Port Number on page 2 43 is 6601 and the ILEC you are working with is Bell Atlantic North designated as BAN your operations personnel would Step A Type the URL http larry 6601 in Netscape Communicator 4 61 or later or Internet Explorer 4 15 or later to find the ezCallerID application Step B Click the HTML document file name main BAN htm1 to start the ezCallerID application HTTP Daemon Port Num
128. ng the ezCallerID Gateway ieee cceseeeseescecnecesesecsseesecsceseeeeseeseeeeaeeeeeas 2 53 T Fest all ez all rID ProCesses cts isccgneets tives tenets siropa eirt E EE E 2 53 J Start ezCallerID Web Browser Standalone GUI ccceccccecesseceeesteeceeeceessseeeneneees 2 54 K Set up a Service Center and DownStream Interface eee eeeeeereeseeeeeneeeneeseeaes 2 55 L Create CNAM Orders documents 0 ccccccccessecesesceeceeeceeesseecsesecesseecseaeeeseseeeeseeeeaes 2 56 M Verify Orders Sent through Gateway 000 0 cee cecesecesceseeesceseeeeeeeeeeeseaeeseesseesaecaeesaeeaes 2 56 N Backup Installation Directories ccs ceseeseceeceseeeeceseeeeceseeeeecaeeeaecaeesaecsecsaeeseeseees 2 57 O Setup DSET Customer Service Dial in Procedure ieee cesses ceeeeeeseeeeeeeneenee 2 58 What to DO Nektaro i EEA eniue teen E E E EE ie 2 58 Uninstalling the ezCallerID Application 00 ce eeeeeceeeeeeeeseeeeecaeecaecaaesaecneceseeseenaeees 2 58 Defining Users and Privilege Levels sscccsccssssscsscsssssscsssssscscssscsscssscssscsscssesssecsesssccsessssssssescssssssesssoses 3 1 Getting Started cscs sei ne r nee aatiain a acti aatingantimeaasia sition ngs 3 1 Login toezCaller Dio a eee Sek OaE E Meh AIBA ANA 3 1 Choosing Acceptable PasSWOrdS s sisiisississserosisrsesressiosrororesisstopros sesser peresen osades oisi ses os sriie 3 5 M odifying Pass Words icc nsan ch oee araors EE E e E O a a es 3 6 Exiting the ez
129. nistrator can assign as many Operations Codes to a privilege level as necessary When users login to the ezCallerID they are only able to perform those functionalities that are listed in their privilege level Any GUI operation not included in their privilege level is disabled and the menu option is inaccessible Table 3 2 lists the Operation Codes and their associated menu ocomman Table 3 2 Privilege Operation Codes 1 of 2 Code Operation Description 1 All 100 Privilege Level Create 101 Privilege Level Modify 102 Privilege Level View 103 Privilege Level Delete 104 User Create 106 Modify User Privilege Level 107 User View 108 User Delete November 15 1999 1091 B DRAFT 3 17 Defining Users and Privilege Levels ezCallerID System Administration Manual Table 3 2 Privilege Operation Codes 2 of 2 Code Operation Description 112 Account Info View 113 Account Create 114 DSI Info 115 DSI Create 116 DSI Info Modify 117 Activity Log 120 ezCallerlID Create 121 Get ezCallerID Documents Data Factors to Consider Since you are determining each person s authority in the ezCallerID consider what each person does in their daily job Do you want a Service Rep changing upload schedules which could effect the entire system s processing Also decide who will be correcting ezCallerID document errors and who will be checking for confirmation messages Is it your job or th
130. nsult Chapter 5 Preventative Maintenence section See INSERT CROSS REFERENCE Overview Creating Oracle DSET ezCallerID Databases Table 2 3 ezCallerID Oracle Database Creation Steps 1 of 2 bee Step Page Once You Have Performed this Step m A 2 9 Login and source Oracle profile with needed environment variables m B 2 10 Create UNIX directories for each database mount point m c 2 10 Create UNIX directories to hold other Oracle database instance administration files m D 2 11 Copy and edit initialization and configuration files to use for the ezCallerID databases m E 2 12 Create links from the configuration and initialization files to the Oracle administration home directory m F 2 12 Set up some SQL scripts to create the actual space allocations for the databases m G 2 13 Run the Oracle scripts to create the CNAM and CNSECDB table structures m H 2 14 Mount the ezCallerID the CNAM and CNSECDB Oracle databases m l 2 14 Create a DSET Product DBA User ID 2 8 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Table 2 3 ezCallerID Oracle Database Creation Steps 2 of 2 Check here Step page Oo J 2 15 Once You Have Performed this Step Set up the Oracle Communications Network for the two databases A Define Environment Variables 1 Login as the Database Administrator at your company site with the Oracle User ID To make configuring the
131. of 3 Acronym ILEC Incumbent Local Exchange Carrier A traditional old incumbent local exchange carrier that was part of the Bell System or an Independent Local Exchange Carrier such as GTE or Alltel NPA Number Plan Area A fancy way of saying area code of the telephone number OCN Operating Company Number A valid operating company number thats required for portable exchanges oss Operations Support System Methods and procedures that directly support the daily operation of the telecommunications infrastructure The average Local Exchange Carrier has hundreds of systems supporting order negotiation order processing line assignment line testing and billing PDF Portable Document Format A format developed by Adobe to allow printed documents to retain formatting while viewed online with multiple operating systems DSET transforms its written documents into PDF for distribution to customers PON Purchase Order Number A unique number automatically assigned to the service order by the ezCallerlD application sc Service Center A clearinghouse that collects and processes roaming and billing information from a number of carriers It then transfer the compiled data including confirmation codes and error messages to the proper carriers SCP Service Control Point A remote database within the System Signaling 7 network which supplies the translation and routing data needed to deliver advanced network services
132. oftware executables that support the ezCallerlD product cnam DATA Stores CNAM documents in UNIX File System cnam etc Provides list of files copied to disk during this installation Oracle SQL scripts that create DSET databases register the cnam schema ezCallerlID database schema and perform database maintenance functions Contains the stand alone Java GUI that works with your Web cnam www Browser and the troubleshooting logs need to diagnose problems with the application gateway or security system November 15 1999 1091 B DRAFT 2 25 Installing ezCallerID ezCallerID System Administration Manual Application Processes and Scripts Subdirectories bin and d dir contain the DSET ezCallerID application processes You will use the bin subdirectory to manually start and stop the ezCallerID application Configuration Files These files contain the gatway application and security configuration set up by the ezCallerID installation script for a specific trading partner ILEC designated by XXX XXX cnamgw cfg ezCallerID gateway configuration file XXX cnamliIgp cfg Defines how and where ezCallerID documents are stored by the IGP and the names IDs used to communicate with the regional NPAC center XXX security cfg Defines what format and SAP IDs are used to implement the ezCallerID internal security agent CNAM Documents Errors and Notification Messages The DATA subdirectory contains the CNAM documents err
133. oh EEEE EE sleeves Coenie Gus live eo Eeh B 6 Verifying ezCallerID Stats noenee e echsces Sececbh ocbestdp capagiscedsassassensh dos sngvess as EEE ar Eoi o ESS ERASE ER B 7 Checking the Web Server nn er r eesti ale E IEA ane B 8 Removing ez CallerlD anno eee eena ie Suse baees asks Lice such sea nace EEEE E o an Era eE isaac laos B 9 Catalog of Windows and Fields ccsccscssscsccsssescscsscccescscesescssssescsssesscscssssssessecssesssceseesscssessessesssesseeseeees C 1 SOLVICE CONE TS E E A E eaten pete ts ease chee E eee Linea C 1 Creating New Service Center 0 00 E A a A EE a C 1 Viewing Service Centers se eo eas eaae a enh Tae N aioe eons ener C 1 Downstream Intertace ispitei oieri reir e or res Ee EEEE Err SENEE r PESTE E EE EEO EEE EEEE E EE C 3 Creating DownStream Interface Information eee cece ceeeeeeeeeeeeeeceeeseecaecaeeseenseenees C 3 Setting Week Mask Download Frequency 00 ccc eececeesecsceesececesececeseeseeneeeeseaeeeeseneeaeeeaa C 4 Setting Periodic Download Frequency ce eeeececeesceeceeeeeeseseecaeeseecaecaeaecsaeeseenseeseeeens C 5 Modifying DSI Information 2 0 2 c5sscscdes sbsedh nerse etree r E chive REE ET EES eos C 6 Viewing DownStream Interface Information sssseeseseeeesssressstsresresesresrerrsreerrrrererrereresse C 6 Viewing WeekMask Download Frequency ssseessseeessseeessreessrtererreesrsserrrseeresresesrrererreee C 8 Viewing Periodic Download Frequency ssesesseeseeer
134. on 1 cd SDP_DIR cnam 22 df bt du s CNAM Orders Documents For the instance of the Oracle database you created for the ezCallerID application orders go to the file directory SORACLE_MOUNT oraclel oradata CNAM data0l dbf This database increases in size by 5 Mb increments until it reaches a maximum size of 150 Mb Use the df and du commands to monitor disk space for the file directory defined by the SORACLE_MOUNT environment variable Notification Messages and Errors Your message queue usage increases as notifications and errors are uploaded from your trading partner You need to check your disk usage on a regular basis depending upon the frequency you schedule notification uploads The notification messages reside in the file directory SDP_DIR cnam DATA ACNTS lt Trading Partner gt input 5 2 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Application Process Health Application Gateway Status As System Administrator you need to check the status of the ezCallerID application You can do this from any UNIX machine 1 On any UNIX terminal at the command prompt enter command ps aef grep startup The system reply will be similar to cnamadm 14951 1 0 19 51 04 pts 8 0 00 startup export home cnamadm cnamGW cnam config cnam startup CNAMadnm is an example of a User ID and 14951 is a sample process ID All ezCallerID Processes 2 To check on th
135. opped ps flgrep lt ezCalleriID_processes gt Replace lt ezCallerID_processes gt with each process startup lsrgw cnamlgp secAgent namemgr andthttpd 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Checking namemgr Several processes in the ezCallerID use the namemgr to register information If it is not running the following message may appear Can t create SAP Make sure that namemgr is running Issue the ps command to see if namemgr process is running If the namemgr process is running and this problem occurs the time lag between the namemgr process and the other ezCallerID processes in the startup config file is not sufficient 1 Stop the ezCallerID application see 2 Using a text editor to modify the SDP_DIR cnam config cnam startup file 3 increase the time lag and 4 restart the Gateway Verifying Database Access The secAgent and cnamlgp processes need access to database files to input or access information If they can not access the database the following message may appear D_usr_opendb failed Make sure the database files specified in the configuration files exist and have the correct file permissions Starting the ezCallerID Gateway 1 Start from directory SDP_DIR cnam bin 2 Type the command cnam stop 3 Make sure all CNAM processes have stopped ps ef grep lt LSR_processes gt November 15 1999 1091 B DRAFT 5 17 Maintenance
136. ora grep CNSECDB You should see a response similar to the following lines for the two Oracle databases CNAM and CNSECDB 1 0 16 45 13 3 06 oracleCNAM LOCAL NO 0 Oct 26 0 11 ora_dbw0_CNA 0 OGE 2652 0 04 ora_pmon_CN 0 Oct 26 0 12 ora_lgwr_CN Oct 26 2 40 ora_ckpt_CN 0 0 Oct 26 13 ora_smon_CN Oct 26 02 ora_reco_CN Ce ASE amp Oc Oc Oc Oc Oc Oc 26 04 ora_pmon_ 26 00 ora_dbw0_CN 26 7 2 02 26 7 25 26 14 ae 26 7 02 I EEL WEP he Ee Et Figure 2 6 Example Console Output for Oracle Databases 2 52 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID H Starting the ezCallerID Gateway 10 To start the ezCallerID gateway change the current directory to the ezCallerID 11 subdirectory containing the ezCallerID process scripts cd SDP_DIR cnam bin Type this command at the prompt cnam start You should see a response similar to these lines if the start command is successful Info cnam invoked on pts 2 by cnam Date Mon Nov 1 19 04 30 CST 1999 Checking for environment variables 6640 started on gorda pts 2 at Mon Nov 1 19 04 33 CST 1999 by cnam Test all ezCallerID Processes 12 Ensure all six processes namemgr thttpd secAgent startup cnamIgp and cnamgw ate active 13 Type the command at the console ps ef grep cnam Note You may see some extra processes that belong to the
137. ormance e Storage spaces initial extent next extent size etc suggested by your Oracle DBA need to be modified 1091 B DRAFT 5 27 Maintenance and Troubleshooting ezCallerID System Administration Manual 5 28 To clean up the Oracle database schema you need to 1 Drop the current schema from the datbase instances Modify the contents of the corresponding schema registration SQL scripts Re register the appropriate schema as described in Manually Registering Oracle Schema on page 5 24 The Oracle SQL scripts that define which database tables are dropped dropDB sql dropGenDB sql Called by dropDB sql1 to drop the tables that describe the schema name changes dropIgpDB sql dropSecDB sql The CNAM Oracle database instance needs the dropDB sql and dropIgpDB sql scripts The CNSECDB Oracle database instance needs the dropDB sql and dropSecDB sql scripts to drop its tables Dropping the ezCallerID Orders Database 1 If the Oracle ezCallerID Orders database is not online repeat the first three steps found in Manually Register the ezCallerID Order Database Schema on page 5 25 Run the script to drop the tables containing the ezCallerID orders in the CNAM Oracle database cd DP_DIR cnam schema export ORACLE_SID CNAM dropDB sql dbadm dbadm CNAM SDP_DIR cnam schema dropiIgpSch sql gt gt dev null lt continuation of command gt pS 1091 B DRAFT November 15 1999 ezCallerID System Administrat
138. ors and supporting files Database Schemas The schema subdirectory contains SQL scripts needed to define the schemas for the CNAM document and security databases Other scripts register the database schemas define tables and fields and perform maintenance functions Logs Each of the ezCallerID processes read a separate configuration file to specify the actual directory where Logs are created Figure 2 2 shows the standard directory structure for the logs This is consistent with the LOG_DIR parameter specified in the configuration files of the ezCallerID processes 2 26 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID web Server Root Directory CNAM Log Root Directory Trading Trading Trading Partner 1 Partner 2 Partner 3 one Figure 2 2 Log Directory Structure The trading partner log subdirectories cnamgw cnamlgp and Security contain CNAM document and software actions the System Administrator can use to determine that the ezCallerID application is functioning properly Copy ezCallerID from Distribution Media 1 Mount the DSET installation TAR tape or CD ROM 2 Use the cd command to position yourself at the Installation Directory for the ezCallerID application 3 Starting at the top level directory where ezCallerID will be installed retrieve the application files from tape using the UNIX command tar xvf deviceName Example tar xvf dev rmt 1 If
139. ort System OSS server 3 The request is stored in two formats one for ezCallerID and the other for the UNIX File System UFS Discuss variation with with the different configurations using OSS vs TBS and the UNIX File System vs Oracle persistent database 4 Next the request is sent to the Service Center according to the data transfer schedule defined by your system administrator The Service Center is a pick up stop for the ILEC November 15 1999 1091 B DRAFT 1 3 Introducing ezCallerID ezCallerID System Administration Manual 5 The ILEC picks up the request and verifies the data against their information A notification message is returned to the Service Center indicating the condition of the request 6 The UFS retrieves the message from the Service Center and it displays for the Service Representative to read 7 The notification message can dictate two outcomes a If accepted the transfer is complete and the customer is provisioned The CLEC has the ezCallerID information so they can provide complete service for that customer b If not accepted due to errors the errors are corrected using the ezCallerID and the request is once more sent Order Status Every Caller ID customer order has a status definition The status definition describes the current state of the order from its initial creation to the point of order completion Table 1 1 Order Status States 1 of 2 Status Description Compl
140. oted the OSS shutdown processes or the No Orbix daemon at node paris UNIX machine is down Completion status COMPLETED_NO Message startup Make sure Increase the time interval seconds between when the namemgr is running before you namemgr process starts and subsequent processes start the agent Message Can t create SAP Make sure that Increase the time interval seconds between when the namemgr is running namemgr process starts and subsequent processes The transfer protocol link between the The ezCallerID keeps every document that goes through it in ezCallerID and the Service Center is a persistent database If the acknowledgement 997 is not interrupted while sending an order document received from the Service Center within a the time you specify the order document is sent again November 15 1999 1091 B DRAFT 5 13 Maintenance and Troubleshooting ezCallerID System Administration Manual Table 5 3 ezCallerID Problem Determination 2 of 2 What if Then Do The transfer protocol link between ezCallerID See Transfer Protocol corrective actions and the Service Center is interrupted while receiving a notification message The link between ezCallerID and the OSS breaks while transfering a document As determined by the OSS Server Any complete document that reaches ezCallerID is stored in a persistent database The Gateway has a variable that determines the number of times the gateway r
141. ovember 15 1999 ezCallerID System Administration Manual Catalog of Windows and Fields Viewing Periodic Download Frequency November 15 1999 N Interval x 180 seconds OK Cancel Frequency interval Ey Unsigned Java Applet Window Figure B 13 Interval window 1091 B DRAFT C 9 Catalog of Windows and Fields ezCallerID System Administration Manual ezCallerID Documents Creating ezCalleriID Documents To Access ezCallerID gt Create ezCalleriD Document N ezCallerlID Create x OTC Number SC NPA NXX LINE Value OCN Calling Name Transaction Type Effective Date 114411 214 212 320 RAO ezCallerlD B Presentation Indicator RE Oct ihs s OK Cancel Clear Ey Unsigned Java Applet Window Figure B 14 ezCallerID Create window Viewing ezCallerID Documents Table B 5 Field Value Constraints for ezCallerID Create Window 1 of 2 Field Name Length Type Description possible values The 6 digit code associated with the account name of a OTC Number aa f also known as Service Center 6 digits Service Center defined The Service Center numbers are defined by the System Administrator nps The first 3 digits of a station number in the format of NPA NEA 3 digits NXX LineNumber ee The next 3 digits of a station number in the format of MAN 3 digits NPA NXX LineNumber Line Value 4 digits The last 4 digits of a station number in the format of NPA L
142. ow See UNRESOLVED XREF for field descriptions 4 Click OK If you want to view the data transfer times you will examine the details of the DownStream Frequency information DownStream Frequency Details You can view the DownStream frequency for when the system checks for new ezCallerID documents It can be set to e Specific times on selected days of the week e A constant time interval between data transfers WeekMask This data transfer schedule specifies the actual times starting and stopping when the ezCallerID performs the operations Each day has its own schedule 1 Hold down the lt Shift gt key and click the weekMask field to select it 2 To view the Frequency schedules that control when the transmission of ezCallerID orders happen double click the WeekMask Frequency text with the white background 3 12 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels The WeekMask window displays as shown in Figure 3 14 Note Only the System Administrator can change the DownStream Frequency information N Week Mask Ea Sunday Monday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin Tuesday Wednesday StartHr StartMin StopHr StopMin Thursday StartHr StartMin StopHr StopMin StartHr StartMin StopHr StopMin po Saturday StartHr StartMin StopHr StopMi Selected start and stop times of the data Frid
143. owner cnam but these are the ones required for the ezCallerID gateway application to run November 15 1999 cnam 7345 7343 0 19 32 58 pts 2 0 00 ezConnect home cnam cnam2 0 6 cnam d dir bin namemgr lt Name Manager gt cnam 7357 7343 0 19 33 08 pts 2 0 00 ezConnect home cnam cnam2 0 6 cnam bin thttpd p 6601 d ezConnect home cnam lt HTTP Daemon gt 1091 B DRAFT 2 53 Installing ezCallerID ezCallerlID System Administration Manual cnam 7355 7343 1 19 33 08 pts 2 0 00 ezConnect home cnam cnam2 0 6 cnam bin secAgent p ezConnect home cnam cnam2 lt Security Agent Process gt cnam 7343 1 0 19 32 58 pts 2 0 00 startup ezConnect home cnam cnam2 0 6 cnam config ILLUMINET cnam startup lt Startup Process gt cnam 7356 7343 1 19 33 08 pts 2 0 00 ezConnect home cnam cnam2 0 6 cnam bin igpAgent ILLUMINET lt IGP Process gt cnam 7359 7343 1 19 33 08 pts 2 0 00 ezConnect home cnam cnam2 0 6 cnam bin cnamgw 20 ILLUMINET lt cnamgw Process gt J Start ezCallerID Web Browser Standalone GUI 2 54 Note If you are not using the TBS software from MetaSolv or another Operation Support System OSS then you must perform major steps J and K to send a test CNAM order document through the ezCallerID gateway application For example if your host machine name is larry the HTTP Daemon Port Number see HTTP Daemon Port Number on page 2 43 is 6601 and the ILEC you are working with is Bell Atlantic No
144. pplet Window Figure 3 8 Logout Window 2 Click Yes to close the ezCallerID Console primary window November 15 1999 1091 B DRAFT 3 7 Defining Users and Privilege Levels ezCallerID System Administration Manual Organization of Menu Commands Most ezCallerID commands are accessed using the menu bar and its subordinate menu commands Session Admin ezCallerlID Service Centers DownStream Interface Log Exit DovwnStream Interface View DSI info Create DSI Modify DSI info Privilege gt User Menu gt User Menu Modity View Delete Modify Password Figure 3 9 ezCallerlD Menu Commands Some commands are reserved for the System Administrator and other specific users All commands under the Admin menu are reserved for some of these User IDs Note Ifa menu command is grayed out your User ID does not have privileges to perform this command If your User ID needs to perform a function contact your ezCallerID System Administrator and inform the individual that the Privilege Level assigned to your User ID is incorrect 3 8 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels The Service Center A Service Center is the communication link between you and the Line Information Database LIDB It is needed to port exchange telephone number information It works similar to an electronic mail box You use DSET s ezCallerID
145. prevent from running out of storage space it is recommended that the ezCallerID document output files be removed periodically These files should be backed up to tape prior to deleting them 1 To remove CNAM documents stored in the Oracle database the Oracle DBA needs to gt Stop the ezCallerID application with the appropriate script Bring Oracle CNAM database offline and stop the ezCallerID listener processs Use SQL PLUS commands to archive orders Delete desired CNAM document records Free up space in the actual user_data datafile SORACLE_MOUNT oraclel oradata CNAM user01 dbf Mount the CNAM Oracle database and turn on the listener process gt Start the ezCallerID application VVVV Vv 5 22 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Backing up Messages and Errors 2 To remove CNAM notification messages and errors type the commands cd DP_DIR cnam DATA ACNTS lt Service_CenterI gt tar uvf dev rmtO input lt use tape on dev rmt0 rm rf input cd lt Service_Center2 gt tar uvf dev rmt0O input rm rf output lt continue for each service center gt Backing up the Logs The names of log files end with the date they were created We recommend that the ezCallerID log files are backed up to tape weekly The logs are simple ASCII files and can be backed up using standard UNIX utilities After backups you can delete the log files so that th
146. r IDs as shown in Figure 3 27 Figure 3 27 User View Response window 3 To view more User ID details select and double click a User ID The User View Response window appears 4 Click OK to close the window Deleting a User ID The System Administrator privilege can delete a user from the application Once a user ID is deleted it must be re created before that user can access the application again 1 Select Admin gt User Menu gt Delete The User Delete window appears Figure 3 28 User Delete window 2 Type the User ID 3 Click OK twice November 15 1999 1091 B DRAFT 3 27 Defining Users and Privilege Levels ezCallerID System Administration Manual 3 28 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Chapter 4 Communicating with Service Centers This chapter describes how to create Service Centers and configure the communication link between you and the UNIX File System UFS Creating a New Service Center Note When you create a new Service Center the corresponding DownStream Interface DSI information must also be created before it will work 1 Select Service Centers gt Create a New Service Center The Create Service Center window displays as shown in Figure 4 1 N Create Service Center Eg Service Center Description OK Cancel j Unsigned Java Applet Window Figure 4 1 Create Service Center window 2 Type the Service Center abbreviatio
147. racle databases allocate disk space 2 12 2 13 creation maintenance 2 26 deleting tables 5 29 dropping tables 5 28 DSET creation 2 12 edit for DSET 2 13 running 2 13 schema registration 5 24 Oracle SQL avoid modifying 5 25 prepares environment 2 30 security changing your password 3 6 disk space estimation 2 7 Security Agent delete database tables 5 30 drop database tables 5 29 Oracle database instance name 2 42 overview 1 9 port number 2 33 2 39 process name 2 36 register database schema 5 26 servers DSET application gateway 2 42 remote CORBA name 2 39 2 40 TCP IP port number 2 33 Service Centers SC creating 4 1 defined A 2 displaying a list 3 9 4 13 problems 5 14 viewing 4 3 Service Control Point SCP defined A 2 Service Management System SMS defined A 2 Index 8 ezCallerID System Administration Manual Service Orders tracking 5 7 SMS See Service Management System software DSET application components 1 7 software features new in this release xix sourcing DSET application profile 2 47 Oracle environment variables 2 10 starting DSET application 2 53 2 54 startup Oracle databases bring online 2 14 init config files 2 12 Oracle listener file 2 18 states ezCallerID order 1 4 status gateway 5 3 system administrators default passwords 2 55 default User IDs 2 55 a tables deleting 5 29 dropping 5 28 Oracle databases installation 2 44 TAR tape DSET installation 2 27 TBS See Telecom Busines
148. ript attempts to automatically e Register the CORBA OSS processes with the Orbix CORBA daemon e Register the schemas for the two Oracle databases chosen during installation Registering Processes with Orbix Software CORBA OSS only During this phase of the installation the script registers the ezCallerID application processes gateway and interconnection gateway platform with the Orbix software You will see console messages that begin with the words RUNNING C_SETUP ON Defining Oracle Database Schemas The ezCallerID Document Database and the Security Agent Database need to register the database schema structure of tables and procedures with the Oracle software To register the Oracle Schemas the two Oracle database instances must have been started and the Oracle Listener process must be running If these steps see H Mount the Databases on page 2 14 are not done prior to the ezCallerID installation the two databases must be started and the schemas registered manually 2 44 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID When the database schemas are registered by the installation script the console messages display as Explanation of registering Oracle schemas starting to register the CNAM database schema PL EFASE WAIT Register th zCallerID gateway CNAM Oracle database sc hema is done starting to register the CNSECDB database sc
149. rivescusstheves eepe p ekeen E EEE EEEE EERE EES 2 32 Port NUM befS aa ea a E ee ae ele 2 32 Reponses for ezCallerID Installation Script ssseesseeeseeereeseeresreesrsresrssterrsrerrsrenrereereees 2 33 Run the ezCallerID Installation Script ssesesseeesesseeesseeeseeeresrssesrsserrrseerrsreererenserrnsereesene 2 34 Finishing the ezCallerID Installation Script eseeeesseessseesesreersresrerrsresresreresrsresesserresreeesre 2 44 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Contents Post installation Fasks a a A E coche Shee AE ON AEE EEEE ARE E Ena EE 2 46 A gt Source theProfle Flens srne e a e E E E A a E RA 2 47 B Provide Variables to ezCallerID System Administrator ssesesseeesseereerereersreerreeeesrsee 2 47 ezCallerID Environment Variables sssessseseeseseseeeeseseeseesersestsstesrtssesstesresstesressessresres 2 48 C Validate ezCallerID Environment Variables eseseeeseeeeseeseeessreesrerrsrsresresrrerereeesrees 2 48 D Validate DB and CORBA Environment Variables s sseeeeseeeeseeeserereereresrsserersereesee 2 49 E Verify Library Paths for Processes esssesseseeeesseeessseesesesseressrerrsrenrsrenterreresrssersseeresre 2 50 F Verify CORBA Software CORBA OSS only ssesseeessssseessssreessresssrresrrresesrssererseeresee 2 52 G Verify Oracle Databases are Started o0 eee ees cseesee cee ceseesecnseeseceeceseeeeeeeeseeeaeeeeeas 2 52 H Starti
150. rth designated as BAN your operations personnel would 14 Type the URL http larry 6601 in Netscape Communicator 4 61 or later or Internet Explorer 4 15 or later to find the ezCallerID application 15 Click the HTML document file name main BAN htm1 to start the ezCallerID application An alternative method to access the application is to specify the TCP address the port number and the HTML document in one command hitp IP_addr_of_ CNAMGW_host web_port_number main trading_partner_name html Example http 38 254 200 10 6601 main BAN html 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID K Set up a Service Center and DownSitream Interface Sign on as the ezCallerID System Administrator 16 Follow the procedure in Login to ezCallerID on page 3 1 of the Defining Users and Privilege Levels chapter to establish yourself as the System Administrator of the ezCallerID application with access to all operations Use one of the default user IDs and passwords defined for the ezCallerID application s adm00 SEC ADM1 n adm10 NET ADM1 Create Service Center Create a Service Center trading partner to which you will send CNAM orders documents 17 Follow the procedure in Creating a New Service Center on page 4 1 of the Communicating with Service Centers chapter Set up Downstream Interface To effectively test the ezCallerID application gateway to see if documents ar
151. s Creating New Service Center To Access Service Centers gt Create a New Service Center N Create Service Center Ea Service Center Description OK Cancel ey Unsigned Java Applet Window Figure C 1 Create Service Center window Table C 1 Field Constraints for Create Service window Field Name Length Type Description possible values Service Canter 6 digits The 6 digit code associated with the Service Center Description 1 100 alphanumeric characters A description of the Service Center Viewing Service Centers To Access Service Centers gt View all Service Centers November 15 1999 1091 B DRAFT C 1 Catalog of Windows and Fields ezCallerID System Administration Manual N Service Centers xi 111111 testing Figure C 2 Service Centers window N Service Center Information Figure C 3 Service Center Info window C 2 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual Catalog of Windows and Fields DownStream Interface Creating DownStream Interface Information To Access DownStream Interface gt Create DSI N Create DSI x Service Center ooo001 eekMask JT 0 0000 DownStream Frequency periodic ABSENT OK Cancel ey Unsigned Java Applet Window Figure C 4 Create DSI window Table B 2 Field Value Constraints for Create DSI Information Window Field Name Length Type Description possible values The 6 digit code assoc
152. s 3 8 typographical conventions xviii messages User ID Login 3 5 N namemgr key process 5 20 November 15 1999 Index names CORBA remote host 2 39 remote server 2 39 Oracle database instances 2 41 Security Agent process 2 35 2 36 naming conventions application 2 18 ILEC trading partner 2 18 navigation 3 8 network communications Oracle databases 2 15 nonfunctional commands 3 8 NPA See Numbering Plan Area Numbering plan Area NPA defined A 2 O operating system required for DSET application 2 2 Operations Support Systems OSS defined A 2 MetaSolv TBS software 2 2 Oracle databases administration files 2 10 clean up reasons 5 27 creating options required 2 6 overview 2 8 scripts 2 13 DBA involvement 5 25 DSET application User ID 2 14 DSET file directories 2 10 estimating disk space CNAM documents 2 8 security agent 2 7 init config files 2 11 instances description 2 17 1091 B DRAFT Index 5 Index names 2 2 2 41 links to startup files 2 12 listener file editing 2 17 starting 2 18 maintenance 5 24 mounting bring online 2 14 names used 2 7 network communications 2 15 Orders delete tables 5 30 drop tables 5 28 steps to register schema 5 25 performance tuning 5 27 ready for installation 2 34 reference books 2 3 registering schema manually 5 24 registering schemas automatically 2 44 manually 5 25 5 26 messages 2 45 scripts running 2 13 security steps to delete tables 5 30 steps to drop
153. s Solutions TCP IP gateway port numbers 2 39 host computer address 2 42 server port number 2 33 Telecom Business Solutions TBS CORBA software 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual troubleshooting 5 18 defined A 3 tests after DSET install script 2 46 CORBA daemon active 2 52 5 3 DSET processes running 2 53 Oracle databases online 2 52 5 4 verify order created 2 56 TNS names communiucation protocol 2 16 connection descriptors 2 17 files 2 15 listener file 2 17 TNS See Transparent Network Substrate trading partners designate during installation 2 36 file naming conventions 2 18 log directories 2 37 Transparent Network Substrate TNS defined A 3 troubleshooting CORBA software 5 18 list of problems 5 13 namemegr 5 20 U UFS See UNIX File System Uniform Resource Locator URL defined A 3 start DSET application 2 43 uninstalling DSET application 2 58 Oracle software patches 2 6 UNIX commands installation script requirements 2 22 UNIX File System UFS defined A 3 UpStream Frequency 3 13 4 16 URL See Uniform Resource Locator November 15 1999 Index User Groups 3 24 creating 3 24 modifying 3 25 User IDs defaults for system administrator 2 55 DSET application 2 22 2 23 2 30 Oracle DSET application 2 14 user s manual organization xvii viewing online effectively xviii validate correct installation 2 46 DSET environment variables 2 48 orders through g
154. s is a sample value not a default value You must manually type in a port number Refer to the guidelines in Port Numbers on page 2 32 If the port number is within the range of 1025 to 99998 then the installation script echoes the gateway port number Gateway Server TCP IP port number is 6600 15 The ezCallerID CNAM security port number identifies the TCP IP port where the Security Agent communicates with the gateway The security port number should be greater than 1024 and less than 99999 Type the security agent port number 1111 default Type the security agent port number for the ezCallerID application The value in parenthesis is a sample value not a default value You must manually type in a port number Refer to the guidelines in Port Numbers on page 2 32 If the port number is within the range of 1025 to 99998 then the installation script echoes the security port number Security TCP IP port number is 6601 CORBA Installation Information CORBA OSS only 16 Ifyou have chosen to use the Operational Support System OSS with CORBA instead of the standalone GUI you must identify the gt CORBA host name gt Remote CORBA server name gt Gateway Waiting Period before extracting CNAM orders from OSS The installation script prompts you with The remote CORBA hostname is the machine on which the OSS CORBA server is running Type the remote CORBA hostname November 15 1999 1091 B DRAFT 2 39 Instal
155. same external machines This process takes about 30 seconds to run 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Technical Reference Stop Script To stop ezCallerID use the UNIX system where it resides 1 Start in directory DP_DIR cnam bin 2 Type the script name and parameter cnam stop This invokes the igpApp script with the stop parameter This process takes about 10 seconds to run To set script variables enter CNAM_INSTALL_DIRECTORY cnam profile 3 At HOME locate file kshrc 4 Use VI or another text editing tool to add the following line CNAM_INSTALL_DIRECTORY cnam profile November 15 1999 1091 B DRAFT B 5 Technical Reference ezCallerID System Administration Manual Checking Gateway Status B 6 As System Administrator you need to check the status of the ezCallerID You can do this from any UNIX machine On any UNIX terminal at the command prompt enter command ps aef grep startup The system will reply will be similar to cnamadm 14951 1 0 19 51 04 pts 8 0 00 startup export home cnamadm cnamGW cnam config cnam startup cnamadm is an example of a username and 14951 is a sample process ID Instead of running this for startup you can replace startup with cnamgw secAgent igpAgent or namemgr These 5 processes should always be running and results should always resemble the sample above 1091 B DRAFT November 15 1999 ezCallerID System Administrat
156. se SQL statement Insert the statement character set WE8ISO8859P1 Replace secrb_temp with cnsecdbrb_temp for the rollback segments Change the rollback segment names from rb11 rb12 rb13 rb14 to ensecdbrb1 cnsecdbrb2 ecnsecdbrb3 cnsecdbrb4 Replace SECDB with CNSECDB anywhere in the directory pathnames throughout the script G Run CNAM and CNSECDB Table Creation Scripts Run the two scripts you created see F Create Scripts to Allocate Database Space on page 2 12 November 15 1999 1091 B DRAFT 2 13 Installing ezCallerID ezCallerID System Administration Manual 21 Run the CNAM and CNSECDB database creation scripts login as the Oracle user svrmgrl connect internal SHOME SQL o_crCnam sql SHOME SQL o_crCnSecdb sql quit H Mount the Databases 22 Mount the CNAM database with the SQL PLUS commands after this UNIX command export ORACLE _SID CNAM login as the Oracle user o svrmgrl connect internal startup quit 23 Mount the CNSECDB database with the SQL PLUS commands after this UNIX command f export ORACLE_SID CNSECDB login as the Oracle user o svrmgrl connect internal startup quit l Create a DSET Product DBA User ID The ezCallerID application must login with a database administration dbadm User ID and password dbadm to both Oracle databases to enforce security 2 14 1091 B DRAFT November 15 1999 ezCallerID System Administratio
157. sececeseeseceseesceeeeeseaeeaeeeneeaes C 16 Privilege Level View Response Window cesesscesceesceseeseeeeseseesseeseecaeenaenaes C 16 User Create window isinisisi neeese nereo rieien desl eed ab cosh E ER C 17 User View Response Window 0 cece seceseeseceecesecesceseeeeceseseaeeaeeeaecaeesaecaeeaeenees C 18 User View Response Window ceceecesceeeesceseeeeeeseeesecaeesaecaeaecesceseeeeeeeeeeneeaes C 18 1091 B DRAFT xiii List of Figures ezCallerID System Administration Manual xiv 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual List of Tables Table 1 1 Table 1 2 Table 2 1 Table 2 2 Table 2 3 Table 2 4 Table 2 5 Table 2 6 Table 2 7 Table 2 8 Table 2 9 Table 2 10 Table 2 11 Table 3 1 Table 3 2 Table 3 3 Table 5 1 Table 5 2 Table 5 3 Table A 1 Table C 1 Table B 2 Table B 3 Table B 4 Table B 5 Table B 6 Table B 7 Table B 8 Table Preface 1 Contacting DSET s Customer Service eee eeeesessecsceesececeseeecsseeseeeseeseeeeeeees XX Orden Status Stat s scecccetieroncs EaR ARE REE E ERRAR 1 4 Due Date States nog hena e i E acd Saha E T ee A 1 5 ezCallerID Pre Installation Checklist 2 0 0 eeceeesssseeccesseceseeceeeceaeeeneeeeeeesaeeeseecees 2 2 ezCallerID Oracle CNAM Database Size Estimation eeceeseescecereeeneceeneeees 2 8 ezCallerID Oracle Database Creation Steps 0 0 0 ceeeeceseeesceeeeeeeeeeeeeeeneeseeeaeenaes 2 8 V
158. seeceeceseeseceseeeceseseeseeeeaes 2 15 Configuration and Naming Conventions 0 cc eceeeeceessessecscessecaecaeesecsseeseceseeseeeeeeeseeeens 2 18 Ongoing Tasks for Oracle Database Administrator eee ececeeeereeeeeceeeeecaecnneeneeaees 2 19 Role of DSET Installation Team y s sines essees onesie i a eane ike aneo Eno issii 2 19 Last minute Oracle CORBA Preparations sseeseseeeessseeseereresrssesrsserrrsterrsreererenerresessseees 2 20 Prepare Basic DSET Environment cece eseeceeceeeeeeeeeeeeeceseecaecsaecaecsaeaeceeceseceseeeeeeeeseseaeeaeenees 2 22 Steps to Define Basic DSET Environment ssseeesseseeseseessreresrerrsrererresrrrrererresenesrsresreee 2 22 Determine Information Needed for ezCallerID Installation eseeseeeessereseseserseeserererreeeee 2 23 Define the ezCallerID System Administrator User ID 00 eeeeeeeseeeeceseeeeecneenneenees 2 23 Create the ezCallerID Installation Directory seesesseeesssesesseseseesrerrsreeresreresrnesesserrrsreersre 2 24 DSET Application File Directories 2 0 0 eee csecesecneceeesecesceseceseeeeeeeeseseaeeaeesseceeaeenees 2 24 Copy ezCallerID from Distribution Media eee eee eeeceeceeeeeecneecaecasesaecsecnseeneensees 2 27 Run the instalIDSET Script cecinere iis esis nse rsp Eae s En r ae rior Roae 2 28 What the installDSET Script Does sssessessesesseeesesresrsrsrsresrerrsresresreresrssertssentesrerrerenrsreneees 2 30 Install the ezCaller DD A pplication vcs sesccseescscvesscc
159. sein ae E Ea EE a E AE want E E AO AR R 5 1 Checking Disk Space ssc ssta die n OR RR a lade Sie aes 5 1 Application Process Healthier eesse asenon esanai a peen or eS PES EREE rE S SEEE 5 3 Viewing ezCallerID Logs Application Operation e eseseesessseesesressssssesessrrrrsreersresrerrereerese 5 5 Tracking a REQuest riene EE E vende E pee sewecd E RE 5 12 Troubleshooting Problems 3 4 s sss sscc ssssesseduss cvasbetestcodiosteas osbcestcsetsbscevessdasivasisesscsvaascensecuscostessqenseeses gt 5 13 Problem Determination Table eee ee ceeseecseceseceeceseesecesceseceseseseaseseseaseseecaessaeaeenees 5 13 Actions t Resolve PrODIEMS eisin ni e a atone asteeet tenn EESE E E E EN 5 15 Restarting the ezCallerID Application esesseeesssseseseesrsersrerrsresrssresestsesrnsesersreersrenrsrenseees 5 15 Manually Ending ezCallerID Processes ss essssessssseeseeeesersreessreeresrerrsreesrsserrrsrerrnrenrsrenreees 5 16 Checking namemsr ones ea ee hain fee SR RIE N ASES 5 17 Verifying Database ACCESS sas ct veresorsses e e R E E E N E 5 17 Starting the ezCallerID Gateway essseeeeseeeessseeesessesesserrsserrssrertsreeterrsterrsserenserrrsreeesreee 5 17 CORBA Orb1X SoftWare sccceessccccsensevecoee feiss aee pereante oraraa NPE cosctcesccedesudesugessusdeesseceseeds 5 18 Checking the Oracle Databases 00 ects eeceseesecsseeeceeceseeeeceseeeeceaeeeeecaeseeecaeesaecaecsaecaeenaee 5 19 Increase the Time Lag for the namemgr Proc
160. stration Manual Communicating with Service Centers 3 Next you schedule the DownStream and UpStream transmission frequency You can choose to trasnmit by Day or by Time This determines how often information is transferred to and from the Service Center Entering DownStream Fequency Note November 15 1999 This determines how often documents are sent to the Service Center You can schedule the DownStream to occur daily or by a time period Not Both Decide which method to use then see below for directions For Daily Schedule 1 From the Create DSI window see Figure 4 4 double click the white space next to WeekMask in the DownStream Frequency field If there is no white space hold the Shift key and click the WeekMask line This makes the WeekMask active now you can double click the white space The Week Mask window displays as shown in Figure 4 5 1091 B DRAFT 4 7 Communicating with Service Centers ezCallerID System Administration Manual N Week Mask arth 8 startm 0 stoph 9 stopm 0 Tuesday Wednesday arth 8 startm 0 stoph 10 stopm 0 Thursday Saturday OK Cancel iy Unsigned Java Applet Window Figure 4 5 Week Mask window See for field descriptions 2 Click the Add bar for each day of the week to transmit 3 Your window will look like this 4 8 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Communicating with Service Centers Figure 4 6 Daily Sched
161. stration Manual Installing ezCallerID echo SDP_DIR ezConnect home cnam cnam2 0 6 echo SD_DIR ezConnect home cnam cnam2 0 6 cnam d dir echo SPATH ezConnect home cnam cnam2 0 6 cnam d dir bin ezConnect home cnam cnam2 0 6 cnam bin usr local bin usr bin usr sbin ezConnect home e911 tools usr ucb etc opt iona OrbixMT_2 3c bin ezConnect home cnam bin opt iona OrbixMT_2 3c bin export u02 oracle app oracle product 8 0 5 bin Note The PATH variable contains the pathnames to all application binary libraries plus any Oracle or CORBA libraries required for your company s configuration D Validate DB and CORBA Environment Variables 6 Continue to echo the environmental variables specific to the software packages used for your DSET gateway configuration Note The following environment variable values are examples only The actual file directory pathnames are specific to your company and host machine echo SIONA_HOME opt iona OrbixMT_2 3c echo SIT_CONFIG_ PATH opt iona OrbixMT_2 3c cfg echo S LD_LIBRARY_PATH opt iona OrbixMT_2 3c lib export u02 oracle app oracle product 8 0 5 lib November 15 1999 1091 B DRAFT 2 49 Installing ezCallerID ezCallerID System Administration Manual Note Several of the Oracle environmental variables are developed to make creating your Oracle database CNAM and CNSECDB easier echo SORACLE_MOUNT export u02 oracle data echo SORACLE_HOME export u02 oracle
162. t requests and CLECs deposit Notification Messages Both the ILEC and the CLEC pick up exchange the data at scheduled time intervals Service Centers are usually configured for each major ILEC For example A Service Center would be established for Bell Atlantic It would service all customers in New Jersey Delaware Pennsylvania West Virginia Washington D C and Michigan A second Service Center would exist for Bell South customers in Kentucky Tennessee North Carolina etc 1091 B DRAFT 1 13 Introducing ezCallerID ezCallerID System Administration Manual 1 14 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Chapter 2 Installing ezCallerlID Overview This chapter describes how to install and configure the ezCallerID application You can think of this software installation as divided into six major sections 1 Pre installation Tasks 2 40 ccctieieaciececessesvscconsepentes stoveaceerneoveccosnecestvensdontceanes on page 2 2 2 Install Third party Software 0 ceseeeceeeeeeceeeeeeeseeeseecseesaecsecnaeeeeseees on page 2 4 3 Create Oracle Databases isciuti cise sscgsesvesssseschensscteatcesconsessqessoevesh sadvestess ees on page 2 7 4 Prepare the Basic DSET Product Environment 0 0 0 cece eeeeseeeeeeeeeeeees on page 2 22 5 Install the DSET ezCallerID application 20 0 eee ee ceeeeeeeeeeeeeeneeseeeaes on page 2 32 6 POst installation Tasks esc secceee endo e anen a a a
163. t of operations that determines which functions the user can perform November 15 1999 ezCallerlID System Administration Manual Catalog of Windows and Fields Privilege Level Privilege Type Privilege Operations Privilege Level Create Privilege Level Modi 4 OK Cancel ey Unsigned Java Applet Window Figure B 19 Privilege Level Modify window Table B 7 Field Value Constraints for Privilege Level Modify Window Field Name Length Type Description possible values Privilege Level Up to 8 digits The privilege level indicator that determines the functions a user can perform Privilege Type 100 alphanumeric characters description OF Ine Pllc a user canperlorm when given this privilege level Privilege Operations Choose from the list A set of operations that determines which functions the user can perform Viewing Privilege Levels To Access Admin gt Privilege gt View N Privilege Level View Request EQ View all the privilege levels iy Unsigned Java Applet Window Figure B 20 Privilege Level View Request window November 15 1999 1091 B DRAFT C 15 Catalog of Windows and Fields ezCallerlID System Administration Manual N Privilege Level View x Privilege Level Privilege Type 0 admin ops a 2 all hd 4 r ox ey Unsigned Java Applet Window Figure B 21 Privilege Level View window N Privilege Level View Response x Privilege Level 2 Pr
164. tables 5 29 steps to register schema 5 26 software requirements 2 2 2 4 verify online 2 52 5 4 Oracle software file directories 2 9 home directory 2 38 patches finding 2 5 Sun Sparc specific 2 6 uninstalling 2 6 order status current state 1 4 Index 6 ezCallerID System Administration Manual orders documents delete tables 5 30 disk space estimation 2 8 drop tables 5 28 examining DSET logs 2 56 gateway waiting period 2 40 Oracle database instance name 2 41 register database schema 5 25 testing gateway 2 56 organization manual xvii OSS See Operations Support Systems OSS server link breaks with gateway 5 14 overviews basic environment preparation 2 22 creating Oracle databases 2 8 DSET database creation 2 8 instalaltion script responses 2 33 installation 2 1 post instalaltion tasks 2 46 pre installation tasks 2 2 preventative monitoring 5 1 P passwords changing 3 24 defaults system administrator 2 55 3 24 modifying 3 5 requirements 3 24 patches Oracle software 2 5 2 6 Sun Sparc specific 2 6 PDF See Portable Document Format Periodic Frequency 3 13 4 16 schedule 3 13 4 16 Periodic See DownStream Interface PON See Purchase Order Number 1091 B DRAFT November 15 1999 ezCallerlID System Administration Manual port numbers 2 33 example for DSET products 2 32 HTTP daemon process 2 43 Security Agent 2 39 TCP IP gateway 2 39 uniqueness for applications 2 32 Portable Document Format PDF defined A 2 vi
165. tions for configuring the third party databases and installing the ezCallerID application Chapter 3 describes how to set up the gateway so the Service Representatives can login Chapter 4 contains instructions for configuring the communication link for Service Centers Chapter 5 provides maintenance information Appendix A contains a glossary of abbreviations acronyms and definitions Appendix B is your technical reference section Appendix C is a catalog of application windows and field definitions 1091 B DRAFT xvii Preface ezCallerID System Administration Manual Viewing the Manual in Online Format To effectively adjust the page layout to view this user s guide online 1 Conventions Double click the PDF file of this guide using the Microsoft Windows Explorer The ezCallerID System Administration Manual displays using the Acrobat Reader Click the magnifying glass icon at the bottom of the window The Zoom To window displays to let you choose the display magnification Type 150 for the Magnification and click OK This manual uses specific conventions to help you recognize what to do with the software Example Convention Description a XXX yyy Courier bold Indicates commands you need to enter Press Return Press Tab Arial bold Indicates keys you press on the keyboard Dual angle brackets lt gt lt Control 0 gt Dual angle brackets and plus sign For key commands the plus sign ind
166. to request changes to a customer s caller ID information and the request is manually sent via email to a Service Center The Service Center is a hub for the clearinghouse to confirm data with the LIDB and transfer the information back to the CLEC Only the System Administrator can create a Service Center however you can display information about it For assistance with logging into ezCallerID see Login to ezCallerID on page 3 1 Viewing the List of Service Centers You can display a list of all Service Centers This information cannot be changed 1 Select Service Centers gt View all Service Centers A list of all Service Centers display as shown in Figure 3 10 Service Center Name Description 333333 test OK J Unsigned Java Applet Window Figure 3 10 Service Centers Window 2 Double click the text of the Service Center The Service Centers window displays as shown in Figure 3 11 November 15 1999 1091 B DRAFT 3 9 Defining Users and Privilege Levels ezCallerID System Administration Manual Service Center 123456 Description Ameritech OK Ey Unsigned Java Applet Window Figure 3 11 Service Center Info window 3 The Service Center number and its description display This information is view only Click OK to close the windows 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Viewing the Data Transfer Schedule
167. ually type the Oracle Document Database name if you want to use a name other than the default Once you choose the ezCallerID Document Database name the installation script echoes your response and requests confirmation ezCallerID Oracle db name is CNAM CONFIRMATION Is this Oracle db name correct y n Type Y to confirm the Oracle Document Database name or type N to return to the prompt in Step 21 on page 2 41 1091 B DRAFT 2 41 Installing ezCallerID 2 42 23 24 ezCallerID System Administration Manual You must now provide the installation procedure with the Security Agent Database name Th zcallerID security database is the database that contains the User IDs of the System Administrators and Operations personnel This database continues to monitor all users throughout their sessions Type th zCallerID Security db name CNSECB default The value in parenthesis is the default value You must manually type the Oracle Document Database name if you want to use a name other than the default Once you choose the ezCallerID Document Database name the installation script echoes your response and requests confirmation zCallerID Security db name is CNSECDB CONFIRMATION Is this Security db name correct y n Type Y to confirm the Oracle Security Database name or type N to return to the prompt in Step 23 on page 2 42 Host TCP IP Address Sometimes 25 26 This step is only needed whe
168. ule window with days selected 4 Click the text below the Add bar The Intervals of Day window displays as shown in Figure 4 7 Start fo hour min Stop fo hour min OK Cancel ey Unsigned Java Applet Window You can type the times or select from the drop down selection list Figure 4 7 Intvis of Day Window 5 Type the start and stop times for transmissions that day Use military time Click OK to close the windows and accept the schedule The WeekMask window re displays Repeat Step 4 on page 4 4 through Step 6 on page 4 6 for each day of the week you When you are finished the WeekMask window will look similar to Figure 4 8 Figure 4 8 Complete WeekMask window November 15 1999 1091 B DRAFT 4 9 Communicating with Service Centers ezCallerID System Administration Manual To Delete a Time 1 Hold the Control key and right click the text The time is removed For Periodic Schedule 1 From the Create DSI window see Figure 4 4 click the ABSENT text next to the DownLoad Frequency field The Periodic Frequency becomes active 2 Click the white space next to Periodic The Interval window displays as shown in Figure 4 9 180 seconds OK Cancel ey Unsigned Java Applet Window Figure 4 9 Interval window 3 Type how often you want the transmission to occur If you choose this method we recommend 3 600 seconds 4 Click OK to accept
169. ult DSET suggests a waiting period of 86400 seconds once per day Type the number of seconds you want the ezCallerID gateway to wait before extracting a CNAM order from the OSS 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerlD Note You may want to set the waiting period to a shorter interval 1200 seconds 20 minutes during the initial testing period Later you can increase the waiting period by modifying the CNAM gateway configuration file Modify a DSET application configuration file only under the direction of DSET Customer Service personnel To modify the CNAM gateway configuration file config lt ILEC gt cnamgw cfqg use a UNIX text editor such as vi and change the value in the line denoted by Time period for the gateway extract the data from OSS GW_SLEEP_TIME 3000 ezCallerID Orders and Security Oracle Database Names Important 21 22 November 15 1999 Contact your UNIX System Administrator for the Oracle database name When using the Oracle server v8 0 5 to store CNAM orders documents information and perform security monitoring you must now provide the installation procedure with the names of the Oracle Document Database and Security Agent Database The ezCallerID database is the database for customer order storage Type th zCallerID Oracle db name CNAM default The value in parenthesis is the default value You must man
170. urity agent database cd SORACLE_TOP CNSECDB mkdir bdump cdump create pfile udump D Build Initialization and Configuration Files Take a standard Oracle database configuration file plus an initialization file and copy the files to the correct Oracle administration file directories 9 10 11 12 13 14 November 15 1999 cd S ORACLE_TOP CNAM pfile cp example_config ora configCNAM ora cp example_init ora initCNAM ora Edit the configCNAM ora and insert the document database name CNAM into each appropriate portion of the directory pathnames for control files and dump files Make sure to change the line with the information db_name CNAM Edit the initCNAM ora and insert the document database name CNAM into the appropriate parts of the ifile directory pathname Change the names of the rollback segments to cnamdbrbl1 cnamdbrb2 cnamdbrb3 cnamdbrb4 cd SORACLE_TOP CNSECDB pfile cp example_config ora configCNSECDB ora cp example_init ora initCNSECDB ora Edit the conf igCNSECDB ora and insert the Security Agent database name CNSECDB into each appropriate portion of the directory pathnames for control files and dump files Make sure to change the line with the information db_name CNSECDB Edit the initCNSECDB ora and insert the Security Agent database name CNSECDB into the appropriate parts of the ifile directory pathname Change the names of the rollbac
171. ves to create customer orders and store them in an Oracle database Table 2 6 Third party Information for ezCallerlD Installation Script Information Response default value Oracle Home Directory Path Oracle ezCallerID Document Database Name CNAM Oracle Security Agent Database Name CNSECDB CORBA OSS Integration IONA Orbix Home Directory Path Define the ezCallerID System Administrator User ID 1 Create the UNIX user ID CNAM with super user authority 2 Use the UNIX cd command to move to the CNAM user ID home directory November 15 1999 1091 B DRAFT 2 23 Installing ezCallerID ezCallerlID System Administration Manual 3 Ensure that these UNIX commands work for the CNAM user ID xrm Delete files taxr Copy files from installation tape daf Determine amount of disk space available awk Pattern matching program tail Extract information from file s records f grep Find literal match to string in files host id Get hexadecimal number of host server chown Change file ownership chgrp Change file ownership to new group hostname Determine name of host machine ping Determine the TCP IP address of machines on this network Create the ezCallerID Installation Directory 1 Use the UNIX cd command to move to the Installation parent directory see Figure 2 1 of the ezCallerID application 2 Create the CNAM Version 2 0 home directory by typing the command mkdir CNAM2 0 DSET Application Fil
172. w See UNRESOLVED XREF for field descriptions d Click OK to close the Interval of Day window Periodic This option controls the transfer of ezCallerID documents by time interval 1 Hold down the lt Shift gt key and click the periodic line to select it 2 Ifyou double clicked the Periodic Frequency see Figure 4 14 the Interval window displays as shown in Figure 4 17 180 seconds OK Cancel Frequency interval ZS Unsigned Java Applet Window Figure 4 17 Interval window These Frequency settings tell the ezCallerID to transfer data every n seconds 3 Click OK to exit the windows November 15 1999 1091 B DRAFT 4 17 Communicating with Service Centers ezCallerID System Administration Manual 4 18 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Chapter 5 Maintenance and Troubleshooting This chapter provides recommendations for monitoring identifying proflems with and backing up the ezCallerID application to ensure optimum performance The chapter is divided into four parts Important Preventative monitoring activities to ensure proper ezCallerID operation Troubleshoot problems that can arise cesses ceeeseceeceseeeeceseeeeeeeeeaeeeaeeaee on page 5 13 Possible corrective actions you would take to address the problems on page 5 15 Backing up and archiving ezCallerID application data eee eee on page 5 21 Oracle Database Maintenance 00
173. weekMask ABSENT periodic interval 30 CNAM GW gt gt ACTIVITY LOG lt lt 1999 Nov 12 15 18 22 gt gt User s adm00 Message type FROM OSS MESSAGE IIDBCreate transid 5 authkey 1111111111 source s adm00 dest octnum 111111 npa 111 nxx 111 line 1111 recType 0 recSType P recSType2 0 pkey 0 acode C pin pinaction I cardtype U brindicator B cardnum sind H Iscnbind Y billname holdername usagecat 055 addrline addrline2 addrcity addrstate addrzip ocn bsp rao bnscode A effdate clcode Figure 5 6 Activity Log for ezCallerID Gateway Figure 5 6 illustrates some of the information contained in the CnamgwActivity YYYYMMDD logs November 15 1999 1091 B DRAFT 5 11 Maintenance and Troubleshooting ezCallerID System Administration Manual gt gt ACTIVITY LOG lt lt 1999 Nov 12 16 37 58 gt gt IGP agent New Document Received Data IgpMessageData OCT_STR len 280 MESSAGE cNamCreate transid 0 authkey 1111111111 source dest octnum 111111 npa 444 nxx 444 line 4444 recType 2 recSType 00 tType C plndicator R cName 90123451 ocn 1111 bsp 1111 rao 111 effdate 110399 Figure 5 7 Activity Log for the Interconnectivity Gateway Platform Figure 5 7 illustrates some of the CNAM order information contained in the CnamIgpActivity YYYYMMDD logs Tracking a R
174. work communication files SORACLE_USER_HOME Oracle s home directory for the Oracle User ID O Verify library paths are set up by checking for process dependencies with the UNIX E 2 50 ldd command F 2 52 CORBA OSS only Verify that the Orbix process daemon is running G 2 52 Verify that the Oracle software and the ezCallerID Oracle databases CNAM and CNSECDB are ready for online transactions H 2 53 Start the ezCallerlD application using the ezCallerID st art up script l 2 53 Test to see that all ezCallerID application processes are running Test to see if you can login to the ezCallerID application with your Web browser as 2 54 the ezCallerID System Administrator K 2 55 Set up a Service Center and a DownStream Interface to test the application 2 56 Create one or more CNAM orders documents Examine the Activity and Trace logs to verify that CNAM orders documents M 2 36 passed through the ezCallerID gateway 2 46 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Table 2 10 ezCallerID Post Installation Steps 2 of 2 on Step Page Once You Have Performed this Step m N 2 57 Create a backup tape media of the ezCallerID gateway installation once it is fully functional m Provide remote dial in capacity user level authorization is fine so DSET customer o 2 58 service personnel can access all tasks within the ezCallerID application directory A Source t
175. ws and OSS for manipulating an Line Information DataBase LIDB customer record The Interconnectivity Gateway Platform IGP Security Agent Oracle database and activity logs for processing the order requests The DownStream Interface DSI for collecting and translating the data into recognized formats The Telecommunications Business Solutions TBS interface or the Operational Support System OSS The Service Center for sending and receiving data from the ILEC Generating a Request Requests for transferring Caller ID information enter the ezCallerID two ways The Operations Support System OSS Server The Operations Support System OSS uses the industry standard CORBA language This ezCallerID software release 2 0 features Metasolv s Telecom Business Solutions TBS that is compatible with the OSS This allows many existing ezCallerID data entry systems to continue operating with the new technology The ezCallerID CORBA Gateway November 15 1999 Receives Caller ID requests in the CORBA Interface Definition Language IDL format from the CLEC s OSS Converts CORBA Caller ID requests into an internal format ASN 1 for processing within the LSR Gateway and sends them to ILEC Service Centers Receives notification messages from the ezCallerID IGP Converts messages back to the CORBA IDL format Sends CORBA messages to the CLEC 1091 B DRAFT 1 7 Introducing ezCallerID ezCallerID System Administration Manual
176. y Registering Oracle Schema Schema registration will overwrite any existing schema if any and will makes the Oracle DB instance ready to receive orders This needs to be done for the first time when the DB instances are created The SQL scripts that describe the table definitions and the organization of the fields regSch sql regGenSch sql Called by regSch sql1 to perform name change conversions for schema regIigpSch sql regSecSch sql The cnam Oracle database instance needs the regGenSch sql and regIlgpSch sql scripts The cnsecdb Oracle database instance needs the regGenSch sql1 and regSecSch sql scripts to define the tables 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Maintenance and Troubleshooting Important These scripts contain the table definitions and table creation operations The table definitions should never be changed as this will effect the operation of the ezCallerID gateway system The table creation operations can be modified to suit the needs of your specific site Your Oracle DBA can suggest script changes based upon the storage location access performance indexing disk mirroring capabilities etc Check with your Oracle DBA regarding these scripts have the DBA examine the scripts and get approval before registering the ezCallerID schema Skipping this step may affect the performance of the ezCallerID Gateway Manually Register the ezCallerlD Order Database Schema To
177. ying the Operations Code of a Privilege Level 1 Select Admin gt Privilege gt Modify The Privilege Level Modify window appears as shown in Figure 3 19 3 20 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Defining Users and Privilege Levels Privilege Level Privilege Type Privilege Operations Privilege Level Create Privilege Level Modi hd 4 OK Cancel ey Unsigned Java Applet Window Figure 3 19 Privilege Level Modify window See for field descriptions 2 Enter the Privilege Level and description Note The operations added to the existing Privilege Level will not display you must recreate the level 3 Choose each operation 4 Click OK The Operation Response window appears indicating that the operation was successful 5 Click OK Viewing All Privilege Levels and Details This function allows the administrator to view the Operations Codes associated with each Privilege Level 1 Select Admin gt Privilege gt View The Privilege Level View window displays with a list of all privilege levels November 15 1999 1091 B DRAFT 3 21 Defining Users and Privilege Levels ezCallerID System Administration Manual N Privilege Level View x Privilege Level Privilege Type 0 admin ops a 2 all fy 4 gt ox iy Unsigned Java Applet Window Figure 3 20 Privilege Level View window 2 Double click the privilege level The Privileg
178. z 18 1 Mb 9 27 99 6 Since the bug patch bug991197 is applied to Precompiler 8 0 5 2 1 on a Sun Sparc Solaris follow the instructions and apply this patch also the instructions are found in the file bug991197 README 991197 7 Be sure to use the WE8ISO8859P9 character set option when creating both the CNAM document and the CNSECDB Security Agent databases See Create Oracle Databases on page 2 7 8 Ensure that the Oracle 8 Objects Option and Network Option are set enabled CORBA Software e Install Orbix v2 3 c if you want to use the MetaSolv Telecom Business Solutions TBS software as an Operational Support System OSS according to documentation provided by IONA Technologies PLC Integrated OSS Configuration e Install TBS v4 0 1 according to documentation provided by MetaSolv Software 2 6 1091 B DRAFT November 15 1999 ezCallerID System Administration Manual Installing ezCallerID Create Oracle Databases The ezCallerID default installation requires an Oracle database to store orders and perform system security administration Your database administrator must create this database before you install the ezCallerID application If you currently are using an Oracle database there is no need to change databases ezCallerID 2 0 will work with your previous data Introduction Note Throughout this chapter we refer to two ezCallerID Oracle databases You can give these databases any alphanumeric eight

CNAM System Administration Manual

Contents

Download Pdf Manuals

Related Search

Related Contents