test

Sun Java System Portal Server 7 Command-Line Reference

Chapter 5 Monitoring Subcommands

This chapter describes the folllowing subcommands:

psadmin get-monitoring-mbeans-information

Description

Returns attributes, operations, and notifications information about Portal Server MBeans.

Syntax

Long Format

psadmin get-monitoring-mbeans-information --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] [mbean-name-regexp]

Short Format

psadmin get-monitoring-mbeans-information -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 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 information for the selected MBean.

[--output | -o ] output-filename

Names the output file.

[--verbose | -v]

Shows progression of command.

The following operand is available:

mbean-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–1 get-monitoring-mbeans-information -u amadmin -f ./password -p portal1 -i nicp104_80 -t MonitoringConfiguration gives

This command outputs:


com.sun.portal:type=MonitoringConfiguration
DESCRIPTION

Portal Server (PS) Monitoring

ATTRIBUTES
Name: UseJavaPlatformMBeanServer
Description: JDK 5.0: Use Java Platform MBeanServer. If enabled, 
Java Management Instrumentation is accessible via PS CLI.
Type: java.lang.Boolean
Readable: true
Writable: true

Name: Disable
Description: Disable PS Monitoring. If PS Monitoring is disabled, 
you will not be able to get PS statistics.
Type: java.lang.Boolean
Readable: true
Writable: true

Name: HtmlAdaptorPort
Description: JMX HTML Adaptor Port. If 0, JMX HTML Adaptor is disabled. 
JMX HTML Adaptor is useful for debugging, only if PS CLI is not of 
good help.
Type: java.lang.Integer
Readable: true
Writable: true

Name: ConnectorServerPort
Description: JMX Connector Server Port. PS CLI uses this port to 
connect to JMX MBeanServer and to fetch PS statistics information.
Type: java.lang.Integer
Readable: true
Writable: true

OPERATIONS
Name: reset
Description: Reset operation removes previously collected PS 
statistics. PS statistics will be collected if PS Monitoring has been
 enabled.
Type: void
Signature
        No parameters found


Name: destroy
Description: Destroy operation destroys PS statistics. Please make
 sure you've disabled PS Monitoring before calling this operation.
Type: void
Signature
        No parameters found


Name: getRegistry
Description: Returns a Map of [ObjectName, Object] for quick use inside 
Portal Monitoring Subsystem. Please note that not all Portal Monitoring 
MBeans participate in such registry.
Type: java.util.Map
Signature
        No parameters found


NOTIFICATIONS
Name: javax.management.AttributeChangeNotification
Description: This MBean is a JMX (javax.management.)
NotificationBroadcaster, and emits javax.management.
AttributeChangeNotifcation for its attributes.
Notification types: jmx.attribute.change

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

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

psadmin get-monitoring-attributes

Description

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

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

Syntax

Long Format

psadmin get-monitoring-attributes --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-attributes -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–12 get-monitoring-attributes -u amadmin -f ./password -p portal1 -i nicp104_80 -t ConnectorServer

This command outputs:


com.sun.portal:type=ConnectorServer
        Active = true
        Address = service:jmx:jmxmp://localhost:49156
        Attributes = {jmx.remote.profiles=TLS SASL/PortalServerPlain,
 jmx.remote.tls.enabled.cipher.suites= SSL_RSA_WITH_RC4_128_MD5, 
jmx.remote.tls.enabled.protocols=TLSv1}
        ConnectionIds.0 = jmxmp://localhost:64242 DemoUser 23436655
Example 5–13 get-monitoring-attributes -u amadmin -f ./password -p portal1 -i nicp104_80 Port

This command outputs:


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 = 49182
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 = 49156
        HtmlAdaptorPort = 49182
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

psadmin log-monitoring-attributes

Description

Returns MBean attribute values for Portal Server MBeans periodically. Returns MBean attribute values for identified MBeans every interval-seconds. A set of MBeans is first determined based on given type and name key properties, or given JMX ObjectName pattern.

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 the attribute name regular expression is specified, then attribute values 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 values for a MBean are returned.

Syntax

Long Format

