4.1 Introduction

4.2 Starting the Hot Swap Driver and Hot Swap Manager

4.2.1 Starting Hot Swap Under Windows NT

4.2.2 Starting Hot Swap Under UNIX

4.3 Starting the CT Access Server

4.4 Verifying Hot Swap

4.1 Introduction

To start up OAM, start the following components:

• (If your hardware supports Hot Swap) the Hot Swap driver and Hot Swap Manager. OAM Hot Swap operations require that these components be running.

• The CT Access server (ctdaemon). OAM will only operate if ctdaemon is running.

This chapter describes how to start these components.

4.2 Starting the Hot Swap Driver and Hot Swap Manager

The following sections describe procedures for starting the Hot Swap driver and Manager under Windows NT and UNIX. See Chapter 8 for more details on the Hot Swap Driver service (hssrv) and the Hot Swap Manager (hsmgr).

Note: If you stop the Hot Swap driver, reboot your system before starting it again.

4.2.1 Starting Hot Swap Under Windows NT

When CT Access is installed, the Hot Swap driver is installed as a Windows NT driver. The Hot Swap Manager is also installed as a Windows NT service. Both are configured to be started manually.

The Hot Swap Manager is dependent on the Hot Swap driver. Therefore, starting Hot Swap Manager as a Windows NT service automatically starts the Hot Swap driver.

To start the Hot Swap Manager, enter:

net start hsmgr

You can set the Hot Swap Manager to start automatically using the Windows NT Control Panel Services applet. To do so:

1. Open the Services applet in the Control Panel.

2. Highlight NMS HotSwap Manager.

3. Click the Startup... button.

4. Set the startup type to Automatic.

5. Click Close.

4.2.2 Starting Hot Swap Under UNIX

When CT 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 variable to be set to LD_LIBRARY_PATH = /opt/nms/lib:/opt/nms/hotswap/lib.

To start the Hot Swap applications in console mode:

1. Start the Hot Swap Driver by entering:
   /opt/nms/hotswap/bin/hssrv

2. Start the Hot Swap Manager by entering:
   /opt/nms/hotswap/bin/hsmstart
   This script sets the LD_LIBRARY_PATH variable, and starts the Hot Swap Manager in console mode.

To start the Hot Swap applications as daemons:

1. Start the Hot Swap Driver in daemon mode by entering:
   /opt/nms/hotswap/bin/hssrv -d

2. Make sure the LD_LIBRARY_PATH variable is set as described above.

3. 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 your /etc/inittab file to include lines which set the LD_LIBRARY_PATH variable and then start the Hot Swap Driver and 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.

Note: The Hot Swap Driver service must be started before the Hot Swap Manager.

4.3 Starting the CT Access Server

Before you use OAM or any related utility, start the CT Access server (ctdaemon), as follows:

• (Windows NT) You can start ctdaemon in any of the following ways:

• Access a command prompt, and enter:
  net start ctdaemon

• In the Windows Control Panel, double-click on Services, and start the CT Access server within this applet.

• For console interaction with the NMS ctdaemon Windows NT service, invoke ctdaemon -c from any command prompt while the service is running.

(Windows NT or UNIX) Invoke ctdaemon -i from the command prompt. This method allows full console interaction with the ctdaemon.

Note: In order for the OAM Supervisor to start up within the CT Access server when it boots, the following line must appear in the [ctasys] section in cta.cfg (this line is included by default):

Service = oam, oammgr

ctdaemon must be running for OAM functions, and other Server mode operations, to be available. If ctdaemon is stopped, all dependent applications will receive an error. The service may need to be stopped and restarted for OAM functions to become available again. Note that applications accessing CT Access in Library mode only will not be affected if ctdaemon is shut down.

4.4 Verifying Hot Swap

Once you have started the Hot Swap Manager and driver, use hsmon to verify that all Hot Swap files are installed and the Hot Swap driver and the Hot Swap manager are running. To run hsmon:

1. Start hsmon by entering:
   hsmon

2. If you open the ejector handles on a CompactPCI board, messages reporting the extraction are displayed. For example:
   < 1,9 HSM_BOARD_EXTRACTION_CONFIGURED

3. If you insert a CompactPCI board, messages reporting the insertion are displayed. For example:
   < 1,9 HSM_BOARD_CONFIGURED
   < 1,9 HSM_BOARD_READY

4. Press s to stop hsmon.

For more details on hsmon, see Chapter 8.