Sun Java System Portal Server 7 Command-Line Reference

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