Writer instructions

Page title

For most spaces, this page must be titled Space announcements.

For spaces with localized content, this page must be titled Space announcements l10n.

Purpose

Provide an announcement banner on every page of your space.

Location

Move this page outside of your home branch.

Guidelines

Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see MainView Middleware Monitor 9.2.

Changing preferences for the MVMM Configuration Agent


The MVMM Configuration Agent uses a set of default preferences that permit it to run immediately. The default behavior is to:

  • Write configuration files to MQS_HOME/ExtensionConfig (where MQS_HOME is a variable set in your environment).
  • Use automatic deployment via an HTTP connection to the TMTM Application Service

You can change the MVMM Configuration Agent preferences using the agentpref tool provided as part of the agent distribution. See also Defining-policies.

The following table lists the MVMM Configuration Agent preferences. To list these preferences, use the following command: agentpref --list-preferences

Preference

Value

Default

ASHost

For auto deployment. The host where the MVMM Application Service runs.

The MVMM Application Service normally resides on the same host as the MVMM Topic Service so the MVMM Configuration Agent uses the MVMM Topic Service setting.

When you configure the agent to connect to the MVMM Topic Service using agentpref, the MVMM Configuration Agent begins automatic deployments.

ASPort

For auto deployment. The port where the MVMM Application Service runs.

The default MVMM Application Service port is 15007. Ensure that no firewalls between the agent and MVMM Application Service host are blocking this port.

ASSecure

For auto deployment. Connects to the MVMM Application Service using a secure (HTTPS) connection. See Post-core-component-installation-and-configuration.

False.

BatchInterval

How often BTM extensions publish updates.

30 seconds.

ChangeConfigDirectoryTo

Instructs the MVMM Configuration Agent to change the directory to which it writes configurations. If configurations exist, they are moved to this location. If the agent is not running, they are moved when it starts. The agent removes this preference when the change is processed.

Not applicable.

ConfigInterval

Configures the interval, in seconds, used by monitoring extensions to check for configuration changes.

60 seconds.

DeploymentInterval

Configures the interval, in seconds, used to check the deployment source for changes.

60 seconds.

DeploySourceDirectory

For manual deployments. The directory from which the MVMM Configuration Agent reads deployments.

If this preference is not set, the MVMM Configuration Agent automatically reads deployments from the MVMM Application Service.

If this preference is set, the agent processes manual deployments, and preferences for auto deployment are ignored.

Remove this preference to revert to automatic deployments.

MSPassword

Password to access media when auto-deploy is used.

For auto deployment. The password used to connect to the media repository of the MVMM Application Service.

Note

Passwords will be encoded in an encoding supported by the extension. However you may provide the value encoded and the value will be re-encoded to the supported encoding. Supported encodings are: OBF, Base64, Cryptor and Cloaker.

A default password is used.

MSRetries

Number of retry attempts made when accessing media.

3

MSRetryInterval

Interval between retry attempts.

1 second.

MSUser

For auto deployment. The username used to connect to the media repository of the MVMM Application Service.

A default username is used.

NativeEncoding

Override the default native encoding of a BTM extension.

If not set, the environment's default native encoding is used (as set by the system). If set, the BTM extensions use the CCSID defined by the NativeEncoding property.

DisableAgentDistribution

Disables any further agent distribution. Any distributions already scheduled complete.

False.

ChangeDistributionDirectoryTo

Instructs the MVMM Configuration Agent to change the directory to which it writes agent and extension distributions. If distributions exist, they are moved to this location. If the agent is not running, they are moved when it starts. The agent removes this preference when the change is processed.

Not applicable

ASSecure

For auto deployment and agent and extension distributions, indicates that the agent connects to the MVMM Application Service using a secure (HTTPS) connection.

True.

ASTrustStore

A java keystore containing the certificate for the Application Service HTTPS port, used for auto deployment.

A trust store is provided in the MVMM Configuration Agent package if using an agent distribution.

Use the MVMM Configuration Agent in console mode, and issue the "saveHTTPSCertificate" command to capture the current HTTPS certificate.

The key store must reside either in the configuration/services directory of the MVMM Configuration Agent, or the directory defined by the MQS_HOME environment variable.

httpsTrustStore.jks

ASTrustStorePassword

Password used to access the java key store.

Note

Passwords will be encoded in an encoding supported by the extension. However you may provide the value encoded and the value will be re-encoded to the supported encoding. Supported encodings are: OBF, Base64, Cryptor and Cloaker.



A default password is used

ASTrustStoreType

The key store type

jks

EXAMPLE: Change the deployment interval from the default to 30 seconds.

 Use this command: agentpref --set "BTMConfig Ext" DeploymentInterval 30
 

where:
BTMConfig Ext is the name of the extension. Any space characters in the extension name might need to be enclosed in quotation marks or escaped depending on the shell being used to issue the command.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*