NEC Sentry Installation Guide

							NDA-30080   Revision 1.0Page 31
Sentry Installation Guide Annoyance Trap
Chapter 3 Annoyance Trap
This chapter describes the field entries to make during the installation and 
configuration of the Annoyance Trap software. 
Overview
The Annoyance Trap program is an OAI application that provides a method for 
tracking and identifying annoying callers. 
Any user can trigger the Annoyance Trap by placing the annoying party on hold 
and then dialing a designated number. The initiator is then reconnected to the 
annoying party. Depending upon the application configuration, a designated 
security operator may be placed in a three-way conference with the initiator and the 
annoying party, and/or an audio device may be triggered to alert security personal.
The Annoyance Trap program provides support for one or more display terminal 
applications through an event message protocol. Terminal applications that want to 
receive messages send a request to the Annoyance program, which will then send 
event messages to the terminal application as events occur. 
The location and status of all parties may be displayed by the Sentry Alarm Control 
Terminal application. This information can be used to track and identify annoying 
callers. Note that the Annoyance Trap program does not require a terminal 
application to create a conference with the security operator and/or trigger the 
audio device, and can be run alone if there is no requirement for a display terminal. 
Events may also be saved in a history log file.
The installation and configuration of Annoyance Trap includes the following 
procedures:
• Software Installation 
 Application Configuration
 Database Requirements
Additional Manuals
In addition to this guide, instructions in the following manuals may provide further 
assistance in this installation:
Applications Manager (APM) Installation Manual - Contains step-by-step 
instructions for installing the software from the release media.
Applications Manager (APM) Operations Manual - Explains how applications like 
Annoyance Trap are configured in the APM environment and how the Annoyance 
Trap databases are created, using the entries and values provided in this chapter. 
						

							Page 32NDA-30080   Revision 1.0
Annoyance Trap Sentry Installation Guide
Software Installation
The Annoyance Trap software must first be loaded from the release media. 
Remember to use the Applications Manager (APM) Installation Manual if you 
need further instructions for installing software using the APM.
Note:You will be prompted for several values when you install the software. For more 
information about these and other parameters, refer to the next section, 
Configuration on page 40.
1. To begin the Annoyance Trap software installation, log in to the APM 
Platform Management Menu by typing apmadm at the UNIX login prompt, 
then press Enter. The login and password prompts are shown below.
If your “apmadm” account requires a password, enter the appropriate 
password at the subsequent password prompt.
The APM Administration main menu displays, as illustrated below:
login: apmadm
password:
NEC America      APM Administration                Wed  Jan 31, 1996
APM Platform Release  Rel2.0  (Oct 09, 1995
)
Main Menu
APM
Debug Facilities
Halt APM System
File Archive
Installation of Applications/Packages
Removal of Packages
Start-up APM System
Logout
UNIX
Enter Option:  []
  APM Status: ACTIVE 
						

							NDA-30080   Revision 1.0Page 33
Sentry Installation Guide Annoyance Trap
2. Type i and press Enter to select the Installation of Applications/Packages 
option. 
The Installation of Application/Packages screen displays.
3. At the “
Enter Package to be installed” prompt, type applications and 
press Enter.  The “
Enter Release Media Device” prompt displays.
Installation of Applications/Packages
Available Packages are:
applications    asl    mtl     tcpip     update    x25
Enter Package to be installed: 
NEC America     APM Administration                Wed - Jan 31, 1996
NEC America       APM Administration              Wed  Jan 31, 1996
Installation of Applications/Packages
Available Packages are:
applications     asl    mtl    tcpip     update     x25
Enter Package to be installed:  applications 
Release Media Devices are:
(F)loppy Disk Device           (C)artridge Tape Device
Enter Release Media Device:  
						

							Page 34NDA-30080   Revision 1.0
Annoyance Trap Sentry Installation Guide
4. Select the floppy disk device as the installation media by typing f and pressing 
Enter.  The following screen displays:
5. Insert the Annoyance Trap diskette into the floppy disk device, and press Enter 
to continue.
The screen displays files in the application installation. Many files may scroll 
off the screen, until all of the files from the diskette have been processed. 
The “
Has all release media been loaded” prompt displays, as illustrated 
below:
Installation Procedure
Installing from /dev/fd0
Insert OAI Release Media #1
Enter  to continue: 
Has all release media been loaded [y or n] ?  x oai/app/annoyTrap/install/ani.cfg, 2338 bytes, 5 tape blocks x oai/app/annoyTrap/install/Mannoi.cfg, 198 bytes, 1 tape blocks
                                            .
                                            .
x oai/chksum_app, 654 bytes, 2 tape blocks x oai/app/annoyTrap.ins, 7969 bytes, 16 tape blocks
x oai/app/annoyTrap/bin/annoyTrap, 376592 bytes, 736 tape blocks
                                            .
                                            .
                                            . 
						

							NDA-30080   Revision 1.0Page 35
Sentry Installation Guide Annoyance Trap
6. Type y and press Enter to indicate that all release media has been loaded.
The APM installation begins processing all of the Annoyance Trap 
installation files and checking them for correctness. The screen indicates the 
status of the installation. 
After the files have been processed, the “root password” prompt displays. In 
order to complete the Annoyance Trap installation, you must modify certain 
files that require “root” privileges. The “root password” prompt is illustrated 
below:
OAI Platform is at revision 5 for machine i386 (Dec 19 1994 Rel 1.6.1)
annoyTrap Revision: 5     machine type: i386     Version: 1.7Processing, please wait...Validating installed files..............
Validation Completed
                  Installing the Release Files
