NEC Medical Center System Operations Manual

							NDA-30026   Revision 6Page 9
Medical Center System Operations Manual - JAVA Edition SERVER INSTALLATION
Chapter 2 SERVER INSTALLATION
Introduction
This chapter provides a step-by-step description of the installation and setup of 
Medical Center System (MCS). The following steps must be taken before MCS can 
be installed:
1. The OAI/APM system must be installed on the SCO UNIX system. 
2. The Informix Dynamic Server (IDS) Workgroup Edition Version 7.30 must be 
installed on the SCO UNIX system.
Note:A system obtained through NEC CNG Division will normally have been precon-
figured with these requirements. If reinstalling or upgrading a system, the install-
er should contact NEC to obtain the system staging procedures.
The installation and setup of MCS involves the following procedure. Perform the 
installation in this sequence and refer to the listed sections for detailed instructions:
1.Hardware Installation on page 11 
Each attendant station consists of an NEC Advanced Attendant Console and a 
CRT. This section presents the attendant setup for each station and discusses 
how the hardware configurations are used to determine software characteristics.
2.Software Installation on page 12 
This section discusses installation and configuration of the MCS software 
components of the UAP. 
3.Application Configuration on page 19 
MCS is internally supported by the Applications Manager (APM) and must 
therefore be set up in the APM environment. This section presents a detailed 
description of the required setup. Use the instructions provided in the APM 
Operations Manual to make the entries contained in this section. 
4.Database Requirements on page 32 
MCS provides two default APM databases that are loaded during software 
installation. One of these databases can be changed through the APM Database 
Administration option. This section defines the fields and entries in this 
database. Use the instructions provided in the APM Operations Manual to make 
any required changes to the database presented in this section.
5.MAT Assignments on page 34 
Specific data settings must be assigned at the NEAX2400 Maintenance 
Administration Terminal (MAT) before MCS will function. This section 
specifies the necessary commands and the values to which they are to be set.
6.Attendant Station Preparation on page 35 
Attendant stations are set up via the MCS Main Menu. Enter from the UNIX 
login prompt during this step. 
						

							Page 10NDA-30026   Revision 6
SERVER INSTALLATION Medical Center System Operations Manual - JAVA Edition
7.Extension Installation 
After the installation is performed as outlined in Steps 1 through 6, the extensions 
must be added to the Informix database. Each extension is assigned through the 
Extension Maintenance option, entered from the System Administration option on 
the MCS Main Menu.
Note:In some cases, sequence is important in the assignment process. We recommend a re-
view of Chapter 7, “SYSTEM ADMINISTRATION” before beginning these assign-
ments.
The Applications Manager Operations Manual provides detailed instructions for using 
the APM menus and for completing the data entry screens shown in this manual. 
NEAX2400 IMS System manuals provide the procedures for making the data 
assignments at the NEAX MAT. 
						

							NDA-30026   Revision 6Page 11
Medical Center System Operations Manual - JAVA Edition SERVER INSTALLATION
Hardware Installation
The hardware configuration of each attendant station determines the software 
characteristics for the attendant configuration in JAVA MCS. Each MCS attendant 
station consists of an NEC Advanced Attendant Console and a PC Workstation, and 
each is identified by the following unique characteristics: 
Attendant ID:  An attendant console equipment number for each particular station 
ranging from 1 to 16. 
Extension:  A unique extension assigned to the attendant console on the PBX.
Number 
Attendant 
StationNumber each attendant station with a unique value between 1 and 16, and label each 
with its assigned Attendant ID. The easiest method is to make the station Attendant ID 
match the logical ID of each attendant console as it is assigned on the NEAX 
Maintenance Administration Terminal. (Refer to MAT Assignments on page 34 for 
more information.)
  
						

							Page 12NDA-30026   Revision 6
SERVER INSTALLATION Medical Center System Operations Manual - JAVA Edition
Software Installation
This section discusses the installation of MCS software from the release media and 
describes the required MCS software configurations. Before beginning this section, be 
sure to install the UNIX operating system, including the raw partition required for 
Informix, and the Applications Manager platform. Refer to the instructions provided 
with each of these software packages for more information. 
Installation of MCS software is initiated from the Applications Manager (APM) 
Platform Maintenance Main Menu. To display this menu, type the login apmadm at 
the UNIX prompt and press Enter. When prompted, type the assigned password and 
press Enter. Using instructions in the APM Operations Manual, select and implement 
the Installation of Applications/Packages option from this menu to load MCS 
software from release media. As the installation process executes, follow the steps 
described below as they correspond to the screen display, and make entries as 
indicated. Required input is shown in boldface type.
Step 1: 
Superuser/ 
Root PasswordType the password for the root login and press Enter to continue. If you type an invalid 
password, the message “Error entering root password. Installation failed” displays, the 
installation cancels, and you must restart the installation.
Figure 2-1   Super User Root
After entering a valid root password, the MCS user account installation will quickly 
display several screens as the install process continues. Some example screens are 
shown below:
Figure 2-2   Example Install Screens
MCS Installation
Installation requires Super User (root) privileges.
Password:  
NOTE: To re-run this script login as ‘apmadm’ get to ‘Unix’
and execute the following command ‘/oai/install/mcs.ins’.
su root:
Installing 16 mcs network users on SCO UNIX.
User (mcs1) installed.
User (mcs2) installed.
User (mcs3) installed.
User (mcs4) installed.
Deleting password for user: mcs1
Last successful password change for mcs1:  NEVER
Deleting password for user: mcs2
Last successful password change for mcs2:  NEVER  
						

							NDA-30026   Revision 6Page 13