psadmin log-monitoring-attributes --adminuser uid --passwordfile password-filename [--portal portal-ID] | [--proxy-type sra-proxy-type ] --instance instance-ID --period interval-seconds [--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 log-monitoring-attributes -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] [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.

--period interval-seconds

Specifies interval in seconds between two fetch attribute requests to identified MBeans.

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

Prompts for user confirmation to confirm getting attribute values 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 ajava.util.regex regular expression as an operand to filter attribute names you are querying for values.

Examples

Example 5–14 log-monitoring-attributes -u amadmin -f ./password -p portal1 -i nicp104_80 --period 30 --name-properties "channelAction=Content"

This command outputs:


com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Introduction,
class=com.sun.portal.providers.urlscraper.URLScraperProvider|Count|
Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|
RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282706283|2|Rolling average time to get fresh content for this channel|
1129214762259|94|100|1070|94|PS Channel Action Statistics: Content|
744|1129214743642|1164|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider|
Count|Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|
Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282706578|1|Rolling average time to get fresh content for this channel|
1129214725863|3179|100|3179|0|PS Channel Action Statistics: Content|
3179|1129214725856|3179|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282706829|2|Rolling average time to get fresh content for this channel|
1129214762260|93|100|1494|93|PS Channel Action Statistics: Content|1027|
1129214744071|1587|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound
 |MaxTime|
MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282707068|1|Rolling average time to get fresh content for this channel|
1129214772705|10388|100|10388|0|PS Channel Action Statistics: Content|10388|
1129214772703|10388|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityAnonymousContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider|Count|Description|LastSampleTime|
LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|
Unit|UpperBound
1129282707308|1|Rolling average time to get fresh content for this channel|
1129214744288|1837|100|1837|0|PS Channel Action Statistics: Content|1837|
1129214744287|1837|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.jsp.
table.JSPTableContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282707597|1|Rolling average time to get fresh content for this channel|
1129214772706|10544|100|10544|0|PS Channel Action Statistics: Content|10544|
1129214772705|10544|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Login,class=com.sun.portal.providers.jsp.JSPProvider|Count|Description|
LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|
StartTime|TotalTime|Unit|UpperBound
1129282707829|1|Rolling average time to get fresh content for this channel|
1129214744286|1784|100|1784|0|PS Channel Action Statistics: Content|1784|
1129214744285|1784|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282708074|1|Rolling average time to get fresh content for this channel|
1129214765880|3575|100|3575|0|PS Channel Action Statistics: Content|3575|
1129214765879|3575|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.jsp.
single.JSPSingleContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282708310|2|Rolling average time to get fresh content for this channel|
1129214775544|14849|100|14849|0|PS Channel Action Statistics: Content|14451|
1129214747977|29102|RollingAvgTime|1000

Please type <exit> when you want to stop logging monitoring attributes
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Introduction,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|
Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282739968|2|Rolling average time to get fresh content for this channel|
1129214762259|94|100|1070|94|PS Channel Action Statistics: Content|744|
1129214743642|1164|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider|Count|
Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|
RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282740212|1|Rolling average time to get fresh content for this channel|
1129214725863|3179|100|3179|0|PS Channel Action Statistics: Content|3179|
1129214725856|3179|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282740456|2|Rolling average time to get fresh content for this channel|
1129214762260|93|100|1494|93|PS Channel Action Statistics: Content|1027|
1129214744071|1587|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282740688|1|Rolling average time to get fresh content for this channel|
1129214772705|10388|100|10388|0|PS Channel Action Statistics: Content|10388|
1129214772703|10388|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityAnonymousContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider|Count|Description|LastSampleTime
|LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|
TotalTime|Unit|UpperBound
1129282740956|1|Rolling average time to get fresh content for this channel|
1129214744288|1837|100|1837|0|PS Channel Action Statistics: Content|1837|
1129214744287|1837|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.jsp.
table.JSPTableContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime
|Unit|UpperBound
1129282741187|1|Rolling average time to get fresh content for this channel|
1129214772706|10544|100|10544|0|PS Channel Action Statistics: Content|10544|
1129214772705|10544|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Login,class=com.sun.portal.providers.jsp.JSPProvider|Count|Description|
LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|
StartTime|TotalTime|Unit|UpperBound
1129282741459|1|Rolling average time to get fresh content for this channel|
1129214744286|1784|100|1784|0|PS Channel Action Statistics: Content|1784|
1129214744285|1784|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282741691|1|Rolling average time to get fresh content for this channel|
1129214765880|3575|100|3575|0|PS Channel Action Statistics: Content|3575|
1129214765879|3575|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.jsp.
single.JSPSingleContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282742005|2|Rolling average time to get fresh content for this channel|
1129214775544|14849|100|14849|0|PS Channel Action Statistics: Content|14451|
1129214747977|29102|RollingAvgTime|1000

Please type <exit> when you want to stop logging monitoring attributes
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Introduction,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound
|MaxTime|MinTime|
Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282773679|2|Rolling average time to get fresh content for this channel|
1129214762259|94|100|1070|94|PS Channel Action Statistics: Content|744|
1129214743642|1164|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider|Count|
Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|
RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282773913|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|
1129214725856|3183|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound
|MaxTime|MinTime|
Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282774175|2|Rolling average time to get fresh content for this channel|
1129214762260|93|100|1494|93|PS Channel Action Statistics: Content|1027|
1129214744071|1587|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282774420|1|Rolling average time to get fresh content for this channel|
1129214772705|10388|100|10388|0|PS Channel Action Statistics: Content|10388|
1129214772703|10388|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityAnonymousContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider|Count|Description|LastSampleTime|
LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|
TotalTime|Unit|
UpperBound
1129282774662|1|Rolling average time to get fresh content for this channel|
1129214744288|1837|100|1837|0|PS Channel Action Statistics: Content|1837|
1129214744287|1837|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.jsp.
table.JSPTableContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282774983|1|Rolling average time to get fresh content for this channel|
1129214772706|10544|100|10544|0|PS Channel Action Statistics: Content|10544|
1129214772705|10544|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,name=Login,
class=com.sun.portal.providers.jsp.JSPProvider|Count|Description|
LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|
StartTime|TotalTime|Unit|UpperBound
1129282775563|1|Rolling average time to get fresh content for this channel|
1129214744286|1784|100|1784|0|PS Channel Action Statistics: Content|1784|
1129214744285|1784|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityMembershipPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282775793|1|Rolling average time to get fresh content for this channel|
1129214765880|3575|100|3575|0|PS Channel Action Statistics: Content|3575|
1129214765879|3575|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.
jsp.single.
 JSPSingleContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282776074|2|Rolling average time to get fresh content for this channel|
1129214775544|14849|100|14849|0|PS Channel Action Statistics: Content|14451|
1129214747977|29102|RollingAvgTime|1000

Please type <exit> when you want to stop logging monitoring attributes
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=Introduction,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|Count|Description|LastSampleTime|LastTime|LowerBound|
MaxTime|MinTime|Name|RollingAvgTime|
StartTime|TotalTime|Unit|UpperBound 1129282807696|2|Rolling average time 
to get fresh content for this channel|1129214762259|94|100|1070|94
|PS Channel Action Statistics: Content|744|1129214743642|1164|
RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider|
Count|Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|
RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282807921|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|
1129214725856|3183|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content
,name=Documentation,class=com.sun.portal.providers.urlscraper.
URLScraperProvider|
Count|Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|
Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282808136|2|Rolling average time to get fresh content for this channel|
1129214762260|93|100|1494|93|PS Channel Action Statistics: Content|1027|
1129214744071|1587|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityPortlet,class=com.sun.portal.providers.portletwindow.
 PortletWindowProvider|
Count|Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|
RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282808351|1|Rolling average time to get fresh content for this channel|
1129214772705|10388|100|10388|0|PS Channel Action Statistics: Content|10388|
1129214772703|10388|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityAnonymousContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound 1129282808568|1|Rolling average time to get fresh content for this
 channel|1129214744288|1837|100|1837|0|PS Channel Action Statistics: Content|
1837|1129214744287|1837|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityHomeContainer,class=com.sun.portal.providers.containers.
jsp.table.JSPTableContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282808788|1|Rolling average time to get fresh content for this channel|
1129214772706|10544|100|10544|0|PS Channel Action Statistics: Content|10544|
1129214772705|10544|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,name=Login,
class=com.sun.portal.providers.jsp.JSPProvider|Count|Description|
LastSampleTime|LastTime|LowerBound|MaxTime|MinTime|Name|RollingAvgTime|
StartTime|TotalTime|Unit|UpperBound
1129282809056|1|Rolling average time to get fresh content for this channel|
1129214744286|1784|100|1784|0|PS Channel Action Statistics: 
Content|1784|1129214744285|1784|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content
,name=CommunityMembershipPortlet,class=com.sun.portal.providers.portletwindow.
PortletWindowProvider|Count|Description|LastSampleTime|LastTime|LowerBound|Max
Time|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282809278|1|Rolling average time to get fresh content for this channel|112
9214765880|3575|100|3575|0|PS Channel Action Statistics: Content|3575|11292147
65879|3575|RollingAvgTime|1000
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=CommunityParentContainer,class=com.sun.portal.providers.containers.jsp
.single.JSPSingleContainerProvider|Count|Description|LastSampleTime|LastTime|
LowerBound|MaxTime|MinTime|Name|RollingAvgTime|StartTime|TotalTime|Unit|
UpperBound
1129282809494|2|Rolling average time to get fresh content for this channel|
1129214775544|14849|100|14849|0|PS Channel Action Statistics: Content|14451|
1129214747977|29102|RollingAvgTime|1000

Please type <exit> when you want to stop logging monitoring attributes
exit
Do you really want to exit? [y/n]
y
Example 5–15 log-monitoring-attributes -u amadmin -f ./password -p portal1 -i nicp104_80 --period 30 --name-properties "name=RedirectChannel"

This command outputs:


com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider|
Count|Description|LastSampleTime|LastTime|LowerBound|MaxTime|MinTime
|Name|RollingAvgTime|StartTime|TotalTime|Unit|UpperBound
1129282962603|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|
1129214725856|3183|RollingAvgTime|1000
Please type <exit> when you want to stop logging monitoring attributes
1129282994319|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|
1129214725856|3183|RollingAvgTime|1000
Please type <exit> when you want to stop logging monitoring attributes
1129283025953|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|1
129214725856|3183|RollingAvgTime|1000
Please type <exit> when you want to stop logging monitoring attributes
1129283057584|2|Rolling average time to get fresh content for this channel|
1129282758188|4|100|3179|4|PS Channel Action Statistics: Content|2120|
1129214725856|3183|RollingAvgTime|1000
Please type <exit> when you want to stop logging monitoring attributes
exit
Do you really want to exit? [y/n]
y

psadmin set-monitoring-attributes

Description

Sets MBean attribute values 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 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.

Be careful when you set UseJavaPlatformMBeanServer attribute of MBean with type MonitoringConfiguration. Toggling this boolean attribute may result in unregistering all MBeans in Portal Server instance or Portal Server Secure Remote Access instance, and the command might show an error message as a result.

Syntax

Long Format

psadmin set-monitoring-attributes --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] attribute1Name attribute1-value [[attribute2-Name attribute2-value]...]

