book
Article ID: KB0091204
calendar_today
Updated On:
Description
Resolution:
Environment:
===========
CIM 8.1.X
CIM 8.2.X
All Platforms Supported by the CIM Versions
Symptoms:
========
Many different error messages at CIM startup indicating the cache manager (ActiveSpaces) is not started correctly.
Cause:
=====
Documentation is incomplete or mis-leading.
Resolution:
==========
A documentation JIRA (CIM-15111) has been opened. There are two methods of configuring a clustered JBOSS/CIM ActiveSpaces instance.
1). All AS configuration in the common area of ConfigValues.xml file, only if the same port number is available for listening on all members.
2). AS configuration in the member section of ConfigValues.xml file; useful if different listening ports must be used.
Remember that the same ConfigValues.xml must be available to all nodes on a mounted directory.
1). Common
Define a unique metaspace name for the platforms:
<ConfValue description="" name="AS Meta Space Name Type" propname="com.tibco.cim.cache.as.metaspace" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="cim_ms" value="a unique name"/>
</ConfValue>
<ConfValue description="" name="AS Unicast URL" propname="com.tibco.cim.cache.as.unicasturl" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="tcp:////" value="tcp:////"/>
</ConfValue>
If using unicast, clear the multicast to turn it off:
<ConfValue description="Provide the multicast url for AS" name="AS Multicast URL" propname="com.tibco.cim.cache.as.multicasturl" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="tibpgm:////" value=""/>
</ConfValue>
Define the distribution role, SEEDER for peer-to-peer:
<ConfValue description="AS DistributionRole for a Member." name="AS Member Distribution Role" propname="com.tibco.cim.cache.as.distributionrole" sinceVersion="8.0.1" visibility="Advanced">
<ConfEnum>
<EnumValue default="true" selected="true" value="SEEDER"/>
<EnumValue default="true" value="LEECH"/>
</ConfEnum>
</ConfValue>
Define replication count for the cluster:
<ConfValue description="Provide the replication count for AS cluster." name="AS Replication count" propname="com.tibco.cim.cache.as.replicationcount" sinceVersion="8.0.1" visibility="Advanced">
ConfNum default="0" value="1"/>
</ConfValue>
Define unicast discovery URLs. List all listening URLs in the cluster:
<ConfValue description="Provide the unicast discovery urls for AS" name="AS unicast discovery URLS" propname="com.tibco.cim.cache.as.discoveryurl" sinceVersion="8.2" visibility="Advanced">
<ConfList>
<ConfListString value="IP1:port1"/>
<ConfListString value="IP2:port1"/>
<ConfListString value="IPn:port1"/>
</ConfList>
</ConfValue>
Define the listening URL, the same port must be available on all members to define here, this "tcp://:port1" means use port1 on the member's IP:
<ConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
<ConfString default="tcp://" value="tcp://:port1"/>
</ConfValue>
2). Per Member
<Server name="Member1">
Define unicast discovery URLs. List all listening URLs in the cluster:
<ConfValue description="Provide the unicast discovery urls for AS" name="AS unicast discovery URLS" propname="com.tibco.cim.cache.as.discoveryurl" sinceVersion="8.2" visibility="Advanced">
<ConfList>
<ConfListString value="IP1:port1"/>
<ConfListString value="IP2:port2"/>
<ConfListString value="IPn:port3"/>
</ConfList>
</ConfValue>
Define the listening URL, the same port must be available on all members to define here, this "tcp://:port1" means use port1 on the member's IP:
<ConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
<ConfString default="tcp://" value="tcp://IP1:port1"/>
</ConfValue>
<Server name="Member2">
Define unicast discovery URLs. List all listening URLs in the cluster:
<ConfValue description="Provide the unicast discovery urls for AS" name="AS unicast discovery URLS" propname="com.tibco.cim.cache.as.discoveryurl" sinceVersion="8.2" visibility="Advanced">
<ConfList>
<ConfListString value="IP1:port1"/>
<ConfListString value="IP2:port2"/>
<ConfListString value="IPn:port3"/>
</ConfList>
</ConfValue>
Define the listening URL, the same port must be available on all members to define here, this "tcp://:port1" means use port1 on the member's IP:
<ConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
<ConfString default="tcp://" value="tcp://IP2:port2"/>
</ConfValue>
<Server name="Membern">
Define unicast discovery URLs. List all listening URLs in the cluster:
<ConfValue description="Provide the unicast discovery urls for AS" name="AS unicast discovery URLS" propname="com.tibco.cim.cache.as.discoveryurl" sinceVersion="8.2" visibility="Advanced">
<ConfList>
<ConfListString value="IP1:port1"/>
<ConfListString value="IP2:port2"/>
<ConfListString value="IPn:port3"/>
</ConfList>
</ConfValue>
Define the listening URL, the same port must be available on all members to define here, this "tcp://:port1" means use port1 on the member's IP:
<ConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
<ConfString default="tcp://" value="tcp://IPn:portn"/>
</ConfValue>
Some configuration in the Common area of ConfigValues.xml is required.
Define a unique metaspace name for the platforms:
<ConfValue description="" name="AS Meta Space Name Type" propname="com.tibco.cim.cache.as.metaspace" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="cim_ms" value="a unique name"/>
</ConfValue>
<ConfValue description="" name="AS Unicast URL" propname="com.tibco.cim.cache.as.unicasturl" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="tcp:////" value="tcp:////"/>
</ConfValue>
If using unicast, clear the multicast to turn it off:
<ConfValue description="Provide the multicast url for AS" name="AS Multicast URL" propname="com.tibco.cim.cache.as.multicasturl" sinceVersion="8.0.1" visibility="Advanced">
<ConfString default="tibpgm:////" value=""/>
</ConfValue>
Define the distribution role, SEEDER for peer-to-peer:
<ConfValue description="AS DistributionRole for a Member." name="AS Member Distribution Role" propname="com.tibco.cim.cache.as.distributionrole" sinceVersion="8.0.1" visibility="Advanced">
<ConfEnum>
<EnumValue default="true" selected="true" value="SEEDER"/>
<EnumValue default="true" value="LEECH"/>
</ConfEnum>
</ConfValue>
Define replication count for the cluster:
<ConfValue description="Provide the replication count for AS cluster." name="AS Replication count" propname="com.tibco.cim.cache.as.replicationcount" sinceVersion="8.0.1" visibility="Advanced">
ConfNum default="0" value="1"/>
</ConfValue>
Issue/Introduction
Configuring Peer-to-Peer Active Spaces Servers for CIM Cluster Servers in JBOSS.