60955aak Iss5 EMOS50

1QDE 60955 AAK-YYA
Issue 5
THIS DOCUMENT UNCONTROLLED WHEN PRINTED
INSTALLATION AND
CONFIGURATION OF THE EM-OS
RELEASE 5.0 APPLICATION
SOFTWARE (VIA DAT MEDIA)
The information contained herein is the

responsibility of and is approved by the
This is a Marconi Communications Limited following, to whom all enquiries should be
standard authorised for use within Marconi directed in the first instance:
Communications Limited by:
Mr. T. Masling Mr. J. Melling
Test & Commissioning Strategy Manager Software Products Manager
Dept. FC0887 Dept. FC0887
Manufacturing & Logistics Manufacturing & Logistics
New Horizon Park, Coventry. New Horizon Park, Coventry.
This is an unpublished work the copyright in which vests in Marconi Communications Limited. All rights reserved.
The information contained herein is confidential and the property of Marconi Communications Limited and is supplied without liability for errors
or omissions. No part may be reproduced, disclosed or used except as authorised by contract or other written permission. The copyright and the
foregoing restriction on reproduction and use extend to all media in which the information may be embodied.
New Century Park
PO Box 53, Coventry CV3 1HJ England Facsimile : National 01203 562247
Telephone : National 01203 562000 International: +44 1203 562247
International: +44 1203 562000 Telex : 31361 GPTEL
0.2 CONTENTS
Section Page
0 PREFACE
0.1 TITLE................................................................................................................ 0001
0.2 CONTENTS......................................................................................................0002
0.3 HISTORY..........................................................................................................0004
0.4 ISSUE CONTROL............................................................................................0005
0.5 REFERENCES.................................................................................................0006
0.6 ABBREVIATIONS.............................................................................................0007
1 GENERAL........................................................................................................0101
1.1 INTRODUCTION AND SCOPE........................................................................0101
1.2 OPTIONS......................................................................................................... 0101
1.3 EQUIPMENT REQUIREMENTS.......................................................................0102
1.4 CONVENTIONS...............................................................................................0102
1.5 REQUIRED INFORMATION.............................................................................0102
1.6 CAUTIONS.......................................................................................................0102
1.7 FALLBACK PROCEDURES.............................................................................0103
1.8 SUPPORT GROUP CONTACT........................................................................0103
1.9 RECORDING OF CUSTOMER WORKSTATION INFORMATION....................0103
1.10 EMC CONFORMITY.........................................................................................0103
1.10.1 Hardware Installations......................................................................................0103
1.10.2 Hardware Upgrades.........................................................................................0104
2 INSTALL EM-OS APPLICATION VIA TAPE......................................................0201

2.1 INSTALL EM-OS R5.0 APPLICATION ENHANCEMENT SOFTWARE.............0203
3 CONFIGURE EM-OS COMMS COMPONENTS..............................................0301

3.1 INSERTING LAN 9000 OR 100VG ANYLAN BOARD......................................0301
3.2 INSTALL/CONFIGURE THE EISA BUS............................................................0301
3.3 CONFIGURATION OF LAN 9000 OR 100VG ANYLAN BOARD......................0302
3.4 INSTALL CENTRAL DATA SCSI COMMS SERVER.........................................0303
3.5 INSTALL EM-OS DIGITAL I/O CARD................................................................0303
4 SETUP THE EM-OS APPLICATION.................................................................0401

4.1 EXECUTE EM-OS SETUP UTILITY.................................................................0401
4.1.1 Set EM-OS Hostname......................................................................................0401
4.1.2 Set OMS IPC Trader Hostname.......................................................................0402
4.1.3 Enable/Disable Network Element Licenses......................................................0402
4.1.4 Add/Delete X-Terminal For Use With EM-OS...................................................0402
4.1.5 Add/Delete EM-OS Workstation For Use Via Remote Login............................0403
4.1.6 Enable/Disable Communications Protocols......................................................0403
4.1.7 Enable/Disable External Link Interface............................................................0404
4.1.8 Enable/Disable Radio Manager........................................................................0405
4.1.9 Enable/Disable Default Routing.......................................................................0406
4.1.10 Add/Delete ItinerantX Terminal User Account...................................................0406
4.1.11 Enable/Disable New Architecture Manager (NAM) - (full GUI management of
SMA version 2 NEs).........................................................................................0406
4.2 ENABLE/DISABLE SERIAL DATA HANDOFF..................................................0407
4.3 ENABLE/DISABLE REMOTE WINDOWING....................................................0409
5 STARTING THE APPLICATION........................................................................0501
Page 02 Copyright - Refer to Title Page 1QDE 60955 AAK-YYA

Issue 5
99 APPENDIX.......................................................................................................9901
99.1 APPENDIX A - SERIAL PORT CONFIGURATION FILE
(EHSSERIALPORT.CFG).................................................................................9901
99.2 APPENDIX B - TROUBLESHOOTING.............................................................9904
1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 03

Issue 5
0.3 HISTORY
Change No. Issue Details Of Change
1A New Document
Author: M. Dam
FC0887
Test and Commissioning Strategy
Coventry
1B Contents of ‘/etc/gated.conf’ modified in section 4.1.7.2

Section 4.1.11 added - enabling and configuring NAM (SDH2).
(A J Frank)
1 Formally issued after FOA (A J Frank)
2 Alteration to facilitate on-line backups without ObjectStore

installed
3 Updated to incorporate loading of EMOS R5.0 Enhancement

software (A J Frank)
4 Correction to incorrect reference 0.5.5 (M. Dam)
5 Updated to reflect loading of enhancement software not applicable to

to pre-9806 builds only. Changed to use VUE instead of X11
windows. (A J Frank)
Original master held on ‘Word for Windows’

in Documentation Department FS0975, Liverpool.

Issue 5
0.4 ISSUE CONTROL
Date 17 21 14 18 20 05 22
MAR APR MAY MAY AUG OCT JUN
98 98 98 98 98 98 99
Section
All 1A 1B 1 2 3 4 5

