
          PORTCFG INSTALLATION PROCEDURE FOR C-ODI DRIVERS
          ================================================

This file is about Auto Installation of C-ODI driver using Portcfg.NLM.

Definitions
===========
AGP2 -  refers to a configuration of upto 2 adapters which together provide 
        the link aggregation & link failover features of the LFT, DLB & PAg,
	and FEC implementation by AMD.

AGP4 -  refers to a configuration of upto 4 adapters which together provide 
        the link aggregation & link failover features of the DLB & PAg,
	and FEC implementation by AMD.


Installation Procedure
======================
Installation of the CPCNTNW.LAN C-ODI driver for LFT, DLB & PAg, and FEC 
functionality would require the following procedure in the order specified.

    1. Load the "portcfg" custom NLM to setup the required
       configuration. For details on how to use "portcfg", please refer to
       the subsequent section.
        
    2. Read the file "sys:\system\agp.ncf" and modify or add any binding
       information in this file as per your requirement. 
    
    3. Reboot 

Before proceeding with the above installtion procedure, please ensure that
all the adapters which will be configured for LFT, DLB & PAg, and FEC 
support are physically present in the PCI slots. The user should have all 
the physical slot numbers and grouping information before using the "portcfg" 
utilty.


NetWare Server Parameters for PermaNet Server implementation
============================================================
It is recommended that the AGP4 configurations be tried out on systems
with at least 64 MB of RAM memory. Also the following NetWare parameters
should be set to the values given below

    MAXIMUM PACKET RECEIVE BUFFERS   300 or higher
    MINIMUM PACKET RECEIVE BUFFERS   100 or higher 

These parameters may be accessed by choosing the SERVER PARAMETERS menu
and COMMUNICATIONS PARAMETERS CATEGORY sub-menu in the Novell supplied
"monitor" utility.

Portcfg.NLM
===========
The "portcfg" utility allow the user to group the adapters according to
required LFT, DLB & PAg, and FEC configurations. The output of this 
utilty is the following file

    sys:\system\agp.ncf  - this is a script file generated by "portcfg" to 
                           load all the adapters in single-adapter or
                           multi-adapter configurations.

All the adapters of any chosen configurations are loaded through the
invocation of the script generated by the "portcfg" utility. An entry is
made to the "sys:\system\autoexec.ncf" file to invoke this script
autimatically during boot time. The "portcfg" utility provides all the
binding information required for the IPX protocol. Network numbers
provided by the "portcfg" utility may be modified if required. Binding
information for additional protocols such as IP may also be added in the
"agp.ncf" script. 

Invocation of the "portcfg" utility brings up a menu with the following
options. 

    Aggregated Group Of 4 Ports
    Aggregated Group Of 2 Ports
    PermaNet Port
    Normal Port
    Display Configuration Information
    Cancel Configuration Chosen
    Exit


Aggregated Group Of 4 Ports 
===========================
Allows DLB & PAg and FEC functionality for a group of 4 adapters. This 
option brings up a sub menu where the user specifies the PCI slot numbers 
of the primary and secondary adapters. Partially filled groups may also be 
specified by choosing a value of 0 for a secondary slot. For example if 
the user chooses to configure 3 adapters only in an aggregated groups of 4 
adapters, he/she may do so by specifying a value of 0 for any one of the 
secondary slots. 

Aggregated Group Of 2 Ports 
===========================
Same as above for a group of 2 adapters.

PermaNet Port
=============
Allows the user to specify the primary adapters and the corresponding
backup for the Link Fault Tolerance (LFT) feature.

Normal Port
===========
Allows the user to load an adapter in the default mode.

Display Configuration Information
=================================
Displays the configuration chosen up till the point of invocation of this
option. Each group is shown under the appropriate group header within
parantheses in terms of the PCI slot numbers chosen for that group. The
primary adapter is shown first followed by the secondary adapters. For
example an aggregated group of 4 adapters with slots numbers 2, 3, 5 & 7 
is shown as
    
    ( 2, 3, 5, 7 )

Here the adapter in slot 2 is the primary adapter.


Cancel Configuration Chosen
===========================
Allows the user to cancel all the configurations chosen till the point of
invocation of this option.

Exit
====
Allows the user to exit the utilty. This brings up a submenu which allows
the user to cancel the exit option, exit without saving any configuration
information or exit and save the configurations specified. If the last option
in the sub menu is chosen, it displays the location of the script
generated by this utilty and exits after saving all the configurations
specified by the user.
