test

Sun Java System Portal Server 7 Command-Line Reference

psadmin get-monitoring-mbean-names

Description

Returns JMX ObjectNames for Portal Server MBeans.

This command fetches JMX MBean ObjectNames that match given type and name key properties, or given JMX ObjectName pattern, filtered with given ObjectName regular expression. The command fetches JMX 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, the --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.

Syntax

Long Format

psadmin get-monitoring-mbean-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 ] [--output output-filename ] [--verbose] [mbean-name-regexp ]

Short Format

psadmin get-monitoring-mbean-names -u uid -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] [mbean-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.

[--output | -o ] output-filename

Names the output file.

[--verbose | -v]

Shows progression of command.

The following operand is available:

mbean-name-reg-exp

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–2 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80

This command outputs:


com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Introduction,class=com.sun.portal.providers.urlscraper.
URLScraperProvider
com.sun.portal:type=com.sun.portal.desktop.context.ProviderCallerPool
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.
portletwindow.PortletWindow Provider
com.sun.portal:type=ConnectorServer
com.sun.portal:type=HtmlAdaptorServer
com.sun.portal:type=DesktopRequestStatistic,name=Content
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityAnonymousContainer,class=com.sun.portal.providers.
 containers.jsp.table.JSPTableContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityHomeContainer,class=com.sun.portal.providers.
containers.jsp.table.JSPTableContainerProvider
com.sun.portal:type=MonitoringConfiguration
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Login,class=com.sun.portal.providers.jsp.JSPProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityParentContainer,class=com.sun.portal.providers.
 containers.jsp.single.JSPSingleContainerProvider
Example 5–3 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 -t DesktopRequestStatistic

This command outputs:


com.sun.portal:type=DesktopRequestStatistic,name=Content
Example 5–4 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 -t DesktopRequestStatistic -v

This command outputs:


MBean ObjectName pattern is null
MBean type is DesktopRequestStatistic
MBean name-properties are null
MBean name reg-exp is null
Connecting to Portal Admin Server
Connecting to Portal Admin Server...done
Querying MBean ObjectNames with pattern com.sun.portal:
type=DesktopRequestStatistic,*
Filtering MBean ObjectNames with pattern [\S]*:[\S]*
com.sun.portal:type=DesktopRequestStatistic,name=Content
Disconnecting from Portal Admin Server
Disconnecting from Portal Admin Server...done
Example 5–5 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 --name-properties "channelAction=Content"

This command outputs:


com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Introduction,class=com.sun.portal.providers.urlscraper.
 URLScraperProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
 PortletWindowProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=Documentation,class=com.sun.portal.providers.urlscraper.
 URLScraperProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityAnonymousContainer,class=com.sun.portal.providers.container.
 jsp.table.JSPTableContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityHomeContainer,class=com.sun.portal.providers.containers.
 jsp.table.JSPTableContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityParentContainer,class=com.sun.portal.providers.containers.
 jsp.single.JSPSingleContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.
 portletwindow.PortletWindowProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,name=Login,
 class=com.sun.portal.providers.jsp.JSPProvider
Example 5–6 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 --name-properties "channelAction=Content,name=RedirectChannel"

This command outputs:


com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
Example 5–7 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 --object-name "*:type=ConnectorServer

This command outputs:


com.sun.portal:type=ConnectorServer
Example 5–8 get-monitoring-mbean-names -u amadmin -f ./password -p portal1 -i nicp104_80 -v type=ChannelActionStatistic,channelAction=Content,name=Community

This command outputs


MBean ObjectName pattern is null
MBean type is null
MBean name-properties are null
MBean name reg-exp is type=ChannelActionStatistic,channelAction=Content,
name=Community
Connecting to Portal Admin Server
Connecting to Portal Admin Server...done
Querying MBean ObjectNames with pattern com.sun.portal:*
Filtering MBean ObjectNames with pattern [\S]*:type=ChannelActionStatistic,
 channelAction=Content,name=Community[\S]*
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityMembershipPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityAnonymousContainer,class=com.sun.portal.providers.containers.
 jsp.table.JSPTableContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.
 jsp.table.JSPTableContainerProvider
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
 name=CommunityParentContainer,class=com.sun.portal.providers.containers.
 jsp.single.JSPSingleContainerProvider
Disconnecting from Portal Admin Server
Disconnecting from Portal Admin Server...done