test

Sun Java System Portal Server 7 Command-Line Reference

psadmin get-monitoring-attribute-names

Description

Returns MBean attribute names for Portal Server MBeans. A set of MBeans is first determined based on given type and name key properties, or given JMX ObjectName pattern.

This command fetches MBean attribute names from either a Portal Server instance or a Portal Server Secure Remote Access instance. Two options, --portal and proxy-type, determine whether Portal Server instance or Portal Server Secure Remote Access instance names are fetched.

This command fetches MBean ObjectNames from either a Portal Server instance or a Portal Server Secure Remote Access instance. Two options, –-portal and --proxy-type, determine whether Portal Server instance or Portal Server Secure Remote Access instance names are fetched.If both portal and proxy-type options are specified, portal option is ignored.

If no option values or operand are specified, then the command returns ObjectNames of all MBeans registered with the Portal Server instance or the Portal Server Secure Remote Access instance. If the --type and --name-properties, --object-name options are specified, only the object-name option is considered for the operation.

If attribute-name-regexp is specified, then attribute names of all MBeans from the determined set of MBeans matching the attribute name regular expression is returned. If attribute name regular expression is not specified, then all attribute names for a MBean are returned. If no option values or operand are specified, then attribute names of all MBeans registered with Portal Server instance or Portal Server Secure Remote Access instance are returned.

Syntax

Long Format

psadmin get-monitoring-attribute-names --adminuser uid --passwordfile password-filename [--portal portal-ID] | [--proxy-type sra-proxy-type ] --instance instance-ID [--type type-name-property [--name-properties mbean-name-properties ] | [--object-name mbean-object-name] [--interactive] [--output output-filename] [--verbose] [ attribute-name-regexp]

Short Format

psadmin get-monitoring-attribute-names -u user -f password-filename [-p portal-ID] | -x sra-proxy-type ] [-i instance-ID] [[-t type-name-property [--name-properties mbean-name-properties] | [--object-name mbean-object-name]] -o output-filename [-v] [attribute-name-regexp]

Options

The following options are required:

[--adminuser | -u] uid

Specifies the administrator's distinguished name.

[--passwordfile | -f] password-filename

Specifies the administrator's password in the password file.

[--instance | -i] instance-ID

Specifies the Portal Server instance or Portal Server Secure Remote Access instance for this command. Portal Server Secure Remote Access instance is also known by Portal Server Secure Remote Access profile name.

The following options are not required:

[--portal | -p] portal-ID

Specifies the portal ID.

[--proxy-type | -x ] sra-proxy-type

Identifies Portal Server Secure Remote Access Proxy type: Gateway, Rewriter Proxy, or Netlet Proxy. sra-proxy-type can be gateway, rwp, or nlp respectively.

[--type | -t] type-name-property

Specifies the unique identity of the MBean ObjectName.

--name-properties "key1=value1,key2=value2,..."

If ObjectName property 'type' is not unique, MBean ObjectName may have additional name-properties to uniquely identify it. You can locate such MBean specifying additional name-properties using this option, along with the -–type option.

--object-name mbean-object-name

Specifies a valid JMX ObjectName pattern to select monitoring MBeans.

--interactive

Pompts for user confirmation to confirm getting attribute names for the selected MBean.

[--output | -o ] output-filename

Names the output file.

[--verbose | -v]

Shows progression of command.

The following operand is available:

[ attribute-name-regexp]

Specifies a java.util.regex regular expression as an operand to locate a MBean, if type and name-properties options are not enough.

Examples

Example 5–9 get-monitoring-attribute-names -u amadmin -f ./password -p portal1 -i nicp104_80 -t MonitoringConfiguration

This command outputs:


com.sun.portal:type=MonitoringConfiguration
        ConnectorServerPort
        Disable
        HtmlAdaptorPort
        UseJavaPlatformMBeanServer
Example 5–10 get-monitoring-attribute-names -u amadmin -f ./password -p portal1 -i nicp104_80 --interactive

This command outputs:


Do you want to continue operation with <com.sun.portal:
 type=ChannelActionStatistic,channelAction=Content,name=Introduction,
class=com.sun.portal.providers.urlscraper.URLScraperProvider>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
 type=com.sun.portal.desktop.context.ProviderCallerPool>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
 type=ChannelActionStatistic,channelAction=Content,
 name=CommunityMembershipPortlet,class=com.sun.portal.providers.
 portletwindow.PortletWindowProvider>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
type=ConnectorServer>? [y/n]
y
Do you want to continue operation with <com.sun.portal:
type=HtmlAdaptorServer>? [y/n]
y
Do you want to continue operation with <com.sun.portal:
type=DesktopRequestStatistic,name=Content>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,
name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,
name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider>? [y/n]n
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,
name=CommunityAnonymousContainer,class=com.sun.portal.providers.
containers.jsp.table.JSPTableContainerProvider>? [y/n]n
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider>? [y/n]
n
Do you want to continue operation with <com.sun.portal:
type=MonitoringConfiguration>? [y/n]
y
Do you want to continue operation with <com.sun.portal:
type=ChannelActionStatistic,channelAction=Content,name=Login,class=com.sun.
portal.providers.jsp.JSPProvider>? [y/n]n
Do you want to continue operation with <com.sun.portal
:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.
jsp.single.JSPSingleContainerProvider>? [y/n]
n
com.sun.portal:type=ConnectorServer
        Active
        Address
        Attributes
        ConnectionIds.index
        MBeanServerForwarder
com.sun.portal:type=HtmlAdaptorServer
        Active
        ActiveClientCount
        AuthenticationOn
        Host
        LastConnectedClient
        MaxActiveClientCount
        Parser
        Port
        Protocol
        ServedClientCount
        State
        StateString
com.sun.portal:type=MonitoringConfiguration
        ConnectorServerPort
        Disable
        HtmlAdaptorPort
        UseJavaPlatformMBeanServer
Example 5–11 get-monitoring-attribute-names -u amadmin -f ./password -p portal1 -i nicp104_80 -v Port

This command outputs:


MBean ObjectName pattern is null
MBean type is null
MBean name-properties are null
Attribute name reg-exp is Port
Connecting to Portal Admin Server
Connecting to Portal Admin Server...done
Querying MBean ObjectNames with pattern com.sun.portal:*
Filtering MBean attribute names with pattern [\S]*Port[\S]*
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Introduction,class=com.sun.portal.providers.urlscraper.URLScraperProvider
        No MBean attributes found
com.sun.portal:type=com.sun.portal.desktop.context.ProviderCallerPool
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.
portletwindow.PortletWindowProvider
        No MBean attributes found
com.sun.portal:type=ConnectorServer
        No MBean attributes found
com.sun.portal:type=HtmlAdaptorServer
        Port
com.sun.portal:type=DesktopRequestStatistic,name=Content
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
 PortletWindowProvider
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityAnonymousContainer,class=com.sun.portal.providers.
 containers.jsp.table.JSPTableContainerProvider
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityHomeContainer,class=com.sun.portal.providers.containers.
 jsp.table.JSPTableContainerProvider
        No MBean attributes found
com.sun.portal:type=MonitoringConfiguration
        ConnectorServerPort
        HtmlAdaptorPort
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Login,class=com.sun.portal.providers.jsp.JSPProvider
        No MBean attributes found
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.
jsp.single.JSPSingleContainerProvider
        No MBean attributes found
Disconnecting from Portal Admin Server
Disconnecting from Portal Admin Server...done