Issue 5
0.5 REFERENCES
0.5.1 1QAA 60025 AAG-YYA NSG Engineering Manual
0.5.2 1ABR 60774 AAM-CTA EM-OS Release 5.0 Provisioning and Control
Document
0.5.3 1QDE 60615 AEY-YYA Installation and Configuration of HP-UX 10.20

ACE Operating System for the EM-OS
Application
0.5.4 1QDE 60955 ACU-YYA EM-OS Release 4.5/4.6 to 5.0 Upgrade Procedure
0.5.5 1QDF 60955 AAC EM-OS Release 5.0 Administrator Operator

Manual
0.5.6 1QDE 60639 AHQ-YYA Installation and Configuration of Central Data

SCSI Comms Server to a HP Workstation
0.5.7 1QDE 60639 AJH-YYA Installation and Configuration of EM-OS Remote

Windowing Facility
0.5.8 1QDE 60857 AFU-YYA Installation and Configuration of a Digital I/O

Card into an HP Workstation

Issue 5
0.6 ABBREVIATIONS
The following terms may be used in this specification:-
DAT Digital Audio Tape
EISA Extended Industry Standard Architecture

ELI External Link Interface
EM-OS Equipment Management Operations System
HP Hewlett Packard
HP-UX Hewlett Packard UNIX operating system
IP Internet Protocol
IPC Inter Process Communication
LAPB Link Access Procedures Balanced (X.25)

LCN Logical Channel Number
OMS Object Management System

OSI Open Systems Interconnection
PNG Public Networks Group
TMN Telecomms Managed Networks
End of Section

Issue 5
This page intentionally blank to facilitate double sided printing.

Issue 5
1 GENERAL
1.1 INTRODUCTION AND SCOPE
The purpose of this document is to define the procedures which must be followed for installing
and configuring Marconi Communications’s EM-OS Release 5.0 application. This document
assumes that a suitable HP-UX operating system and ObjectStore Database Server software (if
applicable) has previously been installed on the workstation (see ref. 0.5.3 for details on how to
do this). Any differences or additional installation or configuration information for any specific
EM-OS 5.0 builds will be given on release notes.
1.2 OPTIONS
There are three actions identified in this document:-
1. Install EM-OS application via tape.
2. Configure EM-OS Comms components.
3. Setup the EM-OS application.
All actions should be carried out with the following constraints:-
a. The procedure to install and configure a Central Data SCSI Comms Server, LAN 9000
card(s), 100VG AnyLAN card(s) or a Digital I/O Card should only be carried out if the
customer has purchased the relevant cards and/or hardware.
b. Serial data handoff should only be enabled if the customer has purchased a license to use
it.
c. Specific network element access licenses should only be enabled if the customer has
purchased a license to use them.
d. Access to specific Comms protocols should only be enabled if the customer has, or
intends to purchase relevant hardware.
e. Remote Windowing should only be enabled if the customer has purchased a license to
use it.
Note: The procedures should be carried out by an engineer with a good understanding of
HP-UX system administration and experience of the EM-OS application. Where experience is
limited it is strongly recommended that relevant training is undertaken. This can be in the
form of official HP training courses or Marconi Communications practical classroom sessions.

Issue 5
1.3 EQUIPMENT REQUIREMENTS
The following items of equipment are required to carry out the procedures detailed in this
document:-
a. HP-UX workstation and peripherals according to relevant version of -CTA document,

with an installed version of the HP-UX Operating System (see Reference 0.5.3).
b. HP DAT drive (if not integral).
c. EM-OS Release 5.0 Application files tape (1HGC 60371 ***). [See product release
note for correct version]
d. EM-OS Release 5.0 Application Enhancement software (1HGC 60371 ***) - if

applicable. [See product release note for correct version]
e. Licence codes for access to all the element types the customer has purchased (see
Reference 0.5.2).
1.4 CONVENTIONS
The following typographical conventions are used throughout this document:
a. Operator entries that must be typed in exactly as shown appear in “”, e.g. “tar xvf
/dev/rmt/0m”.
b. Keyboard keys to be depressed appear in [ ], e.g. [Return] means press the [Return]
key.
c. Text output by the workstation appear in ‘’, e.g. ‘Welcome to HP-UX’.
Note: The characters above are used as delimiters in the text and should NOT be entered as
part of the commands.
1.5 REQUIRED INFORMATION

The information required to enable the installation and configuration of the EM-OS application
will be detailed in the appropriate Network Planners Instructions covering this information.
Ensure this information is available prior to commencing the procedures detailed within this
specification.
1.6 CAUTIONS
NEVER USE THE POWER ON/OFF SWITCH TO REBOOT THE HEWLETT
PACKARD WORKSTATION USE ONLY THE ‘REBOOT’ FACILITY FROM THE
UNIX WINDOW OR IN EXTREME CASES PRESS THE ‘HARD RESET’ BUTTON.
THE FOLLOWING SET OF KEYSTROKES IS USED TO RESET THE X-SERVER ON

THE WORKSTATION - [CTRL], [SHIFT], [RESET]. IT SHOULD ONLY BEEN USED
IN AN EMERGENCY.
Issue 5
1.7 FALLBACK PROCEDURES

If a problem occurs with the loading or operation of the EM-OS application software, access the
UNIX window on the workstation and repeat the install procedure from Section 2.
Note: When editing files using the ‘vi’ editor great care should be taken as it is very easy to
corrupt files. It operates in two modes ‘command mode’ and ‘text entry mode’. When in text
entry mode i.e. any characters typed in are echoed on the screen, pressing the [ESC] key will
return to command mode. To leave the editor without saving any changes, return to command
mode and enter “:q!”. The command ‘:q!’ should be echoed at the bottom left of the screen.
Press [Return] to confirm this command. Always make sure the caps lock is off before starting
‘vi’.
1.8 SUPPORT GROUP CONTACT

If the use of Marconi Communications In-Service Operational Support Group Cover is agreed,
and assistance or consultation is required, the Marconi Communications Support Group should
be contacted via the Marconi Communications PNG ISOS helpdesk.
1.9 RECORDING OF CUSTOMER WORKSTATION INFORMATION

