NEC Student Services Installation Guide

							STUDENT SERVICES
Installation Guide
NEC America, Inc.
NDA-30073
Revision 1
October, 1997
Stock # 241689 
						

							LIABILITY DISCLAIMER
NEC America, Inc. reserves the right to change the specifications, 
functions, or features, in this document at any time, without notice. NEC 
America, Inc. has prepared this document for use by its employees and 
customers.  The information contained herein is the property of NEC 
America, Inc. and shall not be reproduced without prior written approval 
from NEC America, Inc.
Copyri
ght 1997
NEC America, Inc. 
						

							NDA-30073  Revision 1Page i
Student Services - Installation Guide CONTENTS
TABLE OF CONTENTS
Page
Chapter 1 - INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
How to Use This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
Guide Organization  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
What is Student Services?  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
Application & Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
Application Components  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
Databases  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
Pre-Installation Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
Installation Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
Chapter 2 - SOFTWARE INSTALLATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
Install Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
UNIX Subsystem Database Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
EXCEPTIONS to Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
Chapter 3 - APPLICATION CONFIGURATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
Overall Configuration Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Configuration for Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
Screen Saver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
Report Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
Configuration for StationControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
Primary Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
APM Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14 
						

							Page iiNDA-30073  Revision 1
CONTENTS Student Services - Installation Guide
This Page Left Blank. 
						

							NDA-30073   Revision 1Page 1
Student Services - Installation Guide INTRODUCTION
Chapter 1 INTRODUCTION
This guide provides the information needed to install and configure the Student 
Services application software. This document is based on Release 1 of the Student 
Services software.
Refer also to the Student Services Administrator Guide for additional information. 
It describes the screens and functions for Administrator operation of Student 
Services. Additional installation and configuration information can be found in the 
following manuals:
•Applications Manager (APM) Operations Manual - Describes how 
applications are configured in the APM environment and how the Student 
Services databases are created using the entries and values provided in this 
guide.
NEAX2400 System Manuals - Provides detailed descriptions for parameter 
assignments that must be made through the Maintenance Administration 
Terminal (MAT) commands on the NEAX2400.
How to Use This Guide
This guide describes the screens, parameters, and step-by-step procedures to install 
and configure all components of the Student Services software. The organization 
of this guide reflects the order of installation and configuration for the Student 
Services application and its components.
Guide 
OrganizationChapter 1 - Introduction
Chapter 1 details how to use this guide, the actual guide organization, and an 
overview of Student Services. 
Chapter 2- Software Installation
This chapter describes the procedure to install the Student Services software from 
diskette.
Chapter 3- Application Configuration
Chapter 3 describes specific field entries that must be made or verified to properly 
configure Student Services for operation.
Chapter 4- MAT Assignments
Various data parameters must be set through the MAT function at the PBX. These 
parameters are described in this chapter. 
						

							Page 2NDA-30073   Revision 1
INTRODUCTION Student Services - Installation Guide
What is Student Services?
OverviewStudent Services is an application software package for the NEC Open Application 
Interface (OAI) environment. It operates on an NEC User Application Processor 
(UAP) system, in conjunction with an NEC PBX system.
The Student Services application is designed to meet the needs of a student housing 
facility. It provides a telephone system Administrator’s interface for feature and 
operational scheduling of designated telephone stations and station groups. 
The application updates station parameters directly to the premises NEC PBX. The 
PBX applies these parameters to the designated stations, providing telephone 
service restrictions or service changes based on a defined schedule.
Application & 
FunctionsOften in a student housing environment, telephone service must be limited and 
operational capabilities changed on a scheduled basis. Daily, weekly, and special 
term scheduling may be required depending on the facility. Additionally, the 
telephone privileges and scheduling may be different for select groups of users.
Student Services provides a database for station telephone functions. The database 
allows existing stations to be scheduled for special operation according to the 
defined parameters of the schedule. Stations can also be grouped in a group 
database where parameters can be defined and scheduled over the whole group.
Application 
ComponentsThe Student Services software package is comprised of several internal 
components that perform the primary application functions:
The Administrator component provides the system administrator’s inter-
face to Student Services. The interface allows an administrator to add, de-
lete, and modify records in the Student Services database files. The interface 
provides access to event scheduling and immediate event requests, along 
with record printing and database find functions.
StationControl is an OAI component that uses PBX components to set 
route restriction class, station forwarding, and service feature class. It com-
municates with the PBX and performs the specified actions.
The StopTalk component (also an OAI component) manages the termina-
tion of active calls when an event is started. It manages the communication 
between the various Student Services components and the PBX to invoke a 
warning announcement to the callers and to activate call termination.
The Override OAI component provides a special function for the adminis-
trator. This function allows an administrator to make calls to stations that 
have been restricted from receiving incoming calls by a Student Services 
event (overriding the event restriction). This can be useful in emergency and 
special announcement situations. 
						

							NDA-30073   Revision 1Page 3
Student Services - Installation Guide INTRODUCTION
These internal components are transparent to the administrator, but various 
parameters of these components must be configured during the installation 
sequence of the Student Services software. Configuration for these components is 
described in later chapters of this guide.
DatabasesThe Student Services software application is comprised of multiple databases. 
Three primary databases contain all the information specific to the Stations, 
Groups, and the Scheduled Events functions of the program.
The software uses two copies of these databases; the Working database and the 
Installed database. The working database allows changes to be made to Student 
Services Stations, Groups, or Scheduled Events without affecting the realtime 
operation of the PBX system. The installed database is the data base actually being 
used realtime by the PBX for Student Services data.
When changes are made to any of the three primary databases, they are first made 
to the working database copy. It is this working copy that is being changed from 
any of the menus and functions of the Student Services software. The Install 
Databases function of the Student Services application (or when exiting the 
program) will install the current working database as the new installed database.
StationsGroupsScheduled
Events
StationsGroupsScheduledEvents
StationsGroupsScheduledEvents
Working
Database
Installed
Database
INSTALL 
						

							Page 4NDA-30073   Revision 1
