⟦1239a6854⟧

TextFile

#######################################################################
#								      #
# Copyright (c) 1988 University College London			      #  
# All rights reserved.						      #
#								      #
# Redistribution and use in source and binary forms are permitted     #
# provided that the above copyright notice and this paragraph are     #
# duplicated in all such forms and that any documentation,	      #
# advertising materials, and other materials related to such	      #
# distribution and use, acknowledge that the software was developed   #
# by the Department of Computer Science, University College London.   #
# The name of the University may not be used to			      #
# endorse or promote products derived from this software without      #
# specific prior written permission.				      #
# THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR      #
# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED      #
# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. #
#								      #
#######################################################################


THE UCL OSI MANAGEMENT SYSTEM

The contents of the `osimis' directory (stands for OSI Management Information 
Service) implement the functionality of the UCL Management System.
The system has been developed on top of the ISO Development Environment
(ISODE) and at present it manages the ISODE transport layer. ISODE 
availability is assumed for the system to be of any usefulness.
The software was developed as part of UCL's work in the ESPRIT Project 395
"INCA". For further information about project INCA contact either of the
two addresses at the end of this text.

The system was initially developed on ISODE version 5.0 whose transport
layer was modified to report the management information. The current version
of the system (1.2) is based on ISODE version 6.0 which has officially
incorporated the transport management hooks.


The various subdirectories contain the following components of the system:

`msap' (stands for Management Service Access Point):
it contains a library that implements the functionality of CMIS/CMIP 
as in the documents:

Final ISO/DIS 9595 "Common Management Information Service Specification",
January 1990.

Final ISO/DIS 9596 "Common Management Information Protocol Specification",
January 1990.


`sma' (stands for System Management Agent):
it contains the System Management Agent (SMA) which is a management process 
implementing the local Management Information Base (MIB) and enabling 
access to it via CMIS. The management information concerns at present the
ISODE transport layer and it is realised communicating with the active ISODE
tranport entities (i.e. processes using ISODE transport services).
The structure of the management information in the MIB conforms to the
spirit of the document:

ISO TC97/SC21 WG4 N 2684 "OSI Management Information Services -
Structure of Management Information", Washington Output, April 1988

The actual MIB supported is defined in INCA deliverable 2.2 Appendix B 
and is reproduced in the file `docs/MIB'.


`smap' (stands for System Management Application Process):
it contains three different management processes that access and manipulate 
the management information in the SMA.


`misode' (stands for Managed ISODE):
it contains a version of the ISODE library with the transport layer compiled
with the management hooks in it to report management information to the SMA.
It also contains a version of the ISODE imisc program linked with that
library as an application to test the management system.


The rest of the subdirectories are:

`h' (stands for Header files):
contains the header files for the source code in `msap', `sma' and `smap.


`docs' (stands for Documents):
contains documents describing the management system.


More information of what exactly each subdirectory contains
may be found in README files in each.


HOW TO INSTALL THE SYSTEM

The UCL Management System uses ISODE version 6.0 and has successfully run
on Sun-3 workstations running SusOS 4.0 and on VAXstations running Ultrix. 
We will describe below the necessary changes to enable the system to
operate in a new environment.


1) The ISODE database should be updated first with entries for the
SMA on the systems to provide and access the management service. Note
that the SMA is a static server.  The application context and the
provided service should be: 
		context =	"management"
		service	=	"SMA"
The person who maintains ISODE at your site should be able to do that.
If there is no such ISODE expert, an example with the UCL entries
is given at the end of this file to help with this task.

2) A UDP port for the service "manager" should be installed in /etc/services.
This is needed for the local communication between the transport ISODE
entities and the SMA (UDP server).

3) On the systems that access the management service (usually a superset of 
the systems that provide it), a configuration file with the names of the
systems where SMAs run should be installed and the header file `h/config.h'
should be edited - consult README file in `h'.

4) Before you run make, the following paths in Config.mk should be edited
to reflect the local configuration:
ISODE	=	isode library directory
INC	=	isode header file directory
LIB	=	the directory to install the msap library
DAEMON	=	the directory to install the sma program
BIN	=	the directory to install the smap programs
 

The Makefile in this directory makes and installs the `msap' library and
the `sma' and `smap' management programs. In order to make and install
the `misode', the Makefile in that directory should be used - see README file.

In order to make and install it, run "make; make install". 
If you are interested in the msap library only (CMIS/P implementation), 
you just need to run make in `msap'. 

In order to test the system, you can run a special version
of the ISODE imisc program in `misode/imisc' linked with the isode library
compiled with the transport management hooks. You will also need to modify
the ISODE database - consult README file in `misode/imisc'.



HOW TO UPDATE THE ISODE DATABASE

The ISODE files `isobjects', `isoentities' and `isoservices' on the
systems to provide and access the management service should be updated
as follows:


isobjects: you should register the application context associated with
           an object identifier. In the UCL system the entry looks like:

"management"		1.17.5.5.0


isoentities: you should register the presentation address of the service for
             the hosts providing it. Two example entries for the UCL system:

ego	SMA		1.17.5.12.0 \
			#603/Internet=ego.cs.ucl.ac.uk+11010

tiger	SMA		1.17.5.12.0 \
			#603/Internet=tiger.cs.ucl.ac.uk+11010

The service object identifier is 1.17.5.12.0, the TCP port is 11010,
the presentation and session selectors are NULL and the transport one is 603.


isoservices: nothing, as the SMA is a static service.

The service and context object identifiers and the SMA TCP port number
have been locally chosen.


HOW TO UPDATE /ETC/SERVICES

The entry in the UCL /etc/services file for the SMA is:

manager		1099/udp		# SMA

The UDP port number for the SMA has been locally chosen.



Any problems in installing the system, comments and bugs should be reported to:

 - George Pavlou, gpavlou@uk.ac.ucl.cs
 - Graham Knight, gknight@uk.ac.ucl.cs
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦1239a6854⟧ TextFile

Derivation

TextFile