Whilst carrying out the installation of the customer workstation, the Customer EM-OS
Workstation Information record sheet (see Appendix B of 1QDE 60615 AEY-YYA) shall be
completed accordingly. On completion, this information will be forwarded to Build
Management (EMOS), Customer Support, Post Point 41/51, 4th Floor Kelvin Building,
Marconi Communications Limited, Edge Lane, Liverpool, L7 9NW, or fax to +44 (0)151 254
4970.
1.10 EMC CONFORMITY

1.10.1 Hardware Installations
All newly installed equipment’s must be CE marked - either on the equipment, on the packaging
or in the user documentation. Care must be taken to ensure that the CE mark is not discarded
with the packaging.
If a Customer requests a copy of the associated EMC (Electromagnetic Compatibility) DoC

(Declaration of Conformity) this should be obtained from the appropriate Business Unit or
Product Division.
Refer to the equipment list for the project and ensure that all the correct items, including cables
are available before commencing assembly. If all the equipment is not present, or does not
match the equipment list, the relevant project manager should be informed immediately so steps
can be taken to track down or replace the missing items.
1.10.2 Hardware Upgrades
To meet Electromagnetic Compatibility (EMC) all hardware upgrades must be carried out
following the equipment manufacturer’s instructions.
End of Section
Issue 5
2 INSTALL EM-OS APPLICATION VIA TAPE

Once the HP-UX 10.20 ACE operating system together with the ObjectStore Database server
software (if applicable) has been installed on a workstation, the EM-OS application can then be
installed by carrying out the steps which follow:-
a. If necessary, start up VUE by typing :-
“init 4”[Return]
At the ‘Vue Login’ prompt , login as ‘root’ with the appropriate password.
b. Ensure that the tape containing the EM-OS S/W build to be installed is set to ‘READ
ONLY’ (recognition hole tab open) and load it carefully into the DAT drive (push the
cartridge into the drive slot until the automatic loading mechanism takes up the
cartridge).
c. Wait for the tape to complete its load sequence as indicated by the LED(s) on the front
of the drive changing from flashing to steady.
d. Open a Unix terminal by clicking on the small terminal icon at the bottom of the screen.
At the ‘#’ prompt enter the command:-
“swinstall”[Return]
to display the ‘SD Install - Software Selection’ screen together with a ‘Note’ window.
Click on ‘OK’ in the displayed ‘Note’ window to acknowledge.
e. In the ‘Specify Source’ window, click on the ‘Source Depot Type’ field and select the
option ‘Local Tape’. Confirm that the ‘Source Host’ field contains the hostname of this
machine and the ‘Source Depot Path’ field contains the device name ‘/dev/rmt/0m’ for
the DAT drive.
Click on ‘OK’ to confirm.
f. Select the ‘EM-OS’ product by positioning the mouse cursor onto this fileset and
clicking with the left mouse button to highlight.
g. Click with the left mouse button on ‘Actions’ in the menu bar and from the drop down
menu click on ‘Mark for Install’.
The select fileset should now be marked with a ‘Yes’.
h. Click with the left mouse button on ‘Actions’ in the menu bar and from the drop down
menu click on ‘Install(analysis)’.
The workstation will now analyse the selected fileset.

Issue 5
j. When analysis is complete, as shown when the ‘Status’ field changes to ‘Ready’, click
on ‘OK’.
Click on ‘Yes’ at both resulting ‘Confirmation’ screens to commence installation.
k. The ‘Install Window’ will be displayed. This will be updated as the required filesets are
loaded. The entire process will take about 60 minutes to complete.
l. Wait until the ‘Install Window’ shows the status of ‘Ready’ then click on ‘Done’ to
reset the current ‘swinstall’ session.
A ‘Note’ window will be displayed informing that a reboot will take place, click on
‘OK’ to acknowledge.
m. An automatic reboot will take place. Monitor the reboot on the console.
n. The screen will display ‘HP-UX Start-up in Progress’ watch for any reports.
p. When the EM-OS application software was installed a default password file was also
installed containing a limited number of users and a password of [Return] for the ‘root’
user. At this stage a sensible password can be set.
q. At the login prompt, type:-
“root”[Return]
Press [Return] for the password.
r. If a new password is required for the root user, then type:-
“passwd”[Return]
The following prompt will be displayed:-
‘Change password for root.’

‘New password:’
s. Enter the required new password and press [Return].
The following prompt will be displayed:-
‘Re-Enter new password:’
t. Enter the same password and press [Return]. The new password has now been set.
u. Press the button on the front of the tape drive to eject the tape. The tape will rewind and
be ejected.
Remove the tape from the drive and store it in its protective case in a safe environment.
2.1 INSTALL EM-OS R5.0 APPLICATION ENHANCEMENT SOFTWARE

This section is only applicable if EM-OS R5.0 enhancement software is to be installed.
b. Ensure that the tape containing the EM-OS application enhancement software (1HGC
60371 ***) [See product release note for correct version] is set to ‘READ ONLY’
(recognition hole tab open) and load it carefully into the DAT drive (push the cartridge
into the drive slot until the automatic loading mechanism takes up the cartridge).
c. Wait for the tape to complete its load sequence as indicated by the LED(s) on the front
of the drive changing from flashing to steady.
d. Open a Unix terminal by clicking on the small terminal icon at the bottom of the screen.
At the ‘#’ prompt enter the command:-
“swinstall”[Return]
to display the ‘SD Install - Software Selection’ screen together with a ‘Note’ window.
Click on ‘OK’ in the displayed ‘Note’ window to acknowledge.
e. In the ‘Specify Source’ window, click on the ‘Source Depot Type’ field and select the
option ‘Local Tape’. Confirm that the ‘Source Host’ field contains the hostname of this
machine and the ‘Source Depot Path’ field contains the device name ‘/dev/rmt/0m’ for
the DAT drive.
Click on ‘OK’ to confirm.
f. Select the required fileset by positioning the mouse cursor onto the fileset and clicking
with the left mouse button to highlight.
g. Click with the left mouse button on ‘Actions’ in the menu bar and from the drop down
menu click on ‘Mark for Install’.
The selected fileset should now be marked with a ‘Yes’.
h. Repeat paragraphs f and g if other filesets are required to be installed.

i. Click with the left mouse button on ‘Actions’ in the menu bar and from the drop down
menu click on ‘Install(analysis)’.
The workstation will now analyse the selected filesets.
j. When analysis is complete, as shown when the ‘Status’ field changes to ‘Ready’, click
on ‘OK’.
Click on ‘Yes’ at the resulting ‘Confirmation’ screen to commence installation.
k. The ‘Install Window’ will be displayed. This will be updated as the required filesets are
loaded.
l. Wait until the ‘Install Window’ shows the status of ‘Completed’ then click on ‘Done’
to reset the current ‘swinstall’ session.
m. Click on ‘File’, then ‘Exit’ to close the current swinstall session.
n. Reboot the workstation by typing :-
“reboot”[Return]
o. Monitor the reboot on the console.
p. The screen will display ‘HP-UX Start-up in Progress’ watch for any reports.
q. At the login prompt, type:-
“root”[Return]
Press [Return] for the password.
r. Press the button on the front of the tape drive to eject the tape. The tape will rewind and
be ejected.
Remove the tape from the drive and store it in its protective case in a safe environment.
End of Section
Issue 5
3 CONFIGURE EM-OS COMMS COMPONENTS

This section should only be carried out if either an Ethernet board or a Digital I/O card is to be
installed into one of the EISA expansion slots of the workstation or a Central Data SCSI
Comms Server is to be added to the workstation configuration.
Note: HP 700 Series workstations require an HP LAN 9000 Ethernet card, the J Class
workstations require a 100VG AnyLAN Ethernet card.
3.1 INSERTING LAN 9000 OR 100VG ANYLAN BOARD

Before the LAN 9000 or 100VG AnyLAN board can be installed and configured it must have
been inserted into a free slot.
a. Shutdown the workstation by typing:-
“/etc/reboot -h”[Return]
b. Insert the board into a spare slot and make a note of the slot number.
c. Power on the workstation and login as the ‘root’ user.
3.2 INSTALL/CONFIGURE THE EISA BUS

To install the LAN 9000 board the utility ‘/etc/eisa_config’ must be executed. The 100VG
AnyLAN card will automatically be installed on the system.
a. Enter: “cd /etc/eisa”[Return].
b. Execute eisa_config by typing: “/etc/eisa_config”[Return]. A list of configured slots

will be displayed.
c. Add the LAN 9000 board to the slot in which it already resides by typing:-
“add !HWP1850.CFG <slot>”[Return]
where <slot> is the slot in which the board has been installed.
d. Save the changes by typing “save”[Return].
e. Exit eisa_config by typing “exit”[Return]. A message will be displayed confirming the

actions taken.
f. Reboot the workstation by typing “/etc/reboot -q”[Return].
Confirm that the LAN 9000 board is shown as present and configured during the reboot
sequence.
Issue 5
g. When the reboot has completed and the ‘Console Login’ prompt appears, login to the
workstation using “root”[Return] and entering the root password as previously.
3.3 CONFIGURATION OF LAN 9000 OR 100VG ANYLAN BOARD

Once the LAN 9000 or 100VG AnyLAN board has been installed (see Section 3.2) the ‘sam’
utility must be executed to configure the board.
Note: The additional LAN board must be correctly terminated before it can be configured.
b. Open a Unix terminal by clicking on the small terminal icon at the bottom of the screen.
At the prompt, start-up the System Administration utility ‘sam’ by typing:-
“sam”[Return]
c. From the ‘System Administration Manager’ main window, double click on the
‘Networking and Communications’ icon.
d. In the resultant window, double click on the ‘Network Interface Cards’ icon.
e. In the ‘Networking and Communications’ window highlight the LAN card installed
and from the ‘Actions’ menubar, select ‘Configure’ to display the ‘Configure LAN
Card’ window.
f. From the ‘Card Type’ menubar, select the ‘Ethernet’ option for LAN 9000 boards or
‘100VG Ethernet’ option for 100VG AnyLAN boards.
g. In the ‘Internet Address’ field, enter the LAN boards’ Internet address as supplied by
the Network Planner (different to the one for the internal lan). This field is mandatory.
If required, in the ‘Comments’ field type in a meaningful string e.g. one which identifies
the use of the card. This field is optional.
h. If a subnetwork mask is required, as supplied by the Network Planner, enter this in the
‘Subnetwork Mask’ field.
j. To add an alias for the workstation for this LAN board, click on the ‘Add Aliases’
button to display the ‘Add Aliases’ window.
k. In the ‘Alias’ field enter a meaningful string to identify the workstation and the LAN
board as supplied by the Network Planner. This field is mandatory.
l. Activate ‘Add’ then ‘OK’ to return to the ‘Configure LAN Card Window’ window.
Issue 5
Activate ‘OK’.
m. A ‘Message’ box appears reporting the progress of the task and finally that the interface
is enabled. When the task is finished the ‘Configure LAN Card Window’ window is
removed.
n. From the ‘File’ menubar in the ‘Network Card Configuration’ window, choose ‘Exit’.
p. In the ‘System Administration Manager’ window, choose ‘Exit’ then ‘Exit SAM’.
3.4 INSTALL CENTRAL DATA SCSI COMMS SERVER

Refer to 1QDE 60639 AHQ-YYA (see 0.5.6 References) for details of how to Install and
Configure a Central Data SCSI Comms Server to the HP Workstation and an Interface
Converter 285RC.
3.5 INSTALL EM-OS DIGITAL I/O CARD

Refer to 1QDE 60857 AFU-YYA (see 0.5.8 References) for details of how to Install and
Configure an Amplicon PC237 Digital Input/Output card to the HP Workstation.
End of Section
Issue 5
This page intentionally blank to facilitate double sided printing.

Issue 5
4 SETUP THE EM-OS APPLICATION