INTRODUCTION Student Services - Installation Guide
This process ensures the PBX operates on complete data and only receives any 
changes all at once. This also allows major changes to the working database to be 
discarded if an error is made, before installing to the PBX.
Pre-Installation Requirements
The Student Services application installs to, and operates from, an NEC UAP 1000 
(or equivalent) computer; operating in conjunction with an NEC NEAX2400 PBX 
system. No additional hardware is required for Student Services.
Student Services requires OAI Platform Release 2.0 (or greater) software to be 
installed and operating on the UAP computer. If this software is not currently 
installed on the UAP, contact a NEC representative. OAI software must be 
installed and operating BEFORE installing Student Services.
Installation Sequence
The installation and configuration of Student Services involves the following 
sequence of actions:
1.Software Installation — Student Services software must first be loaded from 
the release diskette. The procedures to load and install the software to a UAP 
computer are described in Chapter 2 of this guide. 
2.Application Configuration — Student Services is internally supported by the 
Application Manager (APM) software operating on the UAP. Various parame-
ters must be configured in the APM environment. Student Services uses multi-
ple databases constructed and maintained through the APM Database 
Administration option. Refer to Chapter 3 of this guide for configuration proce-
dures.
3.MAT Assignments — Various data settings must be assigned at the 
NEAX2400 Maintenance Administration Terminal (MAT) for Student Services 
to function. The variables , definition settings, and data parameters that must be 
added or modified are described in Chapter 4 of this guide.  
						

							NDA-30073   Revision 1Page 5
Student Services - Installation Guide SOFTWARE INSTALLATION
Chapter 2 SOFTWARE INSTALLATION
This chapter describes the procedures to install the Student Services software. 
Some screen descriptions list an ‘Exception number’. An Exception is an 
alternate screen display that may be encountered during installation. These 
exceptions are described in the section following the Install Procedure.
Note:
Some keyboards use a marked Return
 key for the carriage return function. Other 
keyboards mark this function key as Enter
. The installation procedure will iden-
tify this function as Return
 (Enter). When the procedure indicates, use the appro-
priate marked key on your particular keyboard.
Install Procedure
To begin the Student Services software 
installation, go to an available UNIX 
login screen (i.e., a virtual screen, e.g., 
) and type “apmadm” at the 
UNIX login prompt, then press Return 
(Enter).
If your “apmadm” account requires a 
password, enter the “apmadm” pass-
word at the subsequent password 
prompt.
The “APM Administration” Main 
Menu.
Type “i” in the “Enter Option: [ ] input 
field and then press Return (Enter) to 
select the “Installation of Applications/
Packages”.\_WY^* Q`]QT]
`Qccg_bT*
>53 1]UbYSQ 1@= 1T]Y^YcdbQdY_^ =_^ :e^ # 
1@= @\QdV_b] BU\UQcU BU\$ =Qi !# !))

=QY^ =U^e
1@=
4UReW 6QSY\YdYUc
8Q\d 1@= CicdU]
6Y\U 1bSXYfU
9^cdQ\\QdY_^ _V 1``\YSQdY_^c@QS[QWUc
BU]_fQ\ _V @QS[QWUc
CdQbde` 1@= CicdU]
9H
5^dUb ?`dY_^* KYM
1@= CdQdec* 13D9F5
3_^VYWebQdY_^ _V E1@
@2H CY]e\Qd_b 
						

							Page 6NDA-30073   Revision 1
SOFTWARE INSTALLATION Student Services - Installation Guide
Messages are displayed showing the 
progress of the installation.
For Student Services installation, cer-
tain files must be modified that require 
“root” privileges.
You are prompted for the “root” pass-
word. Type in the “root” password at 
the prompt and press Return (Enter).
(Exceptions: 3)
You are prompted for the “user ID”. 
Type the user ID (if one has been as-
signed) and press Return (Enter).
Press Return (Enter) to accept the de-
fault ID of 8000.
3bUQdY^W 4YbUSd_bYUc ^UUTUT
>53 1]UbYSQ 9^S CdeTU^d CUbfYSUc =_^  :e^ # 
3bUQdY^W RQS[e` TYbUSd_bi
4US_]`bUccY^W VY\Uc
Ce`Ub EcUb b__d `bYfY\UWUc QbU bUaeYbUT d_ SbUQdU dXU cdQSdb\ ecUb QSS_e^d
@\UQcU U^dUb dXU ce`Ub ecUb @Qccg_bT*
>53 1]UbYSQ 9^S CdeTU^d CUbfYSUc =_^  :e^ # 
Ce`Ub EcUb b__d `bYfY\UWUc QbU bUaeYbUT d_ SbUQdU dXU cdQSdb\ ecUb QSS_e^d
@\UQcU U^dUb dXU ce`Ub ecUb @Qccg_bT*
>53 1]UbYSQ 9^S CdeTU^d CUbfYSUc =_^  :e^ # 
5^dUb cdQSdb\ ecUb YT K(   M*