smc(1M) System Administration Commands smc(1M)NAMEsmc - start the Solaris Management Console
SYNOPSISsmc [ subcommand] [ args]
smc [ subcommand] [ args] -T tool_name
[ -− tool_args]
DESCRIPTION
The smc command starts the Solaris Management Console. The Solaris Man‐
agement Console is a graphical user interface that provides access to
Solaris system administration tools. It relies on Solaris Management
Console servers running on one or more computers to perform modifica‐
tions and report data. Each of these servers is a repository for code
which the console can retrieve after the user of the console has
authenticated himself or herself to the server.
The console can also retrieve toolboxes from the server. These tool‐
boxes are descriptions of organized collections of tools available on
that and possibly other servers. Once one of these toolboxes is loaded,
the console will display it and the tools referenced in it.
The console can also run in a terminal (non-graphically), for use over
remote connections or non-interactively from a script.
For information on the use of the graphical console, and for more
detailed explanations of authentication, tools, and toolboxes, please
refer to the Solaris Management Console online help available under the
"Help" menu in the Solaris Management Console. To enable an NIS/NIS+
map to be managed from the Solaris Management Console, you must use the
smc edit command to create a new toolbox for that map and enter the
information about your NIS/NIS+ server where necessary. For instruc‐
tions on creating a new toolbox, in the Solaris Management Console Help
menu, select "Contents," then "About the Solaris Management Console
Editor," then "To Create a Toolbox."
Subcommands
The smc subcommands are:
open The default subcommand for the Solaris Management Console is
open. This will launch the console and allow you to run tools
from the toolboxes you load. It does not need to be specified
explicitly on the command line.
edit The edit subcommand will also launch the console, like the open
subcommand. However, after loading a toolbox, you will not be
able to run the referenced tools. Instead, you will be able to
edit that toolbox, that is, add, remove, or modify any tools or
folders in that toolbox.
SMF Administration
The Solaris Management Console is implemented as a method that is man‐
aged by the service management facility (SMF) (see smf(5)), under the
fault management resource identifier (FMRI):
svc:/application/management/wbem:default
Administrative actions on this service, such as enabling, disabling, or
requesting restart, can be performed using svcadm(1M).
The configuration properties of this service can be modified with svc‐
cfg(1M).
Through svcadm, the Solaris Management Console supports the following
actions:
start Starts the CIM Object Manager (CIMOM) and Solaris Management
Console server on the local host.
stop Stops the CIMOM and Solaris Management Console server on the
local host.
status Gets the status of the CIMOM and Solaris Management Console
server on the local host.
Controlling Remote Access
The Solaris Management Console supports an SMF property that controls
remote access to WBEM-based applications, which include the Solaris
Management Console. The property, options/tcp_listen, has default value
of false, which disallows remote access. The value true allows remote
access. See EXAMPLES.
OPTIONS
The following options are supported. These letter options can also be
specified by their equivalent option words preceded by a double dash.
For example, you can use either -D or -−domain with the domain argu‐
ment.
If tool_args are specified, they must be preceded by the -− option and
separated from the double dashes by a space.
-−auth-data 13;file
Specifies a file which the console can read to collect authentica‐
tion data. When running the Solaris Management Console non-interac‐
tively, the console will still need to authenticate itself with the
server to retrieve tools. This data can either be passed on the
command line using the -u, -p, -r, and -l options (which is inse‐
cure, because any user can see this data), or it can be placed in a
file for the console to read. For security reasons, this file
should be readable only by the user running the console, although
the console does not enforce this restriction.
The format of file is:
hostname=host name
username=user name
password=password for user name
rolename=role name
rolepassword=password for role name
Only one set of hostname-username-password-rolename-rolepassword
may be specified in any one file. If the rolename is not specified,
no role will be assumed.
-B | -−toolbox 13;toolbox
Loads the specified toolbox. toolbox can be either a fully-quali‐
fied URL or a filename. If you specify an HTTP URL as, for example,
http://host_name:port/. . .
it must point to a host_name and port on which an Solaris Manage‐
ment Console server is running. If you omit port, the default port,
898, is used. This option overrides the -H option.
-D | -−domain 13;domain
Specifies the default domain that you want to manage. The syntax of
domain is type:/host_name/domain_name, where type is nis, nisplus,
dns, ldap, or file; host_name is the name of the machine that
serves the domain; and domain_name is the name of the domain you
want to manage. (Note: Do not use nis+ for nisplus.) This option
applies only to a single tool run in the terminal console.
If you do not specify this option, the Solaris Management Console
assumes the file default domain on whatever server you choose to
manage, meaning that changes are local to the server. Toolboxes can
change the domain on a tool-by-tool basis; this option specifies
the domain for all other tools.
-h | -−help
Prints a usage statement about the smc command and its subcommands
to the terminal window. To print a usage statement for one of the
subcommands, enter -h after the subcommand.
-H | -−hostname 13;host_name:port
Specifies the host_name and port to which you want to connect. If
you do not specify a port, the system connects to the default port,
898. If you do not specify host_name:port, the Solaris Management
Console connects to the local host on port 898. You may still have
to choose a toolbox to load into the console. To override this
behavior, use the -B option (see above), or set your console pref‐
erences to load a "home toolbox" by default.
-Jjava_option
Specifies an option that can be passed directly to the Java runtime
(see java(1). Do not enter a space between -J and the argument.
This option is most useful for developers.
-l | -−rolepassword 13;role_password
Specifies the password for the role_name. If you specify a
role_name but do not specify a role_password, the system prompts
you to supply a role_password. Passwords specified on the command
line can be seen by any user on the system, hence this option is
considered insecure.
-p | -−password 13;password
Specifies the password for the user_name. If you do not specify a
password, the system prompts you for one. Passwords specified on
the command line can be seen by any user on the system, hence this
option is considered insecure.
-r | -−rolename 13;role_name
Specifies a role name for authentication. If you are running the
Solaris Management Console in a terminal and you do not specify
this option, no role is assumed. The GUI console may prompt you for
a role name, although you may not need to assume a role.
-s | -−silent
Disables informational messages printed to the terminal.
-t
Runs the Solaris Management Console in terminal mode. If this
option is not given, the Solaris Management Console will automati‐
cally run in terminal mode if it cannot find a graphical display.
-−trust
Trusts all downloaded code implicitly. Use this option when running
the terminal console non-interactively and you cannot let the con‐
sole wait for user input.
-T | -−tool 13;tool_name
Runs the tool with the Java class name that corresponds to
tool_name. If you do not specify this option and the Solaris Man‐
agement Console is running in terminal mode, the system prompts
you. If the Solaris Management Console is running in graphical
mode, the system either loads a toolbox or prompts you for one (see
options -H and -B).
-u | -−username 13;user_name
Specifies the user name for authentication. If you do not specify
this option, the user identity running the console process is
assumed.
-v | -−version
Prints the version of the Solaris Management Console to the termi‐
nal. In the graphical console, this information can be found in the
About box, available from the Help menu.
-y | -−yes
Answers yes to all yes/no questions. Use this option when running
the terminal console non-interactively and you cannot let the con‐
sole wait for user input.
EXAMPLES
Example 1 Printing a Usage Statement
The following prints a usage statement about the smc command to the
terminal window:
smc--help
Example 2 Using SMF Property to Allow Remote Access
The following sequence of commands allows remote access to WBEM-based
applications, including the Solaris Management Console.
# svccfg -s svc:/application/management/wbem \
setprop options/tcp_listen = true
# svcadm refresh svc:/application/management/wbem
Example 3 Passing an Option to Java
The following passes an option through to the Java VM, which sets the
com.example.boolean system property to true. This system property is
only an example; the Solaris Management Console does not use it.
smc -J-Dcom.example.boolean=true
ENVIRONMENT VARIABLES
See environ(5) for a description of the following environment variable
that affects the execution of the smc command:
JAVA_HOME If you do not specify this environment variable, your PATH
is searched for a suitable java. Otherwise, the /usr/j2se
location is used.
EXIT STATUS
The following exit values are returned. Other error codes may be
returned if you specify a tool (using -T tool_name) that has its own
error codes. See the documentation for the appropriate tool.
0 Successful completion.
1 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWmcc │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOauths(1), java(1), profiles(1), roles(1), smcconf(1M), svcadm(1M), svc‐
cfg(1M), attributes(5), environ(5), smf(5), X(7)SunOS 5.10 10 Aug 2007 smc(1M)