Processing files
Installation requires Super User (root) privileges.
Please Enter su/root Password:
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998 
						

							Page 36NDA-30080   Revision 1.0
Annoyance Trap Sentry Installation Guide
7. Type in the root password at the prompt and press Enter to continue the 
Annoyance Trap installation.
The Annoyance Trap installation will create any directory that does not 
already exist. The paths of the directories will display on the screen.
8. Press Enter to continue.  Next, you will be prompted to enter the “Annoyance 
Trap Pilot Number”.
9. Type the number your site will use to trigger Annoyance Trap, such as *69.  
This number should contain no more than 5 characters.
Creating Annoyance Trap directories . . .
/oai/app/sentry created
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
/oai/app/sentry/bin created
/oai/app/sentry/install created
/oai/app/sentry/cfg created
/oai/app/sentry/cfg/terminals created
/oai/app/sentry/cfg/terminals/default created
/oai/log already exists
/oai/log/sentry created
Press Enter to continue. [ ]
Please type the Annoyance Trap Pilot Number, then press Enter.
Annoyance Trap Pilot Number: [ ]
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998 
						

							NDA-30080   Revision 1.0Page 37
Sentry Installation Guide Annoyance Trap
10. If you have entered the correct pilot number, type y and press Enter to verify 
your entry. Otherwise, type n and press Enter, and enter the correct value.
After you have entered and verified the pilot number, the “Annoyance Trap 
Operator’s Extension” prompt displays.
11. If your system requires an Annoyance Trap operator, type the operator’s 
extension at the prompt, such as 1000, and press Enter.  Then, verify that this 
extension is correct at the next prompt.
If your system does not require an Annoyance Trap operator, press Enter 
without typing an extension.
After entering an verifying the appropriate value, if any, the following screen 
displays:
Please type the Annoyance Trap Operator’s Extension, then press
then just press Enter.
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
Enter. If your system does not require an Annoyance Trap Operator,
Annoyance Trap Operator’s Extension [ ]
Please type the Annoyance Trap Audio Device Extension, then press
press Enter.
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
Enter. If your system does not require an Audio Device, then just
Audio Device Extension [ ] 
						

							Page 38NDA-30080   Revision 1.0
Annoyance Trap Sentry Installation Guide
12. Do one of the following:
If your system requires an Annoyance Trap audio device, type the device’s 
extension at the prompt, such as 1001, and press Enter.  Verify that this 
extension is correct at the next prompt, and go to step 13.
If your system does not require an Annoyance Trap audio device, press 
Enter without typing an extension. Press Enter to verify that you have not 
entered an extension, then go to step 14.
13. The dummy phone is used to activate the audio device, and is required if an 
audio device extension has been specified. Type the dummy phone extension 
at the “Dummy Phone Extension” prompt, and press Enter. Verify this value 
by typing y and pressing Enter.
14. The following screen displays, whether or not your system has an Annoyance 
Trap audio device.
15. Press Enter to continue and the Annoyance Trap Auto-Configuration program 
installs the default configuration.
The default Annoyance Trap Application Configuration
Annoyance Trap Installation has concluded, be sure to
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
will now be installed by the autoconfig program. After the
and modify any settings that are different from your system. check the configuration using the Applications Manager (APM)
Press Enter to continue [ ]
Annoyance Trap Auto-Configuration
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
/oai/utils/autocfg running . . .
/oai/utils/autocfg: Annoyance Trap application configured.
/oai/utils/autocfg terminated normally.
Annoyance Trap Auto-Config Complete
Press Enter to continue. [ ] 
						

							NDA-30080   Revision 1.0Page 39
Sentry Installation Guide Annoyance Trap
16. Press Enter to continue the installation process.
17. Press Enter to continue and the following screen displays when the installation 
is complete.
18. Press Enter.
Installing the Annoyance Trap Binary . . .
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
Installing the Tenant Database Files . . .Installing the Building Database Files . . .Installing the History Log Configuration Files. . .
Press Enter to continue. [ ]
Annoyance Trap Installation Complete.
NEC America Inc.   Annoyance Trap Installation   Wed - Apr 29, 1998
Press Enter to continue. [ ] 
						

							Page 40NDA-30080   Revision 1.0
Annoyance Trap Sentry Installation Guide
Configuration
The Annoyance Trap software is configured automatically during installation if 
you answer “yes” to the autoconfig prompt. You may also configure Annoyance 
Trap manually by using the Add Function of the Application Configuration option 
on the APM System Administration menu.  The default application name is 
Annoyance_Trap.
Note:
This section contains information that is entered in the Annoyance Trap 
configuration file. For specific instructions on what these parameters mean and 
how to make these entries, use the APM Operations Manual.
Application 
CharacteristicsWhen manually adding Annoyance Trap to the APM Application Configuration 
file, define the parameters as follows:
Note:
These parameters are defined automatically if you answered “yes” to the 
autoconfig prompt during installation.
ParameterEntryDescription
OAI Application Y(es) Indicates whether or not (Yes or No) Annoyance Trap 
communicates with the NEAX2400 using OAI 
processes.
CRT  Application N(o) Indicates whether or not (Yes or No) Annoyance Trap 
requires a terminal screen that is of the same type as 
the one used by the APM.  
Communication 
QueueN(o) Indicates whether or not (Yes or No) this non-OAI 
application needs an IPC queue to communicate with 
other processes.