OBSOLETE Patch-ID# 111406-02
Keywords: ttymux dual console netra ct cpci
Synopsis: Obsoleted by: 111406-03 Netra ct 1.0: Dual Console TTYmux support
Date: Mar/04/2002


Install Requirements: None                      
                      
Solaris Release: 8

SunOS Release: 5.8

Unbundled Product: Netra ct

Unbundled Release: 1.0

Xref: 

Topic: 

Relevant Architectures: sprac.sun4u

BugId's fixed with this patch: 4466477 4614742

Changes incorporated in this version: 4614742

Patches accumulated and obsoleted by this patch: 

Patches which conflict with this patch: 

Patches required with this patch: 108528-10 or greater 108528-21 or greater 109458-02 or greater 110790-04 or greater

Obsoleted by: 

Files included with this patch: 

/kernel/drv/sparcv9/ttymux
/platform/SUNW,UltraSPARC-IIi-Netract/kernel/dacf/sparcv9/ttymux_dacf
/platform/SUNW,UltraSPARC-IIi-Netract/kernel/drv/ttymux.conf
/usr/lib/rcm/modules/SUNW_ttymux_rcm.so
/usr/platform/SUNW,UltraSPARC-IIi-Netract/lib/sysevent/modules/libttymux_slm.so

Problem Description:

4614742 Montecarlo/Tonga fails to full hot swap with ttymux enabled
 
(from 111406-01)
4466477 montecarlo requires support for dual console (ttymux)

Patch Installation Instructions:
-------------------------------- 
For Solaris 8 release, refer to the man pages for instructions on
using 'patchadd' and 'patchrm' scripts provided with Solaris.
Any other special or non-generic installation instructions should be
described below as special instructions.  The following example
installs a patch to a standalone machine:
 
        example# patchadd /var/spool/patch/109585-01
 
The following example removes a patch from a standalone system:
 
        example# patchrm 109585-01
 
For additional examples please see the appropriate man pages.
 
Reboot the system after patch installation for the changes to take effect.

Special Install Instructions:
----------------------------- 
After installing the patch
 
To enable ttymux
----------------
 
   1. Bring the system down to OBP level 
	# shutdown -i 0
 
   At OBP level,
 
   2. Run the following 2 commands to enable multiplexer feature.
 
	ok setenv input-device input-mux
	ok setenv output-device output-mux
 
   3. Reset the machine. 
 
	ok reset 
 
   4. Reboot the system.
 
	ok boot -r   
 
 
To disable the ttymux
---------------------
 
   1. To disable ttymux you need to be in alarm console (rsc prompt) 
 
   2. Type "reset" on the alarm console
 
   3. Run the following 2 commands. 
 
	ok setenv input-device ttya
	ok setenv output-device ttya
 
   4. Reset the machine.
 
	ok reset
 
   5. Boot the machine.
 
	ok boot
 
 
------------------------------------------
IMPORTANT !!! 
 
When you install/upgrade OS or backout this patch 
you should DISABLE the ttymux 
before the OS installation/upgrade or the patch removal.
 
------------------------------------------
HOTSWAP :
 
During full hotswap removal operation, 
a message with the following format is displayed on the 
system console. 
 
<time> <machine_name> pcihp: NOTICE: pci_pci<driver_instance_no>: PCI device <slot_no> Busy
 
example># Feb  4 16:44:07 lab1260-96 pcihp: NOTICE: pci_pci0: PCI device 8 Busy
 
This message is expected during alarm card full hotswap removal operation 
when ttymux is enabled and should be disregarded.  
Operator should wait for alarm amber LED to remove the alarm card.
 
In case you need to perform multiple hotswaps please note the following.
 
After the alarm card hotswap insertion,
please wait ~ 1 minute for alarm card POST (self-test) to complete 
before performing another full hotswap removal of alarm card.  
 
==============================================
Dual Console Point Patch Installation Guide
----------------------------------------------
 
The dual console or multiple console (ttymux) functionality 
is delivered by the following 3 patches.
 
	111406-02
	111407-01* (point patch)
	111408-01** (point patch)
 
You need to install required patch cluster A. 
before the ttymux patch cluster B. installation.
 
A. Required patches ( available from SunSolve.Sun.COM )
 
   111293-04 : /usr/lib/libdevinfo.so.1 patch 
   109458-02 : /kernel/strmod/ldterm patch 
   108528-10 : kernel update patch
   110790-04 : OBP update for SUNW,UltraSPARC-IIi-Netract (3.15.6.ct)
 
   Due to patch dependencies it is recommended to 
   install the patches in top to bottom sequence.
 
B. ttymux patches 
 
   111407-01* : Point Patch for pcihp and pci.so.1 for TTYmux 
   111408-01** : Point Patch for se to support Dual Console TTYmux 
   111406-02 : Patch for Dual Console TTYmux support (this patch)
 
   Due to patch dependencies, the installation should be done in 
   the order of 111407-01, 111408-01, and 111406-02. 
 
Note :
	* If you have installed kernel update patch 108528-13
	   you do not need to install 111407-01.
	   Please refer to README.111407-01 for more information.
 
	** If you have installed 109815-12
           you do not need to install 111408-01 patch.
 
==============================================
Dual Console Technical Information
----------------------------------------------
 
1. Streams multiplexor is used to multiplex serial I/O from multiple 
   serial ports.
 
2. To enable ttymux feature, set the NVRAM variables as follows.
 
   input-device to input-mux
   output-device to output-mux
 
3. To disable the feature, change the values of NVRAM variables to ttya.
 
   input-device to ttya 
   output-device to ttya 
 
4. To change from Alarm console (rsc prompt) to Solaris prompt
   type "console".
   To change from Solaris prompt to rsc, type "~."
 
5. Dependencies
 
   a. changes to pci hotplug module (kernel module)
   b. pci library for configuration administration (userland binary)
   c. device information library (userland binary)
   d. se driver and ldterm module (kernel)
   e. OBP 3.14.6
 
   All these binaries are provided as a part of ttymux patches and an OBP update patch.
 
6. Hotswap of Alarm card when ttymux is enabled
 
   a. Basic Hotswap is supported for both Removal and Insertion.
   b. Full Hotswap is supported for both Removal and Insertion.

README -- Last modified date:  Friday, December 5, 2003

