========================================================================
Nortel Networks                           Updated: 11/16/2000


Optivity NMS OIT Package README for DM/VM:
========================================================================



OIT PACKAGE SUMMARY:
====================

This document contains installation instructions, new feature, and known
restriction information for Optivity Integration Toolkit (OIT) files 
when used to integrate DM/VM to Optivity Database. The oit file
specifies what devices can be lauched in the DM/VM. These OIT 
installation instructions are not included in the Optivity and 
Passport 8600, 8100, 1000 switch documentation.  Manual installation of 
this OIT file is required for Optivity NMS v9.0.x releases.  


DEVICES SUPPORTED:
====================
Passport 8600 Series switches: 
            nortel-passport8610, 
            nortel-passport8606.

Passport 8100 Series switches: 
            nortel-passport8110, 
            nortel-passport8106.

Passport 1000 Series switches: 
            bay-xlr1050-switch,
            bay-xlr1051-switch,
            bay-xlr1100-switch,
            bay-xlr1150-switch,
            bay-xlr1200-switch,
            bay-xlr1250-switch,
            bay-xlr1250-switch,
            nortel-accelar1100,
            nortel-accelar1150,
            nortel-accelar1200.


NOTE: ****  This OIT package requires NMS 9.1.0.1 or later.  ****


NOTES FOR INSTALLATION:
=======================

The default locations for an Optivity install are:

Unix ($OITHOME):                        /usr/oit
Windows 95/98/NT (%OITHOME%):           <DRIVE_LETTER>:\Optivity\OIT

All installation commands are relative to the directory containing the
extracted (un-tarred or un-zipped) OIT package.  The following commands 
should be executed in that directory only.


Installing on UNIX 
------------------

1. On your workstation, log into Optivity NMS as root (su command).

2. Open a unix shell window and prepare your user environment with one 
   of the following commands:

      source /opt/lnms/bin/opt_cshrc (for csh and tcsh)
      . /opt/lnms/bin/opt_kshrc (for sh or ksh)

3. In the /usr/oit directory, create the following subdirectory 
   structures (if they do not already exist):

      mkdir -p passport/lan/dmvm

4. Copy the OIT file to the correct location:

      cp NMS_T_DM_VM_B.oit $OITHOME/passport/lan/dmvm

5. At the command prompt, type the following:

   oitInstall -u $OITHOME/passport/lan/rel3x/dmvm/NMS_T_DM_VM_B.oit

   where -u indicates to upgrade Optivity NMS. If you do not specify 
   the -u parameter, a syntax check only is performed on the OIT file. 
   You must have superuser permissions.


Installing on Win/NT Server  
---------------------------

1. On your workstation, log in as Administrator.

2. Open a command prompt.

3. In the \Optivity\oit directory, create the following subdirectory 
   structures:

      mkdir passport\lan\dmvm

4. Copy contents of the OIT package to the correct locations:

      cp NMS_T_DM_VM_B.oit %OITHOME%\passport\lan\dmvm
      cp NMS_Passport_tdm.bat %OITHOME%\passport\lan\dmvm
      cp NMS_Passport_tvm.bat %OITHOME%\passport\lan\dmvm

6. Run the oitInstall executable as follows:

   oitInstall -u %OITHOME%\passport\lan\dmvm\NMS_T_DM_VM_B.oit

   where -u indicates to upgrade Optivity NMS. If you do not specify 
   the -u parameter, a syntax check only is performed on the OIT file. 

NOTE:  Before lauching Dm/Vm from InfoCenter on NT, you need to set 
environment variables, as follows.

1. Go to Start->Settings->Control Panel->System->Environment.

3. Add TDM_HOME environment variable, (^dm_drive^ is the drive  
   where you installed the DM application):

   set variable : TDM_HOME 
   set value    : ^dm_drive^\dm

4. Append following PATH environment variable to the end of the existing PATH:

   set variable : PATH 
   set value    : %OITHOME%\passport\lan\dmvm;
   

Installation Results
--------------------

When you installed Optivity NMS, the installation program copied  
an oitinstalled.cnf file and an oitapplied.cnf file to the default 
location. These were empty files. When you upgrade Optivity NMS with
new device support, these files are updated with an entry for the 
new device. The contents of the oitinstalled.cnf and oitapplied.cnf
files should be the same. Each installed OIT package creates a line
in the format: <oit filename> <absolute path for oit file location>.

Example entries for the *.cnf files follow:


# This file contains all the OIT updates that are potential 
# update candidates.

<oit filename> <absolute path for oit file>

(UNIX EXAMPLE)
      NMS_T_DM_VM_B.oit $OITHOME/passport/lan/dmvm

(PC EXAMPLE)
      NMS_T_DM_VM_B.oit %OITHOME%\passport\lan\dmvm




NEW FEATURES IN THIS RELEASE:
=============================

Dm/Vm supports for nortel-passport8606, nortel-passport8610, 
nortel-passport8106, nortel-passport8110, nortel-passport1100, 
nortel-passport1150, nortel-passport1200.


OLD FEATURES REMOVED IN THIS RELEASE:
=====================================

None



BUGS FIXED IN THIS RELEASE:
===========================

None



FILES ASSOCIATED WITH THIS OIT KIT:
===================================
README.txt
NMS_T_DM_VM_B.oit
NMS_Passport_tdm.bat
NMS_Passport_tvm.bat



KNOWN LIMITATIONS:
=================

-- DBAdmin

   If you reinitialize the Optivity NMS databases through the DBAdmin
   tool, you must re-install any previously installed OIT packages.
   (CR 132974-1)

-- Info Center

   Optivity NMS 9.1 InfoCenter launch error/NT "cannot connect to 
   localhost". Often, all daemons will still be running. Workaround:  
   Stop and restart ObjectStore daemons and then all Optivity daemons 
   which were stopped as a result of stopping ObjectStore. 
   (CR 137136-1)

--  


(c) 1998-2000 Nortel Networks Incorporated. All rights reserved.
========================================================================