System Administration Commands smc(1M)
NAME
smc - start the Solaris Management Console
SYNOPSIS
smc [ subcommand] [ args]
smc [ subcommand] [ args] -T tool_name
[ -- tool_args]
DESCRIPTION
The smc command starts the Solaris Management Console. The
Solaris Management 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 modifications 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 toolboxes 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 map to be managed fromthe 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 server where necessary. For instructions 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." SubcommandsThe smc subcommands are:
open The default subcommand for the Solaris Management Console is open. This will launch the console andSunOS 5.11 Last change: 11 Dec 2009 1
System Administration Commands smc(1M)
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 referencedtools. Instead, you will be able to edit that tool-
box, 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 managed 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 svccfg(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 Manage-
ment Console server on the local host. Controlling Remote Access The Solaris Management Console supports an SMF property thatcontrols remote access to WBEM-based applications, which
include the Solaris Management Console. The property,SunOS 5.11 Last change: 11 Dec 2009 2
System Administration Commands smc(1M)
options/tcp_listen, has default value of false, which disal-
lows remote access. The value true allows remote access. SeeEXAMPLES.
OPTIONS The following options are supported. These letter optionscan also be specified by their equivalent option words pre-
ceded by a double dash. For example, you can use either -D
or --domain with the domain argument.
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 authentication data. When running the Solaris ManagementConsole non-interactively, the console will still need
to authenticate itself with the server to retrieve tools. This data can either be passed on the commandline using the -u, -p, -r, and -l options (which is
insecure, because any user can see this data), or it canbe placed in a file for the console to read. For secu-
rity 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 nameOnly 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 afully-qualified 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
SunOS 5.11 Last change: 11 Dec 2009 3
System Administration Commands smc(1M)
Solaris Management Console server is running. If you omit port, the default port, 898, is used. This optionoverrides 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, dns, ldap, or file; host_name is the
name of the machine that serves the domain; anddomain_name is the name of the domain you want to
manage. This option applies only to a single tool run in the terminal console.If you do not specify this option, the Solaris Manage-
ment 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 ona 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 usagestatement 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 con-
nects to the default port, 898. If you do not specifyhost_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 overridethis behavior, use the -B option (see above), or set
your console preferences 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.SunOS 5.11 Last change: 11 Dec 2009 4
System Administration Commands smc(1M)
-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 sys-
tem 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 automatically run in terminal mode if it cannot find a graphical display.--trust
Trusts all downloaded code implicitly. Use this optionwhen running the terminal console non-interactively and
you cannot let the console wait for user input.-T | --tool 13;tool_name
Runs the tool with the Java class name that correspondsto tool_name. If you do not specify this option and the
Solaris Management Console is running in terminal mode,SunOS 5.11 Last change: 11 Dec 2009 5
System Administration Commands smc(1M)
the system prompts you. If the Solaris Management Con-
sole is running in graphical mode, the system eitherloads 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 terminal. 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 optionwhen running the terminal console non-interactively and
you cannot let the console wait for user input.EXAMPLES
Example 1 Printing a Usage StatementThe 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 toWBEM-based applications, including the Solaris Management
Console.# svccfg -s svc:/application/management/wbem \
setprop options/tcp_listen = true
# svcadm refresh svc:/application/management/wbem
SunOS 5.11 Last change: 11 Dec 2009 6
System Administration Commands smc(1M)
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 VARIABLESSee environ(5) for a description of the following environ-
ment variable that affects the execution of the smc command:
JAVA_HOME If you do not specify this environment vari-
able, 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 codesmay 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 attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWmcc ||_____________________________|_____________________________|
SEE ALSO
auths(1), java(1), profiles(1), roles(1), smcconf(1M),
svcadm(1M), svccfg(1M), attributes(5), environ(5), smf(5), X(7)SunOS 5.11 Last change: 11 Dec 2009 7