Medical Center System Operations Manual - JAVA Edition SERVER INSTALLATION
Step 2: MCS 
Login NamesThe mcs and mcsadm login names are installed with the same user ID. (The default is 
4001.) Any change in the user ID value must be made for both login names, since they 
both use the same user ID value. Press Enter at each user ID prompt to accept the 
default value. A warning message displays when the 4001 user is being installed. Type 
‘y’ and press Enter at the warning prompt and continue the installation. The 
installation should default through this section. If another user is using the assigned ID, 
you will need to select another ID by adding one to the default until it can be assigned.
Step 3: MCS 
Installation 
ProcessingThe installation script performs several steps after you enter the login name. 
Information about these steps displays as they are performed. None of these steps 
require input. This process includes the following actions:
Entering boot-up commands into UNIX boot-up sequence.
Installing all remaining MCS files and directories as well as MCS host directories 
and executables.
Entering MCS crontab information. 
At the prompt, type ‘y’ and press Enter to continue the installation.
Figure 2-3   MCS Installation Processing
.
.
.
Installing MCS system boot sequence...
mcs crontabs entries complete...
Installing gettydefs entry for MCS.
Installing MCS directories and executables...
Continue with installation of Mcs/Informix Database (y/n)  [  ] 
						

							Page 14NDA-30026   Revision 6
SERVER INSTALLATION Medical Center System Operations Manual - JAVA Edition
Step 4: Informix 
Database 
InstallationThe figure below shows a normal execution of the Informix setup and includes the 
required input for each prompt. Type y and press Enter if this is the first time this 
installation is being performed. 
The informix user must not have a password, as described in the APM Informix 
Installation section. If the informix user does have a password, this step will fail. 
Required input is shown in boldface type.
Figure 2-4   Informix Setup
The APM Main Menu displays. Select the Logout option from the Main Menu.
Step 5: Jmcmp 
Server 
Software 
InstallationJMCMP Pre-Install
This installs the Java JMCMP server software. The JMCMP Pre-Install step of the 
installation checks for previous installed versions of JMCMP Server.  If no previous 
versions exist, the following is displayed: Press Enter to continue.
Figure 2-5   Jmcmp Pre-Install - 1st Install
Please Enter su/informix Password: 
MCS Informix Database Installation
.
.
.
Creating Mcs database: [mcsdb].
Mcs database [mcsdb] created.
MCS Informix database created.
Do the Mcs Database Indexes already exist? (y/n) n 
.
.
.
Building Mcs database indexes: [mcsdb].
Mcs database [mcsdb] indexes built.
..
.
MCS Installation Complete.
Creating MCS Informix database... Does the Mcs Database already exist? (y/n) n  Bringing Informix Database Engine On-line...
        JMCMP Server Pre-Install
        Checking the system configuration....
        JMCMP Server Pre-Install Complete
        Press Enter to Continue Installation: 
						

							NDA-30026   Revision 6Page 15
Medical Center System Operations Manual - JAVA Edition SERVER INSTALLATION
Step 5: Jmcmp 
Server 
Software 
Installation 
(Cont)However, if a previous version is detected, an option is given to either upgrade (leaving 
configured data alone), overwrite (completely overwrite all Jmcmp data), or abort the 
installation. Enter ‘u’, ‘o’, or ‘a’ to upgrade, overwrite, or abort the installation and 
then press Enter.
Figure 2-6   Jmcmp Pre-Install - Install Options
If the upgrade option is chosen, the following is displayed: Press Enter to continue
Figure 2-7   Jmcmp Pre-Install - Upgrade Option
If the overwrite option is chosen, the following is displayed: Press Enter to continue
Figure 2-8   Jmcmp Pre-Install - Overwrite Option
        JMCMP Server Pre-Install
        Checking the system configuration....
        JMCMP Server Ver1.0 Currently Installed
        Do you wish to upgrade, overwrite the existing
        JMCMP Server Installation or Abort? (u/o/a):
        Saving Current JMCMP Server Applications and Configurations
        To insure access to data please login as root
Login: root
Password:
        Adjusting directory access ... Done.
        JMCMP Server Pre-Install Complete
        Press Enter to Continue Installation:
        Overwriting Existing JMCMP Server Installation
        To insure access to data please login as root
Login: root
Password:
        Adjusting directory access ... Done.
        JMCMP Server Pre-Install Complete
        Press Enter to Continue Installation: 
						

							Page 16NDA-30026   Revision 6