On an installed EM-OS workstation there are a large number of files and parameters that need to
be configured. In order to encapsulate this process a number of executable scripts have been
created. These allow automatic configuration of the most common files and parameters.
The setup scripts should be run immediately after the application has been installed and allow the
following information to be set:-
a. The hostname of the EM-OS application.
b. The hostname of the workstation running the OMS IPC trader.
c. Access to specific element types, via the licensing feature.
d. The hostnames and addresses for any networked X-terminals.
e. The hostnames and addresses for any networked EM-OS workstations which will be
connected via the remote login feature.
f. The profile of the communications stack, i.e. what interfaces the EM-OS is going to
communicate down.
g. Enable/disable the External Link Interface.
h. Enable/disable the Radio Manager.
j. Enable/disable Default Routing.
Note: After the setup scripts have been run, the workstation should be rebooted in order for
the changes to take effect.
4.1 EXECUTE EM-OS SETUP UTILITY

All scripts are located in the directory /emos/hpux/setup. Change to this directory by typing:-
“cd /emos/hpux/setup”[Return]
Carry out Sections 4.1.1 to 4.1.9 as necessary to configure the required parameters, referring to
the information supplied by the Network Planner.
4.1.1 Set EM-OS Hostname
Enter the following to set the EM-OS hostname:-
“em.host <hostname>”[Return]
where <hostname> is the given workstation hostname as detailed in the Network Planners
instructions.
Issue 5
For example if the hostname of the workstation was ‘gptemos1’ enter:-
“em.host gptemos1”[Return]
4.1.2 Set OMS IPC Trader Hostname
Enter the following to set the hostname of the workstation that the OMS IPC Trader is running
on:-
“em.trader <hostname>”[Return]
where <hostname> is the given workstation hostname running the OMS IPC Trader as detailed
in the Network Planners instructions.
For example if the hostname of the workstation running the OMS IPC Trader was ‘gptemos1’
enter:-
“em.trader gptemos1”[Return]
4.1.3 Enable/Disable Network Element Licenses
Enter the following to enable/disable the required Network Element licenses:-
“em.license <NE license code> <action>”[Return]
where <NE license code> is the specific Marconi Communications license code;
<action> is the action to perform (either “enable” or “disable”);
For example to enable the license code 1SAA60034AAR enter:-
“em.license 1SAA60034AAR enable”[Return]
Note: All Marconi Communications license code characters must be entered in UPPER
CASE.
Repeat the command for each Marconi Communications license code as required.
4.1.4 Add/Delete X-Terminal For Use With EM-OS
Enter the following to add/delete the required X-terminals for use with EM-OS:-
“em.xterm <action> <X-terminal hostname> <X-terminal IP address>” [Return]
where <action> is the action to perform (-a) for add, (-d) for delete or (-l) for list;
<X-terminal hostname> is the given X-terminal hostname as detailed in the Network
Planners instructions;
<X-terminal IP address> is the given X-terminal IP address as detailed in the Network
Planners instructions;
For example to add an X-terminal with hostname ‘xterm1’ and an IP address of ‘20.0.0.1’ enter:-
Issue 5
“em.xterm -a xterm1 20.0.0.1”[Return]
Repeat the command for each X-terminal as required.
4.1.5 Add/Delete EM-OS Workstation For Use Via Remote Login
Enter the following to add/delete the required EM-OS workstations for use via remote login:-
“em.rlogin <action> <remote login workstation hostname> <remote login workstation IP

address>”[Return]
where <action> is the action to perform (-a) for add, (-d) for delete or (-l) for list;
<remote login workstation hostname> is the given remote login workstation hostname as
detailed in the Network Planners instructions;
<remote login workstation IP address> is the given remote login workstation IP address
as detailed in the Network Planners instructions;
For example to add a remote login workstation with hostname ‘gptemos1’ and an IP address of
‘20.0.0.1’ enter:-
“em.rlogin -a gptemos1 20.0.0.1”[Return]
Repeat the command for each remote login workstation as required.
4.1.6 Enable/Disable Communications Protocols
Enter the following to enable/disable the required communications protocols:-
“em.protocol <action> <communications protocol>”[Return]
where <action> is the action to perform (-e) for enable, (-d) for disable or (-l) for list;
<communications protocol> is the given communications protocol to enable/disable as
detailed in the Network Planners instructions, options are intlan, lan1, lan2, lan3 and
lan4;
For example to enable the communications protocol for the HP internal LAN enter:-
“em.protocol -e intlan”[Return]
Repeat the command for each communications protocol as required.
4.1.7 Enable/Disable External Link Interface
Note: On EM-OS Release 5.0 the ELI is enabled by default, it should be disabled where its
use has not been specified by the Network Planner.
Enter the following to enable/disable the ELI:-
“em.eli <action>”[Return]
Issue 5
where <action> is the action to perform (-e) for enable, (-d) for disable.
For example to disable the ELI enter:-
“em.eli -d”[Return]
4.1.7.1 Edit ELISecurity file
ONLY REQUIRED WHERE ELI HAS BEEN ENABLED
Currently the em.eli script does not allow the user to add the IP address of the external
equipment. This should be done as follows:-
a. At the command line enter:-
“cd /emos/hpux/release”[Return]
“vi ELISecurityFile”[Return]
b. Move the cursor down to the bottom of the file.
Note: The file may be empty.
c. Add the IP address(es) of the external equipment as follows:-
[A]“<IP address of external equipment>”[ESC]
d. Save the file and exit by typing “:wq!”[Return]
4.1.7.2 Enable gated process
ONLY REQUIRED WHERE ELI HAS BEEN ENABLED
To enable the gated process, carry out the following:-
a. Edit the /etc/rc.config.d/netconf file:-
“vi /etc/rc.config.d/netconf”[Return]
b. Find the line:-
‘GATED=0’ and amend the line to read:-
‘GATED=1’
c. Confirm that the line:-
‘SUBNET_MASK[0]=“xxx.xxx.xxx.xxx”’
Issue 5
displays the correct subnetwork mask as specified by the Network Planner. If not enter
the correct subnet mask.
FOR EXAMPLE:-
‘SUBNET_MASK[0]=“255.255.255.0”’
d. Save the file and exit “:wq!”[Return].
e. Create the /etc/gated.conf file:-
“vi /etc/gated.conf”[Return]
f. Add the following line to this file:-
“rip yes;”
g. Save and exit from the file “:wq!”[Return].
4.1.8 Enable/Disable Radio Manager
Note: On EM-OS Release 5.0 the Radio Manager is enabled by default, it should be disabled
where its use has not been specified by the Network Planner.
Enter the following to enable/disable the Radio Manager :-
“em.radio <action>”[Return]
For example to disable the Radio Manager enter:-
“em.radio -d”[Return]
4.1.9 Enable/Disable Default Routing
Note: On EM-OS Release 5.0 Default Routing is enabled by default, it should only be
disabled when specified by the Network Planner.
Enter the following to enable/disable Default Routing :-
“em.default_route <action>”[Return]
where <action> is the action to perform (on) for enable, (off) for disable.
For example to disable Default Routing enter:-
“em.default_route off”[Return]
Issue 5
4.1.10 Add/Delete ItinerantX Terminal User Account
Enter the following to add/delete an ItinerantX terminal user account :-
“em.itinx <action>”[Return]
where <action> is the action to perform (-a) to add an ItinerantX user account, (-d) to delete an
ItinerantX account.
For example to add an ItinerantX account enter :-
“em.itinx -a”[Return]
The script will prompt for an ItinerantX account name - there can be just a single account or
many different accounts, and a password for the new account. Enter details as specified in the
Network Planners instructions.
Once setup, an ItinerantX terminal session is invoked by a telnet session to the host EM-OS
workstation (requires EM-OS to be running). Once the ItinerantX user logs in, they will be
automatically presented with the ‘EM-OS Welcome Screen’ and can then login to the EM-OS
(normal rules on EM-OS user/ password apply).
4.1.11 Enable/Disable New Architecture Manager (NAM) - (full GUI management

of SMA version 2 NEs)
Note: Although the NAM processes are enabled by default, the initial EM-OS Release 5.0
does not support NAM. It should be disabled.
Enter the following to enable/disable the SDH2 manager:-
“em.nam_sdh2 <action>”[Return]
For example to disable the NAM enter:-
“em.nam_sdh2 -d”[Return]
4.1.11.1 Setup/configure the SDH2 processes
ONLY REQUIRED WHERE NAM (SDH2) HAS BEEN ENABLED
For correct operation of the NAM manager, some initial configuration is carried out by the
em.smsetup script. If NAM has been enabled this script must be run or EM-OS will not start up.
enter :-
“em.smsetup”[Return]
Issue 5
4.2 ENABLE/DISABLE SERIAL DATA HANDOFF

