Configuring Peer-to-Peer Active Spaces Servers for CIM Cluster Servers in JBOSS.

Configuring Peer-to-Peer Active Spaces Servers for CIM Cluster Servers in JBOSS.

book

Article ID: KB0091204

calendar_today

Updated On:

Products Versions
TIBCO Collaborative Information Manager -
Not Applicable -

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:
    &ltConfValue description="" name="AS Meta Space Name Type" propname="com.tibco.cim.cache.as.metaspace" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="cim_ms" value="a unique name"/>
    </ConfValue>
    
    &ltConfValue description="" name="AS Unicast URL" propname="com.tibco.cim.cache.as.unicasturl" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="tcp:////" value="tcp:////"/>
    </ConfValue>

If using unicast, clear the multicast to turn it off:
    &ltConfValue description="Provide the multicast url for AS" name="AS Multicast URL" propname="com.tibco.cim.cache.as.multicasturl" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="tibpgm:////" value=""/>
    </ConfValue>

Define the distribution role, SEEDER for peer-to-peer:
    &ltConfValue description="AS DistributionRole for a Member." name="AS Member Distribution Role" propname="com.tibco.cim.cache.as.distributionrole" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfEnum>
            &ltEnumValue default="true" selected="true" value="SEEDER"/>
            &ltEnumValue default="true" value="LEECH"/>
        </ConfEnum>
    </ConfValue>

Define replication count for the cluster:
    &ltConfValue 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:
    &ltConfValue 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">
        &ltConfList>
            &ltConfListString value="IP1:port1"/>
            &ltConfListString value="IP2:port1"/>
            &ltConfListString 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:
    &ltConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
        &ltConfString default="tcp://" value="tcp://:port1"/>
    </ConfValue>
    
2). Per Member
    &ltServer name="Member1">

Define unicast discovery URLs.  List all listening URLs in the cluster:
    &ltConfValue 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">
        &ltConfList>
            &ltConfListString value="IP1:port1"/>
            &ltConfListString value="IP2:port2"/>
            &ltConfListString 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:
    &ltConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
        &ltConfString default="tcp://" value="tcp://IP1:port1"/>
    </ConfValue>

    &ltServer name="Member2">

Define unicast discovery URLs.  List all listening URLs in the cluster:
    &ltConfValue 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">
        &ltConfList>
            &ltConfListString value="IP1:port1"/>
            &ltConfListString value="IP2:port2"/>
            &ltConfListString 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:
    &ltConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
        &ltConfString default="tcp://" value="tcp://IP2:port2"/>
    </ConfValue>


    &ltServer name="Membern">

Define unicast discovery URLs.  List all listening URLs in the cluster:
    &ltConfValue 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">
        &ltConfList>
            &ltConfListString value="IP1:port1"/>
            &ltConfListString value="IP2:port2"/>
            &ltConfListString 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:
    &ltConfValue description="Provide the listen url for AS" name="AS Listen URL" propname="com.tibco.cim.cache.as.listenurl" sinceVersion="8.2" visibility="Advanced">
        &ltConfString 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:
    &ltConfValue description="" name="AS Meta Space Name Type" propname="com.tibco.cim.cache.as.metaspace" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="cim_ms" value="a unique name"/>
    </ConfValue>
    
    &ltConfValue description="" name="AS Unicast URL" propname="com.tibco.cim.cache.as.unicasturl" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="tcp:////" value="tcp:////"/>
    </ConfValue>

If using unicast, clear the multicast to turn it off:
    &ltConfValue description="Provide the multicast url for AS" name="AS Multicast URL" propname="com.tibco.cim.cache.as.multicasturl" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfString default="tibpgm:////" value=""/>
    </ConfValue>

Define the distribution role, SEEDER for peer-to-peer:
    &ltConfValue description="AS DistributionRole for a Member." name="AS Member Distribution Role" propname="com.tibco.cim.cache.as.distributionrole" sinceVersion="8.0.1" visibility="Advanced">
        &ltConfEnum>
            &ltEnumValue default="true" selected="true" value="SEEDER"/>
            &ltEnumValue default="true" value="LEECH"/>
        </ConfEnum>
    </ConfValue>

Define replication count for the cluster:
    &ltConfValue 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.