HP-UX SNAplus2 R7 Administration Guide

Administering SNAplus2
Enabling and Disabling SNAplus2 on the Local System
3.3 Enabling and Disabling SNAplus2 on the Local System
This section explains how to enable and disable the SNAplus2 software on the HP-UX server.
You must enable the SNAplus2 software before you can use any SNAplus2 tools (including the Motif administration
program). Normally, the software is enabled automatically after you install SNAplus2, but if necessary you can
enable it manually.
3.3.1 Specifying the Path to SNAplus2 Programs
SNAplus2 executable programs are stored in a directory specific to SNAplus2; when you run the programs, you
need to specify the path to this directory. You can specify the path either by adding the directory to your
PATH
environment variable before you run the programs for the first time, or by including the directory name each time
you run the programs.
The Motif administration program is stored in the directory /opt/sna/bin/X11, and the other programs are
stored in the directory /opt/sna/bin. If you add these directories to the definition of the PATH environment
variable in your .login or .profile file, SNAplus2 locates the programs automatically. Alternatively, you can
specify the directory name when you run the program, as in the following examples:
/opt/sna/bin/snap start
/opt/sna/bin/snapadmin query_node
/opt/sna/bin/X11/xsnapadmin
The sample command lines shown in this manual assume that you have added the directories to your PATH
environment variable, and do not include the directory names.
3.3.2 Enabling SNAplus2 Servers
This section describes how to enable SNAplus2 on a computer that was installed as a server (that is, with the SNA
node components installed). If you are enabling SNAplus2 on a client, see Section 11.4.1, Enabling and disabling
SNAplus2 on HP-UX clients.
You must enable SNAplus2 on the local system before you can configure or manage the local node (either locally
or from a remote SNAplus2 node).
To enable the SNAplus2 software, enter the following command at the HP-UX command prompt:
snap start [ -s ][-m kernel_memory_limit][-t ]
When you install SNAplus2, the installation utility automatically updates the startup file the snap start
command. This ensures that SNAplus2 is started automatically at system startup. If you do not want SNAplus2 to
be started automatically, you can remove or comment out this line, and then follow the instructions in this section
to enable the SNAplus2 software manually.
The parameters and options for the snap start command are as follows:
-s
Specifies that SNAplus2 should not write messages to the system console. If you do not use this option,
SNAplus2 writes messages to the console when it ends, and also writes the text of certain error log messages
to the console as well as to the log file.
-m kernel_memory_limit
Specifies the maximum amount of kernel memory, in kilobytes, that SNAplus2 should use at any time. (Kernel
memory is used for internal data structures.) If a component of SNAplus2 attempts to allocate kernel memory
66