Serial data handoff should only be enabled if the customer has purchased a license to use
it.
The serial data handoff program works in conjunction with the EM-OS event handler to direct a
copy of the EM-OS events to the serial port. This feature is disabled by default. To enable this
feature carry out the following steps:-
a. Change directory to ‘/emos/hpux/release’, by typing:-
“cd /emos/hpux/release”[Return]
b. Edit the ‘.emosrc’ file, by typing:-
“vi .emosrc”[Return]
c. Using the [cursor] keys, move to the section of the file containing the following:-
‘async-event-handler:critical
start-up = AEHR (Note: This line will read ‘start-up = AEHR -e’ where the
start-up-action = wait External Link Interface has not been disabled - see below)
init-timeout = 600’
Note: If the External Link Interface has not been disabled, a ‘-e’ parameter will have been
added automatically to the ‘start-up = AEHR’ line. If Serial events are required to be
forwarded via the ELI (i.e. where the EM-OS is being managed by SMN-OS via an NE Server)
this ‘-e’ parameter should not be deleted and the following parameters should be added after
the ‘-e’ parameter.
d. To enable Serial Data Handoff, the following arguments should be added after the word
‘AEHR’ (or ‘AEHR -e’ where the ELI has not been disabled :-
-s Enable forwarding of status events.

(Serial Data Handoff automatically enabled).
-t xx Override default watch-dog time-out period (in seconds)

Default is 60 seconds
(Serial Data Handoff automatically enabled).
FOR EXAMPLE
To enable Serial Data Handoff and set the time-out to 120 seconds the following changes
should be made:-
i. Using the [cursor] keys, move the cursor onto the letter ‘R’ of ‘AEHR’ or the
‘e’ of the ‘-e’ parameter where the ELI has not been disabled.
ii. Type the following to amend the file:-

Issue 5
[a][spacebar]”-st”[spacebar]”120”[ESC]
iii. The file should now read:-
‘async-event-handler:critical
start-up = AEHR -st 120 (Note: This line should now read ‘start-up =
start-up-action = wait AEHR -e -st 120’ where the External Link
init-timeout = 600’ Interface has not been disabled)
iv. Exit the file by typing “:wq!”[Return].
Unless specified by the Network Planner, the EHSSerialPort.cfg file should be left
at default settings, the following is for example purposes only.
To enable the CTS hardware flow control and DSR line detection features carry out the
following steps:-
i. Edit the file ‘/emos/hpux/release/EHSSerialPort.cfg’ by typing:-
“vi /emos/hpux/release/EHSSerialPort.cfg”[Return]
ii. Move the cursor to the line containing the token ‘DSR_DETECTION’ and
remove the comment (‘#’) character from the beginning of the line.
iii. Move the cursor to the line containing the token ‘RTS_CTS’ and remove the
comment (‘#’) character from the beginning of the line.
iv. Save the file and exit by typing:- “:wq!”[Return]

If it is later required to disable the CTS hardware flow control feature edit the
‘EHSSerialPort.cfg’ file, re-insert the comment (‘#’) character at the beginning of the
line containing the token ‘RTS_CTS’ then save and exit the file.
Note: Any combination of CTS hardware flow control and DSR line detection features
can be enabled/disabled.
An example of the EHSSerialPort.cfg file is shown in Appendix A.
4.3 ENABLE/DISABLE REMOTE WINDOWING

Remote Windowing should only be enabled if the customer has purchased a license to use
it.
No detailed configuration instructions are needed for enabling or disabling remote windowing,
since most of the software is third-party and hence has its own instructions. However, the
following software items are needed (refer to 0.5.2 and 0.5.7 References for exact requirements
and additional configuration instructions):-
a. UNIX Link (for the HP included in the EM-OS Application)
b. FTP TCP issue 3.1 bundled with CoSession PC2X issue 6.2N (for the PC)
Issue 5
c. PC-MOS (if required)
The above items should be installed via the following sequence:-
a. Install PC/TCP software and CoSession PC2X (see third-party installation instructions).
b. Install PC-MOS (if required).
c. Configure UNIX Link as follows:-
Note: A license must first have been obtained from Unipress Software.
i. Enter:- “cd /usr/cspc2x”[Return]
ii. Enter:- “cspc2x.customer_info”[Return]
This will output a character string which will be requested by Unipress Software
when a license is requested for the workstation. Make a record of this character
string for reference.
ii. Enter:- “cspc2x.add_license”[Return]
Note: It will now be necessary to enter the license string obtained previously from
Unipress Software.
d. Test the link to see if a PC window can be displayed on the HP by running the UNIX link
software manually by the following command:-
“/usr/cspc2x/cspc2x”[Return]
e. Enable the External Managed Network license using the setup program described in
Section 4.1 and reboot the workstation.
f. The remote windowing feature on the EM-OS can now be used.
End of Section
Issue 5
5 STARTING THE APPLICATION

At this stage any further procedures contained on the specific release note(s) should be applied.
If the OMS IPC Trader is running on one machine in a network of EM-OS workstations, then
the workstation on which the OMS IPC Trader is to run should be started up first. To start the
EM-OS application carry out the following steps:-
a. If ObjectStore has been installed then the following commands can be skipped - carry
on to paragraph ‘b’. If ObjectStore has not been installed and configured then carry out
the following commands :-
“cdemos”[Return]
“mv os_persist_wr os_persist_wr.save”[Return]
b. Enter the following from the command line:-
“cd /emos/hpux/setup”[Return]
“make_persist_links.cmd”[Return]
c. Edit the file ‘/etc/inittab’ to restore the automatic boot up feature, by typing:-
“vi /etc/inittab”[Return]
d. On the first line change the number 2 to a 5.
e. Save the file and exit.
f. If an internal tape drive has been utilised or the tape drive has been supplied with the
workstation, reboot the workstation at this point by typing “/etc/reboot”[Return].
If the external DAT tape drive has been connected to carry out this procedure and is
required to be removed, the workstation should be shutdown by typing:
“/etc/reboot -h”[Return]
The workstation will display the message ‘Halted, you may now cycle power’. At this
point, power down the workstation and disconnect the tape drive, then power the
workstation back up.
g. When the ‘EM-OS Backup/Restore’ window is displayed, select the appropriate

options to start-up the EM-OS applications.
h. The ‘EM-OS Welcome Screen’ will be displayed.
i. The first time the EM-OS is run, only the root user can login using the root account.
Therefore, at the EM-OS login screen enter “root” for the username and the relevant
password.
Issue 5
j. Check that the EM-OS application runs correctly by referring to the EM-OS 5.0
Commissioning Specification (see 0.5.5 References).
Note: Ensure that the User and Terminal ‘Inactivity Logout’ periods are set to that required
by the customer. If this facility is not required to be active, it will be necessary to set both the
User and Terminal Inactivity Logout periods to ‘Disable’ to prevent the user being logged out
after a set period. These can be accessed via the ‘User Administration’ and ‘Terminal
Administration’ facilities from the ‘Security’ drop down menu in the ‘Network Control’
window.
End of Section
Issue 5
99 APPENDIX
99.1 APPENDIX A - SERIAL PORT CONFIGURATION FILE
(EHSSERIALPORT.CFG)
The purpose of this file is to indicate a number of standard parameters concerned with the
configuration of the serial port and to enable the hardware flow control features for the sending
of the alarm data to an external source for analysis or recording. The file consists of a number
of tokens which indicate that the feature is required and parameters associated with the token.
Comments in the file are identified by a # in column 1 of each line.
An example EHSSerialPort.cfg configuration file is given below:-
# AsyncVMEPort Configuration
# Baud 0 0
# Baud 50 1
# Baud 75 2
# Baud 110 3
# Baud 134 4
# Baud 150 5
# Baud 200 6
# Baud 300 7
# Baud 600 8
# Baud 1200 10
# Baud 1800 11
# Baud 2400 12
# Baud 4800 14
# Baud 7200 15
# Baud 9600 16
# Baud 19200 17
# Baud 38400 18
# Baud 57600 19
# Baud 115200 20
# Baud 230400 21
# Baud 460800 22
#SICANON set canonical mode

# In canonical mode input processing, terminal input is processed in
# units of lines, where a line is delimited by a new-line (NL)
# character, an end-of-file (EOF) character, or an end-of-line character
# (EOL). See Special Characters for more information on NL, EOF, and
# EOL. This means that a read request does not return until an entire
# line has been typed or a signal has been received. Also, no matter
# how many characters are requested in the read call, at most one line
# will be returned. It is not, however, necessary to read a whole line
# at once; any number of characters can be requested in a read, even
# one, without losing information.
Issue 5
#RICANON reset canonical mode

# In non-canonical mode input processing, input characters are not
# assembled into lines, and erase and kill processing does not occur.
# The values of the MIN and TIME members of the c_cc array (see termios
# Structure) are used to determine how to process the characters
# received. MIN represents the minimum number of characters that should
# be received before read() successfully returns. TIME is a timer of
# 0.10 second granularity that is used to timeout bursty and short term
# data transmissions. The four possible cases for MIN and TIME and
# their interactions are described below.#SICRNL
#SIGNCR Ignore CR.

#SISIG Enable signals.
#SIXOFF Enable start/stop input control.
#SIXON Enable start/stop output control.
#SOXONOFF Enable start/stop output control.
#SOXANY Enable any character to restart output.
#CS5 5 bits per character
#SCSTOPB Send two stop bits
#CSSTOP15 Send 1.5 stop bits
#SCPARODD Set odd parity
#RCPARODD Set even parity
#SCPARENB Enable parity
#RCPARENB Disable parity
#VMIN minimum number of character received to satisfy read
#VTIME inter-character timer of .10 seconds granularity
#RCSTOB Reset stop bits
#RICRNL Do not Map CR to NL on input.
#RIGNCR Do not ignore CR
#RISIG Disable signals
#RIXOFF Disable start/stop input control.
#RIXON Disable start/stop output control.
#ROXONOFF Disable start/stop output control.
#ROXANY Disable any character to restart output.
#RONLCR Do not Map NL to CR/NL on output.
#PORT_0 Use Port 0 (/dev/tty00) - default
#PORT_1 Use Port 1 (/dev/tty01)
#RTS_CTS Enable hardware flow control - default NOT enabled
#DSR_DETECTION Test the DSR line is up before/during writing data - if not up then flush
output and ignore current message to be sent
Issue 5
baud 16
ricanon
vmin 10
vtime 10
cs8
scstopb
scparodd
ronlcr
scparenb
PORT_0
#DSR_DETECTION
#RTS_CTS
Issue 5
99.2 APPENDIX B - TROUBLESHOOTING
STEP POSSIBLE PROBLEM SOLUTION
2.3(e) The installation utility fails to open a Take the following actions:-
specified source device for installing
from. 1. Have the media inserted in the
drive and wait until the drive
finishes the initialisation process
(the indicator says the drive is
ready).
2. Ensure the source reads:-

/dev/update.src or /dev/rmt/0m
4.1 After executing the setup utility, the Read the EM-OS resource database,
EM-OS screens appear in different by executing the following command
colours i.e. blue in a terminal window:-
“/usr/bin/X11/xrdb -1 -nlcpp
/.Xdefaults” [Return]
then close and reopen all affected

windows.
5 (f) The EM-OS fails to start-up Make sure the HP internal Ethernet
port has been terminated correctly.
To check this enter the command:-
“/etc/lanscan”[Return]
which should display the connection

is ‘UP’. If it is ‘DOWN’, check the
termination and then execute:-
“/etc/landiag”[Return]
Choose the option for lan (l) and

reset (r) then quit the program.
Recheck the correction with lanscan
to see if it is now ‘UP’. If it is
reboot the workstation to start EM-
OS up correctly.
Issue 5
STEP POSSIBLE PROBLEM SOLUTION
5 (j) In the EM-OS, no NE icons can be The em.license script has not been
created since the list is empty run correctly, see 4.1 for details on
how to do this.
5 (j) A remote login connection cannot be The OMS IPC Trader should be set
made between two EM-OS to run on only ONE workstation in a
workstations. network of EM-OS workstations.
The workstation running Trader
should always be started up and
logged into first.
End of Section
End of Document

60955aak Iss5 EMOS50

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

60955aak Iss5 EMOS50

Uploaded by

Copyright:

Available Formats

1QDE 60955 AAK-YYA

THIS DOCUMENT UNCONTROLLED WHEN PRINTED

The information contained herein is the

2 INSTALL EM-OS APPLICATION VIA TAPE......................................................0201

3 CONFIGURE EM-OS COMMS COMPONENTS..............................................0301

4 SETUP THE EM-OS APPLICATION.................................................................0401

5 STARTING THE APPLICATION........................................................................0501

Page 02 Copyright - Refer to Title Page 1QDE 60955 AAK-YYA

1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 03

1B Contents of ‘/etc/gated.conf’ modified in section 4.1.7.2

1 Formally issued after FOA (A J Frank)

2 Alteration to facilitate on-line backups without ObjectStore

3 Updated to incorporate loading of EMOS R5.0 Enhancement

4 Correction to incorrect reference 0.5.5 (M. Dam)

5 Updated to reflect loading of enhancement software not applicable to

Original master held on ‘Word for Windows’

Page 04 Copyright - Refer to Title Page 1QDE 60955 AAK-YYA

1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 05

0.5.3 1QDE 60615 AEY-YYA Installation and Configuration of HP-UX 10.20

0.5.5 1QDF 60955 AAC EM-OS Release 5.0 Administrator Operator

0.5.6 1QDE 60639 AHQ-YYA Installation and Configuration of Central Data

0.5.7 1QDE 60639 AJH-YYA Installation and Configuration of EM-OS Remote

0.5.8 1QDE 60857 AFU-YYA Installation and Configuration of a Digital I/O

Page 06 Copyright - Refer to Title Page 1QDE 60955 AAK-YYA

DAT Digital Audio Tape

EISA Extended Industry Standard Architecture

LAPB Link Access Procedures Balanced (X.25)

OMS Object Management System

PNG Public Networks Group

TMN Telecomms Managed Networks

1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 07

Page 08 Copyright - Refer to Title Page 1QDE 60955 AAK-YYA

1. Install EM-OS application via tape.

2. Configure EM-OS Comms components.

3. Setup the EM-OS application.

All actions should be carried out with the following constraints:-

1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 11

a. HP-UX workstation and peripherals according to relevant version of -CTA document,

b. HP DAT drive (if not integral).

d. EM-OS Release 5.0 Application Enhancement software (1HGC 60371 ***) - if

c. Text output by the workstation appear in ‘’, e.g. ‘Welcome to HP-UX’.

1.5 REQUIRED INFORMATION

THE FOLLOWING SET OF KEYSTROKES IS USED TO RESET THE X-SERVER ON

1.7 FALLBACK PROCEDURES

1.8 SUPPORT GROUP CONTACT

1.9 RECORDING OF CUSTOMER WORKSTATION INFORMATION

1.10 EMC CONFORMITY

If a Customer requests a copy of the associated EMC (Electromagnetic Compatibility) DoC

2 INSTALL EM-OS APPLICATION VIA TAPE

a. If necessary, start up VUE by typing :-

Click on ‘OK’ to confirm.

The select fileset should now be marked with a ‘Yes’.

The workstation will now analyse the selected fileset.

1QDE 60955 AAK-YYA Copyright - Refer to Title Page Page 21

Click on ‘Yes’ at both resulting ‘Confirmation’ screens to commence installation.

q. At the login prompt, type:-

Press [Return] for the password.

r. If a new password is required for the root user, then type:-

The following prompt will be displayed:-

‘Change password for root.’

s. Enter the required new password and press [Return].

The following prompt will be displayed:-

‘Re-Enter new password:’