Short Format

psadmin set-monitoring-attributes -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] attribute1Name attribute1-value [[attribute2-Name attribute2-value]...]

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 begateway, 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

Prompts for user confirmation to confirm setting attribute values for the selected MBean.

[--output | -o ] output-filename

Names the output file.

[--verbose | -v]

Shows progression of command.

The following operand is available:

attribute1Name attribute1Value [[attribute2Name attribute2Value]...]

Specifies attribute name value pairs that set attributes on identified MBeans.

Examples

Example 5–16 psadmin set-monitoring-attributes

The following command lines show how to enable JMX HTML Adaptor for a portal instance. Note that enabling JMX HTML Adaptor may compromize security, is an un-supported feature, and to be used only for debugging. Using this CLI (monitoring subcommands of psadmin) and portal AdminConsole are recommended ways to monitor a portal instance.


./psadmin get-monitoring-attributes -u amadmin -f ./password -p portal1
 -i nicp104_80 -t MonitoringConfiguration
com.sun.portal:type=MonitoringConfiguration
        ConnectorServerPort = 49156
        Disable = false
        HtmlAdaptorPort = 0
        UseJavaPlatformMBeanServer = false
./psadmin set-monitoring-attributes -u amadmin -f ./password -p portal1
 -i nicp104_80 --interactive -t MonitoringConfiguration HtmlAdaptorPort 49182