SERVER INSTALLATION Medical Center System Operations Manual - JAVA Edition
Step 5: Jmcmp 
Server 
Software 
Installation 
(Cont)JMCMP Install
After the Pre-Install phase of installation, the following is displayed: 
Figure 2-9   Jmcmp Installation - Access to Data
Enter the root password and press Enter to allow proper access to configuration data. 
If this is a first install of Jmcmp Server, the following is displayed: 
Figure 2-10   Jmcmp Installation - Initial Installation
If the upgrade option is selected, as described in Figure 2-6, “Jmcmp Pre-Install - Install 
Options” on page 15, the Jmcmp Server application, the following is displayed: 
Figure 2-11   Jmcmp Installation - Upgrade Installation
Pressing Enter installs the new applications, and then restores all configuration data 
from the previous installation. For the ‘Upgrade’ option, no other configuration is 
needed, and installation is complete.
             Installation requires Super User (root) privileges.
        NOTE: To re-run this script login as ’apmadm’ get to ’Unix’
              and execute the following command ’/oai/install/jmcmpServer.ins’.
su root
Password:
      
        Initial JMCMP Server Install
        Unpacking Install JMCMP Server Ver1.0.
        Upgrading JMCMP Server Ver1.0 to Ver1.1
        Unpacking Upgrade JMCMP Server Ver1.0
Installation Complete
        Hit Enter to continue: 
						

							NDA-30026   Revision 6Page 17
Medical Center System Operations Manual - JAVA Edition SERVER INSTALLATION
Step 5: Jmcmp 
Server 
Software 
Installation 
(Cont)If overwrite the existing installation is selected, the following is displayed: 
Figure 2-12   Jmcmp Installation - Overwrite Installation
This installs the new applications, plus sets all configuration data to default values. If 
the Jmcmp Server was previously installed, the APM application “JmcmpConnServer” 
may already be configured. If so, the following is displayed: 
Figure 2-13   Jmcmp Installation - Overwrite APM Application Configuration
To keep the same configuration parameters for the APM application 
“JmcmpConnServer”, type ‘n’ and press Enter. To set the configuration parameters to 
default values, which must be modified later, type ‘y’and press Enter.
If this is an “Initial” installation, or if overwriting the existing installation, the 
allowable client connections to the Jmcmp Server must be defined. The following is 
displayed: 
Figure 2-14   Allowable Client Connections Description
        Overwriting JMCMP Server Ver1.0
        Unpacking Install JMCMP Server Ver1.0.
        Application JmcmpConnServer is already configured.
        Do you wish to overwrite current configuration
        data with the new default data? (y/n)
                             JMCMP Server Connection ID Configuration
        For each Java Client connection, an identifier must be
        defined.  The identifier can be either:
                (a) A fully qualified host name, or a hostname that can be
                    resolved on the Server machine.
                    (e.g., clientmachine.domain.com)
                (b) The 32-bit IP address of the client machine.
                    (e.g., 123.45.678.901)
                (c) The 48-bit MAC address (Ethernet address) of the client’s
                    Network Interface Card.
                    (e.g. 00:20:af:9c:5a:b3)
        Do you wish to edit the JMCMP Server Connection ID configuration
        file at this time (vi editor) ? (y/n)
        NOTE: To exit the vi editor without saving, enter :q!
(Hit Enter to continue) 
						

							Page 18NDA-30026   Revision 6
SERVER INSTALLATION Medical Center System Operations Manual - JAVA Edition
Step 5: Jmcmp 
Server 
Software 
Installation 
(Cont)Entering ‘y’ and pressing Enter starts up the ‘vi’ editor, allowing modifications to the 
User Address Mapping File:
Figure 2-15   Allowable Client Connections Configuration File
For each client position, enter the hostname, IP address, or MAC address of the client 
machine. When the installation is complete, the following is displayed: 
Figure 2-16   Jmcmp Installation - Installation Complete
Step 6: Java 
Server/Client 
Component 
InstallationA Java software component must be installed on the server to enable communication 
with Java clients. This installation is initiated from the Applications Manager (APM) 
Platform Maintenance Main Menu. To display this menu, type the login apmadm at 
the UNIX prompt and press Enter. When prompted, type the assigned password and 
press Enter. Using instructions in the APM Operations Manual, select and implement 
the Installation of Applications/Packages option from this menu to load this software 
component from release media. When all release media has been loaded, the 
installation of this component is complete. No further setup is required for this 
component.
#
#  User Address Mapping File
#
#      In
# POS  Use  Address
# ---  ---  ------------------
  01    0   localhost
  02    0
  03    0
  04    0
  05    0
  06    0
  07    0
  08    0
  09    0
  10    0
  11    0
  12    0
  13    0
  14    0
  15    0
  16    0
NEC America Inc     JmcmpConnServer Ver1.0 Installation     Wed - Aug 25, 1999
Installation Complete
        Hit Enter to continue: