# Hot Swap driver: hssrv

#### Name

hssrv

#### Purpose

Starts and coordinates the set of Hot Swap drivers (Solaris only).

#### Usage

hssrv [ options ]

where options are:

Option | Description
-h, -? | Displays the hssrv Help screen and terminates.
-mc | Prints configuration related messages.
-mi | Prints information messages.
-me | Prints warnings and error messages.
-ma | Prints all messages.
-c | Starts the Hot Swap driver as a console application (default).
-d | Starts the Hot Swap driver as a daemon.
-k | Kills any previous instance of the daemon.

#### Description

On a Solaris system, hssrv must be running to use Hot Swap. When Natural Access is installed, hssrv is placed in the /opt/nms/hotswap/bin directory. Start hssrv as a daemon or as a console application. To run hssrv at boot time (recommended), add information about the program to the /etc/inittab file. For more information, refer to the UNIX administrator manual.

To run on a remote host, the utility must be physically resident on the remote host. Use a separate third-party utility such as telnet, rsh, or rexec to invoke the utility.

When debugging Hot Swap applications, use hssrv in console mode (the default) to see Hot Swap driver messages.

#### Procedure

To run hssrv in console mode:

Step | Action
1 | Stop NMS OAM and any Natural Access applications.
2 | Stop hsmgr.
3 | Invoke hssrv with the option -k to stop any previous instance of the driver: hssrv -k
4 | Reboot the system.
5 | Start hssrv in console mode by entering: hssrv -c

If a print option is included on the command line (-mmessage_type), messages display as boards are inserted and extracted.

There are three types of messages:

#### Configuration messages (messages related to a device configuration process)

hssrv: EXT ACK (1:9:0) -> S0E
hssrv: Remove 40100000-4011FFFF
hssrv: Remove 40120000-4013FFFF
hssrv: Connected through bridge (0:8)
hssrv: BASE 0 32 bit - 128.00 KB - Configure as 40100000-4011FFFF
hssrv: BASE 1 32 bit - 128.00 KB - Configure as 40120000-4013FFFF
hssrv: Assign IRQ for (1: 9)
hssrv: RT (2) - (0:5:0)
hssrv: IRQ10 configured.
hssrv: aghw - [AG PCI Board]

#### Error and warning messages

hssrv: Device is not in RT table.
hssrv: Warning - SetHWInt is not supported
hssrv: - Assuming that IRQ is preconfigured

#### Informational messages

hssrv: - hsbios (PCI BIOS Interface) - Loaded.
hssrv: - hsrmgr (Resource Manager Interface) - Loaded.
hssrv: - hshw (CompactPCI Hardware Interface) - Loaded.
hssrv: PCI BIOS found. 3 bus(es)
hssrv: IRQ routing table - 9 record(s)
hssrv: Check for reserved resource manager keys
hssrv: - 14 reserved key(s)
hssrv: Get current system configuration
hssrv: PCI IDE - Mark IRQ14 (Primary channel is in compatibility mode)
hssrv: PCI IDE - Mark IRQ15 (Secondary channel is in compatibility mode)
hssrv: - 8 PCI device(s) were found
hssrv: - IRQs ( 7 6 8 1 4 3 10 11 5 14 5 11 10 )
hssrv: - 16.93 MB allocated by devices
hssrv: Search for PCI2PCI bridges
hssrv: - PCI2PCI bridge at (0: 8) #0 -> #1
hssrv: - Memory window - 40100000-401FFFFF, 1 MB
hssrv: - PCI2PCI bridge at (0:12) #0 -> #2
hssrv: - Memory window - 40200000-402FFFFF, 1 MB
hssrv: Shared resources 00000001 / 0000000D
hssrv: 24 Software driver(s) configured