


Maintenance Commands                             ssadm-active(1M)



NAME
     ssadm-active - examine the active configuration

AVAILABILITY
     SUNWicgSS

SYNOPSIS
     ssadm active
     ssadm active -x policy

DESCRIPTION
     ssadm active prints out a description of  the  configuration
     that  is  currently being "executed" by the SunScreen.  When
     run with the -x option, the  actual  configuration  file  is
     extracted from the running system and can be saved for later
     examination.

     Without the -x option, ssadm  active  describes  the  active
     configuration  with two lines of text.  The first line lists
     the name of the Screen on which the configuration was origi-
     nally  stored, the name of the internal database in which it
     was stored (this name is always "default"), and the name  of
     the  policy,  including its version number.  The second line
     says the date and time when the configuration was activated,
     and the user (either a Unix user or SunScreen administration
     authorized user) who caused it to be activated.

EXAMPLE
     # ssadm active
     Active configuration: greatwall default Initial.3
     Activated by admin on 03/09/1999 02:58:36 PM PST

     In this example the Screen is currently running a configura-
     tion   that   came   from   the  Screen  named  "greatwall."
     "greatwall" might be the current Screen, or if the Screen is
     a  member of a centralized administration group, it might be
     the primary Screen of the centralized administration  group.
     The  configuration  includes  version  3 of the policy "Ini-
     tial."

     With the -x option, ssadm active saves the active configura-
     tion  into the named policy, which can be examined using the
     ssadm edit command.   The  named  policy  must  not  already
     exist;  ssadm  active will create it.  The saved policy will
     be a "self-contained" policy, meaning that it will contain a
     full  set  of  common  objects  in  addition  to  the policy
     objects.  This is different from a normal policy, which con-
     tains  only  policy objects and is meant to be combined with
     the currently defined common objects.

WARNING
     If the -x option is specified and  the  policy  argument  is



                   Last change: 20 April 1999                   1






Maintenance Commands                             ssadm-active(1M)



     omitted,  ssadm  active writes a configuration file to stan-
     dard output.  Since the format of a  configuration  file  is
     undocumented and private to the SunScreen internal software,
     using ssadm active in this way is not supported.

SEE ALSO
     ssadm(1M),   ssadm-activate(1M),   ssadm-edit(1M),    ssadm-
     policy(1M)















































                   Last change: 20 April 1999                   2



