# Starting Hot Swap

This topic describes how to start Hot Swap under the following operating system environments:

- Windows

- Solaris

- Linux

## Starting Hot Swap under Windows

When Natural Access is installed on a host, the Hot Swap manager is installed as a Windows service. It is configured to be started manually, as follows:

Step | Action
1 | Access a command prompt on the host system.
2 | Enter: net start hsmgr

To set the Hot Swap manager to start automatically on a host using the Windows Control Panel, follow these steps:

Step | Action
1 | Open the Administrative Tools applet in the Control Panel. The Administrative Tools window appears.
2 | Open the Services applet within this window. The Services window appears.
3 | Double-click on NMS HotSwap Manager. The Properties window appears.
4 | In the Startup Type drop-down menu, select Automatic.
5 | Click OK.
6 | Close the Services window.
7 | Close the Administrative Tools window.

Refer to Hot Swap manager: hsmgr for more information.

## Starting Hot Swap under Solaris

When Natural Access is installed, the Hot Swap driver and Hot Swap manager are placed in the /opt/nms/hotswap/bin directory. These services can be started as daemons or as console applications.

Note: The Hot Swap manager requires the LD_LIBRARY_PATH environment variable to be set to LD_LIBRARY_PATH = /opt/nms/lib:/opt/nms/hotswap/lib.

To start the Hot Swap applications in console mode:

Step | Action
1 | Access a command prompt on the host system. If the host system is a remote host, access the command prompt on the host using a separate third-party utility such as telnet, rsh, or rexec.
2 | Start the Hot Swap driver by entering: /opt/nms/hotswap/bin/hssrv
3 | Start the Hot Swap manager by entering: /opt/nms/hotswap/bin/hsmgr This script sets the LD_LIBRARY_PATH environment variable and starts the Hot Swap manager in console mode.

To start the Hot Swap applications as daemons:

Step | Action
1 | Access a command prompt on the host system. If the host system is a remote host, access the command prompt on the host using a separate third-party utility such as telnet, rsh, or rexec.
2 | Start the Hot Swap driver in daemon mode by entering: /opt/nms/hotswap/bin/hssrv -d
3 | Ensure that the LD_LIBRARY_PATH environment variable is set to LD_LIBRARY_PATH = /opt/nms/lib:/opt/nms/hotswap/lib.
4 | Start the Hot Swap manager in daemon mode by entering: /opt/nms/hotswap/bin/hsmgr -d

To run the services in daemon mode at boot time (recommended), edit the /etc/inittab file to include lines that set the LD_LIBRARY_PATH environment variable and then start the Hot Swap driver and Hot Swap manager. In this case, do not include the -d command line option. For more information about the inittab file, refer to the UNIX administrator manuals.

Refer to Hot Swap driver: hssrv and to Hot Swap manager: hsmgr for more information.

## Starting Hot Swap under Linux

When Natural Access is installed, the Hot Swap driver and Hot Swap manager are placed in the /opt/nms/hotswap/bin directory. The Hot Swap manager service can be started as a daemon or as a console application.

Note: The Hot Swap manager requires the LD_LIBRARY_PATH environment variable to be set to LD_LIBRARY_PATH = /opt/nms/lib.

To start the Hot Swap applications in console mode:

Step | Action
1 | Access a command prompt on the host system. If the host system is a remote host, access the command prompt on the host using a separate third-party utility such as telnet, rsh, or rexec.
2 | Load the Hot Swap driver by entering: /opt/nms/hotswap/bin/hsmgr_startup start
3 | Stop the previously running Hot Swap manager by entering: /opt/nms/hotswap/bin/hsmgr -k
4 | Start the Hot Swap manager by entering: /opt/nms/hotswap/bin/hsmgr

To start the Hot Swap applications as daemons:

Step | Action
1 | Access a command prompt on the host system. If the host system is a remote host, access the command prompt on the host using a separate third-party utility such as telnet, rsh, or rexec.
2 | Load the Hot Swap driver and start the Hot Swap manager in daemon mode by entering: /opt/nms/hotswap/bin/hsmgr_startup start

Refer to Hot Swap driver: hssrv and to Hot Swap manager: hsmgr for more information.