
Administration Commands                 list-system-properties(1)

NAME
     list-system-properties - lists the system properties of  the
     domain, configuration, cluster, or server instance

SYNOPSIS
     lists-system-properties
     [--terse={true|false}][ --echo={true|false} ]
     [ --interactive={true|false} ] [ --host  host]
     [--port port] [--secure| -s ] [ --user  admin_user]
     [--passwordfile filename] [--help]
     [target target_name]

DESCRIPTION
     Note -

       This command is available only in domains that are config-
       ured to support clusters, such as domains that are created
       with the cluster profile or the  enterprise  profile.  For
       information about profiles, see Usage Profiles in Sun Java
       System Application Server 9.1 Administration Guide.

     Shared or clustered server  instances  will  often  need  to
     override  attributes  defined in their referenced configura-
     tion. Any configuration attribute in a server  instance  can
     be overridden through a system property of the corresponding
     name. This command lists the system properties of a  domain,
     configuration, cluster, or server instance.

OPTIONS
     -t --terse

         Indicates that any output data  must  be  very  concise,
         typically avoiding human-friendly sentences and favoring
         well-formatted data for consumption by a script. Default
         is false.

     -e --echo
         Setting to true will echo the command line statement  on
         the standard output. Default is false.

     -I --interactive

         If set to true (default),  only  the  required  password
         options are prompted.

     -H --host
         The machine name where the domain administration  server

Java EE 5           Last change: 13 Jul 2007                    1

Administration Commands                 list-system-properties(1)

         is running. The default value is localhost.

     -p --port

         The HTTP/S port for administration. This is the port  to
         which  you  should point your browser in order to manage
         the domain. For example, http://localhost:4848.

         The default port number is 4848.

     -s --secure
         If set to true, uses SSL/TLS  to  communicate  with  the
         domain administration server.

     -u --user

         The authorized domain administration server  administra-
         tive username.

         If you have authenticated to a domain using the  asadmin
         login  command,  then  you  need  not specify the --user
         option  on  subsequent  operations  to  this  particular
         domain.

     --passwordfile
         The --passwordfile option specifies the name,  including
         the full path, of a file containing the password entries
         in a specific format. The entry for  the  password  must
         have  the AS_ADMIN_ prefix followed by the password name
         in uppercase letters.

         For example, to specify the domain administration server
         password,  use  an  entry  with  the  following  format:
         AS_ADMIN_PASSWORD=password, where password is the actual
         administrator  password.  Other  passwords  that  can be
         specified        include        AS_ADMIN_MAPPEDPASSWORD,
         AS_ADMIN_USERPASSWORD, and AS_ADMIN_ALIASPASSWORD.

         All remote commands must specify the admin  password  to
         authenticate to the domain administration server, either
         through --passwordfile or  asadmin  login,  or  interac-
         tively  on the command prompt. The asadmin login command
         can be used only to  specify  the  admin  password.  For
         other  passwords, that must be specified for remote com-
         mands, use the --passwordfile or enter them at the  com-
         mand prompt.

         If you have authenticated to a domain using the  asadmin

Java EE 5           Last change: 13 Jul 2007                    2

Administration Commands                 list-system-properties(1)

         login command, then you need not specify the admin pass-
         word through the  --passwordfile  option  on  subsequent
         operations  to  this particular domain. However, this is
         applicable only to AS_ADMIN_PASSWORD  option.  You  will
         still  need to provide the other passwords, for example,
         AS_ADMIN_USERPASSWORD, as and when required  by  indivi-
         dual commands, such as update-file-user.

         For security reasons, passwords specified as an environ-
         ment variable will not be read by asadmin.

         The  default  value   for   AS_ADMIN_MASTERPASSWORD   is
         changeit.

     --help

         Displays the help text for the command.

OPERANDS
     target
         This option specifies the target on which you are  list-
         ing the system properties. Valid values are

             o    domain_name- Specifies a domain as the target.

             o    configuration_name- Specifies a certain  confi-
                  guration as the target.

             o    cluster_name- Specifies a  certain  cluster  as
                  the target.

             o    instance_name-  Specifies  a   certain   server
                  instance as the target.

EXAMPLES
     Example 1 Using list-system-properties

       asadmin> list-system-properties --user admin
       --passwordfile password.txt --host localhost --port 4848
       http-listener-port=1088 mycluster
       http-listener-port=1088
       Command list-system-properties executed successfully.

EXIT STATUS
     0                           command executed successfully

Java EE 5           Last change: 13 Jul 2007                    3

Administration Commands                 list-system-properties(1)

     1                           error in executing the command

SEE ALSO
     create-system-properties(1), delete-system-property(1)

Java EE 5           Last change: 13 Jul 2007                    4

