WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Configuring the embedded global cache by using commands

You can customize the default global cache topology to use a specific port range and listener host, or you can turn off the default topology and specify your own execution group properties. Multiple brokers can share a cache by using a policy file.

Before you start:

For more information about the default global cache topology, see Data caching overview.

If you are using the default global cache topology, you can use WebSphere Message Broker commands to set a port range and listener host for the cache manager to use, and to report the properties for the cache manager. If you want multiple brokers to share data in the cache, or to configure a cache with enhanced availability, you can use commands to specify a policy file. For more information, see Broker properties.

Use WebSphere Message Broker commands to turn off the default topology and set execution group properties explicitly (see Execution group properties).

You can also use the mqsicacheadmin command to clear data from a map. For more information, see mqsicacheadmin command.

Broker properties

  • To specify a policy for the cache manager to use, set the -b (cachePolicy) parameter on the mqsicreatebroker or mqsichangebroker command.
    The cachePolicy parameter specifies the policy to use for the cache manager. You can set this parameter to default, disabled, none, or the fully qualified name of an XML policy file.
    • If you set this property to default, the default global cache topology is used. The following example shows how to enable the default cache topology:
      mqsichangebroker brokerName -b default
    • If you set this property to disabled, the global cache components in the broker are disabled. The cache is disabled by default.
    • If you set this parameter to none, you must set the execution group properties explicitly.
    • If you specify the fully qualified name of a policy file, the brokers listed in the policy file are configured to share the data in the global cache. The path name must be absolute, not relative. The following example shows how to use the mqsichangebroker command to set the name of a policy file:
      mqsichangebroker brokerName -b c:\filepath\policy.xml 
      For more information, see Configuring the global cache for multiple brokers.
    You must stop the broker before you run the mqsichangebroker command. Changes take effect when you restart the broker.
  • To specify a port range for the cache manager to use, set the -r (cachePortRange) parameter on the mqsicreatebroker or mqsichangebroker command.
    The cachePortRange parameter specifies a range of ports that the cache manager can use. Set this parameter to generate or to a specific range of ports.
    • If you specify a range of ports, the value of this parameter must be in the format xxxx-yyyy, and the range must contain at least 20 ports.
    • If you specify generate, the broker generates a range of ports that are not being used by another broker on that computer. The broker chooses a range that starts from 2800. If, for example, another broker is using ports 2800 to 2819, the broker generates a range from 2820 to 2839.
    You must stop the broker before you run the mqsichangebroker command. Changes take effect when you restart the broker.

    Use of these parameters is shown in the following example.

    mqsichangebroker broker_name -b default -r 2809-2825
  • You can also use the mqsichangeproperties command to change broker properties while the broker is running, although you do have to restart the broker for the changes to take effect. To set the policy, port range, and listener host for the broker, set the -b (componentName) parameter to cachemanager, and use the -n and -v parameters to set the relevant properties, as shown in the following example:
    mqsichangeproperties broker_name -b cachemanager -o CacheManager -n policy,portRange,listenerHost -v default,generate,host_name
  • To report properties for the cache manager, set the -b parameter on the mqsireportproperties command to cachemanager, as shown in the following example.
    mqsireportproperties broker_name -b cachemanager -o CacheManager -r

Execution group properties

Before you start:

Before you can set properties explicitly for an execution group, you must set the cache policy property to none for the broker. You can set the policy by using the mqsicreatebroker, mqsichangebroker, or mqsichangeproperties command, as described in Broker properties. The execution group properties that were set most recently by the broker-level policy are retained as a starting point for customization.

If you set the cache policy property to none, you must set properties on the execution groups. If you stop the execution group that contains the only catalog server, the cache becomes unavailable. Therefore, if you switch off the default topology, ensure that you place the catalog server appropriately. If you restart the execution group that hosts the catalog server, it can no longer communicate with the container servers in other execution groups. Although these container servers are still running, they are no longer part of the cache, and your data is lost. Therefore, you must also restart the execution groups that host the container servers. Alternatively, restart the broker to reset all cache components.

To use the new properties that you set, restart the execution group.

  • To set cache manager properties for an execution group, use the mqsichangeproperties command and specify the object name ComIbmCacheManager. For example, to start the catalog service in execution group 1, set the enableCatalogService property to true, as shown in the following example.
    mqsichangeproperties broker_name -e execution_group_1 -o ComIbmCacheManager -n enableCatalogService -v true
  • To provide a specific domain name for the WebSphere eXtreme Scale servers in an execution group, set the domainName property, as shown in the following example. Only servers with the same domain name can participate in the same embedded grid. Therefore, ensure that all servers that participate in the same embedded grid use the same domain name. If you do not set a specific domain name, the broker creates a domain name that is based on the server names of the catalog servers.
    mqsichangeproperties broker_name -e execution_group_1 -o ComIbmCacheManager -n domainName -v myDomain
  • To start a container server in execution group 2, set the enableContainerService property to true, as shown in the following example.
    mqsichangeproperties broker_name -e execution_group_2 -o ComIbmCacheManager -n  enableContainerService -v true

    For a list of cache manager properties that you can set for an execution group, see Parameter values for the cachemanager component.

  • To report cache manager properties for the execution group, set the -o parameter on the mqsireportproperties command to ComIbmCacheManager, and specify the execution group name, as shown in the following example.
    mqsireportproperties broker_name -e execution_group_name -o ComIbmCacheManager -r
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:19


Task topicTask topic | Version 8.0.0.7 | bn23781_