NAME

sm_symond - Solstice SyMON process controller

SYNOPSIS

/opt/SUNWsymon/sbin/sm_symond [ -n RPC-number ]

[ -d debug-level ] [ -D AIL-debug-level ] [ -p output-level ]
[ -P minutes ] [ -i intervals ] [ -A file ] [ -C file ]
[ -E directory ] [ -H directory ] [ -I directory ] [ -L file ]

AVAILABILITY

SUNWsymon

DESCRIPTION

sm_symond is a tool to manage Solstice SyMON processes. Its primary role is to start the program's agents, monitor those agents for crashes, and provide RPC information to clients that wish to access any of those agents.

The primary repository for agent data is the file /etc/opt/SUNWsymon/sm_symond.conf (see sm_symond.conf (4)).

When sm_symond is run, it first reads /etc/opt/SUNWsymon/sm_symond.conf to determine the local agents to be spawned. It then spawns those agents. If an entry indicates that an agent may exist on a remote system, sm_symond will poll that system looking for another symond to get information on that agent.

Symond serves a hierarchy of information via RPC to any requesting client. Each agent should produce a hierarchy that is readable.

sm_symond is also responsible for looking at the auth_checker.tcl and auth_list.tcl scripts to determine if a Solstice SyMON user has access to the symon data.

OPTIONS

-n

Specify a custom RPC number for this program (the default is 100244). If you use this option to specify a different number for the monitored host, you must also supply it to any client programs, such as symon or sm_egd. This option does not dissociate process and child agents.

-d

Debugging level for sm_symond. These values can be added together for combinations of debug output:

1=trace

2=callbacks

4=rpc

8=spawn info

16=debug access control

32=config file info

-D

Debugging level for AIL for hierarchy transport.

-p

Print hierarchy level:

1=nodes

5=nodes and prop

10=nodes, prop, and data

-P

Turn on profiling to dump after specified number of minutes.

-i

Sampling interval for checking if the agents are still alive.

-A

Specifies alternative authorization checking file (default is auth_checker.tcl ).

-C

Specifies alternative configuration file (default is sm_symond.conf ).

-E

Specifies an alternative ``etc'' directory (default is /etc/opt/SUNWsymon ).

-H

Specifies an alternative ``home'' directory (default is /var/opt/SUNWsymon ). sm_symond will run from inside a subdirectory called hostname under this directory. Any core file or debug file that is generated will reside there.

-I

Specifies an alternative install directory (default is /opt/SUNWsymon ). This contains a subdirectory called etc containing authorization files that are used if no authorization files are found in the directory specified by the -E option. This also contains a subdirectory called lib/tcl that contains the Tcl library.

-L

Specifies an alternative authorization list file (default is auth_list.tcl ).

FILES

/etc/opt/SUNWsymon/sm_symond.conf

list of agents for invocation.

SEE ALSO

symon(1), sm_configd(1M), sm_confsymon(1M), sm_control(1M), sm_egd (1M), sm_krd(1M), sm_logscand(1M), auth_checker.tcl(4), auth_list.tcl(4), event_gen.tcl(4), logscan.tcl(4), rules.tcl(4), sm_symond.conf (4)

NOTES

sm_symond can only be run by root.