Do you want to continue operation with <com.sun.portal:type=MonitoringConfiguration>? [y/n]
y
com.sun.portal:type=MonitoringConfiguration
        Attribute <HtmlAdaptorPort> value set as <49,182>
./psadmin get-monitoring-attributes -u amadmin -f ./password -p portal1
 -i nicp104_80 -t MonitoringConfiguration
com.sun.portal:type=MonitoringConfiguration
        ConnectorServerPort = 49156
        Disable = false
        HtmlAdaptorPort = 49182
        UseJavaPlatformMBeanServer = false

psadmin reset-monitoring-mbeans

Description

Resets Portal Server MBeams to their initial state.

Be careful when using this command to reset a MBean with type MonitoringConfiguration . MonitoringConfiguration MBean reset unregisters all Portal Server instance or Portal Server Secure Remote Access instance MBeans, and restarts instance monitoring. This command may show an error message if MonitoringConfiguration MBean has been reset, and the command tries to reset other MBeans.

Syntax

Long Format

psadmin reset-monitoring-mbeans --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] [mbean-name-regexp]

Short Format

psadmin reset-monitoring-mbeans -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 either 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

Prompts for user confirmation to confirm resetting 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–17 psadmin reset-monitoring-mbeans -u amadmin -f ./password -p portal1 -i nicp104_80 --interactive --name-properties "name=RedirectChannel"

The following snippet shows how a particular MBean can be reset


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

        No MBeans reset
./psadmin get-monitoring-attributes -u amadmin -f ./password -p portal1
s -i nicp104_80 --name-properties "name=RedirectChannel"
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
        Count = 2
        Description = Rolling average time to get fresh content for this 
channel
        LastSampleTime = 1129282758188
        LastTime = 4
        LowerBound = 100
        MaxTime = 3179
        MinTime = 4
        Name = PS Channel Action Statistics: Content
        RollingAvgTime = 2120
        StartTime = 1129214725856
        TotalTime = 3183
        Unit = RollingAvgTime
        UpperBound = 1000
./psadmin reset-monitoring-mbeans -u amadmin -f ./password -p portal1 -i 
nicp104_80 --interactive --name-properties "name=RedirectChannel"
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]y
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
        MBean reset
./psadmin get-monitoring-attributes -u amadmin -f ./password -p portal1 -i 
nicp104_80 --name-properties "name=RedirectChannel"
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
        Count = 0
        Description = Rolling average time to get fresh content for this 
channel
        LastSampleTime = 1129283756991
        LastTime = 0
        LowerBound = 100
        MaxTime = 0
        MinTime = 0
        Name = PS Channel Action Statistics: Content
        RollingAvgTime = 0
        StartTime = 1129283756991
        TotalTime = 0
        Unit = RollingAvgTime
        UpperBound = 1000

psadmin delete-monitoring-mbeans

Description

Deletes or removes Portal Server MBeans.

Tries to delete MBeans that match given type and name key properties, or given JMX ObjectName pattern, filtered with given ObjectName regular expression.

Be careful when deleting MBeans as you may lose important data on the Portal Server instance or the Portal Server Secure Remote Access instance. Some MBeans are immortal MBeans, that is, they cannot be deleted via this command. MBeans with type ConnectorServer, HtmlAdaptorServer, and MonitoringConfiguration are immortal. You may need to restart Portal Server instance or the Portal Server Secure Remote Access instance if you delete an MBean accidently.

Syntax

Long Format

psadmin delete-monitoring-mbeans --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 delete-monitoring-mbeans -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 [--interactive] [-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 either 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

Prompts for user confirmation to confirm deleting the selected MBean.

[--output | -o ] output-filename

Names the output file.

[--verbose | -v]

Shows progression of command.

The following operand is available:

[ mbean-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.

Example

Example 5–18 delete-monitoring-mbeans

The following snippet shows how a particular MBean can be deleted:


./psadmin delete-monitoring-mbeans -u amadmin -f ./password -p portal1
 -i nicp104_80 --name-properties "name=RedirectChannel"
com.sun.portal:type=ChannelActionStatistic,channelAction=Content,
name=RedirectChannel,class=com.sun.portal.providers.jsp.JSPProvider
        MBean unregistered
./psadmin get-monitoring-attributes -u amadmin -f ./password -p portal
1 -i nicp104_80 --name-properties "name=RedirectChannel"
No MBeans found